## todo

解决 cookies 重合问题

导航栏菜单项

页面表格内单元样式细化

仪表盘填充真实数据


#### 下载代码
1. 下载本地项目，安装项目依赖包，运行：bun install
2. 确定本地开发环境正常：需要安装node.js bun git
3. 下载代码编辑器：vscode 并且安装好插件：ts biome tailwind css mdx
4. 创建环境变量文件 .env，复制 .env.example 中的内容到 .env，并根据实际情况修改
5. 启动项目终端运行 bun run dev 

### 上传代码
1. 使用git命令上传至master分支：
#### 添加所有文件
- git add .
#### 查看文件状态
- git status
#### 提交到本地仓库
- git commit -m "提交说明"
#### 推送到远程仓库
- git push -u origin master

#### 确保已配置Git用户信息：
- git config --global user.name "你的用户名"
- git config --global user.email "你的邮箱"

#### git 发布版本命令
- 首先在package.json文件中跟新最新版本号"version": "1.0.2", 
- 然后终端执行./publish.ps1 <版本号> 
- 在gitea项目地址页面选择 发布 -- 发布最新版本号
- 返回后可以在 代码 -- 提交记录中查看发布的版本是否挂载正确

#### 目录结构

public/              # 静态资源（图片、字体等）
src/
├── actions/         # 服务端 Action（表单提交、数据操作等）
├── app/             # App Router 核心目录
│   ├── (root)/      # 根路由组（无路径前缀）
│   ├── login/       # /login 路由页面
│   ├── favicon.ico  # 网站图标
│   ├── globals.css  # 全局样式
│   └── layout.tsx   # 根布局组件
├── components/      # 可复用 UI 组件
├── hooks/           # 自定义 React Hooks
├── lib/             # 工具函数、第三方库封装
├── models/          # 数据模型、类型定义、Schema
└── proxy.ts         # 代理配置（API 转发等）
.env                 # 环境变量（本地开发）
.env.example         # 环境变量示例模板
.gitignore           # Git 忽略文件
.npmrc               # npm 配置
biome.json           # Biome 代码格式化/检查配置
bun.lock             # Bun 包管理器锁文件
components.json      # shadcn/ui 组件库配置
Dockerfile           # Docker 容器化配置
next-env.d.ts        # Next.js 类型声明
next.config.ts       # Next.js 配置文件
package.json         # 项目依赖与脚本
postcss.config.mjs   # PostCSS 配置
README.md            # 项目说明文档
tsconfig.json        # TypeScript 配置

#### 项目使用到的技术栈

核心框架：
- nextjs 服务框架 https://nextjs.org/docs
- react 前端 UI 框架 https://react.dev/learn
- typescript (ts) 类型安全的 JavaScript 超集 https://www.typescriptlang.org/docs/
- bun 包管理器 / 运行时 https://bun.sh/docs

UI / 样式体系：
- radix-ui 无样式的基础 UI 组件库 https://www.radix-ui.com/docs/primitives/overview/introduction
- tailwindcss css 库 https://tailwindcss.com/
- tailwindcss-animate Tailwind CSS 动画插件 https://github.com/jamiebuilds/tailwindcss-animate
- tw-animate-css 扩展的 Tailwind 动画库 https://github.com/ixartz/tw-animate-css
- class-variance-authority (cva) 样式变体管理工具 https://cva.style/docs
- clsx/tailwind-merge CSS 类名处理工具 https://github.com/lukeed/clsx / https://github.com/dcastil/tailwind-merge
- lucide-react 图标库 https://lucide.dev/icons/
- next-themes 主题切换（暗黑 / 亮色模式） https://github.com/pacocoursey/next-themes

表单与数据验证：
- react-hook-form 表单处理库 https://react-hook-form.com/get-started
- @hookform/resolvers react-hook-form 校验解析器 https://react-hook-form.com/api/useform/resolver
- zod 数据验证库 https://zod.dev/
- date-fns 时间处理库 https://date-fns.org/docs/Getting-Started

数据管理与展示：
- zustand 状态管理库 https://zustand-demo.pmnd.rs/
- @tanstack/react-table 表格处理库 https://tanstack.com/table/latest/docs/guide/introduction

工程化与开发工具：
- eslint 代码检查工具 https://eslint.org/docs/latest/
- @biomejs/biome 代码格式化 / 检查工具 https://biomejs.dev/guides/getting-started/
- babel-plugin-react-compiler React 编译器插件（性能优化） https://react.dev/blog/2024/04/25/react-compiler
- typescript 类型检查 https://www.typescriptlang.org/docs/

部署与构建：
- Docker 容器化部署运行环境 https://www.docker.com/get-started
- Turbopack Next.js 新一代构建工具（脚本中启用 --turbopack） https://turbo.build/pack/docs/introduction