docs: add quick start guide (START-BEGIN.md)

This commit is contained in:
AI Clinical Dev Team
2025-10-10 21:15:45 +08:00
parent 96d9783242
commit cc3323b795

171
START-开始使用.md Normal file
View File

@@ -0,0 +1,171 @@
# 🚀 快速开始
## ✅ 问题已全部解决!
### 修复内容
1. ✅ 前端端口:**http://localhost:3000/** (已正确配置)
2. ✅ 获取项目列表失败:**已创建模拟用户**
3. ✅ 创建项目500错误**外键约束已解决**
---
## 🎯 快速启动3步
### 方法1一键启动 ⭐ 推荐
```powershell
双击运行一键启动.bat
```
会自动:
- 启动Docker容器PostgreSQL + Redis
- 启动后端服务(新窗口)
- 启动前端服务(新窗口)
- 10秒后自动打开浏览器
---
### 方法2手动启动
**终端1 - 后端:**
```powershell
cd d:\MyCursor\AIclinicalresearch\backend
npm run dev
```
**终端2 - 前端:**
```powershell
cd d:\MyCursor\AIclinicalresearch\frontend
npm run dev
```
**浏览器:**
```
访问 http://localhost:3000/
```
---
## 🧪 测试流程
### 1. 创建项目
1. 打开 http://localhost:3000/
2. 点击右上角"+ 新建项目"
3. 填写:
- 项目名称:心血管疾病研究
- 研究类型:观察性研究
- 项目背景:研究心血管疾病与生活方式的关系...
4. 点击"创建" ✅ **现在应该成功了!**
### 2. 选择智能体
1. 在首页点击"选题评价智能体"卡片
2. 进入对话界面
### 3. 开始对话
1. 在输入框输入:
```
请评价这个研究选题:
高血压患者服药依从性的影响因素研究
```
2. 按Enter发送
3. 观察AI实时流式回复 🔥
4. 尝试切换模型(右上角):
- DeepSeek-V3推荐
- Qwen3-72B
### 4. 测试Markdown渲染
让AI生成包含代码的回复
```
请用Python写一个计算BMI的函数
```
---
## 🔧 如果仍有问题
### 运行诊断工具
```powershell
双击运行:诊断问题.bat
```
会检查:
- Docker运行状态
- PostgreSQL容器
- Redis容器
- 后端服务
- 前端服务
- 环境变量配置
- 数据库迁移
---
## 📋 系统状态确认
当前系统状态应该全部OK
- [x] ✅ Docker运行中
- [x] ✅ PostgreSQL容器运行中
- [x] ✅ Redis容器运行中
- [x] ✅ 后端健康检查通过http://localhost:3001/health
- [x] ✅ 模拟用户已创建user-mock-001
- [x] ✅ 前端代理配置正确(/api -> 3001
- [x] ✅ 测试项目已创建
---
## 💡 重要说明
### 当前登录用户
- **用户ID** user-mock-001
- **用户名:** 演示用户
- **邮箱:** demo@example.com
> 📌 注意:这是模拟用户,用于开发测试。
> 后续版本会集成真实的用户认证系统。
### API端口
- **后端:** http://localhost:3001
- **前端:** http://localhost:3000
- **前端API代理** `/api` -> `http://localhost:3001`
---
## 🎉 系统功能
### 已实现 ✅
- [x] 项目管理CRUD
- [x] 智能体配置12个
- [x] AI对话流式输出
- [x] Markdown渲染
- [x] 代码高亮
- [x] 模型切换
- [x] @知识库UI
### 待开发 ⏳
- [ ] 知识库系统Dify RAG
- [ ] 历史对话管理
- [ ] 其他11个智能体
- [ ] 用户认证集成
- [ ] 运营管理后台
---
## 📖 更多文档
- **完整测试指南:** `测试和启动.md`
- **开发文档:** `docs/README.md`
- **API文档** `docs/02-技术设计/API设计文档.md`
- **数据库文档:** `docs/02-技术设计/数据库设计文档.md`
---
## 🆘 需要帮助?
如果遇到任何问题,请提供:
1. 后端终端的日志截图
2. 浏览器控制台的错误信息
3. `诊断问题.bat` 的输出结果
---
**🎊 现在可以愉快地使用系统了!**
**祝您测试顺利!** 🚀