# 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*