# AiTori Admin AiTori 后台管理系统,基于 React 19 + TypeScript + Vite 构建。 ## 技术栈 | 类别 | 技术 | |------|------| | 框架 | React 19, TypeScript 5.9 | | 构建工具 | Vite 7 | | UI 组件 | Ant Design 6 | | 样式 | Tailwind CSS 4 | | 状态管理 | Zustand | | 路由 | React Router 7 | | 国际化 | i18next | | 图表 | Recharts | | 拖拽 | dnd-kit | ## 项目结构 ``` src/ ├── api/ # API 接口层 ├── components/ # 公共组件 ├── i18n/ # 国际化配置与语言包 ├── layouts/ # 页面布局 ├── pages/ # 业务页面 ├── router/ # 路由配置 ├── stores/ # Zustand 状态管理 ├── types/ # TypeScript 类型定义 └── utils/ # 工具函数 ``` ## 开发 ### 环境要求 - Node.js >= 20.19.0 - pnpm >= 9 ### 安装依赖 ```bash pnpm install ``` ### 启动开发服务器 ```bash pnpm dev ``` 开发服务器运行在 `http://localhost:3000`,API 请求会代理到 `http://127.0.0.1:8080`。 ### 代码检查 ```bash pnpm lint ``` ## 构建 ```bash # 生产环境 pnpm build:prod # 测试环境 pnpm build:staging ``` 构建产物输出到 `dist/` 目录。 ## Docker 部署 ```bash # 构建生产镜像 docker build -t aitori-web . # 构建测试环境镜像 docker build --build-arg BUILD_MODE=staging -t aitori-web:staging . # 运行容器 docker run -d -p 80:80 aitori-web ``` ## 环境变量 | 变量 | 说明 | 示例 | |------|------|------| | `VITE_API_BASE_URL` | 后端 API 地址 | `https://bi.aitori.jp` | 环境变量通过 `.env.*` 文件按环境配置: - `.env.development` — 本地开发 - `.env.staging` — 测试环境 - `.env.production` — 生产环境