From cc3323b795f4e24a043c607a040e1bceeceb138c Mon Sep 17 00:00:00 2001
From: AI Clinical Dev Team <dev@ai-clinical.com>
Date: Fri, 10 Oct 2025 21:15:45 +0800
Subject: [PATCH] docs: add quick start guide (START-BEGIN.md)

---
 START-开始使用.md | 171 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 START-开始使用.md

diff --git a/START-开始使用.md b/START-开始使用.md
new file mode 100644
index 00000000..7b5a0bd1
--- /dev/null
+++ b/START-开始使用.md
@@ -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` 的输出结果
+
+---
+
+**🎊 现在可以愉快地使用系统了！**  
+**祝您测试顺利！** 🚀
+