AIclinicalresearch/启动指南.md

AI临床研究平台 - 快速启动指南

📋 前提条件

确保以下服务已启动：

# 检查Docker服务
docker ps

# 应该看到以下容器：
# - ai_clinical_postgres (PostgreSQL 15)
# - ai_clinical_redis (Redis 7)

---

🚀 启动后端服务

方法1：使用启动脚本（推荐）

Windows:

双击运行：backend\启动后端.bat

命令行:

cd backend
npm run dev

方法2：手动启动

# 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

预期响应:

{
  "status": "ok",
  "database": "connected",
  "timestamp": "2025-10-10T07:50:03.123Z",
  "uptime": 123.456
}

3. 访问API入口

浏览器访问:

http://localhost:3001/api/v1

预期响应:

{
  "message": "AI Clinical Research Platform API",
  "version": "1.0.0",
  "environment": "development"
}

4. 使用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：数据库连接失败

错误信息：

❌ 数据库连接失败，无法启动服务器

解决方案：

# 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

解决方案：

# 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'

解决方案：

cd backend
npm run prisma:generate

问题4：依赖包缺失

错误信息：

Error: Cannot find module 'xxx'

解决方案：

cd backend
npm install

---

📚 常用命令

数据库管理

cd backend

# 生成Prisma Client
npm run prisma:generate

# 创建新的迁移
npm run prisma:migrate

# 打开Prisma Studio（可视化数据库管理）
npm run prisma:studio

开发命令

# 启动开发服务器（热重载）
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

---

🎉 祝开发顺利！