# AI临床研究平台 - 前端 基于 Vite + React + TypeScript + Ant Design 构建 ## 🚀 快速开始 ### 1. 安装依赖 ```bash npm install ``` ### 2. 启动开发服务器 ```bash npm run dev ``` 访问:http://localhost:3000 ### 3. 构建生产版本 ```bash npm run build ``` ## 📦 技术栈 - **框架**: React 18 + TypeScript - **构建工具**: Vite 6 - **UI组件库**: Ant Design 5 - **CSS框架**: Tailwind CSS 3 - **路由**: React Router 6 - **HTTP客户端**: Axios - **状态管理**: React Hooks(Day 7+可能引入Zustand) ## 📁 项目结构 ``` frontend/ ├── src/ │ ├── api/ # API请求 │ │ ├── request.ts # Axios配置 │ │ └── index.ts # API接口 │ ├── assets/ # 静态资源 │ ├── components/ # 公共组件 │ ├── layouts/ # 布局组件 │ │ └── MainLayout.tsx │ ├── pages/ # 页面组件 │ │ ├── HomePage.tsx # 首页 │ │ └── AgentPage.tsx # 智能体页面 │ ├── types/ # TypeScript类型定义 │ ├── utils/ # 工具函数 │ ├── App.tsx # 根组件 │ ├── main.tsx # 入口文件 │ └── index.css # 全局样式 ├── index.html ├── package.json ├── tsconfig.json ├── vite.config.ts └── tailwind.config.js ``` ## 🎨 功能特性 ### Day 6 已完成 - ✅ 项目初始化(Vite + React + TypeScript) - ✅ Ant Design UI组件库集成 - ✅ Tailwind CSS配置 - ✅ React Router路由配置 - ✅ 主布局组件(侧边栏 + 头部 + 内容区) - ✅ 首页展示(12个智能体卡片) - ✅ 智能体页面(占位符) - ✅ Axios请求配置 - ✅ TypeScript类型定义 ### Day 7-8 待开发 - ⏳ 项目管理功能 - ⏳ 知识库管理功能 - ⏳ 个人中心页面 - ⏳ 设置页面 ### Day 9-10 待开发 - ⏳ 智能对话组件 - ⏳ 与后端API集成 - ⏳ 模型切换功能 - ⏳ 知识库@引用功能 ## 🔧 开发规范 ### 代码规范 - 使用TypeScript类型检查 - 使用ESLint代码检查 - 组件使用函数式组件 + Hooks - 样式优先使用Tailwind CSS - 复杂样式使用Ant Design内联style ### 命名规范 - 组件文件:PascalCase(如:HomePage.tsx) - 普通文件:camelCase(如:request.ts) - 常量:UPPER_SNAKE_CASE(如:API_BASE_URL) ### Git提交规范 - feat: 新功能 - fix: 修复bug - docs: 文档更新 - style: 代码格式调整 - refactor: 代码重构 ## 📡 API配置 后端API地址:http://localhost:3001/api/v1 代理配置已在`vite.config.ts`中设置: ```typescript proxy: { '/api': { target: 'http://localhost:3001', changeOrigin: true, }, } ``` ## 🎯 智能体列表 1. 📊 选题评价 2. 🔍 PICOS构建 3. 📚 文献检索 4. 🎯 文献筛选 5. 📋 数据提取 6. ⚖️ 偏倚评价 7. 📈 Meta分析 8. 🌲 森林图绘制 9. 💡 结果解读 10. 📝 方案撰写 11. ✍️ 文章撰写 12. 📬 投稿辅助 ## 📞 技术支持 详见项目根目录的完整文档: - `docs/01-设计文档/API设计规范.md` - `docs/02-开发规范/代码规范.md` - `docs/04-开发计划/开发里程碑.md` --- **Day 6 完成!前端基础架构搭建完毕!** 🎉