From 529c4d6496313dc1a6746da1a94298f88b310314 Mon Sep 17 00:00:00 2001
From: AI Clinical Dev Team <dev@ai-clinical.com>
Date: Fri, 10 Oct 2025 15:58:14 +0800
Subject: [PATCH] docs: add quick start guide

---
 启动指南.md | 239 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 239 insertions(+)
 create mode 100644 启动指南.md

diff --git a/启动指南.md b/启动指南.md
new file mode 100644
index 00000000..f8694bbf
--- /dev/null
+++ b/启动指南.md
@@ -0,0 +1,239 @@
+# AI临床研究平台 - 快速启动指南
+
+## 📋 前提条件
+
+确保以下服务已启动：
+
+```bash
+# 检查Docker服务
+docker ps
+
+# 应该看到以下容器：
+# - ai_clinical_postgres (PostgreSQL 15)
+# - ai_clinical_redis (Redis 7)
+```
+
+---
+
+## 🚀 启动后端服务
+
+### 方法1：使用启动脚本（推荐）
+
+**Windows:**
+```bash
+双击运行：backend\启动后端.bat
+```
+
+**命令行:**
+```bash
+cd backend
+npm run dev
+```
+
+### 方法2：手动启动
+
+```bash
+# 1. 进入后端目录
+cd backend
+
+# 2. 安装依赖（首次运行）
+npm install
+
+# 3. 生成Prisma Client（首次运行）
+npm run prisma:generate
+
+# 4. 启动开发服务器
+npm run dev
+```
+
+---
+
+## ✅ 验证服务
+
+### 1. 检查控制台输出
+
+应该看到以下输出：
+
+```
+🔍 正在测试数据库连接...
+✅ 数据库连接成功！
+📊 数据库版本: PostgreSQL 15.14
+
+============================================================
+🚀 AI临床研究平台 - 后端服务器启动成功！
+============================================================
+📍 服务地址: http://localhost:3001
+🔍 健康检查: http://localhost:3001/health
+📡 API入口: http://localhost:3001/api/v1
+🌍 运行环境: development
+============================================================
+```
+
+### 2. 访问健康检查端点
+
+**浏览器访问:**
+```
+http://localhost:3001/health
+```
+
+**预期响应:**
+```json
+{
+  "status": "ok",
+  "database": "connected",
+  "timestamp": "2025-10-10T07:50:03.123Z",
+  "uptime": 123.456
+}
+```
+
+### 3. 访问API入口
+
+**浏览器访问:**
+```
+http://localhost:3001/api/v1
+```
+
+**预期响应:**
+```json
+{
+  "message": "AI Clinical Research Platform API",
+  "version": "1.0.0",
+  "environment": "development"
+}
+```
+
+### 4. 使用PowerShell测试
+
+```powershell
+# 测试健康检查
+Invoke-WebRequest -Uri http://localhost:3001/health -UseBasicParsing | Select-Object -ExpandProperty Content
+
+# 测试API入口
+Invoke-WebRequest -Uri http://localhost:3001/api/v1 -UseBasicParsing | Select-Object -ExpandProperty Content
+```
+
+---
+
+## 🛠️ 故障排查
+
+### 问题1：数据库连接失败
+
+**错误信息：**
+```
+❌ 数据库连接失败，无法启动服务器
+```
+
+**解决方案：**
+```bash
+# 1. 检查PostgreSQL容器是否运行
+docker ps | findstr postgres
+
+# 2. 如果没有运行，启动Docker服务
+cd D:\MyCursor\AIclinicalresearch
+docker-compose up -d
+
+# 3. 检查.env文件中的DATABASE_URL是否正确
+# DATABASE_URL="postgresql://ai_clinical:clinical123@localhost:5432/ai_clinical?schema=public"
+```
+
+### 问题2：端口3001已被占用
+
+**错误信息：**
+```
+Error: listen EADDRINUSE: address already in use :::3001
+```
+
+**解决方案：**
+```powershell
+# 1. 查找占用端口的进程
+netstat -ano | findstr :3001
+
+# 2. 结束该进程（PID是最后一列的数字）
+taskkill /PID <进程ID> /F
+
+# 3. 或者修改.env文件中的PORT
+# PORT=3002
+```
+
+### 问题3：Prisma Client未生成
+
+**错误信息：**
+```
+Error: Cannot find module '@prisma/client'
+```
+
+**解决方案：**
+```bash
+cd backend
+npm run prisma:generate
+```
+
+### 问题4：依赖包缺失
+
+**错误信息：**
+```
+Error: Cannot find module 'xxx'
+```
+
+**解决方案：**
+```bash
+cd backend
+npm install
+```
+
+---
+
+## 📚 常用命令
+
+### 数据库管理
+
+```bash
+cd backend
+
+# 生成Prisma Client
+npm run prisma:generate
+
+# 创建新的迁移
+npm run prisma:migrate
+
+# 打开Prisma Studio（可视化数据库管理）
+npm run prisma:studio
+```
+
+### 开发命令
+
+```bash
+# 启动开发服务器（热重载）
+npm run dev
+
+# 构建生产版本
+npm run build
+
+# 启动生产服务器
+npm start
+```
+
+---
+
+## 🎯 下一步
+
+后端服务启动成功后，您可以：
+
+1. **查看数据库**：运行 `npm run prisma:studio`
+2. **查看API文档**：`docs/01-设计文档/API设计规范.md`
+3. **开始开发前端**：进入Day 6的前端开发任务
+
+---
+
+## 📞 技术支持
+
+如果遇到其他问题，请：
+
+1. 查看详细文档：`backend/README.md`
+2. 查看Day 5总结：`docs/05-每日进度/Day05-后端基础架构完成.md`
+3. 查看开发里程碑：`docs/04-开发计划/开发里程碑.md`
+
+---
+
+**🎉 祝开发顺利！**
+