241 lines
7.2 KiB
Markdown
241 lines
7.2 KiB
Markdown
# AI临床研究平台 - 前端
|
||
|
||
基于 Vite + React + TypeScript + Ant Design 构建
|
||
|
||
## 🏠 导航
|
||
|
||
- [← 返回项目主页](../README.md)
|
||
- [📚 查看完整文档](../docs/README.md)
|
||
- [⚙️ 后端项目](../backend/README.md)
|
||
- [🚀 快速启动指南](../启动指南.md)
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 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,
|
||
},
|
||
}
|
||
```
|
||
|
||
## 🎯 智能体列表
|
||
|
||
本平台提供12个AI智能体，覆盖临床研究全流程：
|
||
|
||
### 🌱 选题阶段
|
||
|
||
#### 1. 🎯 选题评价智能体
|
||
- **路由ID**: `topic-evaluation`
|
||
- **功能**: 从创新性、临床价值、科学性和可行性等维度评估研究选题
|
||
- **输入**: 用户提供的临床问题描述
|
||
- **输出**: 结构化评价报告，包含SWOT分析及综合建议
|
||
|
||
#### 2. 🔬 科学问题梳理智能体
|
||
- **路由ID**: `scientific-question`
|
||
- **功能**: 将模糊的研究想法提炼成清晰、具体、可验证的科学问题
|
||
- **输入**: 初步研究想法（如"研究肠道菌群与抑郁症的关系"）
|
||
- **输出**: 多个精炼后的科学问题选项
|
||
|
||
---
|
||
|
||
### 🔬 研究设计阶段
|
||
|
||
#### 3. 📋 PICOS构建智能体
|
||
- **路由ID**: `picos-construction`
|
||
- **功能**: 按照PICOS原则结构化定义临床研究的核心要素
|
||
- **输入**: 引导式表单或自由文本描述的研究问题
|
||
- **输出**: 标准化的PICOS表格（P-患者/人群、I-干预、C-对照、O-结局、S-研究设计）
|
||
|
||
#### 4. 📊 观察指标设计智能体
|
||
- **路由ID**: `observation-design`
|
||
- **功能**: 基于研究设计推荐合适的观察指标集
|
||
- **输入**: 已确定的PICOS框架或研究问题
|
||
- **输出**: 包含主要、次要及安全性指标的详细清单
|
||
|
||
#### 5. 📝 CRF制定智能体
|
||
- **路由ID**: `crf-development`
|
||
- **功能**: 自动生成结构化、符合规范的病例报告表（CRF）框架
|
||
- **输入**: 研究方案、观察指标清单
|
||
- **输出**: 可下载的CRF框架草稿（Word/Excel格式）
|
||
|
||
#### 6. 🔢 样本量计算智能体
|
||
- **路由ID**: `sample-size`
|
||
- **功能**: 根据研究类型、检验水准、把握度、效应量等参数估算样本量
|
||
- **输入**: 引导式表单（研究设计、α、β、效应量等）
|
||
- **输出**: 详细的样本量计算结果，包含公式、参数说明和建议样本量
|
||
|
||
#### 7. 📄 临床研究方案撰写智能体
|
||
- **路由ID**: `protocol-writing`
|
||
- **功能**: 基于科学问题、PICOS等信息，自动生成完整的临床研究设计方案
|
||
- **输入**: 科学问题、PICOS、样本量等
|
||
- **输出**: 包含研究背景、目的、设计、流程等章节的Word文档初稿
|
||
|
||
---
|
||
|
||
### 📝 论文阶段
|
||
|
||
#### 8. ✨ 论文润色智能体
|
||
- **路由ID**: `paper-polishing`
|
||
- **功能**: 提供专业级的语言润色，修正语法、拼写和表达方式
|
||
- **输入**: 上传的论文稿件（Word/Text），目标期刊名称（可选）
|
||
- **输出**: 带修订标记的润色后文稿及修改摘要说明
|
||
|
||
#### 9. 🌐 论文翻译智能体
|
||
- **路由ID**: `paper-translation`
|
||
- **功能**: 提供专业、精准的中英互译服务，优化医学科研术语
|
||
- **输入**: 上传的论文稿件，选择源语言和目标语言
|
||
- **输出**: 翻译完成的稿件，保留原格式
|
||
|
||
#### 10. 🔍 方法学评审智能体
|
||
- **路由ID**: `methodology-review`
|
||
- **功能**: 从研究问题、方案设计、实施可行性和临床意义等维度进行方法学评审
|
||
- **输入**: 上传的研究方案或论文稿件
|
||
- **输出**: 评审报告，分点列出优点、潜在缺陷及改进建议
|
||
|
||
#### 11. 📑 期刊方法学评审智能体
|
||
- **路由ID**: `journal-methodology-review`
|
||
- **功能**: 模拟期刊审稿人视角，针对统计学、方法学问题进行挑战
|
||
- **输入**: 上传的论文稿件，目标期刊
|
||
- **输出**: 模拟的"审稿意见"，列出可能被挑战的问题点
|
||
|
||
#### 12. ✅ 期刊稿约评审智能体
|
||
- **路由ID**: `journal-guidelines-review`
|
||
- **功能**: 依据目标期刊的投稿要求，自动检查格式、字数、参考文献规范
|
||
- **输入**: 上传的论文稿件，目标期刊的投稿指南
|
||
- **输出**: 格式审查报告，清晰列出所有不符合项和修改建议
|
||
|
||
---
|
||
|
||
### 🔗 路由规则
|
||
|
||
所有智能体页面遵循统一路由规则：
|
||
```
|
||
/agent/{路由ID}
|
||
```
|
||
|
||
**示例**：
|
||
- `/agent/topic-evaluation` - 选题评价智能体
|
||
- `/agent/picos-construction` - PICOS构建智能体
|
||
- `/agent/paper-polishing` - 论文润色智能体
|
||
|
||
## 📞 技术支持
|
||
|
||
详见项目根目录的完整文档：
|
||
- `docs/01-设计文档/API设计规范.md`
|
||
- `docs/02-开发规范/代码规范.md`
|
||
- `docs/04-开发计划/开发里程碑.md`
|
||
|
||
---
|
||
|
||
**Day 6 完成！前端基础架构搭建完毕！** 🎉
|
||
|