# 🚀 快速开始

## ✅ 问题已全部解决！

### 修复内容
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` 的输出结果

---

**🎊 现在可以愉快地使用系统了！**  
**祝您测试顺利！** 🚀




