Files

AI Clinical Dev Team 96d9783242 fix: create mock user to resolve FK constraint issue

Issues fixed:
1. Frontend port is 3000 (not 5173)
2. Projects API returns 500 due to missing user
3. Foreign key constraint violation on projects_user_id_fkey

Solutions:
- Created create-mock-user.ts script
- Added user-mock-001 to database
- Created startup guide (娴嬭瘯鍜屽惎鍔?md)
- Created one-click launcher (涓€閿惎鍔?bat)
- Created diagnostic tool (璇婃柇闂.bat)

New files:
- backend/src/scripts/create-mock-user.ts
- 娴嬭瘯鍜屽惎鍔?md
- 涓€閿惎鍔?bat
- 璇婃柇闂.bat

2025-10-10 21:15:04 +08:00

3.9 KiB

Raw Blame History

系统启动和测试指南

🚀 快速启动

1. 启动后端服务

打开第一个终端：

cd d:\MyCursor\AIclinicalresearch\backend
npm run dev

预期输出：

🚀 AI临床研究平台 - 后端服务器启动成功！
📍 服务地址: http://localhost:3001
🔍 健康检查: http://localhost:3001/health

如果报错，检查：

✅ PostgreSQL是否运行？（Docker: docker ps）
✅ Redis是否运行？（Docker: docker ps）
✅ .env文件是否配置了API Keys？

2. 启动前端服务

打开第二个终端：

cd d:\MyCursor\AIclinicalresearch\frontend
npm run dev

预期输出：

  VITE v6.x.x  ready in xxx ms

  ➜  Local:   http://localhost:3000/
  ➜  Network: use --host to expose

3. 访问系统

打开浏览器访问：http://localhost:3000/

🔧 常见问题排查

问题1：获取项目列表失败

原因： 后端服务未启动或数据库连接失败

解决方案：

检查后端是否启动：访问 http://localhost:3001/health

检查数据库是否运行：

docker ps
# 应该看到postgres和redis容器在运行

如果数据库未启动：

cd d:\MyCursor\AIclinicalresearch
docker-compose up -d

问题2：创建项目失败（500错误）

原因： 数据库表未创建或后端代码错误

解决方案：

步骤1：检查数据库表是否存在

cd d:\MyCursor\AIclinicalresearch\backend
npx prisma studio
# 打开Prisma Studio，检查是否有Project表

步骤2：如果表不存在，运行迁移

cd d:\MyCursor\AIclinicalresearch\backend
npx prisma migrate dev

步骤3：查看后端日志

在运行npm run dev的终端中查看错误日志
通常会显示具体的错误原因

问题3：API请求404

原因： 代理配置或路由问题

检查清单：

✅ 后端启动在3001端口
✅ 前端启动在3000端口
✅ vite.config.ts中配置了代理
✅ API路由正确注册

📋 完整启动检查清单

前置条件

Docker Desktop已安装并运行
Node.js已安装（v18+）
PostgreSQL容器已启动
Redis容器已启动
后端依赖已安装（npm install）
前端依赖已安装（npm install）
后端.env文件已配置API Keys
数据库迁移已完成（prisma migrate dev）

启动顺序

启动Docker容器（PostgreSQL + Redis）
启动后端服务（3001端口）
启动前端服务（3000端口）
访问浏览器测试

🧪 测试流程

1. 测试后端健康检查

# 在浏览器或使用curl
curl http://localhost:3001/health

预期响应：

{
  "status": "ok",
  "database": "connected",
  "timestamp": "2025-10-10T..."
}

2. 测试获取智能体列表

curl http://localhost:3001/api/v1/agents

预期响应：

{
  "success": true,
  "data": [
    {
      "id": "topic-evaluation",
      "name": "选题评价智能体",
      ...
    }
  ]
}

3. 测试前端页面

访问 http://localhost:3000/
应该看到首页和12个智能体卡片
创建新项目
选择"选题评价智能体"进入对话

💡 调试技巧

查看后端日志

后端使用Pino日志，启动时会显示所有请求和错误

查看前端控制台

按F12打开开发者工具，查看：

Console：JavaScript错误
Network：API请求状态

查看数据库

cd d:\MyCursor\AIclinicalresearch\backend
npx prisma studio
# 在浏览器中查看和编辑数据库内容

🆘 获取帮助

如果以上方法都无法解决问题，请提供：

后端终端的完整日志
前端浏览器控制台的错误信息
访问 http://localhost:3001/health 的响应
docker ps 的输出

3.9 KiB Raw Blame History Unescape Escape