Workova 管理后台

基于 React + TypeScript + Vite + Ant Design 的管理后台系统，面向运营与管理员使用。

技术栈

• React 18 - UI 框架
• TypeScript - 类型安全
• Vite - 构建工具
• Ant Design 5 - UI 组件库
• Zustand - 状态管理
• React Router 6 - 路由管理
• Axios - HTTP 客户端
• Ant Design Charts - 数据可视化

开发

安装依赖

npm install

启动开发服务器

npm run dev

默认本地访问地址：http://localhost:5173

构建生产版本

npm run build

代码检查

npm run lint
npm run format

项目结构

admin-web/
├── public/              # 静态资源
├── src/
│   ├── components/      # 通用组件
│   ├── pages/           # 页面模块
│   │   ├── Dashboard/   # 数据概览
│   │   ├── Users/       # 用户管理（普通用户）
│   │   ├── AdminUsers/  # 管理员账户管理
│   │   ├── Agents/      # Agent 配置管理
│   │   ├── Models/      # LLM 模型管理
│   │   ├── Workflows/   # 工作流管理
│   │   ├── Knowledge/   # 知识库管理
│   │   ├── Reviews/     # 内容审核
│   │   ├── AppReleases/ # 客户端版本发布
│   │   ├── Settings/    # 系统设置
│   │   └── Login/       # 登录
│   ├── services/        # API 请求服务
│   ├── stores/          # Zustand 全局状态
│   ├── hooks/           # 自定义 Hooks
│   ├── utils/           # 工具函数
│   ├── types/           # TypeScript 类型定义
│   ├── constants/       # 常量配置
│   ├── router/          # 路由配置
│   ├── App.tsx          # 根组件
│   ├── main.tsx         # 入口文件
│   └── index.css        # 全局样式
├── .env.development     # 开发环境配置
├── .env.production      # 生产环境配置
├── vite.config.ts       # Vite 配置
├── tsconfig.json        # TypeScript 配置
└── package.json         # 项目配置

环境变量

开发环境 (.env.development)

VITE_API_BASE_URL=http://localhost:8080
VITE_APP_TITLE=Workova 管理后台

生产环境 (.env.production)

VITE_API_BASE_URL=
VITE_APP_TITLE=Workova 管理后台

代理策略

• npm run dev：默认连接本地后端 http://localhost:8080
• npm run build：默认走同源 /api，由线上 nginx 反向代理到 backend
• 如需更换服务器，修改 admin-web/.env.development 和 admin-web/.env.production 即可

开发规范

• 使用 TypeScript 进行类型检查
• 遵循 ESLint 代码规范
• 使用 Prettier 格式化代码
• 组件使用函数式组件 + Hooks
• 状态管理使用 Zustand
• API 请求统一使用 Axios 封装

License

MIT