todo

解决 cookies 重合问题

导航栏菜单项

页面表格内单元样式细化

仪表盘填充真实数据

目录结构

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 配置

搭建开发环境

1. 下载本地项目：git clone https://43.226.58.254:53000/lanhu/admin
2. 安装依赖包：bun install
3. 创建环境变量文件 .env，复制 .env.example 中的内容到 .env，并根据实际情况修改
4. 启动项目终端运行 bun run dev

构建项目 & 版本管理

1. 在 package.json 文件中修改版本号
2. 构建并上传镜像, 终端运行 ./publish.ps1 <版本号>
3. 终端执行成功后在 https://43.226.58.254:53000/lanhu/admin 发布最新版本

技术栈

类别	场景/库名	推荐方案/用途
核心框架	Next.js	服务框架 (React 全栈框架)
UI / 样式体系	Radix UI	无样式基础 UI 组件原语
	Tailwind CSS	CSS 框架 (原子化 CSS)
	lucide-react	图标库
表单与数据验证	React Hook Form	表单状态管理及验证
	Zod	数据验证与类型推断
数据管理与通信	Zustand	全局状态管理库
	TanStack Query	服务端状态管理 (数据请求、缓存)
	TanStack Table	无头 UI 表格库
工具库	date-fns	日期时间处理库

生产环境的项目部署通过单独的部署脚本进行管理，前端开发上线只需要构建以及发布版本，无需考虑部署问题。