# 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: 数据迁移 + 基础设施�?天）
- [ ] 统一User表（public.users �?platform_schema.users�?
- [ ] 创建所有新�?
- [ ] 超级管理员种子数�?
- [ ] Prompt表和权限配置

### Phase 1-2: 认证系统�?天）
- [ ] JWT认证
- [ ] 登录/登出API
- [ ] 认证中间�?

### Phase 3-4: 运营管理端MVP�?天）
- [ ] 租户管理（CRUD + 品牌配置�?
- [ ] **Prompt管理系统**
  - [ ] 列表/编辑�?版本历史
  - [ ] 全局调试开�?
  - [ ] 草稿保存/发布

### Phase 5-6: 完善功能�?天）
- [ ] 用户管理
- [ ] 权限配置
- [ ] 审计日志查询
- [ ] 配额管理

---

## 🔗 相关模块

- **机构管理端（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*