Files
AIclinicalresearch/frontend-v2
HaHafeng 3446909ff7 feat(ssa): Complete Phase I-IV intelligent dialogue and tool system development
Phase I - Session Blackboard + READ Layer:
- SessionBlackboardService with Postgres-Only cache
- DataProfileService for data overview generation
- PicoInferenceService for LLM-driven PICO extraction
- Frontend DataContextCard and VariableDictionaryPanel
- E2E tests: 31/31 passed

Phase II - Conversation Layer LLM + Intent Router:
- ConversationService with SSE streaming
- IntentRouterService (rule-first + LLM fallback, 6 intents)
- SystemPromptService with 6-segment dynamic assembly
- TokenTruncationService for context management
- ChatHandlerService as unified chat entry
- Frontend SSAChatPane and useSSAChat hook
- E2E tests: 38/38 passed

Phase III - Method Consultation + AskUser Standardization:
- ToolRegistryService with Repository Pattern
- MethodConsultService with DecisionTable + LLM enhancement
- AskUserService with global interrupt handling
- Frontend AskUserCard component
- E2E tests: 13/13 passed

Phase IV - Dialogue-Driven Analysis + QPER Integration:
- ToolOrchestratorService (plan/execute/report)
- analysis_plan SSE event for WorkflowPlan transmission
- Dual-channel confirmation (ask_user card + workspace button)
- PICO as optional hint for LLM parsing
- E2E tests: 25/25 passed

R Statistics Service:
- 5 new R tools: anova_one, baseline_table, fisher, linear_reg, wilcoxon
- Enhanced guardrails and block helpers
- Comprehensive test suite (run_all_tools_test.js)

Documentation:
- Updated system status document (v5.9)
- Updated SSA module status and development plan (v1.8)

Total E2E: 107/107 passed (Phase I: 31, Phase II: 38, Phase III: 13, Phase IV: 25)

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-22 18:53:39 +08:00
..

AI临床研究平台 - Frontend V2

版本: V2.0
创建日期: 2025-11-12
技术栈: React 18 + TypeScript + Vite + Ant Design + Tailwind CSS


📋 项目说明

这是AI临床研究平台的全新前端架构,采用模块化设计,支持:

  • 顶部导航布局
  • 模块化架构5个业务模块
  • 动态模块加载
  • 懒加载和代码分割
  • 统一的开发规范

🚀 快速开始

安装依赖

npm install

启动开发服务器

npm run dev

访问:http://localhost:3000

构建生产版本

npm run build

预览生产构建

npm run preview

📁 项目结构

src/
├── framework/          # 框架层(平台级基础设施)
│   ├── layout/         # 布局系统
│   ├── modules/        # 模块注册系统
│   ├── router/         # 路由系统
│   ├── permission/     # 权限控制
│   └── config/         # 全局配置
│
├── modules/            # 业务模块(完全独立)
│   ├── asl/            # AI智能文献
│   ├── aia/            # AI智能问答
│   ├── pkb/            # 个人知识库
│   ├── rvw/            # 审稿系统
│   └── dc/             # 数据清洗
│
├── shared/             # 共享资源
│   ├── components/     # 通用组件
│   ├── hooks/          # 通用Hooks
│   ├── utils/          # 工具函数
│   └── api/            # API客户端
│
├── pages/              # 页面组件
│   └── HomePage.tsx    # 首页
│
├── App.tsx             # 应用根组件
└── main.tsx            # 应用入口

🎯 模块说明

已实现

  • 框架层:顶部导航、主布局、模块注册
  • 占位页面5个模块的占位展示
  • 首页:模块入口和统计信息

开发中

  • 🚧 ASL模块Week 3 开发AI智能文献

待开发

  • 📋 AIA模块AI智能问答后续重写
  • 📋 PKB模块:个人知识库(后续重写)
  • 📋 RVW模块:审稿系统(后续重写)
  • 📋 DC模块:数据清洗(占位)

🔧 开发规范

命名规范

  • 组件文件PascalCaseTopNavigation.tsx
  • Hooks文件camelCase + use前缀useAuth.ts
  • 工具函数camelCaseformatDate.ts
  • 类型定义PascalCasetypes.ts

路径别名

使用 @/ 作为 src/ 的别名:

import TopNavigation from '@/framework/layout/TopNavigation'
import Placeholder from '@/shared/components/Placeholder'

模块开发

每个新模块需要:

  1. src/modules/[模块名]/ 创建目录
  2. 创建 index.tsx 作为模块入口
  3. moduleRegistry.ts 中注册模块
  4. 实现模块的 ModuleDefinition 接口

📚 相关文档


🔗 API代理

开发环境下,所有 /api/* 请求会被代理到后端服务器:

Frontend: http://localhost:3000
Backend:  http://localhost:3001

📝 TODO

  • 实现权限控制系统
  • 添加用户认证流程
  • 实现面包屑导航
  • 添加全局状态管理
  • 完善错误处理
  • 添加单元测试

维护者: 开发团队
最后更新: 2025-11-12