HaHafeng
aaa29ea9d3
Features: - PromptService enhancement: enhanceWithKnowledge(), loadFullKnowledge(), ragSearch() - FULL mode: Load entire knowledge base content - RAG mode: Vector search based on user query - Knowledge config API: PUT /:code/knowledge-config - Test render with knowledge injection support - Frontend: Knowledge config UI in Prompt editor Bug fixes: - Fix knowledge config not returned in getPromptDetail - Fix publish button 400 error (empty request body) - Fix cache not invalidated after publish - Add detailed logging for debugging Documentation: - Add development record 2026-01-28 - Update ADMIN module status to Phase 4.6 - Update system status document to v4.5 Co-authored-by: Cursor <cursoragent@cursor.com>
ADMIN - 运营管理端
模块代码： ADMIN
模块名称： 运营管理端（Operations Management Portal）
优先级： P0（核心基础设施）
开发状态： 🟡 架构设计中
负责人： [待定]
📋 模块概述
运营管理端是AI临床研究平台的核心管理后台，为公司内部运营人员提供全方位的系统管理和运维能力。
核心价值
- SaaS多租户管理：统一管理所有医院/药企客户
- AI成本控制：精细化配额管理，控制Token消耗
- Prompt工程化：生产环境灰度预览，专业人员调试AI效果
- 系统运维：用户管理、权限配置、审计日志
🎯 核心功能模块
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等
📚 快速开始
-
阅读架构设计
→00-系统设计/00-权限与角色体系梳理报告_v1.0.md -
了解需求
→01-需求分析/02-通用能力层_07-运营与机构管理端PRD_v2.1.md -
Prompt管理（核心功能）
→02-技术设计/03-Prompt管理系统快速参考.md -
查看开发状态
→00-模块当前状态与开发指南.md
⚠️ 注意事项
- 安全第一：运营管理端拥有最高权限，必须严格控制访问
- 审计日志：所有操作必须记录，支持追溯
- 多租户隔离：确保租户数据完全隔离
- Prompt管理：生产环境调试模式必须有权限控制
📞 联系方式
- 技术负责人： [待定]
- 产品负责人： [待定]
最后更新：2026-01-11