# INST-机构管��- 模�当�状�与开�指�

> **最�更新：** 2026-01-11  
> **状�：** 🔴 未开始（等待��管�端完�）  
> **版本�* v0.0 (Planning)

---

## 🎯 一��总结

**机构管�端为医院和��客户�供自�务管�界�，让机构管�员能够独立管�用户����科�项目等资��*

---

## 📊 当�开�状�

### �已完�

- [ ] **�*（尚未开始）

### 🚧 进行�

- [ ] **æ—?*

### �待开�（�赖��管�端）

**�置�件（必须先完�）：**
- [ ] ��管�端基础架构（Phase 0-2�
- [ ] 租户管�功能
- [ ] 租户专属登录�
- [ ] �牌定制�置

**机构管�端开�计划（预计Week 5+）：**

**P1 - 医院管�端（Week 5-6�*
- [ ] 用户管�（CRUD + 科室分��
- [ ] 科室管�（支�多级结构）
- [ ] ��分�（科�个人�
- [ ] 审计日志查询

**P1 - ��管�端（Week 7-8�*
- [ ] 用户管�（CRUD + 角色分��
- [ ] 项目管�（IIT项目关��
- [ ] ��分�（项�个人�
- [ ] 审计日志查询（FDA�规�

---

## ��架构概览

```
┌─────────────────────────────────────────────────�
�        机构管�端（INST Portal�                 �
├──────────────────────┬──────────────────────────�
�  � 医院管��      �  💊 ��管��          �
├──────────────────────┼──────────────────────────�
�· 用户管�           � · 用户管�               �
�· 科室管�           � · 项目管�               �
�· ��分�（科�人） � · ��分�（项�人）     �
�· 审计日志           � · 审计日志（�规）        �
└──────────────────────┴──────────────────────────�
                      �
         继承��管�端的基础设施
                      �
┌─────────────────────────────────────────────────�
â”?             Platform Layer                     â”?
� 认�中心 ���中心 �多租户隔��审计日志      �
└─────────────────────────────────────────────────�
```

---

## � ��矩阵

| 功能 | HOSPITAL_ADMIN | DEPARTMENT_ADMIN | PHARMA_ADMIN | PROJECT_MANAGER | USER |
|------|----------------|------------------|--------------|-----------------|------|
| 用户管�（租户内�| �全部 | �本科�| �全部 | �项目�员 | �|
| 科室管� | �| �| N/A | N/A | �|
| 项目管� | N/A | N/A | �查看 | �管� | �|
| ��分� | �| �本科�| �| �项目�| �|
| 审计日志 | �租户�| �本科�| �租户�| �项目�| �|
| 业务模�使用 | �| �| �| �| �|

---

## � 代�结构（规划）

### �端

```
backend/src/
├── modules/
�  └── institution/                    # 机构管�端模�
�      ├── controllers/
�      �  ├── hospital/
�      �  �  ├── user.controller.ts
�      �  �  ├── department.controller.ts
�      �  �  └── quota.controller.ts
â”?      â”?  â”?
�      �  └── pharma/
�      �      ├── user.controller.ts
�      �      ├── project.controller.ts
�      �      └── quota.controller.ts
â”?      â”?
�      ├── services/
�      �  ├── hospital.service.ts
�      �  └── pharma.service.ts
â”?      â”?
�      └── routes/
�          ├── hospital.routes.ts
�          └── pharma.routes.ts
â”?
└── common/
    └── middleware/
        ├── tenant.middleware.ts        # 租户隔离（�用）
        └── department.middleware.ts    # 科室��检�
```

### �端

```
frontend-v2/src/
├── modules/
�  └── institution/                    # 机构管�端模�
�      ├── pages/
�      �  ├── hospital/
�      �  �  ├── UserManagement/
�      �  �  ├── DepartmentManagement/
�      �  �  ├── QuotaAllocation/
�      �  �  └── AuditLog/
â”?      â”?  â”?
�      �  └── pharma/
�      �      ├── UserManagement/
�      �      ├── ProjectManagement/
�      �      ├── QuotaAllocation/
�      �      └── AuditLog/
â”?      â”?
�      └── components/
�          ├── UserForm/
�          ├── DepartmentTree/
�          ├── QuotaAllocator/
�          └── AuditLogViewer/
â”?
└── layouts/
    └── TenantLayout/                   # 租户专属布局（�牌定制）
```

---

## 🎨 UI/UX 特�

### 1. 租户�牌定制

```typescript
// 从API获�租户�置
const tenantConfig = await api.get('/api/public/tenant-config/:tenantCode');

// 应用�牌样�
document.documentElement.style.setProperty('--primary-color', config.primaryColor);
document.title = config.systemName;
```

**效果�*
- �和医院看到的是�和Logo��和临床研究平�"
- 辉瑞�业看到的是辉瑞Logo�辉瑞IIT管�平�"

### 2. 科室树组件（医院端）

```tsx
<DepartmentTree
  departments={departments}
  onSelect={(dept) => loadDeptUsers(dept)}
  showQuota={true}                    // 显示科室��
  allowEdit={hasPermission('dept:edit')}
/>
```

**支��*
- 多级展开/折�
- 拖拽排�
- ���视�

### 3. ��分��

```tsx
<QuotaAllocator
  totalQuota={1000000}
  allocations={[
    { target: '心内�, allocated: 500000, used: 300000 },
    { target: '神内�, allocated: 300000, used: 150000 }
  ]}
  onAllocate={(target, amount) => handleAllocate(target, amount)}
/>
```

**特性：**
- �视化进度�
- 实时计算剩余��
- 超�预警

---

## 🗄�数�模型

### 医院�

