基础规范
项目结构
src/
├── client/ # 前端代码 (React + Vite)
├── server/ # 后端代码 (Hono + TypeORM)
│ ├── api/ # API路由
│ ├── migrations/ # 数据库迁移脚本
│ ├── modules/ # 业务模块
│ └── middleware/ # 中间件
技术栈
前端
管理后台 (Admin) antd
- React 19 - 前端框架
- TypeScript (严格模式) - 类型系统
- Vite 7 - 构建工具
- React Router 7 - 路由管理
- Ant Design 5 - UI组件库
- Tailwind CSS 4 - 样式框架
- React Query (TanStack) 5 - 数据获取和缓存
- React Hook Form - 表单处理
- Lucide React - 图标库
- Heroicons - 图标库
- React Toastify - 消息通知
管理后台 (Admin) shadcn-ui
- React 19 - 前端框架
- TypeScript (严格模式) - 类型系统
- Vite 7 - 构建工具
- React Router 7 - 路由管理
- Ant Design 5 - UI组件库
- Tailwind CSS 4 - 样式框架
- React Query (TanStack) 5 - 数据获取和缓存
- React Hook Form 7 - 表单处理
- Lucide React - 图标库
- Heroicons - 图标库
- React Toastify - 消息通知
- @hookform/resolvers 5.2.1
- zod 4.0.14
Web端 (Home) shadcn-ui
- React 19 - 前端框架
- TypeScript (严格模式) - 类型系统
- Vite 7 - 构建工具
- React Router 7 - 路由管理
- Tailwind CSS 4 - 样式框架 (原生CSS，不使用Ant Design)
- React Query (TanStack) 5 - 数据获取和缓存
- React Hook Form 7 - 表单处理
- Lucide React - 图标库
- Heroicons - 图标库
- React Toastify - 消息通知
- @hookform/resolvers 5.2.1
- zod 4.0.14
后端
- Hono 4 - Web框架
- TypeORM - ORM框架 (MySQL)
- MySQL 2 - 数据库驱动
- bcrypt - 密码加密
- jsonwebtoken - JWT认证
- compression - 压缩中间件
工具链
- Node.js - 运行时环境
- ESM模块 - ECMAScript模块系统
- dotenv - 环境变量管理
- debug - 调试日志
- uuid - ID生成
- dayjs - 日期处理
- axios - HTTP客户端
开发工具
- TypeScript - 类型检查
- Tailwind CSS - 原子化CSS
- Vite插件 - 开发服务器和热更新
- SWC - 快速编译
- Cross-env - 跨平台环境变量
