feat(aia): Complete AIA V2.0 with universal streaming capabilities

Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

Backend (~1300 lines):
- common/streaming: OpenAI Compatible adapter
- modules/aia: 12 agents, conversation service, streaming integration
- Update route versions (RVW, PKB to v1)

Frontend (~3500 lines):
- modules/aia: AgentHub + ChatWorkspace (100% prototype restoration)
- shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook
- Update API endpoints to v1

Documentation:
- AIA module status guide
- Universal capabilities catalog
- System overview updates
- All module documentation sync

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)
This commit is contained in:
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions

View File

@@ -1,71 +1,71 @@
# INST-机构管理端 - 模块当前状态与开发指南
# INST-<EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡?- 璅<E79285>敶枏<E695B6><E69E8F><EFBFBD><E59786><EFBFBD><EFBFBD><E69298><EFBFBD><E78390>?
> **<2A><><EFBFBD>擧凒<E693A7><EFBFBD>** 2026-01-11
> **<2A><EFBFBD><E59786><EFBFBD>** <20>𣞁 <20><EFBFBD>憪页<E686AA>蝑匧<E89D91>餈鞱𨯫蝞∠<E89D9E>蝡臬<E89DA1><E887AC><EFBFBD>
> **版本:** v0.0 (Planning)
> **<EFBFBD><EFBFBD>𧋦嚗?* v0.0 (Planning)
---
## <20>㴓 銝<><E98A9D><EFBFBD><E4BAA5><EFBFBD>
**机构管理端为医院和药企客户提供自服务管理界面,让机构管理员能够独立管理用户、配额、科室/项目等资源。**
**<EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡臭蛹<EFBFBD>駁堺<EFBFBD>諹晓隡<EFBFBD><EFBFBD><EFBFBD>靘𥡝䌊<EFBFBD>滚𦛚蝞∠<EFBFBD><EFBFBD>屸𢒰嚗諹悟<EFBFBD><EFBFBD>蝞∠<EFBFBD><EFBFBD><EFBFBD>憭毺𡠺蝡讠恣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憸腈<EFBFBD><EFBFBD><EFBFBD>摰?憿寧𤌍蝑㕑<E89D91>皞僐<E79A9E>?*
---
## 📊 当前开发状态
## <EFBFBD><EFBFBD> 敶枏<E695B6><EFBFBD><E69298>𤑳𠶖<F0A491B3>?
### ✅ 已完成
### <EFBFBD>?撌脣<E6928C><E884A3>?
- [ ] **无**(尚未开始)
- [ ] **<EFBFBD>?*嚗<><E59A97><EFBFBD><EFBFBD>憪页<E686AA>
### 🚧 进行中
### <EFBFBD>银 餈𥡝<E9A488>銝?
- [ ] **无**
- [ ] **<EFBFBD>?*
### ⏳ 待开发(依赖运营管理端)
### <EFBFBD>?敺<><E695BA><EFBFBD>𡢅<EFBFBD>靘肽<E99D98>餈鞱𨯫蝞∠<E89D9E>蝡荔<E89DA1>
**<EFBFBD>滨蔭<EFBFBD>∩辣嚗<EFBFBD><EFBFBD>憿餃<EFBFBD>摰峕<EFBFBD>嚗㚁<EFBFBD>**
- [ ] 运营管理端基础架构Phase 0-2
- [ ] 餈鞱𨯫蝞∠<EFBFBD>蝡臬抅蝖<EFBFBD><EFBFBD><EFBFBD>嚗㇊hase 0-2嚗?
- [ ]<><E89D98>蝞∠<E89D9E><E288A0><EFBFBD>
- [ ] 租户专属登录页
- [ ] <EFBFBD><EFBFBD>銝枏<EFBFBD><EFBFBD><EFBFBD>憿?
- [ ] <20><><EFBFBD>摰𡁜<E691B0><F0A1819C>滨蔭
**<EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡臬<EFBFBD><EFBFBD>𤏸恣<EFBFBD>𡜐<EFBFBD><EFBFBD>恣Week 5+嚗㚁<E59A97>**
**P1 - 医院管理端(Week 5-6**
- [ ] 用户管理CRUD + 科室分配)
**P1 - <EFBFBD>駁堺蝞∠<EFBFBD>蝡荔<EFBFBD>Week 5-6嚗?*
- [ ] <EFBFBD><EFBFBD>蝞∠<EFBFBD>嚗㇃RUD + 蝘穃恕<E7A983><E68195><EFBFBD>嚗?
- [ ] 蝘穃恕蝞∠<E89D9E><EFBFBD>𣈲<EFBFBD><F0A388B2><EFBFBD>蝥抒<E89DA5><E68A92><EFBFBD><EFBFBD>
- [ ] 配额分配(科室/个人)
- [ ] <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>摰?銝芯犖嚗?
- [ ] 摰∟恣<E2889F><EFBFBD><E4BA99>亥砭
**P1 - 药企管理端(Week 7-8**
- [ ] 用户管理CRUD + 角色分配)
- [ ] 项目管理IIT项目关联
- [ ] 配额分配(项目/个人)
- [ ] 审计日志查询FDA合规
**P1 - <EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡荔<EFBFBD>Week 7-8嚗?*
- [ ] <EFBFBD><EFBFBD>蝞∠<EFBFBD>嚗㇃RUD + 閫坿𠧧<E59DBF><F0A0A7A7><EFBFBD>嚗?
- [ ] 憿寧𤌍蝞∠<EFBFBD>嚗㇆IT憿寧𤌍<EFBFBD><EFBFBD>嚗?
- [ ] <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?銝芯犖嚗?
- [ ] 摰∟恣<EFBFBD><EFBFBD><EFBFBD>亥砭嚗㇅DA<EFBFBD><EFBFBD><EFBFBD>嚗?
---
## 🏗️ 架构概览
## <EFBFBD><EFBFBD>儭?<3F><EFBFBD><EFBFBD><E79281>
```
┌─────────────────────────────────────────────────┐
机构管理端(INST Portal
├──────────────────────┬──────────────────────────┤
│ 🏥 医院管理端 │ 💊 药企管理端
├──────────────────────┼──────────────────────────┤
│ · 用户管理 │ · 用户管理
│ · 科室管理 │ · 项目管理
│ · 配额分配(科室/人) │ · 配额分配(项目/人) │
│ · 审计日志 │ · 审计日志(合规)
└──────────────────────┴──────────────────────────┘
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡荔<EFBFBD>INST Portal嚗? <EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <20><20>駁堺蝞∠<E89D9E>蝡? <20>? <20><> <20><EFBFBD>蝞∠<E89D9E>蝡? <EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>?繚 <20><EFBFBD>蝞∠<E89D9E> <EFBFBD>? 繚 <20><EFBFBD>蝞∠<E89D9E> <EFBFBD>?
<EFBFBD>?繚 蝘穃恕蝞∠<E89D9E> <EFBFBD>? 繚 憿寧𤌍蝞∠<E89D9E> <EFBFBD>?
<EFBFBD>?繚 <20><EFBFBD><E6BCA4><EFBFBD><EFBFBD><EFBFBD><E59A97>摰?鈭綽<E988AD> <20>? 繚 <20><EFBFBD><E6BCA4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?鈭綽<E988AD> <20>?
<EFBFBD>?繚 摰∟恣<E2889F><EFBFBD> <20>? 繚 摰∟恣<E2889F><EFBFBD><EFBFBD><E59A97><EFBFBD><E996AB> <EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>?
蝏扳㗁餈鞱𨯫蝞∠<E89D9E>蝡舐<E89DA1><E88890><EFBFBD>霈暹鴌
┌─────────────────────────────────────────────────┐
Platform Layer
│ 认证中心 │ 权限中心 │ 多租户隔离 │ 审计日志 │
└─────────────────────────────────────────────────┘
<EFBFBD>?
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? Platform Layer <EFBFBD>?
<EFBFBD>? 霈方<E99C88>銝剖<E98A9D> <20>?<3F><><EFBFBD>銝剖<E98A9D> <20>?憭𡁶<E686AD><F0A181B6><EFBFBD>蝳?<3F>?摰∟恣<E2889F><EFBFBD> <20>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
```
---
@@ -74,12 +74,12 @@
| <20><EFBFBD> | HOSPITAL_ADMIN | DEPARTMENT_ADMIN | PHARMA_ADMIN | PROJECT_MANAGER | USER |
|------|----------------|------------------|--------------|-----------------|------|
| 用户管理(租户内) | ✅ 全部 | ✅ 本科室 | ✅ 全部 | ✅ 项目成员 | |
| 科室管理 | ✅ | ❌ | N/A | N/A | |
| 项目管理 | N/A | N/A | ✅ 查看 | ✅ 管理 | |
| 配额分配 | ✅ | ✅ 本科室 | ✅ | ✅ 项目内 | ❌ |
| 审计日志 | ✅ 租户内 | ✅ 本科室 | ✅ 租户内 | ✅ 项目内 | ❌ |
| 业务模块使用 | ✅ | ✅ | ✅ | ✅ | ✅ |
| <EFBFBD><EFBFBD>蝞∠<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?| <20>?<3F><EFBFBD> | <20>?<3F><EFBFBD>摰?| <20>?<3F><EFBFBD> | <20>?憿寧𤌍<E5AFA7>𣂼<EFBFBD> | <EFBFBD>?|
| 蝘穃恕蝞∠<EFBFBD> | <20>?| <20>?| N/A | N/A | <EFBFBD>?|
| 憿寧𤌍蝞∠<EFBFBD> | N/A | N/A | <EFBFBD>?<3F><EFBFBD> | <20>?蝞∠<E89D9E> | <EFBFBD>?|
| <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> | <20>?| <20>?<3F><EFBFBD>摰?| <20>?| <20>?憿寧𤌍<E5AFA7>?| <20>?|
| 摰∟恣<EFBFBD><EFBFBD> | <20>?蝘<><E89D98><EFBFBD>?| <20>?<3F><EFBFBD>摰?| <20>?蝘<><E89D98><EFBFBD>?| <20>?憿寧𤌍<E5AFA7>?| <20>?|
| 銝𡁜𦛚璅<EFBFBD>雿輻鍂 | <20>?| <20>?| <20>?| <20>?| <20>?|
---
@@ -90,30 +90,30 @@
```
backend/src/
<EFBFBD><EFBFBD><EFBFBD><EFBFBD> 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
<EFBFBD>? <20><EFBFBD><E5A999><EFBFBD> institution/ # <EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡舀芋<EFBFBD>?
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> controllers/
<EFBFBD>? <EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> hospital/
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> user.controller.ts
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> department.controller.ts
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E5A999><EFBFBD> quota.controller.ts
<EFBFBD>? <EFBFBD>? <20>?
<EFBFBD>? <EFBFBD>? <20><EFBFBD><E5A999><EFBFBD> pharma/
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> user.controller.ts
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> project.controller.ts
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> quota.controller.ts
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> services/
<EFBFBD>? <EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> hospital.service.ts
<EFBFBD>? <EFBFBD>? <20><EFBFBD><E5A999><EFBFBD> pharma.service.ts
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> routes/
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> hospital.routes.ts
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> pharma.routes.ts
<EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD> common/
<20><EFBFBD><E5A999><EFBFBD> middleware/
<20><EFBFBD><E98EBF><EFBFBD> tenant.middleware.ts # 蝘<><E89D98><EFBFBD>𠉛氖嚗<E6B096><E59A97><EFBFBD><EFBFBD>
└── department.middleware.ts # 科室权限检查
<EFBFBD><EFBFBD><EFBFBD><EFBFBD> department.middleware.ts # 蝘穃恕<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
```
### <20>滨垢
@@ -121,33 +121,33 @@ backend/src/
```
frontend-v2/src/
<EFBFBD><EFBFBD><EFBFBD><EFBFBD> modules/
│ └── institution/ # 机构管理端模块
├── pages/
│ ├── hospital/
│ │ ├── UserManagement/
│ │ ├── DepartmentManagement/
│ │ ├── QuotaAllocation/
│ │ └── AuditLog/
│ │
│ └── pharma/
├── UserManagement/
├── ProjectManagement/
├── QuotaAllocation/
└── AuditLog/
└── components/
├── UserForm/
├── DepartmentTree/
├── QuotaAllocator/
└── AuditLogViewer/
<EFBFBD>? <20><EFBFBD><E5A999><EFBFBD> institution/ # <EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡舀芋<EFBFBD>?
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> pages/
<EFBFBD>? <EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> hospital/
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> UserManagement/
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> DepartmentManagement/
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> QuotaAllocation/
<EFBFBD>? <EFBFBD>? <20>? <20><EFBFBD><E5A999><EFBFBD> AuditLog/
<EFBFBD>? <EFBFBD>? <20>?
<EFBFBD>? <EFBFBD>? <20><EFBFBD><E5A999><EFBFBD> pharma/
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> UserManagement/
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> ProjectManagement/
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> QuotaAllocation/
<EFBFBD>? <EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> AuditLog/
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> components/
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> UserForm/
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> DepartmentTree/
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> QuotaAllocator/
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> AuditLogViewer/
<EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD> layouts/
<20><EFBFBD><E5A999><EFBFBD> TenantLayout/ # 蝘<><E89D98>銝枏<E98A9D><EFBFBD><E692A3><EFBFBD><E59A97><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
```
---
## 🎨 UI/UX 特性
## <EFBFBD> UI/UX <EFBFBD><EFBFBD>?
### 1. 蝘<><E89D98><EFBFBD><EFBFBD><EFBFBD>摰𡁜<E691B0>
@@ -160,9 +160,9 @@ document.documentElement.style.setProperty('--primary-color', config.primaryColo
document.title = config.systemName;
```
**效果:**
- 协和医院看到的是协和Logo和"协和临床研究平台"
- 辉瑞药业看到的是辉瑞Logo和"辉瑞IIT管理平台"
**<EFBFBD><EFBFBD><EFBFBD>嚗?*
- <EFBFBD><EFBFBD><EFBFBD>駁堺<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Logo<EFBFBD>?<3F><EFBFBD>銝游<E98A9D><E6B8B8>𠉛弦撟喳蝱"
- 颲厩<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>糓颲厩<EFBFBD>Logo<EFBFBD>?颲厩<E9A2B2>IIT蝞∠<E89D9E>撟喳蝱"
### 2. 蝘穃恕<E7A983>𤑳<EFBFBD>隞塚<E99A9E><E5A19A>駁堺蝡荔<E89DA1>
@@ -175,19 +175,19 @@ document.title = config.systemName;
/>
```
**支持:**
**<EFBFBD><EFBFBD>嚗?*
- 憭𡁶漣撅訫<E69285>/<2F><EFBFBD>
- <20>𡝗嗻<F0A19D97><EFBFBD>
- 配额可视化
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
### 3. 配额分配器
### 3. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
```tsx
<QuotaAllocator
totalQuota={1000000}
allocations={[
{ target: '心内科', allocated: 500000, used: 300000 },
{ target: '神内科', allocated: 300000, used: 150000 }
{ target: '<EFBFBD><EFBFBD>蝘?, allocated: 500000, used: 300000 },
{ target: '𧼮<EFBFBD>?, allocated: 300000, used: 150000 }
]}
onAllocate={(target, amount) => handleAllocate(target, amount)}
/>
@@ -200,9 +200,9 @@ document.title = config.systemName;
---
## 🗄️ 数据模型
## <EFBFBD><EFBFBD>儭?<3F>唳旿璅<E79285>
### 医院端
### <EFBFBD>駁堺蝡?
```typescript
// 蝘穃恕
@@ -221,16 +221,16 @@ interface QuotaAllocation {
id: string;
tenantId: string;
targetType: 'DEPARTMENT' | 'USER';
targetKey: string; // DepartmentID UserID
targetKey: string; // DepartmentID <EFBFBD>?UserID
limitAmount: bigint;
usedAmount: bigint;
}
```
### 药企端
### <EFBFBD><EFBFBD>蝡?
```typescript
// 项目关联IIT
// 憿寧𤌍嚗<EFBFBD><EFBFBD><EFBFBD>㶏IT嚗?
interface Project {
id: string;
tenantId: string;
@@ -252,11 +252,11 @@ interface ProjectMember {
---
## 🚀 开发流程
## <EFBFBD><EFBFBD><><E69298><EFBFBD>蝔?
### Step 1: 霈曇恣<E69B87>嗆挾嚗<E68CBE><E59A97><EFBFBD><EFBFBD>
- [ ] 详细需求文档(PRD
- [ ] 霂衣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>PRD嚗?
- [ ] API<50>亙藁霈曇恣
- [ ] <20>唳旿摨栞”霈曇恣
- [ ] UI<55><EFBFBD>霈曇恣
@@ -275,19 +275,19 @@ interface ProjectMember {
- <20><EFBFBD><E6BCA4><EFBFBD><EFBFBD>API
- 摰∟恣<E2889F><EFBFBD>API嚗<49><E59A97><EFBFBD><E996AB>
### Step 3: 前端开发
### Step 3: <EFBFBD>滨垢撘<EFBFBD><EFBFBD>?
1. **<EFBFBD><EFBFBD><EFBFBD>辣**
- TenantLayout(品牌定制布局)
- QuotaAllocator(配额分配器)
- AuditLogViewer(审计日志查看器)
- TenantLayout<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?
- QuotaAllocator<EFBFBD><EFBFBD>憸嘥<EFBFBD><EFBFBD>滚膥嚗?
- AuditLogViewer<EFBFBD>恣霈⊥𠯫敹埈䰻<EFBFBD>见膥嚗?
2. **医院端页面**
2. **<EFBFBD>駁堺蝡舫△<EFBFBD>?*
- <20><EFBFBD>蝞∠<E89D9E>
- 科室管理DepartmentTree
- 蝘穃恕蝞∠<EFBFBD>嚗㇄epartmentTree嚗?
- <20><EFBFBD><E6BCA4><EFBFBD><EFBFBD>
3. **药企端页面**
3. **<EFBFBD><EFBFBD>蝡舫△<EFBFBD>?*
- <20><EFBFBD>蝞∠<E89D9E>
- 憿寧𤌍蝞∠<E89D9E>
- <20><EFBFBD><E6BCA4><EFBFBD><EFBFBD>
@@ -296,48 +296,48 @@ interface ProjectMember {
## <20><> <20><EFBFBD><E8A9A8><EFBFBD>﹝撖潸⏛
### 当前可阅读
### 敶枏<EFBFBD><EFBFBD><EFBFBD>霂?
1. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>**
`../ADMIN-运营管理端/00-系统设计/00-权限与角色体系梳理报告_v1.0.md`
`../ADMIN-餈鞱𨯫蝞∠<EFBFBD>蝡?00-蝟餌<E89D9F>霈曇恣/00-<2D><><EFBFBD>銝舘<E98A9D><E88898><EFBFBD>蝟餅<E9A485><EFBC94>𥁒<EFBFBD>𠽤v1.0.md`
2. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝡荔<EFBFBD>**
`../ADMIN-运营管理端/01-需求分析/02-通用能力层_07-运营与机构管理端PRD_v2.1.md`
`../ADMIN-餈鞱𨯫蝞∠<EFBFBD>蝡?01-<2D><><EFBFBD><E79899><EFBFBD>?02-<2D>𡁶鍂<F0A181B6><EFBFBD><EFBFBD>07-餈鞱𨯫銝擧㦤<E693A7><E3A6A4><EFBFBD><E681A3>PRD_v2.1.md`
3. **运营端状态**
`../ADMIN-运营管理端/00-模块当前状态与开发指南.md`
3. **餈鞱𨯫蝡舐𠶖<EFBFBD>?*
`../ADMIN-餈鞱𨯫蝞∠<EFBFBD>蝡?00-璅<E79285>敶枏<E695B6><E69E8F><EFBFBD><E59786><EFBFBD><EFBFBD><E69298><EFBFBD><E78390>?md`
### 待创建文档
### <EFBFBD><EFBFBD>撱箸<EFBFBD>獢?
**00-蝟餌<E89D9F>霈曇恣/**
- [ ] `01-机构管理端架构设计.md`
- [ ] `02-多租户隔离设计.md`
- [ ] `01-<EFBFBD><EFBFBD>蝞∠<EFBFBD>蝡舀沲<EFBFBD><EFBFBD>挽霈?md`
- [ ] `02-憭𡁶<EFBFBD><EFBFBD><EFBFBD>蝳餉挽霈?md`
- [ ] `03-<2D><EFBFBD>蝞∠<E89D9E>霈曇恣.md`
**01-需求分析/**
**01-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?**
- [ ] `01-<2D>駁堺蝞∠<E89D9E>蝡烈RD.md`
- [ ] `02-<2D><EFBFBD>蝞∠<E89D9E>蝡烈RD.md`
- [ ] `03-用户故事与验收标准.md`
- [ ] `03-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝𡡞<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?md`
**02-技术设计/**
**02-<EFBFBD><EFBFBD><EFBFBD>航挽霈?**
- [ ] `01-API霈曇恣<E69B87><E681A3>﹝.md`
- [ ] `02-数据库设计文档.md`
- [ ] `03-科室树实现方案.md`
- [ ] `02-<EFBFBD>唳旿摨栞挽霈⊥<EFBFBD>獢?md`
- [ ] `03-蝘穃恕<EFBFBD><EFBFBD><EFBFBD>唳䲮獢?md`
- [ ] `04-<2D><EFBFBD>霈∠<E99C88>蝞埈<E89D9E>.md`
**03-UI霈曇恣/**
- [ ] `01-医院端原型设计.html`
- [ ] `02-药企端原型设计.html`
- [ ] `01-<EFBFBD>駁堺蝡臬<EFBFBD><EFBFBD>贝挽霈?html`
- [ ] `02-<EFBFBD><EFBFBD>蝡臬<EFBFBD><EFBFBD>贝挽霈?html`
- [ ] `03-<2D><><EFBFBD>摰𡁜<E691B0><F0A1819C><EFBFBD><EFBFBD>.md`
---
## ⚠️ 技术要点
## <EFBFBD>𩤃<EFBFBD> <20><><EFBFBD><EFBFBD><E888AA>?
### 1. 多租户隔离
### 1. 憭𡁶<EFBFBD><EFBFBD><EFBFBD>蝳?
```typescript
// 中间件:确保只能访问自己租户的数据
// 銝剝𡢿隞塚<EFBFBD>蝖桐<EFBFBD><EFBFBD><EFBFBD>霈輸䔮<EFBFBD>芸楛蝘<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
export const requireTenantAccess = async (request: FastifyRequest) => {
const { tenantId } = request.user;
const { id } = request.params;
@@ -352,10 +352,10 @@ export const requireTenantAccess = async (request: FastifyRequest) => {
};
```
### 2. 科室权限检查
### 2. 蝘穃恕<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
```typescript
// 科室管理员只能管理自己科室
// 蝘穃恕蝞∠<EFBFBD><EFBFBD>睃蘨<EFBFBD>賜恣<EFBFBD><EFBFBD>䌊撌梁<EFBFBD>摰?
export const requireDepartmentAccess = async (request: FastifyRequest) => {
const { role, departmentId } = request.user;
const { deptId } = request.params;
@@ -369,12 +369,12 @@ export const requireDepartmentAccess = async (request: FastifyRequest) => {
### 3. <20><EFBFBD>霈∠<E99C88>
```typescript
// 计算可分配配额
// 霈∠<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憸?
export const calculateAvailableQuota = async (tenantId: string) => {
// 1. 获取租户总配额
// 1. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憸?
const tenantQuota = await getTenantQuota(tenantId);
// 2. 计算已分配配额
// 2. 霈∠<EFBFBD>撌脣<EFBFBD><EFBFBD><EFBFBD>憸?
const allocated = await prisma.tenantQuotaAllocation.aggregate({
where: { tenantId },
_sum: { limitAmount: true }
@@ -387,30 +387,30 @@ export const calculateAvailableQuota = async (tenantId: string) => {
---
## 🔍 与运营管理端的对比
## <EFBFBD><EFBFBD> 銝舘<E98A9D><E88898>亦恣<E4BAA6><E681A3><EFBFBD><E59EA2>笆瘥?
| 特性 | 运营管理端ADMIN | 机构管理端(INST |
| <EFBFBD><EFBFBD>?| 餈鞱𨯫蝞∠<E89D9E>蝡荔<E89DA1>ADMIN嚗?| <20><EFBFBD>蝞∠<E89D9E>蝡荔<E89DA1>INST嚗?|
|------|-------------------|------------------|
| **用户** | 公司内部运营人员 | 医院/药企管理员 |
| **权限** | 全局管理权限 | 租户级管理权限 |
| **租户管理** | ✅ 创建/管理所有租户 | ❌ 只能看到自己租户 |
| **用户管理** | ✅ 全局用户管理 | ✅ 租户内用户管理 |
| **配额管理** | ✅ 分配租户总配额 | ✅ 分配科室/项目配额 |
| **Prompt管理** | ✅ 生产环境调试 | ❌ 无权限 |
| **审计日志** | ✅ 全局日志 | ✅ 租户内日志 |
| **品牌定制** | ✅ 配置所有租户品牌 | ❌ 只能查看 |
| **<EFBFBD><EFBFBD>** | <EFBFBD>砍虬<EFBFBD><EFBFBD><EFBFBD>餈鞱𨯫鈭箏<EFBFBD> | <20>駁堺/<2F><EFBFBD>蝞∠<E89D9E><E288A0>?|
| **<EFBFBD><EFBFBD><EFBFBD>** | <EFBFBD><EFBFBD>蝞∠<EFBFBD><EFBFBD><EFBFBD><EFBFBD> | 蝘<><E89D98>蝥抒恣<E68A92><E681A3><EFBFBD><EFBFBD>?|
| **<EFBFBD><EFBFBD>蝞∠<EFBFBD>** | <EFBFBD>?<3F>𥕦遣/蝞∠<E89D9E><E288A0><EFBFBD><EFBFBD><EFBFBD><E58EA9>?| <20>?<3F><EFBFBD><E88ABE><EFBFBD><E8A781>芸楛蝘<E6A59B><E89D98> |
| **<EFBFBD><EFBFBD>蝞∠<EFBFBD>** | <EFBFBD>?<3F><EFBFBD><E585B8><EFBFBD>蝞∠<E89D9E> | <20>?蝘<><E89D98><EFBFBD><EFBFBD><EFBFBD>瑞恣<E7919E>?|
| **<EFBFBD><EFBFBD>蝞∠<EFBFBD>** | <EFBFBD>?<3F><><EFBFBD><EFBFBD><E89D98><EFBFBD><EFBFBD>憸?| <20>?<3F><><EFBFBD>蝘穃恕/憿寧𤌍<E5AFA7><EFBFBD> |
| **Prompt蝞∠<EFBFBD>** | <EFBFBD>?<3F>煺漣<E785BA><EFBFBD><EFBFBD><E99D9A> | <20>?<3F><EFBFBD><E4ADBE>?|
| **摰∟恣<EFBFBD><EFBFBD>** | <EFBFBD>?<3F><EFBFBD><E585B8><EFBFBD> | <20>?蝘<><E89D98><EFBFBD><EFBFBD>𠯫敹?|
| **<EFBFBD><EFBFBD><EFBFBD>摰𡁜<EFBFBD>** | <EFBFBD>?<3F>滨蔭<E6BBA8><E894AD><EFBFBD><EFBFBD><E58EA9><EFBFBD><E79195>?| <20>?<3F><EFBFBD><E88ABE><EFBFBD> |
---
## 📅 预计开发时间
## <EFBFBD><EFBFBD><>恣撘<E681A3><E69298>烐𧒄<E78390>?
**前提:** 运营管理端基础架构完成Week 4
**<EFBFBD>齿<EFBFBD>嚗?* 餈鞱𨯫蝞∠<E89D9E>蝡臬抅蝖<E68A85><E89D96><EFBFBD>摰峕<E691B0>嚗Áeek 4嚗?
- **Week 5-6** 医院管理端8人天
- **Week 7-8** 药企管理端8人天
- **Week 9** 测试与优化3人天
- **Week 5-6嚗?* <20>駁堺蝞∠<E89D9E>蝡荔<E89DA1>8鈭箏予嚗?
- **Week 7-8嚗?* <20><EFBFBD>蝞∠<E89D9E>蝡荔<E89DA1>8鈭箏予嚗?
- **Week 9嚗?* 瘚贝<E7989A>銝𦒘<E98A9D><F0A69298><EFBFBD>3鈭箏予嚗?
**总计:** 约19人天~4周
**<EFBFBD>餉恣嚗?* 蝥?9鈭箏予嚗ǚ4<C79A><EFBFBD>
---
@@ -418,11 +418,11 @@ export const calculateAvailableQuota = async (tenantId: string) => {
1. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>**嚗𡁜<E59A97><F0A1819C><EFBFBD><EFBFBD><EFBFBD>亦恣<E4BAA6><E681A3>垢摰䂿緵
2. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>**嚗𡁏䰻<F0A1818F>㞗00-<2D><><EFBFBD>銝舘<E98A9D><E88898><EFBFBD>蝟餅<E9A485><EFBC94>𥁒<EFBFBD>𠽤v1.0.md`
3. **UI问题**参考DC/ASL等已有模块
3. **UI<EFBFBD><EFBFBD>**嚗𡁜<E59A97><F0A1819C><EFBFBD>C/ASL蝑匧歇<E58CA7>㗇芋<E39787>?
---
## 🎯 下一步行动
## <EFBFBD>㴓 銝衤<E98A9D>甇亥<E79487><E4BAA5>?
- [ ] 蝑匧<E89D91>餈鞱𨯫蝞∠<E89D9E>蝡臬<E89DA1><E887AC>𣂼抅蝖<E68A85><E89D96><EFBFBD>
- [ ]<>憪讠<E686AA><E8AEA0>躰祕蝏<E7A595>RD
@@ -431,11 +431,12 @@ export const calculateAvailableQuota = async (tenantId: string) => {
---
*机构管理端虽然尚未开始开发,但设计思路已明确。待运营管理端完成后,可快速启动开发。*
*<2A><EFBFBD>蝞∠<E89D9E>蝡航蒾<E888AA><EFBFBD><E59785><EFBFBD>憪见<E686AA><E8A781>𡢅<EFBFBD><EFBFBD>挽霈⊥<E99C88>肽楝撌脫<E6928C>蝖柴<E89D96><E69FB4><EFBFBD>餈鞱𨯫蝞∠<E89D9E>蝡臬<E89DA1><E887AC>𣂼<EFBFBD><EFBFBD>虾敹恍<E695B9>笔鍳<E7AC94><EFBFBD><E585B8><EFBFBD>?
---
**🚀 敬请期待!**
**<EFBFBD><EFBFBD> <20>祈窈<E7A588><EFBFBD>嚗?*