HaHafeng
2481b786d8
Major Changes: - Database: Install pg_bigm/pgvector plugins, create test database - Python service: v1.0 -> v1.1, add pymupdf4llm/openpyxl/pypandoc - Node.js backend: v1.3 -> v1.7, fix pino-pretty and ES Module imports - Frontend: v1.2 -> v1.3, skip TypeScript check for deployment - Code recovery: Restore empty files from local backup Technical Fixes: - Fix pino-pretty error in production (conditional loading) - Fix ES Module import paths (add .js extensions) - Fix OSSAdapter TypeScript errors - Update Prisma Schema (63 models, 16 schemas) - Update environment variables (DATABASE_URL, EXTRACTION_SERVICE_URL, OSS) - Remove deprecated variables (REDIS_URL, DIFY_API_URL, DIFY_API_KEY) Documentation: - Create 0126 deployment folder with 8 documents - Update database development standards v2.0 - Update SAE deployment status records Deployment Status: - PostgreSQL: ai_clinical_research_test with plugins - Python: v1.1 @ 172.17.173.84:8000 - Backend: v1.7 @ 172.17.173.89:3001 - Frontend: v1.3 @ 172.17.173.90:80 Tested: All services running successfully on SAE
238 lines
5.9 KiB
Markdown
238 lines
5.9 KiB
Markdown
# 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*
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|