docs: add quick start guide (START-BEGIN.md)
This commit is contained in:
171
START-开始使用.md
Normal file
171
START-开始使用.md
Normal 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` 的输出结果
|
||||
|
||||
---
|
||||
|
||||
**🎊 现在可以愉快地使用系统了!**
|
||||
**祝您测试顺利!** 🚀
|
||||
|
||||
Reference in New Issue
Block a user