Files
AIclinicalresearch/frontend-v2
HaHafeng 1ece9a4ae8 feat(asl): Add DeepSearch smart literature retrieval MVP
Features:
- Integrate unifuncs DeepSearch API (OpenAI compatible protocol)
- SSE real-time streaming for AI thinking process display
- Natural language input, auto-generate PubMed search strategy
- Extract and display PubMed literature links
- Database storage for task records (asl_research_tasks)

Backend:
- researchService.ts - Core business logic with SSE streaming
- researchController.ts - SSE stream endpoint
- researchWorker.ts - Async task worker (backup mode)
- schema.prisma - AslResearchTask model

Frontend:
- ResearchSearch.tsx - Search page with unified content stream
- ResearchSearch.css - Styling (unifuncs-inspired simple design)
- ASLLayout.tsx - Enable menu item
- api/index.ts - Add research API functions

API Endpoints:
- POST /api/v1/asl/research/stream - SSE streaming search
- POST /api/v1/asl/research/tasks - Async task creation
- GET /api/v1/asl/research/tasks/:taskId/status - Task status

Documentation:
- Development record for DeepSearch integration
- Update ASL module status (v1.5)
- Update system status (v3.7)

Known limitations:
- SSE mode, task interrupts when leaving page
- Cost ~0.3 RMB per search (unifuncs API)
2026-01-18 19:15:55 +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