HaHafeng
4088275290
Fixed issues: - Remove simulateUpload function from DashboardPage Step 3 - Map department to description field when creating KB - Add upload modal in WorkspacePage knowledge assets tab - Fix DocumentUpload import path (../../stores to ../stores) Known issue: Dify API validation error during document upload (file uploaded but DB record failed, needs investigation) Testing: KB creation works, upload dialog opens correctly
316 lines
8.8 KiB
Markdown
316 lines
8.8 KiB
Markdown
# INST - 机构管理端
|
||
|
||
> **模块代码：** INST
|
||
> **模块名称：** 机构管理端（Institution Management Portal）
|
||
> **优先级：** P1（重要功能）
|
||
> **开发状态：** 🔴 未开始
|
||
> **负责人：** [待定]
|
||
|
||
---
|
||
|
||
## 📋 模块概述
|
||
|
||
机构管理端是为**医院客户**和**药企客户**提供的自服务管理界面，让机构管理员能够独立管理自己租户内的用户、配额、科室等资源。
|
||
|
||
### 核心价值
|
||
|
||
1. **自服务管理**：减轻运营团队压力，机构自主管理
|
||
2. **配额分配**：医院/药企内部按科室或个人分配Token额度
|
||
3. **用户管理**：机构内部用户的创建、编辑、停用
|
||
4. **数据隔离**：只能看到和管理自己租户的数据
|
||
|
||
---
|
||
|
||
## 🎯 核心功能模块
|
||
|
||
### 1. 医院管理端（Hospital Admin）
|
||
|
||
#### 用户管理
|
||
- 添加/编辑/停用医院内部用户
|
||
- 分配用户到科室
|
||
- 设置用户角色（科室管理员/普通用户）
|
||
|
||
#### 科室管理
|
||
- 创建/编辑/删除科室
|
||
- 支持多级科室结构（心内科 → 一病区）
|
||
- 查看科室成员列表
|
||
|
||
#### 配额管理
|
||
- 查看医院总配额和使用情况
|
||
- 按科室分配Token额度
|
||
- 按个人分配Token额度
|
||
- 配额使用统计和预警
|
||
|
||
#### 审计日志
|
||
- 查看医院内部的操作记录
|
||
- 导出审计日志
|
||
|
||
---
|
||
|
||
### 2. 药企管理端（Pharma Admin）
|
||
|
||
#### 用户管理
|
||
- 添加/编辑/停用药企内部用户
|
||
- 分配用户角色（项目负责人/数据分析师/普通用户）
|
||
|
||
#### 项目管理
|
||
- 查看药企参与的IIT项目列表
|
||
- 查看项目进展和数据统计
|
||
- 项目成员管理
|
||
|
||
#### 配额管理
|
||
- 查看药企总配额和使用情况
|
||
- 按项目分配Token额度
|
||
- 按用户分配Token额度
|
||
- 配额使用统计和预警
|
||
|
||
#### 审计日志（合规要求）
|
||
- 查看所有数据修改记录（FDA 21 CFR Part 11）
|
||
- 查看IIT模块相关操作
|
||
- 导出审计日志（支持签名验证）
|
||
|
||
---
|
||
|
||
## 🔐 角色与权限设计
|
||
|
||
### 医院端角色
|
||
|
||
| 角色 | 角色Code | 权限范围 | 说明 |
|
||
|------|---------|---------|------|
|
||
| **医院管理员** | HOSPITAL_ADMIN | 租户级管理 | 管理医院内所有资源 |
|
||
| **科室管理员** | DEPARTMENT_ADMIN | 科室级管理 | 仅管理自己科室 |
|
||
| **医生/用户** | USER | 基础功能 | 使用业务模块 |
|
||
|
||
### 药企端角色
|
||
|
||
| 角色 | 角色Code | 权限范围 | 说明 |
|
||
|------|---------|---------|------|
|
||
| **药企管理员** | PHARMA_ADMIN | 租户级管理 | 管理药企内所有资源 |
|
||
| **项目负责人** | PROJECT_MANAGER | 项目级管理 | 管理特定IIT项目 |
|
||
| **数据分析师** | DATA_ANALYST | 只读权限 | 查看项目数据和报告 |
|
||
| **普通用户** | USER | 基础功能 | 使用业务模块 |
|
||
|
||
---
|
||
|
||
## 📂 文档结构
|
||
|
||
```
|
||
INST-机构管理端/
|
||
├── README.md # 本文件
|
||
├── 00-模块当前状态与开发指南.md # 快速上手指南
|
||
│
|
||
├── 00-系统设计/ # 系统架构设计
|
||
│
|
||
├── 01-需求分析/ # PRD文档
|
||
│
|
||
├── 02-技术设计/ # 技术设计文档
|
||
│
|
||
├── 03-UI设计/ # 原型与UI设计
|
||
│
|
||
├── 04-开发计划/ # 开发计划与任务分解
|
||
│
|
||
├── 05-测试文档/ # 测试用例与测试数据
|
||
│
|
||
├── 06-开发记录/ # 每日开发总结
|
||
│
|
||
└── 07-技术债务/ # 技术债务清单
|
||
```
|
||
|
||
---
|
||
|
||
## 🗄️ 数据库Schema
|
||
|
||
### 核心表（platform_schema）
|
||
|
||
- `tenants` - 租户表（机构基本信息）
|
||
- `tenant_members` - 租户成员关系
|
||
- `tenant_quotas` - 租户配额
|
||
- `tenant_quota_allocations` - 配额分配（科室/个人/项目）
|
||
- `departments` - 科室表（医院专用）
|
||
- `tenant_operation_logs` - 租户级操作日志
|
||
|
||
### 关联表
|
||
|
||
- `users` - 用户表
|
||
- `iit_projects` - IIT项目表（药企端）
|
||
- `admin_operation_logs` - 审计日志（可按module过滤）
|
||
|
||
---
|
||
|
||
## 🚀 技术栈
|
||
|
||
### 后端
|
||
- **框架：** Fastify + Prisma
|
||
- **数据库：** PostgreSQL 14+
|
||
- **认证：** JWT（继承运营管理端）
|
||
- **权限：** RBAC（继承运营管理端）
|
||
|
||
### 前端
|
||
- **框架：** React 19 + TypeScript
|
||
- **UI库：** Ant Design 6.0
|
||
- **状态管理：** React Context + Hooks
|
||
- **路由：** React Router v6
|
||
|
||
---
|
||
|
||
## 🎨 URL策略
|
||
|
||
### 租户专属登录
|
||
|
||
```
|
||
# 医院端登录
|
||
https://platform.example.com/t/hospital-301/login
|
||
|
||
# 药企端登录
|
||
https://platform.example.com/t/pharma-abc/login
|
||
```
|
||
|
||
### 品牌定制
|
||
|
||
- Logo（租户自定义）
|
||
- 背景图（租户自定义）
|
||
- 主题色（租户自定义）
|
||
- 系统名称（租户自定义）
|
||
|
||
**数据来源：** `tenants.config` (JSONB字段)
|
||
|
||
---
|
||
|
||
## 📅 开发路线图（待定）
|
||
|
||
### Phase 1: 医院管理端MVP（Week 5-6）
|
||
- [ ] 用户管理界面
|
||
- [ ] 科室管理界面
|
||
- [ ] 配额分配界面
|
||
- [ ] 租户专属登录页
|
||
|
||
### Phase 2: 药企管理端MVP（Week 7-8）
|
||
- [ ] 用户管理界面
|
||
- [ ] 项目管理界面
|
||
- [ ] 配额分配界面
|
||
- [ ] 审计日志查询（合规）
|
||
|
||
### Phase 3: 功能完善（Week 9+）
|
||
- [ ] 统计报表
|
||
- [ ] 配额预警
|
||
- [ ] 批量操作
|
||
- [ ] 数据导出
|
||
|
||
---
|
||
|
||
## 🔗 与运营管理端的关系
|
||
|
||
```
|
||
┌────────────────────────────────────────┐
|
||
│ ADMIN - 运营管理端（内部） │
|
||
│ │
|
||
│ - 创建/管理所有租户 │
|
||
│ - 分配总配额 │
|
||
│ - 全局用户管理 │
|
||
│ - Prompt管理 │
|
||
└────────────────────────────────────────┘
|
||
│
|
||
│ 创建租户 & 分配配额
|
||
↓
|
||
┌────────────────────────────────────────┐
|
||
│ INST - 机构管理端（客户自服务） │
|
||
│ │
|
||
│ 🏥 医院端 │
|
||
│ - 管理医院内部用户 │
|
||
│ - 按科室/个人分配配额 │
|
||
│ - 查看医院内审计日志 │
|
||
│ │
|
||
│ 💊 药企端 │
|
||
│ - 管理药企内部用户 │
|
||
│ - 按项目/个人分配配额 │
|
||
│ - 查看IIT模块审计日志（合规） │
|
||
└────────────────────────────────────────┘
|
||
│
|
||
│ 使用业务模块
|
||
↓
|
||
┌────────────────────────────────────────┐
|
||
│ 业务模块（ASL/DC/IIT等） │
|
||
└────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 📚 核心文档导航
|
||
|
||
### 当前阶段
|
||
|
||
由于机构管理端尚未开始开发，建议先阅读运营管理端的相关文档：
|
||
|
||
1. **架构基础**
|
||
→ `../ADMIN-运营管理端/00-系统设计/00-权限与角色体系梳理报告_v1.0.md`
|
||
|
||
2. **需求文档**
|
||
→ `../ADMIN-运营管理端/01-需求分析/02-通用能力层_07-运营与机构管理端PRD_v2.1.md`
|
||
（该文档同时包含运营端和机构端需求）
|
||
|
||
### 待创建文档
|
||
|
||
- [ ] `00-系统设计/01-机构管理端架构设计.md`
|
||
- [ ] `01-需求分析/01-医院管理端PRD.md`
|
||
- [ ] `01-需求分析/02-药企管理端PRD.md`
|
||
- [ ] `02-技术设计/01-API设计文档.md`
|
||
- [ ] `02-技术设计/02-数据库设计文档.md`
|
||
- [ ] `03-UI设计/01-医院端原型设计.html`
|
||
- [ ] `03-UI设计/02-药企端原型设计.html`
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
### 安全性
|
||
|
||
1. **多租户隔离**
|
||
- 所有查询必须带`tenantId`过滤
|
||
- 防止跨租户数据访问
|
||
|
||
2. **权限控制**
|
||
- 科室管理员只能管理自己科室
|
||
- 项目负责人只能管理自己的项目
|
||
|
||
3. **审计日志**
|
||
- 所有操作必须记录
|
||
- 药企端需要满足FDA合规要求
|
||
|
||
### 性能优化
|
||
|
||
1. **配额计算**
|
||
- 使用数据库聚合查询
|
||
- 增加缓存层（app_cache）
|
||
|
||
2. **科室树查询**
|
||
- 使用递归CTE查询
|
||
- 前端缓存科室结构
|
||
|
||
---
|
||
|
||
## 📞 联系方式
|
||
|
||
- **技术负责人：** [待定]
|
||
- **产品负责人：** [待定]
|
||
|
||
---
|
||
|
||
## 🔄 开发依赖
|
||
|
||
**前置条件（必须先完成）：**
|
||
- ✅ 运营管理端基础架构（认证、权限、租户管理）
|
||
- ✅ 租户专属登录页
|
||
- ✅ 品牌定制配置
|
||
|
||
**可并行开发：**
|
||
- 医院端UI设计
|
||
- 药企端UI设计
|
||
|
||
---
|
||
|
||
*最后更新：2026-01-11*
|
||
|
||
|
||
|
||
|