HaHafeng
96290d2f76
Sprint 1-3 Completed (Backend + Frontend): Backend (Sprint 1-2): - Implement 5-layer Agent framework (Query->Planner->Executor->Tools->Reflection) - Create agent_schema with 6 tables (agent_definitions, stages, prompts, sessions, traces, reflexion_rules) - Create protocol_schema with 2 tables (protocol_contexts, protocol_generations) - Implement Protocol Agent core services (Orchestrator, ContextService, PromptBuilder) - Integrate LLM service adapter (DeepSeek/Qwen/GPT-5/Claude) - 6 API endpoints with full authentication - 10/10 API tests passed Frontend (Sprint 3): - Add Protocol Agent entry in AgentHub (indigo theme card) - Implement ProtocolAgentPage with 3-column layout - Collapsible sidebar (Gemini style, 48px <-> 280px) - StatePanel with 5 stage cards (scientific_question, pico, study_design, sample_size, endpoints) - ChatArea with sync button and action cards integration - 100% prototype design restoration (608 lines CSS) - Detailed endpoints structure: baseline, exposure, outcomes, confounders Features: - 5-stage dialogue flow for research protocol design - Conversation-driven interaction with sync-to-protocol button - Real-time context state management - One-click protocol generation button (UI ready, backend pending) Database: - agent_schema: 6 tables for reusable Agent framework - protocol_schema: 2 tables for Protocol Agent - Seed data: 1 agent + 5 stages + 9 prompts + 4 reflexion rules Code Stats: - Backend: 13 files, 4338 lines - Frontend: 14 files, 2071 lines - Total: 27 files, 6409 lines Status: MVP core functionality completed, pending frontend-backend integration testing Next: Sprint 4 - One-click protocol generation + Word export
AI临床研究平台 - 后端服务
🏠 导航
快速开始
1. 环境要求
- Node.js >= 18
- PostgreSQL 15+
- Redis 7+
2. 安装依赖
npm install
3. 配置环境变量
复制.env.example到.env并配置：
cp .env.example .env
4. 初始化数据库
# 生成Prisma Client
npm run prisma:generate
# 执行数据库迁移
npm run prisma:migrate
# （可选）打开Prisma Studio查看数据
npm run prisma:studio
5. 启动开发服务器
npm run dev
服务器将在 http://localhost:3001 启动
6. 验证服务
访问以下端点验证服务是否正常：
- 健康检查: http://localhost:3001/health
- API入口: http://localhost:3001/api/v1
项目结构
backend/
├── prisma/
│ └── schema.prisma # 数据库模型定义
├── src/
│ ├── config/
│ │ ├── env.ts # 环境变量配置
│ │ └── database.ts # 数据库连接
│ ├── controllers/ # 控制器层
│ ├── services/ # 业务逻辑层
│ ├── routes/ # 路由定义
│ ├── types/ # TypeScript类型定义
│ ├── utils/ # 工具函数
│ └── index.ts # 应用入口
├── .env # 环境变量（不提交到Git）
├── .env.example # 环境变量模板
├── package.json # 项目配置
└── tsconfig.json # TypeScript配置
NPM Scripts
npm run dev- 启动开发服务器（hot reload）npm run build- 构建生产版本npm run start- 启动生产服务器npm run prisma:generate- 生成Prisma Clientnpm run prisma:migrate- 执行数据库迁移npm run prisma:studio- 打开Prisma Studio
数据库设计
详见：../docs/01-设计文档/数据库设计文档.md
API文档
详见：../docs/01-设计文档/API设计规范.md
技术栈
- 框架: Fastify
- ORM: Prisma
- 数据库: PostgreSQL
- 缓存: Redis
- 语言: TypeScript
- 日志: Pino
Day 5 完成情况
✅ 初始化后端项目（Node.js + TypeScript） ✅ 配置Fastify框架 ✅ 配置Prisma ORM ✅ 创建数据库表（执行迁移） ✅ 数据库连接测试通过
所有核心功能已完成！🎉