Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
96290d2f767197b58dba71ab72980802f25c2628
AIclinicalresearch/docs/03-业务模块/ADMIN-运营管理端/README.md
HaHafeng 96290d2f76 feat(aia): Implement Protocol Agent MVP with reusable Agent framework 
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
2026-01-24 17:29:24 +08:00

5.9 KiB
Raw Blame History

ADMIN - 运营管理端

模块代码： ADMIN
模块名称： 运营管理端（Operations Management Portal）
优先级： P0（核心基础设施）
开发状态： 🟡 架构设计中
负责人： [待定]

📋 模块概述

运营管理端是AI临床研究平台的核心管理后台，为公司内部运营人员提供全方位的系统管理和运维能力。

核心价值

  1. SaaS多租户管理：统一管理所有医院/药企客户
  2. AI成本控制：精细化配额管理，控制Token消耗
  3. Prompt工程化：生产环境灰度预览，专业人员调试AI效果
  4. 系统运维：用户管理、权限配置、审计日志

🎯 核心功能模块

1. 租户管理

  • 租户创建/编辑/停用
  • 品牌定制（Logo、背景图、主题色）
  • 模块订阅管理（ASL/DC/IIT等）
  • 配额分配与监控

2. Prompt管理系统 ⭐

  • 生产环境灰度预览
  • 调试者角色（PROMPT_ENGINEER）
  • DRAFT/ACTIVE版本隔离
  • 多业务模块Prompt配置（ASL/DC/IIT/PKB/AIA/RVW）

3. 用户与权限管理

  • 用户CRUD
  • 角色分配（SUPER_ADMIN/PROMPT_ENGINEER/等）
  • 权限配置

4. 系统监控与审计

  • 操作日志审计
  • Token消耗统计
  • 系统健康监控

📂 文档结构

ADMIN-运营管理端/
├── README.md                           # 本文件
├── 00-模块当前状态与开发指南.md         # 快速上手指南
│
├── 00-系统设计/                        # 系统架构设计
│   ├── 00-权限与角色体系梳理报告_v1.0.md
│   └── 02-通用能力层_10-权限体系梳理反馈与修正建议.md
│
├── 01-需求分析/                        # PRD文档
│   └── 02-通用能力层_07-运营与机构管理端PRD_v2.1.md
│
├── 02-技术设计/                        # 技术设计文档
│   ├── 02-通用能力层_03-Prompt管理系统与灰度预览设计方案.md
│   ├── 03-Prompt管理系统快速参考.md
│   └── Prompt管理后台设计.md
│
├── 03-UI设计/                          # 原型与UI设计
│
├── 04-开发计划/                        # 开发计划与任务分解
│
├── 05-测试文档/                        # 测试用例与测试数据
│
├── 06-开发记录/                        # 每日开发总结
│
└── 07-技术债务/                        # 技术债务清单

🔐 角色与权限设计

核心角色

角色 角色Code 权限范围 说明
超级管理员 SUPER_ADMIN 所有权限 公司内部运营人员
Prompt工程师 PROMPT_ENGINEER prompt:* 调试AI Prompt的专业人员
医院管理员 HOSPITAL_ADMIN 租户级管理 仅管理自己的医院租户
药企管理员 PHARMA_ADMIN 租户级管理 仅管理自己的药企租户
普通用户 USER 基础功能 业务模块使用者

Prompt管理专属权限

权限 说明
prompt:view 查看Prompt列表和历史版本
prompt:edit 创建/修改DRAFT版本
prompt:debug ⭐ 开启调试模式（生产环境灰度预览）
prompt:publish 发布DRAFT→ACTIVE

🗄️ 数据库Schema

核心表（platform_schema）

  • tenants - 租户表
  • tenant_members - 租户成员关系
  • tenant_modules - 租户订阅的模块
  • tenant_quotas - 租户配额
  • tenant_quota_allocations - 配额分配（科室/个人）
  • departments - 科室表
  • permissions - 权限表
  • role_permissions - 角色权限关联

Prompt管理表（capability_schema）

  • prompt_templates - Prompt模板
  • prompt_versions - Prompt版本（DRAFT/ACTIVE/ARCHIVED）

审计日志表（admin_schema）

  • admin_operation_logs - 运营操作日志

🚀 技术栈

后端

  • 框架： Fastify + Prisma
  • 数据库： PostgreSQL 14+（支持LISTEN/NOTIFY）
  • 认证： JWT (jsonwebtoken)
  • 密码： bcryptjs

前端

  • 框架： React 19 + TypeScript
  • UI库： Ant Design 6.0
  • 状态管理： React Context + Hooks
  • 路由： React Router v6

📅 开发路线图

Phase 0: 数据迁移 + 基础设施（3天）

  • 统一User表（public.users → platform_schema.users）
  • 创建所有新表
  • 超级管理员种子数据
  • Prompt表和权限配置

Phase 1-2: 认证系统（2天）

  • JWT认证
  • 登录/登出API
  • 认证中间件

Phase 3-4: 运营管理端MVP（5天）

  • 租户管理（CRUD + 品牌配置）
  • Prompt管理系统
    • 列表/编辑器/版本历史
    • 全局调试开关
    • 草稿保存/发布

Phase 5-6: 完善功能（3天）

  • 用户管理
  • 权限配置
  • 审计日志查询
  • 配额管理

🔗 相关模块

  • 机构管理端（INST）：医院端/药企端自服务管理界面
  • 平台基础层（Platform）：认证、权限、存储等基础服务
  • 通用能力层（Capability）：Prompt管理、LLM Gateway等

📚 快速开始

  1. 阅读架构设计
    → 00-系统设计/00-权限与角色体系梳理报告_v1.0.md

  2. 了解需求
    → 01-需求分析/02-通用能力层_07-运营与机构管理端PRD_v2.1.md

  3. Prompt管理（核心功能）
    → 02-技术设计/03-Prompt管理系统快速参考.md

  4. 查看开发状态
    → 00-模块当前状态与开发指南.md

⚠️ 注意事项

  1. 安全第一：运营管理端拥有最高权限，必须严格控制访问
  2. 审计日志：所有操作必须记录，支持追溯
  3. 多租户隔离：确保租户数据完全隔离
  4. Prompt管理：生产环境调试模式必须有权限控制

📞 联系方式

  • 技术负责人： [待定]
  • 产品负责人： [待定]

最后更新：2026-01-11

Reference in New Issue View Git Blame Copy Permalink