```typescript
// 科室
interface Department {
  id: string;
  tenantId: string;
  name: string;
  parentId?: string;                  // 支�多级
  description?: string;
  members: User[];
  quota?: QuotaAllocation;
}

// ��分�
interface QuotaAllocation {
  id: string;
  tenantId: string;
  targetType: 'DEPARTMENT' | 'USER';
  targetKey: string;                  // DepartmentID �UserID
  limitAmount: bigint;
  usedAmount: bigint;
}
```

### ���

```typescript
// 项目（关�IIT�
interface Project {
  id: string;
  tenantId: string;
  iitProjectId?: string;              // 关�IIT项目
  name: string;
  description?: string;
  members: User[];
  quota?: QuotaAllocation;
}

// 项目�员
interface ProjectMember {
  id: string;
  projectId: string;
  userId: string;
  role: 'PROJECT_MANAGER' | 'DATA_ANALYST' | 'MEMBER';
}
```

---

## 🚀 开���

### Step 1: 设计阶段（当�）

- [ ] 详细需求文档（PRD�
- [ ] API接�设计
- [ ] 数�库表设计
- [ ] UI原型设计

### Step 2: �端开�（�赖��端完�）

1. **医院端API**
   - 用户管�API
   - 科室管�API
   - ��分�API
   - 审计日志API

2. **��端API**
   - 用户管�API
   - 项目管�API
   - ��分�API
   - 审计日志API（�规）

### Step 3: �端开�

1. **公共组件**
   - TenantLayout（�牌定制布局�
   - QuotaAllocator（��分�器�
   - AuditLogViewer（审计日志查看器�

2. **医院端页�*
   - 用户管�
   - 科室管�（DepartmentTree�
   - ��分�

3. **��端页�*
   - 用户管�
   - 项目管�
   - ��分�

---

## 📚 核心文档导航

### 当��阅�

1. **整体架构**  
   `../ADMIN-��管��00-系统设计/00-��与角色体系梳�报告_v1.0.md`

2. **需求文档（包�机构端）**  
   `../ADMIN-��管��01-需求分�02-通用能力层_07-��与机构管�端PRD_v2.1.md`

3. **��端状�*  
   `../ADMIN-��管��00-模�当�状�与开�指�md`

### 待创建文�

**00-系统设计/**
- [ ] `01-机构管�端架构设�md`
- [ ] `02-多租户隔离设�md`
- [ ] `03-��管�设计.md`

**01-需求分�**
- [ ] `01-医院管�端PRD.md`
- [ ] `02-��管�端PRD.md`
- [ ] `03-用户故事与验收标�md`

**02-技术设�**
- [ ] `01-API设计文档.md`
- [ ] `02-数�库设计文�md`
- [ ] `03-科室树实现方�md`
- [ ] `04-��计算算法.md`

**03-UI设计/**
- [ ] `01-医院端原型设�html`
- [ ] `02-��端原型设�html`
- [ ] `03-�牌定制指�.md`

---

## ⚠� 技术��

### 1. 多租户隔�

```typescript
// 中间件：确��能访问自己租户的数�
export const requireTenantAccess = async (request: FastifyRequest) => {
  const { tenantId } = request.user;
  const { id } = request.params;
  
  const resource = await prisma.resource.findUnique({
    where: { id }
  });
  
  if (resource.tenantId !== tenantId) {
    throw new ForbiddenError('无�访问其他租户资�');
  }
};
```

### 2. 科室��检�

```typescript
// 科室管�员�能管�自己科�
export const requireDepartmentAccess = async (request: FastifyRequest) => {
  const { role, departmentId } = request.user;
  const { deptId } = request.params;
  
  if (role === 'DEPARTMENT_ADMIN' && departmentId !== deptId) {
    throw new ForbiddenError('无�访问其他科室');
  }
};
```

### 3. ��计算

```typescript
// 计算�分���
export const calculateAvailableQuota = async (tenantId: string) => {
  // 1. 获�租户总��
  const tenantQuota = await getTenantQuota(tenantId);
  
  // 2. 计算已分���
  const allocated = await prisma.tenantQuotaAllocation.aggregate({
    where: { tenantId },
    _sum: { limitAmount: true }
  });
  
  // 3. 返回�用��
  return tenantQuota.totalAmount - (allocated._sum.limitAmount || 0);
};
```

---

## � 与��管�端的对�

| 特�| ��管�端（ADMIN�| 机构管�端（INST�|
|------|-------------------|------------------|
| **用户** | 公�内部��人员 | 医院/��管��|
| **��** | 全局管��� | 租户级管���|
| **租户管�** | �创建/管�所有租�| ��能看到自己租户 |
| **用户管�** | �全局用户管� | �租户内用户管�|
| **��管�** | �分�租户总��| �分�科室/项目�� |
| **Prompt管�** | �生产环境调试 | �无��|
| **审计日志** | �全局日志 | �租户内日�|
| **�牌定制** | ��置所有租户��| ��能查看 |

---

## 📅 预计开�时�

**���* ��管�端基础架构完�（Week 4�

- **Week 5-6�* 医院管�端（8人天�
- **Week 7-8�* ��管�端（8人天�
- **Week 9�* 测试与优化（3人天�

**总计�* �9人天（~4周）

---

## 📞 需�帮助？

1. **架构问题**：�考��管�端实现
2. **��问题**：查看`00-��与角色体系梳�报告_v1.0.md`
3. **UI问题**：�考DC/ASL等已有模�

---

## 🎯 下一步行�

- [ ] 等待��管�端完�基础架构
- [ ] 开始编写详细PRD
- [ ] 设计UI原型
- [ ] 设计API接�

---

*机构管�端虽然尚未开始开�，但设计�路已明确。待��管�端完��，�快速�动开��

---

**🚀 敬请期待�*