Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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:
HaHafeng
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
Download Patch File Download Diff File Expand all files Collapse all files

456
docs/00-系统总体设计/00-今日架构设计总结.md
View File

@@ -1,8 +1,8 @@
# 2025-11-06 譫ｶ譫<EFBDB6>ｮｾ隶｡諤ｻ扈<EFBDBB>
> **日期：** 2025-11-06
> **工作类型：** 系统架构深度设计
> **成果：** 7个核心架构文档，完整的技术方案
> **譌･譛滂ｼ?* 2025-11-06
> **蟾･菴懃ｱｻ蝙具ｼ?* 邉ｻ扈滓楔譫<E6A594>ｷｱ蠎ｦ隶ｾ隶｡
> **謌先棡<EFBFBD>?* 7荳ｪ譬ｸ蠢<EFBDB8>楔譫<E6A594>枚譯｣<E8ADAF>悟ｮ梧紛逧<E7B49B>橿譛ｯ譁ｹ譯?
---
@@ -13,143 +13,143 @@
| # | 譁<>｡｣ | 譬ｸ蠢<EFBDB8><E8A0A2>螳ｹ | 鬘ｵ謨ｰ |
|---|------|---------|------|
| 1 | [00-譬ｸ蠢<EFBDB8>琉鬚倩ｧ｣遲脳(./00-譬ｸ蠢<EFBDB8>琉鬚倩ｧ｣遲<EFBDA3>.md) | 驛ｨ鄂ｲ讓｡蠑上€∝ｮ｡遞ｿ邉ｻ扈溽峡遶区€ｧ縲∵焚謐ｮ蠎捺楔譫<E6A594>ｾ<EFBFBD>ｸ<EFBFBD> | 隸ｦ蟆ｽ |
| 2 | [01-系统架构分层设计](./01-系统架构分层设计.md) | 三层架构、8个业务模块、5个通用能力 | 900+ |
| 3 | [02-文档体系重构方案v2.0](./02-文档体系重构方案.md) | 新文档结构、8个模块、4种部署方案 | 790+ |
| 4 | [03-数据库架构说明](./03-数据库架构说明.md) | PostgreSQL Docker部署、两个独立数据库 | 434+ |
| 5 | [04-运营管理端架构设计](./04-运营管理端架构设计.md) | 15个功能模块、3阶段实施 | 859+ |
| 6 | [05-Schema隔离方案与成本分析](./05-Schema隔离方案与成本分析.md) | 逻辑vs物理隔离、改造成本对比 | 1042+ |
| 2 | [01-邉ｻ扈滓楔譫<EFBFBD><EFBFBD>螻りｮｾ隶｡](./01-邉ｻ扈滓楔譫<E6A594><E8ADAB>螻りｮｾ隶｡.md) | 荳牙ｱよ楔譫<E6A594>€?荳ｪ荳壼苅讓｡蝮励€?荳ｪ騾夂畑閭ｽ蜉<EFBDBD> | 900+ |
| 3 | [02-譁<EFBFBD>｡｣菴鍋ｳｻ驥肴桷譁ｹ譯<EFBFBD>2.0](./02-譁<>｡｣菴鍋ｳｻ驥肴桷譁ｹ譯<EFBDB9>.md) | 譁ｰ譁<EFBDB0>｡｣扈捺桷縲?荳ｪ讓｡蝮励€?遘埼Κ鄂ｲ譁ｹ譯?| 790+ |
| 4 | [03-謨ｰ謐ｮ蠎捺楔譫<EFBFBD>ｯｴ譏讃(./03-謨ｰ謐ｮ蠎捺楔譫<E6A594>ｯｴ譏?md) | PostgreSQL Docker驛ｨ鄂ｲ縲∽ｸ､荳ｪ迢ｬ遶区焚謐ｮ蠎<EFBFBD> | 434+ |
| 5 | [04-霑占是邂｡逅<EFBFBD>ｫｯ譫ｶ譫<EFBFBD>ｮｾ隶｡](./04-霑占是邂｡逅<EFBDA1>ｫｯ譫ｶ譫<EFBDB6>ｮｾ隶?md) | 15荳ｪ蜉溯<E89C89>讓｡蝮励€?髦ｶ谿ｵ螳樊命 | 859+ |
| 6 | [05-Schema髫皮ｦｻ譁ｹ譯井ｸ取<EFBFBD>譛ｬ蛻<EFBFBD>梵](./05-Schema髫皮ｦｻ譁ｹ譯井ｸ取<EFBDB8>譛ｬ蛻<EFBDAC><E89BBB>?md) | 騾ｻ霎宋s迚ｩ逅<EFBDA9>囈遖ｻ縲∵隼騾<E99ABC>謌先悽蟇ｹ豈?| 1042+ |
| 7 | [06-讓｡蝮礼峡遶矩Κ鄂ｲ荳主黒譛ｺ迚域婿譯<E5A9BF>(./06-讓｡蝮礼峡遶矩Κ鄂ｲ荳主黒譛ｺ迚域婿譯<E5A9BF>.md) | 螳梧紛謇灘桁縲∝<E7B8B2>莠ｫ譛榊苅縲・lectron譫ｶ譫<EFBDB6> | 1541+ |
| 8 | [07-Monorepo架构评估](./07-Monorepo架构评估.md) | 当前阶段是否需要、成本收益分析 | 555+ |
| 8 | [07-Monorepo譫ｶ譫<EFBFBD>ｯ<EFBFBD>ｼｰ](./07-Monorepo譫ｶ譫<EFBFBD>ｯ<EFBFBD>ｼｰ.md) | 蠖灘燕髦ｶ谿ｵ譏ｯ蜷ｦ髴€隕√€∵<C280>譛ｬ謾ｶ逶雁<E980B6>譫?| 555+ |
**总计：** 6000+ 行详细设计文档
**諤ｻ隶｡<EFBFBD>?* 6000+ 陦瑚ｯｦ扈<EFBDA6>ｮｾ隶｡譁<EFBDA1>｡?
---
## <20>投 譬ｸ蠢<EFBDB8>楔譫<E6A594><E8ADAB>遲<EFBFBD>
### 1. 系统架构分层 ⭐⭐⭐⭐⭐
### 1. 邉ｻ扈滓楔譫<EFBFBD><EFBFBD>螻<EFBFBD> 箝絶ｭ絶ｭ絶ｭ絶ｭ?
**三层架构：**
**荳牙ｱよ楔譫<EFBFBD>ｼ?*
```
┌───────────────────────────────────────┐
│ 业务模块层（8个模块） │
│ AIA | ASL | PKB | DC | SSA | ST | RVW | ADMIN
└───────────────────────────────────────┘
↓ 依赖
┌───────────────────────────────────────┐
│ 通用能力层（5个能力） │
│ LLM网关 | 文档处理 | RAG | ETL | NLP │
└───────────────────────────────────────┘
↓ 依赖
┌───────────────────────────────────────┐
│ 平台基础层 │
│ 用户权限 | 存储 | 通知 | 监控 | 配置 │
└───────────────────────────────────────┘
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? 荳壼苅讓｡蝮怜ｱゑｼ<E38291>8荳ｪ讓｡蝮暦ｼ<E69AA6> 笏?
笏? AIA | ASL | PKB | DC | SSA | ST | RVW | ADMIN
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
竊?萓晁ｵ<E69981>
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? 騾夂畑閭ｽ蜉帛ｱゑｼ<E38291>5荳ｪ閭ｽ蜉幢ｼ<E5B9A2> 笏?
笏? LLM鄂大<EFBFBD> | 譁<>｡｣螟<EFBDA3>炊 | RAG | ETL | NLP 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
竊?萓晁ｵ<E69981>
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? 蟷ｳ蜿ｰ蝓ｺ遑€螻? 笏?
笏? 逕ｨ謌ｷ譚<EFBDB7>剞 | 蟄伜お | 騾夂衍 | 逶第而 | 驟咲ｽｮ 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
```
**关键洞察：**
- ✅ LLM网关：71%复用率（5/7模块依赖）
- ✅ 文档处理：86%复用率（6/7模块依赖）
- ✅ 模块独立性：RVW、ASL、DC可独立销售
**蜈ｳ髞ｮ豢槫ｯ滂ｼ?*
- 笨?LLM鄂大<EFBFBD><EFBFBD>?1%螟咲畑邇<E79591>ｼ<EFBFBD>5/7讓｡蝮嶺ｾ晁ｵ厄ｼ?
- 笨?譁<>｡｣螟<EFBDA3>炊<EFBFBD>?6%螟咲畑邇<E79591>ｼ<EFBFBD>6/7讓｡蝮嶺ｾ晁ｵ厄ｼ?
- 笨?讓｡蝮礼峡遶区€ｧ<C280>啌VW縲、SL縲．C蜿ｯ迢ｬ遶矩楳蜚?
---
### 2. 业务模块规划（8个模块）
### 2. 荳壼苅讓｡蝮苓ｧ<EFBFBD><EFBFBD><EFBFBD>?荳ｪ讓｡蝮暦ｼ<E69AA6>
| 模块 | 名称 | 商业价值 | 独立性 | 状态 |
| 讓｡蝮<EFBFBD> | 蜷咲ｧｰ | 蝠<>ｸ壻ｻｷ蛟?| 迢ｬ遶区€?| 迥ｶ諤?|
|------|------|---------|-------|------|
| AIA | AI智能问答 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ✅ 已完成 |
| ASL | AI智能文献 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⏳ 下一步重点 |
| PKB | 个人知识库 | ⭐⭐⭐ | ⭐⭐⭐ | ✅ 已完成 |
| DC | 数据清洗整理 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⏳ 规划中 |
| SSA | 智能统计分析 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⏳ 规划中 |
| ST | 统计分析工具 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⏳ 规划中 |
| RVW | 稿件审查系统 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⚡ 独立系统 |
| **ADMIN** | 运营管理端 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐ 新增 |
| AIA | AI譎ｺ閭ｽ髣ｮ遲<EFBFBD> | 箝絶ｭ絶ｭ絶ｭ<E7B5B6> | 箝絶ｭ絶ｭ?| 笨?蟾ｲ螳梧<E89EB3>?|
| ASL | AI譎ｺ閭ｽ譁<EFBFBD>鍵 | 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 竢?荳倶ｸ€豁･驥咲<E9A9A5>?|
| PKB | 荳ｪ莠ｺ遏･隸<EFBFBD>ｺ?| 箝絶ｭ絶ｭ?| 箝絶ｭ絶ｭ?| 笨?蟾ｲ螳梧<E89EB3>?|
| DC | 謨ｰ謐ｮ貂<EFBFBD>ｴ玲紛逅<EFBFBD> | 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 竢?隗<><E99A97>荳?|
| SSA | 譎ｺ閭ｽ扈溯ｮ｡蛻<EFBFBD>梵 | 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 箝絶ｭ絶ｭ絶ｭ<E7B5B6> | 竢?隗<><E99A97>荳?|
| ST | 扈溯ｮ｡蛻<EFBFBD>梵蟾･蜈ｷ | 箝絶ｭ絶ｭ絶ｭ<E7B5B6> | 箝絶ｭ絶ｭ絶ｭ<E7B5B6> | 竢?隗<><E99A97>荳?|
| RVW | 遞ｿ莉ｶ螳｡譟･邉ｻ扈<EFBFBD> | 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 笞?迢ｬ遶狗ｳｻ扈<EFBDBB> |
| **ADMIN** | 霑占是邂｡逅<EFBFBD>ｫ?| 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 箝絶ｭ絶ｭ絶ｭ絶ｭ?| 箝?譁ｰ蠅<EFBDB0> |
**核心亮点：**
- ✅ 新增运营管理端（15个功能模块）
- ✅ 3个模块极具独立销售价值（RVW、ASL、DC）
**譬ｸ蠢<EFBFBD>ｺｮ轤ｹ<EFBFBD>?*
- 笨?譁ｰ蠅櫁ｿ占是邂｡逅<EFBDA1>ｫｯ<EFBDAB><EFBDAF>15荳ｪ蜉溯<E89C89>讓｡蝮暦ｼ<E69AA6>
- 笨?3荳ｪ讓｡蝮玲栫蜈ｷ迢ｬ遶矩楳蜚ｮ莉ｷ蛟ｼ<E89B9F><EFBDBC>VW縲、SL縲．C<EFBC8E>?
---
### 3. 部署方案（4种模式）
### 3. 驛ｨ鄂ｲ譁ｹ譯茨ｼ?遘肴ｨ｡蠑擾ｼ<E693BE>
| 部署模式 | 目标用户 | 技术方案 | 代码复用 | 优先级 |
| 驛ｨ鄂ｲ讓｡蠑<EFBFBD> | 逶ｮ譬<EFBDAE>畑謌ｷ | 謚€譛ｯ譁ｹ譯?| 莉｣遐∝､咲畑 | 莨伜<E88EA8>郤?|
|---------|---------|---------|---------|-------|
| **莠醍ｫｯSaaS** | 荳ｪ莠ｺ縲∝ｰ乗惻譫<E683BB> | Node.js + PostgreSQL | 100% | P0<50>亥ｽ灘燕<E78198><E78795> |
| **独立产品包** | 特定客户 | Docker完整打包 | 80% | P1（阶段二） |
| **Electron单机版** | 个人医生 | 前端90%+后端80% | 85% | P2（阶段二） |
| **私有化部署** | 医院、机构 | K8s/Docker | 100% | P1（阶段二） |
| **迢ｬ遶倶ｺｧ蜩∝<EFBFBD>?* | 迚ｹ螳壼ｮ｢謌ｷ | Docker螳梧紛謇灘桁 | 80% | P1<EFBFBD>磯亳谿ｵ莠鯉ｼ?|
| **Electron蜊墓惻迚?* | 荳ｪ莠ｺ蛹ｻ逕<EFBDBB> | 蜑咲ｫｯ90%+蜷守ｫｯ80% | 85% | P2<EFBFBD>磯亳谿ｵ莠鯉ｼ?|
| **遘∵怏蛹夜Κ鄂?* | 蛹ｻ髯｢縲∵惻譫?| K8s/Docker | 100% | P1<EFBFBD>磯亳谿ｵ莠鯉ｼ?|
**关键洞察：**
- ✅ Electron单机版代码复用率极高（85%+）
- ✅ 独立产品包支持模块化销售
- ✅ 4种部署覆盖全部市场需求
**蜈ｳ髞ｮ豢槫ｯ滂ｼ?*
- 笨?Electron蜊墓惻迚井ｻ｣遐∝､咲畑邇<EFBFBD>栫鬮假ｼ?5%+<EFBFBD>?
- 笨?迢ｬ遶倶ｺｧ蜩∝桁謾ｯ謖∵ｨ｡蝮怜喧髞€蜚?
- 笨?4遘埼Κ鄂ｲ隕<EFBDB2>尠蜈ｨ驛ｨ蟶ょ惻髴€豎?
---
### 4. 数据库架构
### 4. 謨ｰ謐ｮ蠎捺楔譫?
**蠖灘燕迥ｶ諤<EFBDB6>ｼ<EFBFBD>**
- ✅ 有自己独立的PostgreSQL数据库（Docker部署）
- ✅ 16张表，全部在public schema
- ❌ 需要Schema隔离（未来微服务拆分的基础）
- 笨?譛芽<E8AD9B>蟾ｱ迢ｬ遶狗噪PostgreSQL謨ｰ謐ｮ蠎難ｼ<E99BA3>ocker驛ｨ鄂ｲ<E98482>?
- 笨?16蠑<36>陦ｨ<E999A6>悟<EFBFBD>驛ｨ蝨ｨpublic schema
- 笶?髴€隕ヾchema髫皮ｦｻ<EFBDA6>域悴譚･蠕ｮ譛榊苅諡<E88B85><E8ABA1>逧<EFBFBD>渕遑€<E98191>?
**Schema隔离决策：**
**Schema髫皮ｦｻ蜀ｳ遲厄ｼ?*
| 譁ｹ譯<EFBDB9> | 謌先悽 | 譌ｶ譛ｺ | 蟒ｺ隶ｮ |
|------|------|------|------|
| 现在做物理隔离 | 1周 | 数据量小 | ⭐⭐⭐⭐⭐ 强烈推荐 |
| 继续逻辑隔离 | 0 | 当前 | ⭐⭐⭐ 可接受 |
| 未来做物理隔离 | 3-5周 | 数据量大 | ⚠️ 成本5倍 |
| 邇ｰ蝨ｨ蛛夂黄逅<EFBFBD>囈遖?| 1蜻?| 謨ｰ謐ｮ驥丞ｰ<E4B89E> | 箝絶ｭ絶ｭ絶ｭ絶ｭ?蠑ｺ辜域耳闕<E880B3> |
| 扈ｧ扈ｭ騾ｻ霎鷹囈遖ｻ | 0 | 蠖灘燕 | 箝絶ｭ絶ｭ?蜿ｯ謗･蜿?|
| 譛ｪ譚･蛛夂黄逅<EFBFBD>囈遖?| 3-5蜻?| 謨ｰ謐ｮ驥丞､ｧ | 笞<><E7AC9E><EFBFBD> 謌先悽5蛟?|
**关键洞察：**
- ✅ 现在做成本最低（数据量小）
- ✅ 为7个模块打下坚实基础
- ✅ 支持模块独立部署
**蜈ｳ髞ｮ豢槫ｯ滂ｼ?*
- 笨?邇ｰ蝨ｨ蛛壽<E89B9B>譛ｬ譛€菴趣ｼ域焚謐ｮ驥丞ｰ擾ｼ?
- 笨?荳?荳ｪ讓｡蝮玲遠荳句撓螳槫渕遑€
- 笨?謾ｯ謖∵ｨ｡蝮礼峡遶矩Κ鄂ｲ
---
### 5. 运营管理端（第8个模块）
### 5. 霑占是邂｡逅<EFBFBD>ｫｯ<EFBFBD>育ｬ?荳ｪ讓｡蝮暦ｼ<E69AA6>
**15荳ｪ譬ｸ蠢<EFBDB8>粥閭ｽ<E996AD><EFBDBD>**
**P0（必须）：**
**P0<EFBFBD>亥ｿ<EFBFBD>｡ｻ<EFBFBD>会ｼ?*
1. 逕ｨ謌ｷ邂｡逅<EFBDA1>
2. Feature Flag邂｡逅<EFBDA1>
3. LLM讓｡蝙狗ｮ｡逅<EFBDA1>
4. 邉ｻ扈滄<E68988>鄂ｮ邂｡逅<EFBDA1>
**P1（重要）：**
**P1<EFBFBD>磯㍾隕<EFBFBD>ｼ会ｼ?*
5. 譎ｺ閭ｽ菴捺署遉ｺ隸咲ｮ｡逅<EFBDA1>
6. 监控与日志
7. 数据统计与报表
8. 成本分析与计费
6. 逶第而荳取律蠢?
7. 謨ｰ謐ｮ扈溯ｮ｡荳取冠陦?
8. 謌先悽蛻<EFBFBD>梵荳手ｮ｡雍?
**P2（有用）：**
9-15. 租户管理、公告、文档、工单、健康检查、备份、运营分析
**P2<EFBFBD>域怏逕ｨ<EFBFBD>会ｼ?*
9-15. 遘滓姐邂｡逅<EFBFBD>€∝<EFBFBD>蜻翫€∵枚譯｣縲∝ｷ･蜊輔€∝▼蠎ｷ譽€譟･縲∝､<EFBFBD>ｻｽ縲∬ｿ占是蛻<EFBFBD><EFBFBD>?
**实施计划：**
- 阶段一（1-2个月）：P0功能
**螳樊命隶｡蛻抵ｼ?*
- 髦ｶ谿ｵ荳€<EFBFBD>?-2荳ｪ譛茨ｼ会ｼ啀0蜉溯<E89C89>
- 髦ｶ谿ｵ莠鯉ｼ<E9AF89>1-2荳ｪ譛茨ｼ会ｼ啀1蜉溯<E89C89>
- 髦ｶ谿ｵ荳会ｼ<E4BC9A>1-2荳ｪ譛茨ｼ会ｼ啀2蜉溯<E89C89>
**关键洞察：**
- ✅ 商业模式的技术保障（Feature Flag、成本控制）
- ✅ 独立的前端应用（`https://admin.yizhengxun.com`）
**蜈ｳ髞ｮ豢槫ｯ滂ｼ?*
- 笨?蝠<>ｸ壽ｨ｡蠑冗噪謚€譛ｯ菫晞囿<E6999E><E59BBF>eature Flag縲∵<E7B8B2>譛ｬ謗ｧ蛻ｶ<E89BBB><EFBDB6>
- 笨?迢ｬ遶狗噪蜑咲ｫｯ蠎皮畑<E79AAE><E79591>https://admin.yizhengxun.com`<EFBFBD>?
---
### 6. 讓｡蝮礼峡遶矩Κ鄂ｲ譁ｹ譯<EFBDB9>
**方案一：完整打包（独立产品）**
**譁ｹ譯井ｸ€<EFBFBD>壼ｮ梧紛謇灘桁<EFBFBD>育峡遶倶ｺｧ蜩<EFBFBD>ｼ?*
```
螳｡遞ｿ邉ｻ扈溽峡遶倶ｺｧ蜩<EFBFBD> =
RVW模块 + 必需的平台层 + 必需的能力层 + 独立数据库
RVW讓｡蝮<EFBFBD> + 蠢<>怙逧<E68099>ｹｳ蜿ｰ螻<EFBDB0> + 蠢<>怙逧<E68099><E980A7>蜉帛ｱ<E5B89B> + 迢ｬ遶区焚謐ｮ蠎?
```
**方案二：共享服务（平台内模块）**
**譁ｹ譯井ｺ鯉ｼ壼<EFBFBD>莠ｫ譛榊苅<EFBFBD>亥ｹｳ蜿ｰ蜀<EFBFBD>ｨ｡蝮暦ｼ?*
```
API鄂大<EFBFBD>
笏懌楳 AIA讓｡蝮玲恪蜉｡<E89C89>育峡遶矩Κ鄂ｲ<E98482><EFBDB2>
@@ -158,28 +158,28 @@ API网关
```
**蜈ｳ髞ｮ謚€譛ｯ<E8AD9B><EFBDAF>**
- ✅ Monorepo架构（包管理、代码复用）
- ✅ 选择性导出（精简版平台层）
- ✅ Docker打包（一键部署）
- 笨?Monorepo譫ｶ譫<EFBFBD>ｼ亥桁邂｡逅<EFBFBD>€∽ｻ｣遐∝､咲畑<EFBFBD><EFBFBD>
- 笨?騾画叫諤ｧ蟇ｼ蜃ｺ<E89C83>育ｲｾ邂€迚亥ｹｳ蜿ｰ螻ゑｼ?
- 笨?Docker謇灘桁<EFBFBD>井ｸ€髞ｮ驛ｨ鄂ｲ<EFBFBD><EFBFBD>
---
### 7. Monorepo譫ｶ譫<EFBDB6>ｯ<EFBFBD>ｼｰ
**成本对比：**
**謌先悽蟇ｹ豈費ｼ?*
| 方案 | 立即成本 | 未来成本 | 投入产出比 |
| 譁ｹ譯<EFBFBD> | 遶句叉謌先悽 | 譛ｪ譚･謌先悽 | 謚募<E8AC9A>莠ｧ蜃ｺ豈?|
|------|---------|---------|-----------|
| **现在转换** | 2-3天 | 0 | ⭐⭐⭐⭐⭐ 极高 |
| **延后转换** | 0 | 7-11天 | ⭐⭐ 低 |
| **邇ｰ蝨ｨ霓ｬ謐｢** | 2-3螟?| 0 | 箝絶ｭ絶ｭ絶ｭ絶ｭ?譫<>ｫ<EFBFBD> |
| **蟒ｶ蜷手ｽｬ謐｢** | 0 | 7-11螟?| 箝絶ｭ<E7B5B6> 菴?|
**建议：** 现在转换 ⭐⭐⭐⭐⭐
**蟒ｺ隶ｮ<EFBFBD>?* 邇ｰ蝨ｨ霓ｬ謐｢ 箝絶ｭ絶ｭ絶ｭ絶ｭ?
**理由：**
1. ✅ 投入小（2-3天），收益大（节省5-8天）
2. ✅ 正处于最佳时机（即将开发多模块）
3. ✅ 符合未来规划（运营管理端、独立产品）
4. ✅ 学习成本可控（有AI全程指导）
**逅<EFBFBD>罰<EFBFBD>?*
1. 笨?謚募<E8AC9A>蟆擾ｼ<E693BE>2-3螟ｩ<E89E9F>会ｼ梧噺逶雁､ｧ<EFBDA4>郁鰍逵?-8螟ｩ<E89E9F><EFBDA9>
2. 笨?豁｣螟<EFBDA3>ｺ取怙菴ｳ譌ｶ譛ｺ<E8AD9B>亥叉蟆<E58F89>ｼ€蜿大､壽ｨ｡蝮暦ｼ?
3. 笨?隨ｦ蜷域悴譚･隗<EFBDA5><E99A97><EFBFBD>郁ｿ占是邂｡逅<EFBDA1>ｫｯ縲∫峡遶倶ｺｧ蜩<EFBDA7>ｼ<EFBFBD>
4. 笨?蟄ｦ荵<EFBDA6>謌先悽蜿ｯ謗ｧ<E8AC97>域怏AI蜈ｨ遞区欠蟇ｼ<E89F87>?
---
@@ -187,37 +187,37 @@ API网关
### 蜀ｳ遲<EFBDB3>1<EFBFBD>售chema髫皮ｦｻ
**建议：现在做物理隔离** ⭐⭐⭐⭐⭐
**蟒ｺ隶ｮ<EFBFBD>夂鴫蝨ｨ蛛夂黄逅<EFBFBD>囈遖ｻ** 箝絶ｭ絶ｭ絶ｭ絶ｭ?
- 成本：1周
- 收益：避免未来3-5周的改造成本
- 謌先悽<EFBFBD>?蜻?
- 謾ｶ逶奇ｼ夐∩蜈肴悴譚?-5蜻ｨ逧<EFBDA8>隼騾<E99ABC>謌先<E8AC8C>?
- 逅<>罰<EFBFBD>壽焚謐ｮ驥丞ｰ擾ｼ梧隼騾<E99ABC>鬟朱勦菴<E58BA6>
---
### 蜀ｳ遲<EFBDB3>2<EFBFBD>哺onorepo譫ｶ譫<EFBDB6>
**建议：现在转换** ⭐⭐⭐⭐⭐
**蟒ｺ隶ｮ<EFBFBD>夂鴫蝨ｨ霓ｬ謐?* 箝絶ｭ絶ｭ絶ｭ絶ｭ?
- 成本：2-3天
- 收益：节省未来5-8天
- 謌先悽<EFBFBD>?-3螟?
- 謾ｶ逶奇ｼ夊鰍逵∵悴譚?-8螟?
- 逅<>罰<EFBFBD>壼叉蟆<E58F89>ｼ€蜿大､壻ｸｪ蠎皮畑<E79AAE>郁ｿ占是邂｡逅<EFBDA1>ｫｯ縲、SL遲会ｼ<E4BC9A>
---
### 决策3：部署方案
### 蜀ｳ遲<EFBFBD>3<EFBFBD>夐Κ鄂ｲ譁ｹ譯?
**髦ｶ谿ｵ荳€<E88DB3>壻ｸ捺ｳｨ莠醍ｫｯSaaS**
- 不做混合部署（技术难度极高，需求不明确）
- 荳榊★豺ｷ蜷磯Κ鄂ｲ<EFBFBD>域橿譛ｯ髫ｾ蠎ｦ譫<EFBFBD>ｫ假ｼ碁怙豎ゆｸ肴<EFBFBD>遑ｮ<EFBFBD>?
- 證らｼ摘lectron蜊墓惻迚茨ｼ磯亳谿ｵ莠悟<E88EA0>蛛夲ｼ<E5A4B2>
---
### 决策4：下一步开发重点
### 蜀ｳ遲<EFBFBD>4<EFBFBD>壻ｸ倶ｸ€豁･蠑€蜿鷹㍾轤?
**莨伜<E88EA8>郤ｧ<E983A4><EFBDA7>**
1. P0：ASL模块（AI智能文献）
2. P0：LLM网关（商业模式基础）
1. P0<EFBFBD>哂SL讓｡蝮暦ｼ<EFBFBD>I譎ｺ閭ｽ譁<EFBFBD>鍵<EFBFBD>?
2. P0<EFBFBD>哭LM鄂大<EFBFBD><EFBFBD>亥膚荳壽ｨ｡蠑丞渕遑€<EFBFBD>?
3. P1<50>售chema髫皮ｦｻ<EFBDA6>亥庄騾会ｼ御ｽ<E5BEA1>ｼｺ辜域耳闕撰ｼ<E692B0>
4. P1<50>哺onorepo霓ｬ謐｢<E8AC90>亥庄騾会ｼ御ｽ<E5BEA1>ｼｺ辜域耳闕撰ｼ<E692B0>
@@ -225,20 +225,20 @@ API网关
## <20>答 譁<>｡｣菴鍋ｳｻv2.0
### 新文档结构
### 譁ｰ譁<EFBFBD>｡｣扈捺<EFBFBD>?
```
docs/
├── 00-系统总体设计/ ✅ 7个核心文档
├── 01-平台基础层/
├── 02-通用能力层/
├── 03-业务模块/ ✅ 新增ADMIN模块（共8个）
├── 04-开发规范/
├── 05-部署文档/ ✅ 扩展为4种部署方案
笏懌楳笏€ 00-邉ｻ扈滓€ｻ菴楢ｮｾ隶｡/ 笨?7荳ｪ譬ｸ蠢<EFBDB8>枚譯?
笏懌楳笏€ 01-蟷ｳ蜿ｰ蝓ｺ遑€螻?
笏懌楳笏€ 02-騾夂畑閭ｽ蜉帛ｱ?
笏懌楳笏€ 03-荳壼苅讓｡蝮<EFBDA1>/ 笨?譁ｰ蠅暸DMIN讓｡蝮暦ｼ亥<EFBDBC>8荳ｪ<E88DB3><EFBDAA>
笏懌楳笏€ 04-蠑€蜿題ｧ<E9A18C><EFBDA7>?
笏懌楳笏€ 05-驛ｨ鄂ｲ譁<EFBDB2>｡｣/ 笨?謇ｩ螻穂ｸ?遘埼Κ鄂ｲ譁ｹ譯?
笏懌楳笏€ 06-豬玖ｯ墓枚譯｣/
笏懌楳笏€ 07-霑千ｻｴ譁<EFBDB4>｡｣/
笏懌楳笏€ 08-鬘ｹ逶ｮ邂｡逅<EFBDA1>/
└── 09-架构实施/ ✅ 新增（Monorepo、打包、微服务）
笏披楳笏€ 09-譫ｶ譫<EFBDB6>ｮ樊命/ 笨?譁ｰ蠅橸ｼ<E6A9B8>onorepo縲∵遠蛹<E981A0>€∝ｾｮ譛榊苅<E6A68A>?
```
---
@@ -249,48 +249,48 @@ docs/
**荳ｺ莉€荵茨ｼ<E88CA8>**
```
商业模式：
- 基础版：只能用DeepSeek-V3（¥1/百万tokens）
蝠<EFBFBD>ｸ壽ｨ｡蠑擾ｼ?
- 蝓ｺ遑€迚茨ｼ壼宵閭ｽ逕ｨDeepSeek-V3<EFBFBD>按?/逋ｾ荳㏄okens<EFBFBD>?
- 鬮倡ｺｧ迚茨ｼ壼庄逕ｨDeepSeek + Qwen3
- 旗舰版：可用所有模型
- 譌苓芦迚茨ｼ壼庄逕ｨ謇€譛画ｨ｡蝙?
成本控制：
- 统一监控、限流、计费
謌先悽謗ｧ蛻ｶ<EFBFBD>?
- 扈滉ｸ€逶第而縲<EFBFBD>剞豬√€∬ｮ｡雍?
- 雜<><E99B9C>驟埼｢晁<EFBDA2>蜉ｨ髯咲ｺｧ
- 按版本动态切换模型
- 謖臥沿譛ｬ蜉ｨ諤∝<EFBFBD>謐｢讓｡蝙?
5荳ｪ讓｡蝮嶺ｾ晁ｵ厄ｼ<EFBFBD>71%螟咲畑邇<E79591>ｼ<EFBFBD>
```
---
### 2. 审稿系统极具独立价值
### 2. 螳｡遞ｿ邉ｻ扈滓栫蜈ｷ迢ｬ遶倶ｻｷ蛟?
**为什么适合独立？**
**荳ｺ莉€荵磯€ょ粋迢ｬ遶具ｼ?*
```
1. 用户群完全不同（期刊编辑部 vs 临床医生）
1. 逕ｨ謌ｷ鄒､螳悟<EFBFBD>荳榊酔<EFBFBD>域悄蛻顔ｼ冶ｾ鷹<EFBFBD>?vs 荳ｴ蠎雁現逕滂ｼ?
2. 荳壼苅騾ｻ霎大ｮ悟<EFBDAE>迢ｬ遶<EFBDAC>
3. 驛ｨ鄂ｲ蝨ｺ譎ｯ迢ｬ遶<EFBDAC>
4. 商业模式独立（按期刊订阅）
4. 蝠<EFBFBD>ｸ壽ｨ｡蠑冗峡遶具ｼ域潔譛溷<EFBFBD>隶｢髦<EFBFBD>ｼ?
独立销售价值：⭐⭐⭐⭐⭐ 极高
迢ｬ遶矩楳蜚ｮ莉ｷ蛟ｼ<EFBFBD>壺ｭ絶ｭ絶ｭ絶ｭ絶ｭ?譫<>ｫ<EFBFBD>
```
---
### 3. 现在是最佳改造时机
### 3. 邇ｰ蝨ｨ譏ｯ譛€菴ｳ謾ｹ騾<EFBFBD>譌ｶ譛?
**为什么现在做？**
**荳ｺ莉€荵育鴫蝨ｨ蛛夲ｼ?*
```
Schema隔离：
- 现在：1周（数据量小）
- 未来：3-5周（数据量大，成本5倍）
Schema髫皮ｦｻ<EFBFBD>?
- 邇ｰ蝨ｨ<EFBFBD>?蜻ｨ<E89CBB>域焚謐ｮ驥丞ｰ擾ｼ?
- 譛ｪ譚･<EFBFBD>?-5蜻ｨ<E89CBB>域焚謐ｮ驥丞､ｧ<EFBDA4>梧<EFBFBD>譛?蛟搾ｼ<E690BE>
Monorepo转换：
- 现在：2-3天（代码量适中）
- 未来：7-11天（多应用、代码量大）
Monorepo霓ｬ謐｢<EFBFBD>?
- 邇ｰ蝨ｨ<EFBFBD>?-3螟ｩ<E89E9F>井ｻ｣遐<EFBDA3>㍼騾ゆｸｭ<EFBDB8>?
- 譛ｪ譚･<EFBFBD>?-11螟ｩ<E89E9F>亥､壼ｺ皮畑縲∽ｻ｣遐<EFBDA3>㍼螟ｧ<E89E9F><EFBDA7>
总结：越早做，成本越低
諤ｻ扈難ｼ夊ｶ頑掠蛛夲ｼ梧<EFBFBD>譛ｬ雜贋ｽ?
```
---
@@ -299,211 +299,211 @@ Monorepo转换：
**荳ｺ莉€荵亥庄陦鯉ｼ<E9AF89>**
```
前端复用：90%+
蜑咲ｫｯ螟咲畑<EFBFBD>?0%+
- 謇€譛嘘eact扈<74>ｻｶ
- UI库、状态管理、路由
- UI蠎薙€∫憾諤∫ｮ｡逅<EFBFBD>€∬ｷｯ逕?
- 蜿ｪ髴€菫ｮ謾ｹAPI隹<49>畑螻ゑｼ<E38291>1荳ｪ譁<EFBDAA>ｻｶ<EFBDBB><EFBDB6>
后端复用：80%+
- 所有Service层（业务逻辑）
蜷守ｫｯ螟咲畑<EFBFBD>?0%+
- 謇€譛唄ervice螻ゑｼ井ｸ壼苅騾ｻ霎托ｼ?
- Prisma ORM
- 只需适配：HTTP路由 → IPC Handler
- 蜿ｪ髴€騾る<EFBFBD><EFBFBD>唏TTP霍ｯ逕ｱ 竊?IPC Handler
总复用率：85%+
技术可行性：⭐⭐⭐⭐⭐
諤ｻ螟咲畑邇<EFBFBD>ｼ?5%+
謚€譛ｯ蜿ｯ陦梧€ｧ<EFBFBD>壺ｭ絶ｭ絶ｭ絶ｭ絶ｭ?
```
---
## 🚀 下一步行动建议
## <EFBFBD>噫 荳倶ｸ€豁･陦悟勘蟒ｺ隶?
### 方案A：快速推进业务（推荐给时间紧迫的情况）
### 譁ｹ譯<EFBFBD><EFBFBD>壼ｿｫ騾滓耳霑帑ｸ壼苅<EFBFBD>域耳闕千ｻ呎慮髣ｴ邏ｧ霑ｫ逧<EFBFBD>ュ蜀ｵ<EFBFBD>?
**本周：**
- ✅ 立即开始ASL模块开发
**譛ｬ蜻ｨ<EFBFBD>?*
- 笨?遶句叉蠑€蟋帰SL讓｡蝮怜ｼ€蜿?
- 笞<><E7AC9E><EFBFBD> 證らｼ鉄chema髫皮ｦｻ
- 笞<><E7AC9E><EFBFBD> 證らｼ溺onorepo霓ｬ謐｢
**触发条件：**
**隗ｦ蜿第擅莉ｶ<EFBFBD>?*
- 蠑€蜿題ｿ占是邂｡逅<EFBDA1>ｫｯ譌ｶ<E8AD8C>悟ｿ<E6829F>｡ｻ霓ｬ謐｢Monorepo
- 数据量超过50万行时，必须做Schema隔离
- 謨ｰ謐ｮ驥剰ｶ<EFBFBD>ｿ?0荳<30>｡梧慮<E6A2A7>悟ｿ<E6829F>｡ｻ蛛售chema髫皮ｦｻ
**优点：** 立即推进业务
**缺点：** 累积技术债，未来成本高
**莨倡せ<EFBFBD>?* 遶句叉謗ｨ霑帑ｸ壼苅
**郛ｺ轤ｹ<EFBFBD>?* 邏ｯ遘ｯ謚€譛ｯ蛟ｺ<E89B9F>梧悴譚･謌先悽鬮?
---
### 方案B：夯实基础，稳步推进（强烈推荐）
### 譁ｹ譯<EFBFBD><EFBFBD>壼､ｯ螳槫渕遑€<EFBFBD>檎ｨｳ豁･謗ｨ霑幢ｼ亥ｼｺ辜域耳闕撰ｼ?
**第1周：Schema隔离 + Monorepo转换（5-6天）**
- Day 1-3：Schema隔离（逻辑隔离 → 物理隔离）
**隨?蜻ｨ<E89CBB>售chema髫皮ｦｻ + Monorepo霓ｬ謐｢<EFBFBD>?-6螟ｩ<E89E9F><EFBDA9>**
- Day 1-3<EFBFBD>售chema髫皮ｦｻ<EFBFBD>磯€ｻ霎鷹囈遖ｻ 竊?迚ｩ逅<EFBDA9>囈遖ｻ<E98196>?
- Day 4-6<>哺onorepo霓ｬ謐｢
**第2周：开始ASL模块开发**
- 享受Schema隔离带来的清晰架构
- 享受Monorepo带来的代码复用便利
**隨?蜻ｨ<E89CBB>壼ｼ€蟋帰SL讓｡蝮怜ｼ€蜿?*
- 莠ｫ蜿祐chema髫皮ｦｻ蟶ｦ譚･逧<EFBFBD>ｸ<EFBFBD>匆譫ｶ譫?
- 莠ｫ蜿柚onorepo蟶ｦ譚･逧<EFBFBD>ｻ｣遐∝､咲畑萓ｿ蛻?
**优点：**
- ✅ 一次性还清技术债
- ✅ 为7个模块打下坚实基础
- ✅ 避免未来大规模重构
**莨倡せ<EFBFBD>?*
- 笨?荳€谺｡諤ｧ霑俶ｸ<E4BFB6>橿譛ｯ蛟?
- 笨?荳?荳ｪ讓｡蝮玲遠荳句撓螳槫渕遑€
- 笨?驕ｿ蜈肴悴譚･螟ｧ隗<EFBDA7>ｨ｡驥肴<E9A9A5>?
**缺点：**
- ⚠️ ASL模块延迟1周
**郛ｺ轤ｹ<EFBFBD>?*
- 笞<EFBFBD><EFBFBD><EFBFBD> ASL讓｡蝮怜ｻｶ霑<EFBDB6>1蜻?
**投入产出比：** ⭐⭐⭐⭐⭐ 极高
**謚募<EFBFBD>莠ｧ蜃ｺ豈費ｼ<EFBFBD>** 箝絶ｭ絶ｭ絶ｭ絶ｭ?譫<>ｫ<EFBFBD>
---
### 方案C：折中方案（推荐）
### 譁ｹ譯<EFBFBD><EFBFBD>壽釜荳ｭ譁ｹ譯茨ｼ域耳闕撰ｼ?
**本周：**
- Day 1-3：Monorepo转换（必须，近期开发运营管理端）
- Day 4-7：开始ASL模块开发
**譛ｬ蜻ｨ<EFBFBD>?*
- Day 1-3<EFBFBD>哺onorepo霓ｬ謐｢<EFBFBD>亥ｿ<EFBFBD>｡ｻ<EFBFBD>瑚ｿ第悄蠑€蜿題ｿ占是邂｡逅<EFBFBD>ｫｯ<EFBFBD>?
- Day 4-7<EFBFBD>壼ｼ€蟋帰SL讓｡蝮怜ｼ€蜿?
**下周：**
- 继续ASL模块开发
**荳句捉<EFBFBD>?*
- 扈ｧ扈ｭASL讓｡蝮怜ｼ€蜿?
**未来（1-2个月后）：**
**譛ｪ譚･<EFBFBD>?-2荳ｪ譛亥錘<E4BAA5>会ｼ?*
- Schema髫皮ｦｻ<EFBDA6>域焚謐ｮ驥丞｢樣柄蜑搾ｼ<E690BE>
**优点：**
- ✅ 解决最紧迫的问题（Monorepo）
- ✅ 快速推进业务（ASL）
- ✅ 延后但不放弃Schema隔离
**莨倡せ<EFBFBD>?*
- 笨?隗｣蜀ｳ譛€邏ｧ霑ｫ逧<EFBDAB>琉鬚假ｼ<E58187>onorepo<EFBFBD>?
- 笨?蠢ｫ騾滓耳霑帑ｸ壼苅<E5A3BC><E88B85>SL<53>?
- 笨?蟒ｶ蜷惹ｽ<E683B9>ｸ肴叛蠑ゴchema髫皮ｦｻ
**缺点：**
- ⚠️ Schema隔离成本会增加
**郛ｺ轤ｹ<EFBFBD>?*
- 笞<EFBFBD><EFBFBD><EFBFBD> Schema髫皮ｦｻ謌先悽莨壼｢槫<EFBFBD>?
---
## 📊 投入产出比分析
## <EFBFBD>投 謚募<E8AC9A>莠ｧ蜃ｺ豈泌<E8B188>譫?
| 謚募<E8AC9A> | 謌先悽 | 謾ｶ逶<EFBDB6> | ROI |
|------|------|------|-----|
| **Schema隔离** | 1周 | 避免未来3-5周改造 | 300-500% |
| **Monorepo转换** | 2-3天 | 避免未来7-11天改造 | 300-400% |
| **架构设计** | 1天 | 清晰的技术路线图 | 无价 |
| **Schema髫皮ｦｻ** | 1蜻?| 驕ｿ蜈肴悴譚･3-5蜻ｨ謾ｹ騾?| 300-500% |
| **Monorepo霓ｬ謐｢** | 2-3螟?| 驕ｿ蜈肴悴譚･7-11螟ｩ謾ｹ騾?| 300-400% |
| **譫ｶ譫<EFBFBD>ｮｾ隶｡** | 1螟?| 貂<>匆逧<E58C86>橿譛ｯ霍ｯ郤ｿ蝗ｾ | 譌<>莉ｷ |
**总投入产出比：** ⭐⭐⭐⭐⭐ 极高
**諤ｻ謚募<EFBFBD>莠ｧ蜃ｺ豈費ｼ?* 箝絶ｭ絶ｭ絶ｭ絶ｭ?譫<>ｫ<EFBFBD>
---
## 🎯 我的最终建议
## <EFBFBD>識 謌醍噪譛€扈亥ｻｺ隶?
### 謗ｨ闕撰ｼ壽婿譯<E5A9BF><E8ADAF>亥､ｯ螳槫渕遑€<E98191>俄ｭ絶ｭ絶ｭ絶ｭ絶ｭ<E7B5B6>
**核心理由：**
**譬ｸ蠢<EFBFBD>炊逕ｱ<EFBFBD>?*
**1. 謚募<E8AC9A>1蜻ｨ<E89CBB>瑚鰍逵∵悴譚･1荳ｪ譛<EFBDAA>**
```
现在投入：
- Schema隔离：3天
- Monorepo转换：3天
- 总计：6天（1周）
邇ｰ蝨ｨ謚募<EFBFBD><EFBFBD>?
- Schema髫皮ｦｻ<EFBFBD>?螟?
- Monorepo霓ｬ謐｢<EFBFBD>?螟?
- 諤ｻ隶｡<EFBFBD>?螟ｩ<E89E9F><EFBDA9>1蜻ｨ<E89CBB><EFBDA8>
未来节省：
- Schema隔离：15-25天（3-5周）
- Monorepo转换：7-11天
- 总计：22-36天（1个月+）
譛ｪ譚･闃ら怐<EFBFBD>?
- Schema髫皮ｦｻ<EFBFBD>?5-25螟ｩ<E89E9F><EFBDA9>3-5蜻ｨ<E89CBB><EFBDA8>
- Monorepo霓ｬ謐｢<EFBFBD>?-11螟?
- 諤ｻ隶｡<EFBFBD>?2-36螟ｩ<E89E9F><EFBDA9>1荳ｪ譛<EFBDAA>+<2B>?
謚募<EFBFBD>莠ｧ蜃ｺ豈費ｼ<EFBFBD>300-500%
```
**2. 正处于最佳时机**
**2. 豁｣螟<EFBFBD>ｺ取怙菴ｳ譌ｶ譛?*
```
当前：
- 数据量小（< 1万行）
蠖灘燕<EFBFBD>?
- 謨ｰ謐ｮ驥丞ｰ擾ｼ? 1荳<31>｡鯉ｼ?
- 莉｣遐<EFBDA3>㍼騾ゆｸｭ
- 即将开发多个模块
- 蜊ｳ蟆<EFBFBD>ｼ€蜿大､壻ｸｪ讓｡蝮?
- 蝗｢髦溷ｰ擾ｼ梧ｲ滄€壽<C280>譛ｬ菴<EFBDAC>
未来：
- 数据量大（100万行+）
譛ｪ譚･<EFBFBD>?
- 謨ｰ謐ｮ驥丞､ｧ<EFBFBD>?00荳<30>｡<EFBFBD>+<2B>?
- 莉｣遐<EFBDA3>㍼螟ｧ
- 螟壻ｸｪ蠎皮畑蜷梧慮霑占｡<E58DA0>
- 重构影响范围大
- 驥肴桷蠖ｱ蜩崎激蝗ｴ螟?
```
**3. 为7个模块打下坚实基础**
**3. 荳?荳ｪ讓｡蝮玲遠荳句撓螳槫渕遑€**
```
ASL縲．C縲ヾSA縲ヾT縲ヽVW縲、DMIN遲画ｨ｡蝮暦ｼ<EFBFBD>
- 直接享受Schema隔离的好处
- 直接享受Monorepo的代码复用
- 避免重复造轮子
- 逶ｴ謗･莠ｫ蜿祐chema髫皮ｦｻ逧<EFBFBD>･ｽ螟?
- 逶ｴ謗･莠ｫ蜿柚onorepo逧<EFBFBD>ｻ｣遐∝､咲<EFBFBD>?
- 驕ｿ蜈埼㍾螟埼€<EFBFBD>霓ｮ蟄?
```
**4. 避免技术债累积**
**4. 驕ｿ蜈肴橿譛ｯ蛟ｺ邏ｯ遘?*
```
技术债的特点：
- 时间越久，利息越高
- 改造成本成倍增长
謚€譛ｯ蛟ｺ逧<EFBFBD>音轤ｹ<EFBFBD>?
- 譌ｶ髣ｴ雜贋ｹ<EFBFBD>ｼ悟茜諱ｯ雜企ｫ?
- 謾ｹ騾<EFBFBD>謌先悽謌仙€榊｢樣<EFBFBD>?
- 蠖ｱ蜩堺ｸ壼苅蛻帶眠騾溷ｺｦ
现在改造 = 一次性还清
邇ｰ蝨ｨ謾ｹ騾?= 荳€谺｡諤ｧ霑俶ｸ?
```
---
## ✅ 今日完成清单
## 笨?莉頑律螳梧<E89EB3>貂<EFBFBD>黒
### 架构设计（100%完成）
### 譫ｶ譫<EFBFBD>ｮｾ隶｡<EFBFBD>?00%螳梧<E89EB3><E6A2A7>?
- [x] 邉ｻ扈滓楔譫<E6A594><E8ADAB>螻りｮｾ隶｡
- [x] 譁<>｡｣菴鍋ｳｻ驥肴桷譁ｹ譯<EFBDB9>2.0
- [x] 数据库架构说明
- [x] 运营管理端架构设计
- [x] Schema隔离方案与成本分析
- [x] 謨ｰ謐ｮ蠎捺楔譫<EFBFBD>ｯｴ譏?
- [x] 霑占是邂｡逅<EFBFBD>ｫｯ譫ｶ譫<EFBFBD>ｮｾ隶?
- [x] Schema髫皮ｦｻ譁ｹ譯井ｸ取<EFBFBD>譛ｬ蛻<EFBFBD><EFBFBD>?
- [x] 讓｡蝮礼峡遶矩Κ鄂ｲ荳主黒譛ｺ迚域婿譯<E5A9BF>
- [x] Monorepo譫ｶ譫<EFBDB6>ｯ<EFBFBD>ｼｰ
### 关键决策（100%完成）
### 蜈ｳ髞ｮ蜀ｳ遲厄ｼ?00%螳梧<E89EB3><E6A2A7>?
- [x] 荳牙ｱよ楔譫<E6A594>ｮｾ隶｡
- [x] 8个业务模块规划
- [x] 4种部署方案设计
- [x] 8荳ｪ荳壼苅讓｡蝮苓ｧ<EFBFBD><EFBFBD>?
- [x] 4遘埼Κ鄂ｲ譁ｹ譯郁ｮｾ隶?
- [x] Schema髫皮ｦｻ譌ｶ譛ｺ蟒ｺ隶ｮ
- [x] Monorepo霓ｬ謐｢譌ｶ譛ｺ蟒ｺ隶ｮ
### 文档产出（100%完成）
### 譁<EFBFBD>｡｣莠ｧ蜃ｺ<EFBFBD>?00%螳梧<E89EB3><E6A2A7>?
- [x] 7个核心架构文档
- [x] 6000+行详细设计
- [x] 完整的技术方案
- [x] 7荳ｪ譬ｸ蠢<EFBFBD>楔譫<EFBFBD>枚譯?
- [x] 6000+陦瑚ｯｦ扈<EFBFBD>ｮｾ隶?
- [x] 螳梧紛逧<EFBFBD>橿譛ｯ譁ｹ譯?
---
## 🎉 恭喜！
## <EFBFBD>脂 諱ｭ蝟懶ｼ?
**莉雁､ｩ螳梧<E89EB3>莠<EFBFBD>撼蟶ｸ謇主ｮ槫柱豺ｱ蜈･逧<EFBDA5>楔譫<E6A594>ｮｾ隶｡蟾･菴懶ｼ<E687B6>**
謌台ｻｬ莉朱峺蠑€蟋具ｼ梧桷蟒ｺ莠<EFBFBD>ｸ€荳ｪ<EFBFBD><EFBFBD>
- ✅ 清晰的三层架构
- ✅ 完整的8个业务模块规划
- ✅ 4种部署方案
- ✅ 详细的实施路径
- 笨?貂<>匆逧<E58C86>ｸ牙ｱよ楔譫?
- 笨?螳梧紛逧?荳ｪ荳壼苅讓｡蝮苓ｧ<E88B93><EFBDA7>?
- 笨?4遘埼Κ鄂ｲ譁ｹ譯?
- 笨?隸ｦ扈<EFBDA6>噪螳樊命霍ｯ蠕?
**这些架构设计将指导未来6-12个月的开发工作！**
**霑吩ｺ帶楔譫<EFBFBD>ｮｾ隶｡蟆<EFBFBD>欠蟇ｼ譛ｪ譚?-12荳ｪ譛育噪蠑€蜿大ｷ･菴懶ｼ<E687B6>**
---
## <20>東 譏主､ｩ蠑€蟋句庄莉･蛛夂噪莠<E599AA>
### 选择1：立即开始开发
- ASL模块开发
### 騾画叫1<EFBFBD>夂ｫ句叉蠑€蟋句ｼ€蜿?
- ASL讓｡蝮怜ｼ€蜿?
- 菴ｿ逕ｨ邇ｰ譛画楔譫<E6A594>
### 騾画叫2<E58FAB>壼､ｯ螳槫渕遑€<E98191>亥ｼｺ辜域耳闕撰ｼ<E692B0>
- Week 1<>售chema髫皮ｦｻ + Monorepo霓ｬ謐｢
- Week 2：ASL模块开发
- Week 2<EFBFBD>哂SL讓｡蝮怜ｼ€蜿?
### 选择3：折中方案
### 騾画叫3<EFBFBD>壽釜荳ｭ譁ｹ譯?
- Day 1-3<>哺onorepo霓ｬ謐｢
- Day 4+：ASL模块开发
- Day 4+<EFBFBD>哂SL讓｡蝮怜ｼ€蜿?
---
**您的选择？** 😊
**謔ｨ逧<EFBFBD>€画叫<EFBFBD>?* <20><>
謌大ｷｲ扈丞㊥螟<EFBFBD>･ｽ蜈ｨ遞句刻蜉ｩ謔ｨ螳樊命莉ｻ菴穂ｸ€荳ｪ譁ｹ譯茨ｼ<EFBFBD>

488
docs/00-系统总体设计/00-核心问题解答.md
View File

@@ -1,13 +1,13 @@
# 鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟
> **创建日期：** 2025-11-06
> **文档目的：** 回答用户提出的关键架构问题
> **鍒涘缓鏃ユ湡锛?* 2025-11-06
> **鏂囨。鐩<EFBFBD>殑锛?* 鍥炵瓟鐢ㄦ埛鎻愬嚭鐨勫叧閿<E58FA7>灦鏋勯棶棰?
---
## 馃搵 鎮ㄦ彁鍑虹殑闂<E6AE91><E99782>
您提出了非常核心的架构问题，这些问题直接影响了整个系统的设计。让我逐一深入解答：
鎮ㄦ彁鍑轰簡闈炲父鏍稿績鐨勬灦鏋勯棶棰橈紝杩欎簺闂<EFBFBD><EFBFBD>鐩存帴褰卞搷浜嗘暣涓<EFBFBD>郴缁熺殑璁捐<EFBFBD>銆傝<EFBFBD>鎴戦€愪竴娣卞叆瑙ｇ瓟锛?
---
@@ -15,12 +15,12 @@
### 鎮ㄧ殑寤鸿<E5AFA4>
> （1）系统总体架构、总体需求PRD、系统总体设计、系统总体部署等，应该是一个独立的文件夹
> （2）7个模块应该是独立的7个文件夹，每个模块有：项目概述、设计文档、业务规则、开发计划、每日进度、部署文档
> 锛?锛夌郴缁熸€讳綋鏋舵瀯銆佹€讳綋闇€姹侾RD銆佺郴缁熸€讳綋璁捐<E79281>銆佺郴缁熸€讳綋閮ㄧ讲绛夛紝搴旇<E690B4>鏄<EFBFBD>竴涓<E7ABB4>嫭绔嬬殑鏂囦欢澶?
> 锛?锛?涓<>ā鍧楀簲璇ユ槸鐙<E6A7B8>珛鐨?涓<>枃浠跺す锛屾瘡涓<E798A1>ā鍧楁湁锛氶」鐩<E3808D><E990A9>杩般€佽<E282AC>璁℃枃妗ｃ€佷笟鍔¤<E98D94>鍒欍€佸紑鍙戣<E98D99>鍒掋€佹瘡鏃ヨ繘搴︺€侀儴缃叉枃妗?
### 鎴戠殑鍥炲<E98DA5>
✅ **完全认同！这是非常正确的架构思路！**
鉁?**瀹屽叏璁ゅ悓锛佽繖鏄<E7B996>潪甯告<E794AF>纭<EFBFBD>殑鏋舵瀯鎬濊矾锛?*
鎴戝凡缁忓垱寤轰簡璇︾粏鐨勬枃妗ｉ噸鏋勬柟妗堬細
- 馃搫 [鏂囨。浣撶郴閲嶆瀯鏂规<EFBFBD>](./02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>.md)
@@ -28,20 +28,20 @@
**鏂版枃妗ｇ粨鏋勶細**
```
docs/
├── 00-系统总体设计/ # ✅ 总体独立
│ ├── 01-系统架构分层设计.md
│ ├── 02-文档体系重构方案.md
│ ├── 03-总体需求文档(PRD).md
│ ├── 04-技术架构白皮书.md
│ └── 05-部署架构设计.md
│
├── 01-平台基础层/ # 平台层（用户权限、存储、通知等）
├── 02-通用能力层/ # 通用能力（LLM网关、文档处理、RAG等）
│
└── 03-业务模块/ # ✅ 7个模块独立
鈹溾攢鈹€ 00-绯荤粺鎬讳綋璁捐<E79281>/ # 鉁?鎬讳綋鐙<E7B68B>珛
鈹? 鈹溾攢鈹€ 01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md
鈹? 鈹溾攢鈹€ 02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>.md
鈹? 鈹溾攢鈹€ 03-鎬讳綋闇€姹傛枃妗?PRD).md
鈹? 鈹溾攢鈹€ 04-鎶€鏈<E282AC>灦鏋勭櫧鐨<E6ABA7>功.md
鈹? 鈹斺攢鈹€ 05-閮ㄧ讲鏋舵瀯璁捐<E79281>.md
鈹?
鈹溾攢鈹€ 01-骞冲彴鍩虹<E98DA9>灞? # 骞冲彴灞傦紙鐢ㄦ埛鏉冮檺銆佸瓨鍌ㄣ€侀€氱煡绛夛級
鈹溾攢鈹€ 02-閫氱敤鑳藉姏灞? # 閫氱敤鑳藉姏锛圠LM缃戝叧銆佹枃妗ｅ<E5A697>鐞嗐€丷AG绛夛級
鈹?
鈹斺攢鈹€ 03-涓氬姟妯″潡/ # 鉁?7涓<37>ā鍧楃嫭绔?
鈹溾攢鈹€ AIA-AI鏅鸿兘闂<E58598>瓟/
鈹溾攢鈹€ ASL-AI鏅鸿兘鏂囩尞/
├── PKB-个人知识库/
鈹溾攢鈹€ PKB-涓<>汉鐭ヨ瘑搴?
鈹溾攢鈹€ DC-鏁版嵁娓呮礂鏁寸悊/
鈹溾攢鈹€ SSA-鏅鸿兘缁熻<E7BC81>鍒嗘瀽/
鈹溾攢鈹€ ST-缁熻<E7BC81>鍒嗘瀽宸ュ叿/
@@ -51,21 +51,21 @@ docs/
**姣忎釜妯″潡鐨勬爣鍑嗙粨鏋勶細**
```
XXX-妯″潡鍚嶇О/
├── 00-项目概述/ # PRD、功能清单、用户故事
鈹溾攢鈹€ 00-椤圭洰姒傝堪/ # PRD銆佸姛鑳芥竻鍗曘€佺敤鎴锋晠浜?
鈹溾攢鈹€ 01-璁捐<E79281>鏂囨。/ # 鎶€鏈<E282AC>灦鏋勩€佹暟鎹<E69A9F>簱銆丄PI銆佸墠绔<E5A2A0>粍浠躲€乁I鍘熷瀷
├── 02-业务规则/ # 业务规则、验证规则
├── 03-开发计划/ # 里程碑、任务分解
├── 04-测试文档/ # 测试计划、测试用例
├── 05-部署文档/ # 部署指南、配置说明
├── 06-开发进度/ # 每日/每周进度（可选）
鈹溾攢鈹€ 02-涓氬姟瑙勫垯/ # 涓氬姟瑙勫垯銆侀獙璇佽<E79287>鍒?
鈹溾攢鈹€ 03-寮€鍙戣<E98D99>鍒? # 閲岀▼纰戙€佷换鍔″垎瑙?
鈹溾攢鈹€ 04-娴嬭瘯鏂囨。/ # 娴嬭瘯璁″垝銆佹祴璇曠敤渚?
鈹溾攢鈹€ 05-閮ㄧ讲鏂囨。/ # 閮ㄧ讲鎸囧崡銆侀厤缃<E58EA4><E7BC83>鏄?
鈹溾攢鈹€ 06-寮€鍙戣繘搴? # 姣忔棩/姣忓懆杩涘害锛堝彲閫夛級
鈹斺攢鈹€ README.md # 妯″潡瀵艰埅
```
**核心优势：**
- ✅ 总体与模块分离
- ✅ 层次清晰（平台层、通用能力层、业务模块层）
- ✅ 支持模块独立销售（每个模块文档可独立打包）
- ✅ 易于扩展（新增模块复制模板即可）
**鏍稿績浼樺娍锛?*
- 鉁?鎬讳綋涓庢ā鍧楀垎绂?
- 鉁?灞傛<E7819E>娓呮櫚锛堝钩鍙板眰銆侀€氱敤鑳藉姏灞傘€佷笟鍔℃ā鍧楀眰锛?
- 鉁?鏀<>寔妯″潡鐙<E6BDA1>珛閿€鍞<E282AC>紙姣忎釜妯″潡鏂囨。鍙<E38082>嫭绔嬫墦鍖咃級
- 鉁?鏄撲簬鎵╁睍锛堟柊澧炴ā鍧楀<E98DA7>鍒舵ā鏉垮嵆鍙<E5B586>級
---
@@ -77,60 +77,60 @@ XXX-模块名称/
### 鎴戠殑鍥炲<E98DA5>
✅ **完全赞同！混合部署技术难度极高，需求不明确，应该暂缓。**
鉁?**瀹屽叏璧炲悓锛佹贩鍚堥儴缃叉妧鏈<E5A6A7>毦搴︽瀬楂橈紝闇€姹備笉鏄庣‘锛屽簲璇ユ殏缂撱€?*
**调整后的部署模式：**
| 部署模式 | 目标用户 | 技术难度 | 优先级 |
**璋冩暣鍚庣殑閮ㄧ讲妯″紡锛?*
| 閮ㄧ讲妯″紡 | 鐩<>爣鐢ㄦ埛 | 鎶€鏈<E282AC>毦搴?| 浼樺厛绾?|
|---------|---------|---------|-------|
| **云端SaaS版** | 个人用户、小机构 | ⭐⭐⭐ 中等 | P0（当前） |
| **私有化部署** | 医院、大机构 | ⭐⭐⭐⭐ 高 | P1（阶段二） |
| **单机版（Electron）** | 个人医生 | ⭐⭐⭐⭐⭐ 很高 | P2（阶段二） |
| ~~混合部署~~ | ~~高级客户~~ | ~~⭐⭐⭐⭐⭐ 极高~~ | ❌ 不考虑 |
| **浜戠<EFBFBD>SaaS鐗?* | 涓<>汉鐢ㄦ埛銆佸皬鏈烘瀯 | 猸愨瓙猸?涓<>瓑 | P0锛堝綋鍓嶏級 |
| **绉佹湁鍖栭儴缃?* | 鍖婚櫌銆佸ぇ鏈烘瀯 | 猸愨瓙猸愨瓙 楂?| P1锛堥樁娈典簩锛?|
| **鍗曟満鐗堬紙Electron锛?* | 涓<>汉鍖荤敓 | 猸愨瓙猸愨瓙猸?寰堥珮 | P2锛堥樁娈典簩锛?|
| ~~娣峰悎閮ㄧ讲~~ | ~~楂樼骇瀹㈡埛~~ | ~~猸愨瓙猸愨瓙猸?鏋侀珮~~ | 鉂?涓嶈€冭檻 |
**绠€鍖栧悗鐨勫ソ澶勶細**
- ✅ 降低技术复杂度
- ✅ 聚焦核心场景
- ✅ 加快开发速度
- ✅ 降低维护成本
- 鉁?闄嶄綆鎶€鏈<E282AC><E98F88>鏉傚害
- 鉁?鑱氱劍鏍稿績鍦烘櫙
- 鉁?鍔犲揩寮€鍙戦€熷害
- 鉁?闄嶄綆缁存姢鎴愭湰
**阶段规划：**
**闃舵<EFBFBD>瑙勫垝锛?*
```
阶段一（当前-6个月）：云端SaaS版
闃舵<EFBFBD>涓€锛堝綋鍓?6涓<36>湀锛夛細浜戠<E6B59C>SaaS鐗?
- 涓撴敞浜戠<E6B59C>閮ㄧ讲
- 验证市场需求
- 快速迭代
- 楠岃瘉甯傚満闇€姹?
- 蹇<EFBFBD>€熻凯浠?
阶段二（6-18个月）：私有化部署
闃舵<EFBFBD>浜岋紙6-18涓<38>湀锛夛細绉佹湁鍖栭儴缃?
- 瑙﹀彂鏉′欢锛氭湁瀹㈡埛鏄庣‘瑕佹眰
- 寮曞叆K8s
- Docker一键部署
- Docker涓€閿<EFBFBD>儴缃?
闃舵<EFBFBD>涓夛紙18涓<EFBFBD>湀+锛夛細鍗曟満鐗堬紙鍙<E7B499>€夛級
- 触发条件：有大量单机版需求
- 瑙﹀彂鏉′欢锛氭湁澶ч噺鍗曟満鐗堥渶姹?
- 寮€鍙慐lectron搴旂敤
- 本地化运行
- 鏈<EFBFBD>湴鍖栬繍琛?
```
---
## 3️⃣ 审稿系统的独立性
## 3锔忊儯 瀹＄ǹ绯荤粺鐨勭嫭绔嬫€?
### 鎮ㄧ殑璁″垝
> 未来还会增加一个审稿系统的开发，目前已经有核心审稿功能了，可能需要独立成一个系统
> 鏈<EFBFBD>潵杩樹細澧炲姞涓€涓<EFBFBD><EFBFBD>绋跨郴缁熺殑寮€鍙戯紝鐩<EFBFBD>墠宸茬粡鏈夋牳蹇冨<EFBFBD>绋垮姛鑳戒簡锛屽彲鑳介渶瑕佺嫭绔嬫垚涓€涓<EFBFBD>郴缁?
### 鎴戠殑鍥炲<E98DA5>
✅ **审稿系统非常适合独立！这是一个极具商业价值的决策！**
鉁?**瀹＄ǹ绯荤粺闈炲父閫傚悎鐙<E6828E>珛锛佽繖鏄<E7B996>竴涓<E7ABB4>瀬鍏峰晢涓氫环鍊肩殑鍐崇瓥锛?*
**为什么审稿系统适合独立？**
**涓轰粈涔堝<EFBFBD>绋跨郴缁熼€傚悎鐙<EFBFBD>珛锛?*
**1. 用户群完全不同**
**1. 鐢ㄦ埛缇ゅ畬鍏ㄤ笉鍚?*
```
主平台用户：临床医生、研究者
审稿系统用户：期刊编辑部、出版社、学会
涓诲钩鍙扮敤鎴凤細涓村簥鍖荤敓銆佺爺绌惰€?
瀹＄ǹ绯荤粺鐢ㄦ埛锛氭湡鍒婄紪杈戦儴銆佸嚭鐗堢ぞ銆佸<EFBFBD>浼?
→ 两类用户没有交集，完全独立
鈫?涓ょ被鐢ㄦ埛娌℃湁浜ら泦锛屽畬鍏ㄧ嫭绔?
```
**2. 涓氬姟閫昏緫瀹屽叏鐙<E58F8F>珛**
@@ -138,7 +138,7 @@ XXX-模块名称/
涓诲钩鍙帮細绉戠爺鍏ㄦ祦绋嬶紙缁熻<EFBFBD>鍒嗘瀽銆佹枃鐚<EFBFBD>瓫閫夈€佹暟鎹<EFBFBD>竻娲楋級
瀹＄ǹ绯荤粺锛氱ǹ浠跺<EFBFBD>鏌ユ祦绋嬶紙鎶曠ǹ銆佸<EFBFBD>绋裤€佷慨鏀广€佸喅绛栵級
→ 业务逻辑无关联
鈫?涓氬姟閫昏緫鏃犲叧鑱?
```
**3. 閮ㄧ讲鍦烘櫙鐙<E6AB99>珛**
@@ -146,42 +146,42 @@ XXX-模块名称/
涓诲钩鍙帮細浜戠<EFBFBD>SaaS涓轰富锛岄儴鍒嗙<EFBFBD>鏈夊寲
瀹＄ǹ绯荤粺锛氭湡鍒婄紪杈戦儴鐙<EFBFBD>珛閮ㄧ讲
→ 部署需求不同
鈫?閮ㄧ讲闇€姹備笉鍚?
```
**4. 鍟嗕笟妯″紡鐙<E7B4A1>珛**
```
主平台：按版本订阅（基础版、高级版、旗舰版）
审稿系统：按期刊订阅，或按稿件数量计费
涓诲钩鍙帮細鎸夌増鏈<EFBFBD><EFBFBD>闃咃紙鍩虹<EFBFBD>鐗堛€侀珮绾х増銆佹棗鑸扮増锛?
瀹＄ǹ绯荤粺锛氭寜鏈熷垔璁㈤槄锛屾垨鎸夌ǹ浠舵暟閲忚<EFBFBD>璐?
→ 商业模式完全不同
鈫?鍟嗕笟妯″紡瀹屽叏涓嶅悓
```
**褰撳墠鐘舵€侊細**
- ✅ 核心功能已实现（文档提取、规范性评估、方法学评估）
- ✅ 数据库表已独立（review_tasks）
- 鉁?鏍稿績鍔熻兘宸插疄鐜帮紙鏂囨。鎻愬彇銆佽<E98A86>鑼冩€ц瘎浼般€佹柟娉曞<E5A889>璇勪及锛?
- 鉁?鏁版嵁搴撹〃宸茬嫭绔嬶紙review_tasks锛?
- 鈿狅笍 闇€瑕佹墿灞曪紙瀹＄ǹ浜虹<E6B59C>鐞嗐€佸<E282AC>绋挎祦绋嬨€佸<E282AC>杞<EFBFBD><E69D9E>绋匡級
**建议：**
**寤鸿<EFBFBD>锛?*
```
短期（当前）：
- 审稿系统作为主平台的一个模块
- 但在架构设计上保持独立（独立Schema、独立API）
鐭<EFBFBD>湡锛堝綋鍓嶏級锛?
- 瀹＄ǹ绯荤粺浣滀负涓诲钩鍙扮殑涓€涓<EFBFBD>ā鍧?
- 浣嗗湪鏋舵瀯璁捐<EFBFBD>涓婁繚鎸佺嫭绔嬶紙鐙<EFBFBD>珛Schema銆佺嫭绔婣PI锛?
中期（6-12个月）：
涓<EFBFBD>湡锛?-12涓<32>湀锛夛細
- 寮€鍙戝畬鏁村<E98F81>绋跨郴缁燂紙瀹＄ǹ浜恒€佹祦绋嬨€佸<E282AC>杞<EFBFBD><E69D9E>绋匡級
- 验证市场需求
- 楠岃瘉甯傚満闇€姹?
长期（12个月+）：
- 完全独立为单独产品"AI辅助审稿系统"
- 独立部署、独立销售
闀挎湡锛?2涓<32>湀+锛夛細
- 瀹屽叏鐙<EFBFBD>珛涓哄崟鐙<EFBFBD>骇鍝?AI杈呭姪瀹＄ǹ绯荤粺"
- 鐙<EFBFBD>珛閮ㄧ讲銆佺嫭绔嬮攢鍞?
- 鐩<>爣瀹㈡埛锛氭湡鍒婄紪杈戦儴銆佸嚭鐗堢ぞ
```
**独立销售价值：⭐⭐⭐⭐⭐ 极高！**
**鐙<EFBFBD>珛閿€鍞<EFBFBD>环鍊硷細猸愨瓙猸愨瓙猸?鏋侀珮锛?*
- 甯傚満绌虹櫧锛氬浗鍐呯己涔廇I瀹＄ǹ宸ュ叿
- 刚需：期刊编辑部审稿压力大
- 付费能力强：期刊有预算
- 鍒氶渶锛氭湡鍒婄紪杈戦儴瀹＄ǹ鍘嬪姏澶?
- 浠樿垂鑳藉姏寮猴細鏈熷垔鏈夐<EFBFBD>绠?
---
@@ -197,186 +197,186 @@ XXX-模块名称/
杩欐槸鏈€鏍稿績鐨勬灦鏋勯棶棰橈紒鎴戝凡缁忓垱寤轰簡璇︾粏鐨勬灦鏋勫垎灞傝<EFBFBD>璁★細
- 馃搫 [绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>](./01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md)
**三层架构总览：**
**涓夊眰鏋舵瀯鎬昏<EFBFBD>锛?*
### 第一层：平台基础层（Platform Layer）
### 绗<EFBFBD>竴灞傦細骞冲彴鍩虹<EFBFBD>灞傦紙Platform Layer锛?
**定义：** 所有业务模块的地基，提供通用的基础设施能力
**瀹氫箟锛?* 鎵€鏈変笟鍔℃ā鍧楃殑鍦板熀锛屾彁渚涢€氱敤鐨勫熀纭€璁炬柦鑳藉姏
**包含模块：**
1. ✅ **用户与权限中心（UAM）** - 用户认证、权限管理、Feature Flag
2. ✅ **存储服务** - 文件上传下载、OSS/本地文件系统
3. ✅ **通知服务** - 站内消息、邮件、WebSocket推送
4. ✅ **监控与日志** - 操作日志、错误日志、审计日志
5. ✅ **系统配置** - 系统级配置管理
**鍖呭惈妯″潡锛?*
1. 鉁?**鐢ㄦ埛涓庢潈闄愪腑蹇冿紙UAM锛?* - 鐢ㄦ埛璁よ瘉銆佹潈闄愮<E99784>鐞嗐€丗eature Flag
2. 鉁?**瀛樺偍鏈嶅姟** - 鏂囦欢涓婁紶涓嬭浇銆丱SS/鏈<>湴鏂囦欢绯荤粺
3. 鉁?**閫氱煡鏈嶅姟** - 绔欏唴娑堟伅銆侀偖浠躲€乄ebSocket鎺ㄩ€?
4. 鉁?**鐩戞帶涓庢棩蹇?* - 鎿嶄綔鏃ュ織銆侀敊璇<E6958A>棩蹇椼€佸<E282AC>璁℃棩蹇?
5. 鉁?**绯荤粺閰嶇疆** - 绯荤粺绾ч厤缃<EFBFBD><EFBFBD>鐞?
**特征：**
- ✅ 全局唯一（整个平台只有一套）
- ✅ 业务无关（不涉及具体业务逻辑）
- ✅ 强依赖性（所有业务模块都必须依赖）
- ✅ 稳定性高（很少变动）
**鐗瑰緛锛?*
- 鉁?鍏ㄥ眬鍞<E79CAC>竴锛堟暣涓<E69AA3>钩鍙板彧鏈変竴濂楋級
- 鉁?涓氬姟鏃犲叧锛堜笉娑夊強鍏蜂綋涓氬姟閫昏緫锛?
- 鉁?寮轰緷璧栨€э紙鎵€鏈変笟鍔℃ā鍧楅兘蹇呴』渚濊禆锛?
- 鉁?绋冲畾鎬ч珮锛堝緢灏戝彉鍔<E5BD89>級
---
### 第二层：通用能力层（Capability Layer）
### 绗<EFBFBD>簩灞傦細閫氱敤鑳藉姏灞傦紙Capability Layer锛?
**定义：** 跨业务模块共享的核心技术能力
**瀹氫箟锛?* 璺ㄤ笟鍔℃ā鍧楀叡浜<E58FA1>殑鏍稿績鎶€鏈<E282AC>兘鍔?
**包含能力：**
**鍖呭惈鑳藉姏锛?*
#### 1. LLM大模型网关 ⭐⭐⭐⭐⭐ **最核心**
#### 1. LLM澶фā鍨嬬綉鍏?猸愨瓙猸愨瓙猸?**鏈€鏍稿績**
**职责：**
**鑱岃矗锛?*
- 缁熶竴绠＄悊鎵€鏈塋LM璋冪敤
- 根据用户版本动态切换模型
- 成本控制与限流
- Token计数与计费
- 鏍规嵁鐢ㄦ埛鐗堟湰鍔ㄦ€佸垏鎹㈡ā鍨?
- 鎴愭湰鎺у埗涓庨檺娴?
- Token璁℃暟涓庤<EFBFBD>璐?
**使用模块：**
- ✅ AIA（AI智能问答）
- ✅ ASL（AI智能文献）
- ✅ PKB（个人知识库）
- ✅ DC（数据清洗）
- ✅ RVW（稿件审查）
**浣跨敤妯″潡锛?*
- 鉁?AIA锛圓I鏅鸿兘闂<EFBFBD>瓟锛?
- 鉁?ASL锛圓I鏅鸿兘鏂囩尞锛?
- 鉁?PKB锛堜釜浜虹煡璇嗗簱锛?
- 鉁?DC锛堟暟鎹<E69A9F>竻娲楋級
- 鉁?RVW锛堢ǹ浠跺<EFBFBD>鏌ワ級
**澶嶇敤鐜囷細** 5/7 = 71%
**为什么是核心？**
**涓轰粈涔堟槸鏍稿績锛?*
```
杩欐槸鍟嗕笟妯″紡鐨勬妧鏈<EFBFBD>繚闅滐細
- 基础版：只能用DeepSeek-V3（¥1/百万tokens）
- 鍩虹<EFBFBD>鐗堬細鍙<EFBFBD>兘鐢―eepSeek-V3锛埪?/鐧句竾tokens锛?
- 楂樼骇鐗堬細鍙<E7B4B0>敤DeepSeek + Qwen3
- 鏃楄埌鐗堬細鍙<E7B4B0>敤DeepSeek + Qwen3 + Qwen-Long + Claude
成本控制：
鎴愭湰鎺у埗锛?
- 缁熶竴鐩戞帶鎵€鏈塋LM API璋冪敤
- 瓒呭嚭閰嶉<E996B0>鑷<EFBFBD>姩闄愭祦
- 按版本计费
- 鎸夌増鏈<EFBFBD><EFBFBD>璐?
```
**当前状态：** ❌ 未实现（P0优先级）
**褰撳墠鐘舵€侊細** 鉂?鏈<>疄鐜帮紙P0浼樺厛绾э級
---
#### 2. 文档处理引擎 ⭐⭐⭐⭐⭐ **最核心**
#### 2. 鏂囨。澶勭悊寮曟搸 猸愨瓙猸愨瓙猸?**鏈€鏍稿績**
**职责：**
- 多格式文档提取（PDF/Docx/Txt/Excel）
**鑱岃矗锛?*
- 澶氭牸寮忔枃妗ｆ彁鍙栵紙PDF/Docx/Txt/Excel锛?
- 鏂囨湰娓呮礂涓庨<E6B693>澶勭悊
- OCR澶勭悊
- 琛ㄦ牸鎻愬彇
**使用模块：**
- ✅ ASL（文献PDF提取）
- ✅ PKB（知识库文档）
- ✅ DC（Excel/Docx导入）
- ✅ SSA（数据导入）
- ✅ ST（数据导入）
- ✅ RVW（稿件提取）
**浣跨敤妯″潡锛?*
- 鉁?ASL锛堟枃鐚甈DF鎻愬彇锛?
- 鉁?PKB锛堢煡璇嗗簱鏂囨。锛?
- 鉁?DC锛圗xcel/Docx瀵煎叆锛?
- 鉁?SSA锛堟暟鎹<EFBFBD><EFBFBD>鍏ワ級
- 鉁?ST锛堟暟鎹<E69A9F><E98EB9>鍏ワ級
- 鉁?RVW锛堢ǹ浠舵彁鍙栵級
**澶嶇敤鐜囷細** 6/7 = 86%
**当前状态：** ✅ 已实现（Python微服务）
**褰撳墠鐘舵€侊細** 鉁?宸插疄鐜帮紙Python寰<6E>湇鍔★級
---
#### 3. RAG寮曟搸 猸愨瓙猸愨瓙 **鏍稿績**
**职责：**
- 向量化存储（Embedding）
- 语义检索（Semantic Search）
- 检索增强生成（RAG）
**鑱岃矗锛?*
- 鍚戦噺鍖栧瓨鍌<EFBFBD>紙Embedding锛?
- 璇<EFBFBD>箟妫€绱<EFBFBD>紙Semantic Search锛?
- 妫€绱㈠<EFBFBD>寮虹敓鎴愶紙RAG锛?
**使用模块：**
- ✅ PKB（个人知识库问答）
- ✅ ASL（文献内容检索）
- ✅ AIA（@知识库问答）
**浣跨敤妯″潡锛?*
- 鉁?PKB锛堜釜浜虹煡璇嗗簱闂<EFBFBD>瓟锛?
- 鉁?ASL锛堟枃鐚<EFBFBD>唴瀹规<EFBFBD>绱<EFBFBD>級
- 鉁?AIA锛園鐭ヨ瘑搴撻棶绛旓級
**澶嶇敤鐜囷細** 3/7 = 43%
**当前状态：** ✅ 已实现（基于Dify）
**褰撳墠鐘舵€侊細** 鉁?宸插疄鐜帮紙鍩轰簬Dify锛?
---
#### 4. 数据ETL引擎 ⭐⭐⭐ **中等**
#### 4. 鏁版嵁ETL寮曟搸 猸愨瓙猸?**涓<>瓑**
**职责：**
**鑱岃矗锛?*
- Excel澶氳〃JOIN
- 鏁版嵁娓呮礂
- 鏁版嵁杞<E5B581>崲
**使用模块：**
- ✅ DC（数据清洗）
- ✅ SSA（统计分析数据预处理）
**浣跨敤妯″潡锛?*
- 鉁?DC锛堟暟鎹<E69A9F>竻娲楋級
- 鉁?SSA锛堢粺璁″垎鏋愭暟鎹<EFBFBD><EFBFBD>澶勭悊锛?
**澶嶇敤鐜囷細** 2/7 = 29%
**当前状态：** ❌ 未实现（P2优先级）
**褰撳墠鐘舵€侊細** 鉂?鏈<>疄鐜帮紙P2浼樺厛绾э級
---
#### 5. 医学NLP引擎 ⭐⭐⭐ **中等**
#### 5. 鍖诲<EFBFBD>NLP寮曟搸 猸愨瓙猸?**涓<>瓑**
**职责：**
- 医学实体识别（NER）
- 医学术语标准化
**鑱岃矗锛?*
- 鍖诲<EFBFBD>瀹炰綋璇嗗埆锛圢ER锛?
- 鍖诲<EFBFBD>鏈<EFBFBD><EFBFBD>鏍囧噯鍖?
**使用模块：**
- ✅ DC（病例数据NER提取）
**浣跨敤妯″潡锛?*
- 鉁?DC锛堢梾渚嬫暟鎹甆ER鎻愬彇锛?
**澶嶇敤鐜囷細** 1/7 = 14%
**当前状态：** ❌ 未实现（P2优先级）
**褰撳墠鐘舵€侊細** 鉂?鏈<>疄鐜帮紙P2浼樺厛绾э級
---
### 第三层：业务模块层（Product Layer）
### 绗<EFBFBD>笁灞傦細涓氬姟妯″潡灞傦紙Product Layer锛?
**定义：** 面向用户的产品功能，每个模块都是独立的产品单元
**瀹氫箟锛?* 闈㈠悜鐢ㄦ埛鐨勪骇鍝佸姛鑳斤紝姣忎釜妯″潡閮芥槸鐙<E6A7B8>珛鐨勪骇鍝佸崟鍏?
**7涓<37>笟鍔℃ā鍧楋細**
| 模块 | 名称 | 商业价值 | 独立性 | 状态 |
| 妯″潡 | 鍚嶇О | 鍟嗕笟浠峰€?| 鐙<>珛鎬?| 鐘舵€?|
|------|------|---------|-------|------|
| **AIA** | AI智能问答 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ✅ 已完成 |
| **ASL** | AI智能文献 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⏳ 下一步重点 |
| **PKB** | 个人知识库 | ⭐⭐⭐ | ⭐⭐⭐ | ✅ 已完成 |
| **DC** | 数据清洗整理 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⏳ 规划中 |
| **SSA** | 智能统计分析 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⏳ 规划中 |
| **ST** | 统计分析工具 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⏳ 规划中 |
| **RVW** | 稿件审查系统 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⚡ 独立系统 |
| **AIA** | AI鏅鸿兘闂<EFBFBD>瓟 | 猸愨瓙猸愨瓙 | 猸愨瓙猸?| 鉁?宸插畬鎴?|
| **ASL** | AI鏅鸿兘鏂囩尞 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙猸?| 鈴?涓嬩竴姝ラ噸鐐?|
| **PKB** | 涓<EFBFBD>汉鐭ヨ瘑搴?| 猸愨瓙猸?| 猸愨瓙猸?| 鉁?宸插畬鎴?|
| **DC** | 鏁版嵁娓呮礂鏁寸悊 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙猸?| 鈴?瑙勫垝涓?|
| **SSA** | 鏅鸿兘缁熻<EFBFBD>鍒嗘瀽 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙 | 鈴?瑙勫垝涓?|
| **ST** | 缁熻<EFBFBD>鍒嗘瀽宸ュ叿 | 猸愨瓙猸愨瓙 | 猸愨瓙猸愨瓙 | 鈴?瑙勫垝涓?|
| **RVW** | 绋夸欢瀹℃煡绯荤粺 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙猸?| 鈿?鐙<>珛绯荤粺 |
**特征：**
- ✅ 独立部署：可以单独打包部署
- ✅ 独立销售：可以单独售卖
- ✅ 低耦合：模块间不直接依赖
- ✅ 高内聚：模块内功能完整
**鐗瑰緛锛?*
- 鉁?鐙<>珛閮ㄧ讲锛氬彲浠ュ崟鐙<E5B49F>墦鍖呴儴缃?
- 鉁?鐙<>珛閿€鍞<E282AC>細鍙<E7B4B0>互鍗曠嫭鍞<E5ABAD>崠
- 鉁?浣庤€﹀悎锛氭ā鍧楅棿涓嶇洿鎺ヤ緷璧?
- 鉁?楂樺唴鑱氾細妯″潡鍐呭姛鑳藉畬鏁?
---
### 鍙<><E98D99>鐢ㄨ兘鍔涙€荤粨
| 能力 | 使用频率 | 复用模块数 | 优先级 | 状态 |
| 鑳藉姏 | 浣跨敤棰戠巼 | 澶嶇敤妯″潡鏁?| 浼樺厛绾?| 鐘舵€?|
|------|---------|-----------|--------|------|
| **LLM网关** | 71% | 5/7 | P0 | ❌ 待实现 |
| **文档处理引擎** | 86% | 6/7 | P0 | ✅ 已实现 |
| **RAG引擎** | 43% | 3/7 | P1 | ✅ 已实现 |
| **ETL引擎** | 29% | 2/7 | P2 | ❌ 待实现 |
| **医学NLP** | 14% | 1/7 | P2 | ❌ 待实现 |
| **LLM缃戝叧** | 71% | 5/7 | P0 | 鉂?寰呭疄鐜?|
| **鏂囨。澶勭悊寮曟搸** | 86% | 6/7 | P0 | 鉁?宸插疄鐜?|
| **RAG寮曟搸** | 43% | 3/7 | P1 | 鉁?宸插疄鐜?|
| **ETL寮曟搸** | 29% | 2/7 | P2 | 鉂?寰呭疄鐜?|
| **鍖诲<EFBFBD>NLP** | 14% | 1/7 | P2 | 鉂?寰呭疄鐜?|
---
## 5️⃣ 数据库架构
## 5锔忊儯 鏁版嵁搴撴灦鏋?
### 鎮ㄧ殑闂<E6AE91><E99782>
> 设计多Schema架构是非常必要的。
> 璁捐<EFBFBD>澶歋chema鏋舵瀯鏄<EFBFBD>潪甯稿繀瑕佺殑銆?
> 鐩<EFBFBD>墠褰撳墠绯荤粺鐨勬暟鎹<EFBFBD>簱浼间箮鏄疍IFY鐨勶紵
> 目前我们有自己独立的数据库吗？
> 鐩<EFBFBD>墠鎴戜滑鏈夎嚜宸辩嫭绔嬬殑鏁版嵁搴撳悧锛?
### 鎴戠殑鍥炲<E98DA5>
✅ **我们有自己独立的PostgreSQL数据库，不是Dify的！**
鉁?**鎴戜滑鏈夎嚜宸辩嫭绔嬬殑PostgreSQL鏁版嵁搴擄紝涓嶆槸Dify鐨勶紒**
**褰撳墠鏁版嵁搴撴儏鍐碉細**
@@ -391,17 +391,17 @@ datasource db {
**褰撳墠琛ㄧ粨鏋勶細**
```
褰撳墠鏁版嵁搴擄紙PostgreSQL锛岀嫭绔嬩簬Dify锛夛細
├── users # 用户表
├── projects # 项目表
├── conversations # 对话表（AI问答）
├── messages # 消息表
鈹溾攢鈹€ users # 鐢ㄦ埛琛?
鈹溾攢鈹€ projects # 椤圭洰琛?
鈹溾攢鈹€ conversations # 瀵硅瘽琛<EFBFBD>紙AI闂<EFBFBD>瓟锛?
鈹溾攢鈹€ messages # 娑堟伅琛?
鈹溾攢鈹€ knowledge_bases # 鐭ヨ瘑搴撹〃
├── documents # 文档表
├── admin_logs # 管理员日志
鈹溾攢鈹€ documents # 鏂囨。琛?
鈹溾攢鈹€ admin_logs # 绠＄悊鍛樻棩蹇?
鈹溾攢鈹€ general_conversations # 閫氱敤瀵硅瘽
鈹溾攢鈹€ general_messages # 閫氱敤娑堟伅
├── batch_tasks # 批处理任务（Phase 3）
├── batch_results # 批处理结果
鈹溾攢鈹€ batch_tasks # 鎵瑰<EFBFBD>鐞嗕换鍔★紙Phase 3锛?
鈹溾攢鈹€ batch_results # 鎵瑰<EFBFBD>鐞嗙粨鏋?
鈹溾攢鈹€ task_templates # 浠诲姟妯℃澘
鈹斺攢鈹€ review_tasks # 绋夸欢瀹℃煡浠诲姟
@@ -410,22 +410,22 @@ Dify数据库（完全独立）：
鈹斺攢鈹€ 閫氳繃Dify API璋冪敤锛屼笉鐩存帴璁块棶
```
**关键澄清：**
- ✅ 我们有自己的PostgreSQL数据库
- ✅ Dify有自己的数据库（我们不直接访问）
- ✅ 我们通过Dify API调用（HTTP REST API）
- ✅ 两个数据库完全独立
**鍏抽敭婢勬竻锛?*
- 鉁?鎴戜滑鏈夎嚜宸辩殑PostgreSQL鏁版嵁搴?
- 鉁?Dify鏈夎嚜宸辩殑鏁版嵁搴擄紙鎴戜滑涓嶇洿鎺ヨ<EFBFBD>闂<EFBFBD>級
- 鉁?鎴戜滑閫氳繃Dify API璋冪敤锛圚TTP REST API锛?
- 鉁?涓や釜鏁版嵁搴撳畬鍏ㄧ嫭绔?
**浣嗘槸瀛樺湪鐨勯棶棰橈細**
- ❌ **所有表在同一Schema（public）**
- ❌ 未来微服务拆分困难
- ❌ 不支持模块独立部署
- 鉂?**鎵€鏈夎〃鍦ㄥ悓涓€Schema锛坧ublic锛?*
- 鉂?鏈<>潵寰<E6BDB5>湇鍔℃媶鍒嗗洶闅?
- 鉂?涓嶆敮鎸佹ā鍧楃嫭绔嬮儴缃?
---
### Schema闅旂<E99785>鏂规<E98F82>
**目标架构：**
**鐩<EFBFBD>爣鏋舵瀯锛?*
```sql
-- 骞冲彴灞係chema
CREATE SCHEMA platform_schema;
@@ -454,7 +454,7 @@ CREATE SCHEMA asl_schema; -- AI智能文献
鈹溾攢鈹€ asl_screening_results
鈹斺攢鈹€ ...
CREATE SCHEMA pkb_schema; -- 个人知识库
CREATE SCHEMA pkb_schema; -- 涓<EFBFBD>汉鐭ヨ瘑搴?
鈹溾攢鈹€ pkb_knowledge_bases
鈹斺攢鈹€ pkb_documents
@@ -481,12 +481,12 @@ CREATE SCHEMA review_schema; -- 稿件审查
### 杩佺Щ绛栫暐
**阶段一：逻辑隔离（当前阶段，立即实施）**
**闃舵<EFBFBD>涓€锛氶€昏緫闅旂<EFBFBD>锛堝綋鍓嶉樁娈碉紝绔嬪嵆瀹炴柦锛?*
```
鐩<EFBFBD>爣锛氬湪浠ｇ爜灞傞潰鎸塖chema缁勭粐锛屼絾鏁版嵁搴撹繕鏄痯ublic
鏂瑰紡锛歅risma涓<EFBFBD>娇鐢ˊ@map鎸囧畾琛ㄥ悕鍓嶇紑
例如：
渚嬪<EFBFBD>锛?
model AiaProject {
id String @id @default(uuid())
// ...
@@ -506,10 +506,10 @@ model DcProject {
}
```
**好处：**
- ✅ 立即可实施，无需数据迁移
- ✅ 为未来物理隔离打基础
- ✅ 代码层面已经按模块组织
**濂藉<EFBFBD>锛?*
- 鉁?绔嬪嵆鍙<E5B586>疄鏂斤紝鏃犻渶鏁版嵁杩佺Щ
- 鉁?涓烘湭鏉ョ墿鐞嗛殧绂绘墦鍩虹<E98DA9>
- 鉁?浠ｇ爜灞傞潰宸茬粡鎸夋ā鍧楃粍缁?
---
@@ -518,47 +518,47 @@ model DcProject {
鐩<EFBFBD>爣锛氱湡姝ｅ垱寤虹嫭绔婼chema
鏃舵満锛氬綋闇€瑕佹媶鍒嗘煇涓<EFBFBD>ā鍧椾负鐙<EFBFBD>珛寰<EFBFBD>湇鍔℃椂
步骤：
姝ラ<EFBFBD>锛?
1. CREATE SCHEMA xxx_schema;
2. CREATE TABLE xxx_schema.table_name ...
3. INSERT INTO xxx_schema.table SELECT * FROM public.old_table;
4. 更新Prisma Schema（指定schema）
4. 鏇存柊Prisma Schema锛堟寚瀹歴chema锛?
5. 娴嬭瘯楠岃瘉
6. 鍒囨崲鐢熶骇
```
---
## 6️⃣ 下一步开发重点
## 6锔忊儯 涓嬩竴姝ュ紑鍙戦噸鐐?
### 鎮ㄧ殑鍐崇瓥
> 下一步着重开发的功能肯定是AI智能文献模块。
> 当然在总体架构讨论清楚前，我们先不开发。
> 涓嬩竴姝ョ潃閲嶅紑鍙戠殑鍔熻兘鑲<EFBFBD>畾鏄疉I鏅鸿兘鏂囩尞妯″潡銆?
> 褰撶劧鍦ㄦ€讳綋鏋舵瀯璁ㄨ<EFBFBD>娓呮<EFBFBD>鍓嶏紝鎴戜滑鍏堜笉寮€鍙戙€?
### 鎴戠殑鍥炲<E98DA5>
✅ **完全赞同！AI智能文献是核心竞争力，应该是下一步重点。**
鉁?**瀹屽叏璧炲悓锛丄I鏅鸿兘鏂囩尞鏄<E5B09E>牳蹇冪珵浜夊姏锛屽簲璇ユ槸涓嬩竴姝ラ噸鐐广€?*
**寮€鍙戦『搴忓缓璁<E7BC93>細**
**绗<>竴姝ワ細鏋舵瀯璁捐<E79281>锛堟湰鍛<E6B9B0>紝1-2澶╋級**
```
P0文档（必须完成）：
1. ✅ 系统架构分层设计（已完成）
2. ✅ 文档体系重构方案（已完成）
3. ⚠️ LLM大模型网关设计（关键）
P0鏂囨。锛堝繀椤诲畬鎴愶級锛?
1. 鉁?绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>锛堝凡瀹屾垚锛?
2. 鉁?鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>锛堝凡瀹屾垚锛?
3. 鈿狅笍 LLM澶фā鍨嬬綉鍏宠<EFBFBD>璁★紙鍏抽敭锛?
4. 鈿狅笍 鏁版嵁搴揝chema闅旂<E99785>鏂规<E98F82>锛堝叧閿<E58FA7>級
```
**绗<>簩姝ワ細鏂囨。鏁寸悊锛堟湰鍛<E6B9B0>紝1-2澶╋級**
```
1. 璋冩暣ASL妯″潡鏂囨。缁撴瀯锛堟寜鏂版ā鏉匡級
2. 补充缺失的设计文档
2. 琛ュ厖缂哄け鐨勮<EFBFBD>璁℃枃妗?
3. 鏄庣‘寮€鍙戦噷绋嬬<E7BB8B>
```
**第三步：关键技术验证（下周，1-2天）**
**绗<EFBFBD>笁姝ワ細鍏抽敭鎶€鏈<EFBFBD>獙璇侊紙涓嬪懆锛?-2澶╋級**
```
1. 鈿狅笍 R璇<52>█鎶€鏈<E282AC>獙璇侊紙SSA妯″潡闇€瑕侊紝鍙<E7B49D>欢鍚庯級
2. 鈿狅笍 LLM Gateway鍘熷瀷楠岃瘉
@@ -580,65 +580,65 @@ P0文档（必须完成）：
### 鏍稿績鍘熷垯
**1. 架构先行，文档先行**
**1. 鏋舵瀯鍏堣<EFBFBD>锛屾枃妗ｅ厛琛?*
```
✅ 先把总体架构讨论清楚
✅ 先把文档结构调整好
✅ 然后再开始开发
鉁?鍏堟妸鎬讳綋鏋舵瀯璁ㄨ<E79281>娓呮<E5A893>
鉁?鍏堟妸鏂囨。缁撴瀯璋冩暣濂?
鉁?鐒跺悗鍐嶅紑濮嬪紑鍙?
```
**2. 鑱氱劍鏍稿績锛岄€愭<E282AC>鎵╁睍**
```
阶段一（当前-6个月）：
- 云端SaaS版
闃舵<EFBFBD>涓€锛堝綋鍓?6涓<36>湀锛夛細
- 浜戠<EFBFBD>SaaS鐗?
- 鏍稿績妯″潡锛欰SL銆丏C銆丄IA浼樺寲
- 鍏抽敭鑳藉姏锛歀LM缃戝叧銆丼chema闅旂<E99785>
闃舵<EFBFBD>浜岋紙6-18涓<38>湀锛夛細
- 私有化部署
- 绉佹湁鍖栭儴缃?
- 鎵╁睍妯″潡锛歋SA銆丼T
- 鐙<>珛绯荤粺锛歊VW锛堝<E9949B>绋跨郴缁燂級
闃舵<EFBFBD>涓夛紙18涓<EFBFBD>湀+锛夛細
- 鍗曟満鐗堬紙鍙<E7B499>€夛級
- 全面微服务
- 鍏ㄩ潰寰<EFBFBD>湇鍔?
```
**3. 模块独立，能力复用**
**3. 妯″潡鐙<EFBFBD>珛锛岃兘鍔涘<EFBFBD>鐢?*
```
✅ 业务模块独立设计（低耦合）
✅ 通用能力统一提供（高复用）
✅ 支持模块独立销售
鉁?涓氬姟妯″潡鐙<E6BDA1>珛璁捐<E79281>锛堜綆鑰﹀悎锛?
鉁?閫氱敤鑳藉姏缁熶竴鎻愪緵锛堥珮澶嶇敤锛?
鉁?鏀<>寔妯″潡鐙<E6BDA1>珛閿€鍞?
```
---
## ✅ 立即行动清单
## 鉁?绔嬪嵆琛屽姩娓呭崟
### 本周行动（P0）
### 鏈<EFBFBD>懆琛屽姩锛圥0锛?
**1. 架构设计（1-2天）**
- [x] 系统架构分层设计 ✅
- [x] 文档体系重构方案 ✅
- [ ] LLM大模型网关设计
**1. 鏋舵瀯璁捐<EFBFBD>锛?-2澶╋級**
- [x] 绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD> 鉁?
- [x] 鏂囨。浣撶郴閲嶆瀯鏂规<EFBFBD> 鉁?
- [ ] LLM澶фā鍨嬬綉鍏宠<EFBFBD>璁?
- [ ] 鏁版嵁搴揝chema闅旂<E99785>鏂规<E98F82>
**2. 文档迁移（1-2天）**
**2. 鏂囨。杩佺Щ锛?-2澶╋級**
- [ ] 鍒涘缓鏂版枃浠跺す缁撴瀯
- [ ] 杩佺ЩASL妯″潡鏂囨。
- [ ] 璋冩暣鏂囨。缁撴瀯锛堟寜鏂版ā鏉匡級
---
### 下周行动（P1）
### 涓嬪懆琛屽姩锛圥1锛?
**3. 关键文档补充（2-3天）**
**3. 鍏抽敭鏂囨。琛ュ厖锛?-3澶╋級**
- [ ] ASL妯″潡缂哄け鏂囨。
- [ ] LLM缃戝叧璇︾粏璁捐<E79281>
- [ ] RVW鐙<57>珛绯荤粺瑙勫垝
**4. 开始ASL模块开发（启动）**
- [ ] 数据库表设计（asl_schema）
**4. 寮€濮婣SL妯″潡寮€鍙戯紙鍚<EFBFBD>姩锛?*
- [ ] 鏁版嵁搴撹〃璁捐<EFBFBD>锛坅sl_schema锛?
- [ ] API璁捐<E79281>
- [ ] 鍓嶇<E98D93>缁勪欢璁捐<E79281>
@@ -646,41 +646,41 @@ P0文档（必须完成）：
## 馃搳 鎬荤粨
### 您的想法非常正确！
### 鎮ㄧ殑鎯虫硶闈炲父姝ｇ‘锛?
1. ✅ **文档系统重构**：总体独立，模块独立
2. ✅ **不考虑混合部署**：简化技术复杂度
3. ✅ **审稿系统独立**：极具商业价值
4. ✅ **架构分层清晰**：平台层、通用能力层、业务模块层
5. ✅ **Schema隔离必要**：支持模块独立和微服务拆分
6. ✅ **ASL是下一步重点**：核心竞争力
1. 鉁?**鏂囨。绯荤粺閲嶆瀯**锛氭€讳綋鐙<E7B68B>珛锛屾ā鍧楃嫭绔?
2. 鉁?**涓嶈€冭檻娣峰悎閮ㄧ讲**锛氱畝鍖栨妧鏈<E5A6A7><E98F88>鏉傚害
3. 鉁?**瀹＄ǹ绯荤粺鐙<E7B2BA>珛**锛氭瀬鍏峰晢涓氫环鍊?
4. 鉁?**鏋舵瀯鍒嗗眰娓呮櫚**锛氬钩鍙板眰銆侀€氱敤鑳藉姏灞傘€佷笟鍔℃ā鍧楀眰
5. 鉁?**Schema闅旂<EFBFBD>蹇呰<EFBFBD>**锛氭敮鎸佹ā鍧楃嫭绔嬪拰寰<E68BB0>湇鍔℃媶鍒?
6. 鉁?**ASL鏄<EFBFBD>笅涓€姝ラ噸鐐?*锛氭牳蹇冪珵浜夊姏
### 当前最关键的工作
### 褰撳墠鏈€鍏抽敭鐨勫伐浣?
**P0（本周）：**
1. 完成架构设计文档（LLM网关、Schema隔离）
2. 调整文档结构（迁移ASL模块）
**P0锛堟湰鍛<EFBFBD>級锛?*
1. 瀹屾垚鏋舵瀯璁捐<EFBFBD>鏂囨。锛圠LM缃戝叧銆丼chema闅旂<EFBFBD>锛?
2. 璋冩暣鏂囨。缁撴瀯锛堣縼绉籄SL妯″潡锛?
**P1（下周）：**
**P1锛堜笅鍛<EFBFBD>級锛?*
3. 琛ュ厖鍏抽敭鏂囨。
4. 开始ASL模块开发
4. 寮€濮婣SL妯″潡寮€鍙?
### 我们不着急，先把总体思路沟通清楚
### 鎴戜滑涓嶇潃鎬ワ紝鍏堟妸鎬讳綋鎬濊矾娌熼€氭竻妤?
✅ **完全认同您的想法！**
鉁?**瀹屽叏璁ゅ悓鎮ㄧ殑鎯虫硶锛?*
架构设计是地基，地基不牢，后面开发会很痛苦。
鏋舵瀯璁捐<EFBFBD>鏄<EFBFBD>湴鍩猴紝鍦板熀涓嶇墷锛屽悗闈㈠紑鍙戜細寰堢棝鑻︺€?
我们先把架构和文档梳理清楚，再开始开发。
鎴戜滑鍏堟妸鏋舵瀯鍜屾枃妗ｆ⒊鐞嗘竻妤氾紝鍐嶅紑濮嬪紑鍙戙€?
---
**鎺ヤ笅鏉ユ偍鎯宠<E98EAF>璁轰粈涔堬紵**
1. LLM大模型网关的详细设计？
1. LLM澶фā鍨嬬綉鍏崇殑璇︾粏璁捐<EFBFBD>锛?
2. 鏁版嵁搴揝chema闅旂<E99785>鐨勫叿浣撳疄鏂斤紵
3. ASL妯″潡鐨勫紑鍙戣<E98D99>鍒掞紵
4. 瀹＄ǹ绯荤粺鐨勭嫭绔嬭<E7BB94>鍒掞紵
5. 其他架构问题？
5. 鍏朵粬鏋舵瀯闂<EFBFBD><EFBFBD>锛?

126
docs/00-系统总体设计/00-阅读指南.md
View File

@@ -1,157 +1,157 @@
# 绯荤粺鎬讳綋璁捐<E79281> - 闃呰<E99783>鎸囧崡
> **文档日期：** 2025-11-06
> **文档目的：** 快速导航，找到您需要的文档
> **鏂囨。鏃ユ湡锛?* 2025-11-06
> **鏂囨。鐩<EFBFBD>殑锛?* 蹇<>€熷<E282AC>鑸<EFBFBD>紝鎵惧埌鎮ㄩ渶瑕佺殑鏂囨。
---
## 馃幆 濡傛灉鎮ㄦ兂...
### 蹇<>€熶簡瑙ｄ粖澶╃殑鎴愭灉
👉 **必读：** [00-今日架构设计总结](./00-今日架构设计总结.md)
馃憠 **蹇呰<E8B987>锛?* [00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨](./00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨.md)
- 7涓<37>牳蹇冩枃妗ｆ€昏<E282AC>
- 鍏抽敭鍐崇瓥鎬荤粨
- 下一步建议
- 涓嬩竴姝ュ缓璁?
---
### 浜嗚В鏁翠釜绯荤粺鏋舵瀯
👉 **必读：** [08-架构设计全景图](./08-架构设计全景图.md)
- 一图看懂完整架构
馃憠 **蹇呰<E8B987>锛?* [08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥綸(./08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md)
- 涓€鍥剧湅鎳傚畬鏁存灦鏋?
- 鍥涚<E98DA5>閮ㄧ讲妯″紡
- 浠ｇ爜缁勭粐缁撴瀯
👉 **详细了解：** [01-系统架构分层设计](./01-系统架构分层设计.md)
馃憠 **璇︾粏浜嗚В锛?* [01-绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>](./01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md)
- 涓夊眰鏋舵瀯璇︾粏璁捐<E79281>
- 8个业务模块
- 8涓<EFBFBD>笟鍔℃ā鍧?
- 5涓<35>€氱敤鑳藉姏
- 渚濊禆鍏崇郴鍒嗘瀽
---
### 做出下一步行动决策
👉 **必读：** [99-下一步行动决策建议](./99-下一步行动决策建议.md)
- 3个方案对比（立即开发 vs 先改造 vs 折中）
### 鍋氬嚭涓嬩竴姝ヨ<EFBFBD>鍔ㄥ喅绛?
馃憠 **蹇呰<E8B987>锛?* [99-涓嬩竴姝ヨ<E5A79D>鍔ㄥ喅绛栧缓璁甝(./99-涓嬩竴姝ヨ<E5A79D>鍔ㄥ喅绛栧缓璁?md)
- 3涓<33>柟妗堝<E5A697>姣旓紙绔嬪嵆寮€鍙?vs 鍏堟敼閫?vs 鎶樹腑锛?
- 鎴愭湰鏀剁泭鍒嗘瀽
- 鏄庣‘鐨勫缓璁<E7BC93>拰瀹炴柦璁″垝
---
### 了解数据库架构
👉 **先看：** [03-数据库架构说明](./03-数据库架构说明.md)
- PostgreSQL是Docker部署的
### 浜嗚В鏁版嵁搴撴灦鏋?
馃憠 **鍏堢湅锛?* [03-鏁版嵁搴撴灦鏋勮<EFBFBD>鏄嶿(./03-鏁版嵁搴撴灦鏋勮<E98F8B>鏄?md)
- PostgreSQL鏄疍ocker閮ㄧ讲鐨?
- 鎮ㄦ湁鑷<E6B981>繁鐙<E7B981>珛鐨勬暟鎹<E69A9F>簱
- 涓嶥ify鏁版嵁搴撶殑鍏崇郴
👉 **深入了解：** [05-Schema隔离方案与成本分析](./05-Schema隔离方案与成本分析.md)
馃憠 **娣卞叆浜嗚В锛?* [05-Schema闅旂<EFBFBD>鏂规<EFBFBD>涓庢垚鏈<EFBFBD>垎鏋怾(./05-Schema闅旂<E99785>鏂规<E98F82>涓庢垚鏈<E59E9A>垎鏋?md)
- 閫昏緫闅旂<E99785> vs 鐗╃悊闅旂<E99785>
- 改造成本对比（现在1周 vs 未来3-5周）
- 鏀归€犳垚鏈<E59E9A><E98F88>姣旓紙鐜板湪1鍛?vs 鏈<>潵3-5鍛<35>級
- 瀹炴柦鏂规<E98F82>
---
### 浜嗚В濡備綍妯″潡鐙<E6BDA1>珛閮ㄧ讲
👉 **必读：** [06-模块独立部署与单机版方案](./06-模块独立部署与单机版方案.md)
馃憠 **蹇呰<E8B987>锛?* [06-妯″潡鐙<EFBFBD>珛閮ㄧ讲涓庡崟鏈虹増鏂规<EFBFBD>](./06-妯″潡鐙<E6BDA1>珛閮ㄧ讲涓庡崟鏈虹増鏂规<E98F82>.md)
- 瀹屾暣鎵撳寘鏂规<E98F82>锛堢嫭绔嬩骇鍝侊級
- 共享服务方案（平台内模块）
- Electron单机版架构
- 代码复用率分析（85%+）
- 鍏变韩鏈嶅姟鏂规<EFBFBD>锛堝钩鍙板唴妯″潡锛?
- Electron鍗曟満鐗堟灦鏋?
- 浠ｇ爜澶嶇敤鐜囧垎鏋愶紙85%+锛?
---
### 了解运营管理端
👉 **必读：** [04-运营管理端架构设计](./04-运营管理端架构设计.md)
- 15个功能模块
### 浜嗚В杩愯惀绠＄悊绔?
馃憠 **蹇呰<E8B987>锛?* [04-杩愯惀绠＄悊绔<E6828A>灦鏋勮<E98F8B>璁<EFBFBD>(./04-杩愯惀绠＄悊绔<E6828A>灦鏋勮<E98F8B>璁?md)
- 15涓<35>姛鑳芥ā鍧?
- 3闃舵<E99783>瀹炴柦璁″垝
- 对系统的6大影响
- 瀵圭郴缁熺殑6澶у奖鍝?
---
### 浜嗚В鏄<D092>惁闇€瑕丮onorepo
👉 **必读：** [07-Monorepo架构评估](./07-Monorepo架构评估.md)
- 当前阶段需要吗？
- 成本对比（现在2-3天 vs 未来7-11天）
馃憠 **蹇呰<E8B987>锛?* [07-Monorepo鏋舵瀯璇勪及](./07-Monorepo鏋舵瀯璇勪及.md)
- 褰撳墠闃舵<EFBFBD>闇€瑕佸悧锛?
- 鎴愭湰瀵规瘮锛堢幇鍦?-3澶?vs 鏈<>潵7-11澶╋級
- 瀹炴柦鏂规<E98F82>
---
### 浜嗚В鏂囨。浣撶郴濡備綍閲嶆瀯
👉 **必读：** [02-文档体系重构方案v2.0](./02-文档体系重构方案.md)
- 新文档结构设计
馃憠 **蹇呰<E8B987>锛?* [02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>v2.0](./02-鏂囨。浣撶郴閲嶆瀯鏂规<EFBFBD>.md)
- 鏂版枃妗ｇ粨鏋勮<EFBFBD>璁?
- 8涓<38>ā鍧楃殑鏍囧噯鏂囨。妯℃澘
- 杩佺Щ璁″垝
---
### 浜嗚В鎵€鏈夋灦鏋勯棶棰樼殑绛旀<E7BB9B>
👉 **必读：** [00-核心问题解答](./00-核心问题解答.md)
- 部署模式调整（3种，不考虑混合部署）
- 审稿系统独立性分析
- 数据库架构澄清
馃憠 **蹇呰<E8B987>锛?* [00-鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟](./00-鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟.md)
- 閮ㄧ讲妯″紡璋冩暣锛?绉嶏紝涓嶈€冭檻娣峰悎閮ㄧ讲锛?
- 瀹＄ǹ绯荤粺鐙<EFBFBD>珛鎬у垎鏋?
- 鏁版嵁搴撴灦鏋勬緞娓?
---
## 馃搳 鏂囨。闃呰<E99783>椤哄簭寤鸿<E5AFA4>
### 路径1：快速了解（20分钟）
### 璺<EFBFBD>緞1锛氬揩閫熶簡瑙ｏ紙20鍒嗛挓锛?
1. [00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨](./00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨.md) - 5鍒嗛挓
2. [08-架构设计全景图](./08-架构设计全景图.md) - 10分钟
3. [99-下一步行动决策建议](./99-下一步行动决策建议.md) - 5分钟
2. [08-鏋舵瀯璁捐<EFBFBD>鍏ㄦ櫙鍥綸(./08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md) - 10鍒嗛挓
3. [99-涓嬩竴姝ヨ<EFBFBD>鍔ㄥ喅绛栧缓璁甝(./99-涓嬩竴姝ヨ<E5A79D>鍔ㄥ喅绛栧缓璁?md) - 5鍒嗛挓
---
### 路径2：全面理解（1-2小时）
### 璺<EFBFBD>緞2锛氬叏闈㈢悊瑙ｏ紙1-2灏忔椂锛?
1. [00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨](./00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨.md) - 10鍒嗛挓
2. [01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>](./01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md) - 30鍒嗛挓
3. [05-Schema隔离方案与成本分析](./05-Schema隔离方案与成本分析.md) - 20分钟
3. [05-Schema闅旂<EFBFBD>鏂规<EFBFBD>涓庢垚鏈<EFBFBD>垎鏋怾(./05-Schema闅旂<E99785>鏂规<E98F82>涓庢垚鏈<E59E9A>垎鏋?md) - 20鍒嗛挓
4. [07-Monorepo鏋舵瀯璇勪及](./07-Monorepo鏋舵瀯璇勪及.md) - 15鍒嗛挓
5. [99-下一步行动决策建议](./99-下一步行动决策建议.md) - 10分钟
5. [99-涓嬩竴姝ヨ<EFBFBD>鍔ㄥ喅绛栧缓璁甝(./99-涓嬩竴姝ヨ<E5A79D>鍔ㄥ喅绛栧缓璁?md) - 10鍒嗛挓
---
### 路径3：深入研究（3-4小时）
### 璺<EFBFBD>緞3锛氭繁鍏ョ爺绌讹紙3-4灏忔椂锛?
按顺序阅读所有10个文档
鎸夐『搴忛槄璇绘墍鏈?0涓<30>枃妗?
---
## 馃幆 鍏抽敭缁撹<E7BC81>閫熸煡
### Schema闅旂<E99785>
- **建议：** 现在做 ⭐⭐⭐⭐⭐
- **成本：** 1周 vs 未来3-5周
- **ROI：** 300-500%
- **寤鸿<EFBFBD>锛?* 鐜板湪鍋?猸愨瓙猸愨瓙猸?
- **鎴愭湰锛?* 1鍛?vs 鏈<EFBFBD>潵3-5鍛?
- **ROI锛?* 300-500%
### Monorepo
- **建议：** 现在转换 ⭐⭐⭐⭐⭐
- **成本：** 2-3天 vs 未来7-11天
- **ROI：** 300-400%
- **触发条件：** 近期开发运营管理端，必须转换
- **寤鸿<EFBFBD>锛?* 鐜板湪杞<E6B9AA>崲 猸愨瓙猸愨瓙猸?
- **鎴愭湰锛?* 2-3澶?vs 鏈<EFBFBD>潵7-11澶?
- **ROI锛?* 300-400%
- **瑙﹀彂鏉′欢锛?* 杩戞湡寮€鍙戣繍钀ョ<E99280>鐞嗙<E9909E>锛屽繀椤昏浆鎹?
### 下一步行动
- **方案A：** 立即开发ASL（累积技术债）
- **方案B：** 先改造架构，再开发ASL（强烈推荐）⭐⭐⭐⭐⭐
- **方案C：** 只做Monorepo，延后Schema隔离
### 涓嬩竴姝ヨ<EFBFBD>鍔?
- **鏂规<EFBFBD>A锛?* 绔嬪嵆寮€鍙慉SL锛堢疮绉<E796AE>妧鏈<E5A6A7>€猴級
- **鏂规<EFBFBD>B锛?* 鍏堟敼閫犳灦鏋勶紝鍐嶅紑鍙慉SL锛堝己鐑堟帹鑽愶級猸愨瓙猸愨瓙猸?
- **鏂规<EFBFBD>C锛?* 鍙<>仛Monorepo锛屽欢鍚嶴chema闅旂<EFBFBD>
---
## 馃摑 浠婃棩鎴愭灉
**瀹屾垚鐨勬枃妗ｏ細**
1. ✅ 00-核心问题解答.md
2. ✅ 01-系统架构分层设计.md（900+行）
3. ✅ 02-文档体系重构方案v2.0.md（790+行）
4. ✅ 03-数据库架构说明.md（434+行）
5. ✅ 04-运营管理端架构设计.md（859+行）
6. ✅ 05-Schema隔离方案与成本分析.md（1042+行）
7. ✅ 06-模块独立部署与单机版方案.md（1541+行）
8. ✅ 07-Monorepo架构评估.md（555+行）
9. ✅ 08-架构设计全景图.md
10. ✅ 99-下一步行动决策建议.md
1. 鉁?00-鏍稿績闂<EFBFBD><EFBFBD>瑙ｇ瓟.md
2. 鉁?01-绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>.md锛?00+琛岋級
3. 鉁?02-鏂囨。浣撶郴閲嶆瀯鏂规<EFBFBD>v2.0.md锛?90+琛岋級
4. 鉁?03-鏁版嵁搴撴灦鏋勮<EFBFBD>鏄?md锛?34+琛岋級
5. 鉁?04-杩愯惀绠＄悊绔<EFBFBD>灦鏋勮<EFBFBD>璁?md锛?59+琛岋級
6. 鉁?05-Schema闅旂<EFBFBD>鏂规<EFBFBD>涓庢垚鏈<EFBFBD>垎鏋?md锛?042+琛岋級
7. 鉁?06-妯″潡鐙<EFBFBD>珛閮ㄧ讲涓庡崟鏈虹増鏂规<EFBFBD>.md锛?541+琛岋級
8. 鉁?07-Monorepo鏋舵瀯璇勪及.md锛?55+琛岋級
9. 鉁?08-鏋舵瀯璁捐<EFBFBD>鍏ㄦ櫙鍥?md
10. 鉁?99-涓嬩竴姝ヨ<EFBFBD>鍔ㄥ喅绛栧缓璁?md
**总计：** 6000+行详细设计
**鎬昏<EFBFBD>锛?* 6000+琛岃<E7909B>缁嗚<E7BC81>璁?
---

828
docs/00-系统总体设计/01-系统架构分层设计.md
View File

File diff suppressed because it is too large Load Diff

1465
docs/00-系统总体设计/02-文档体系重构方案.md
View File

File diff suppressed because it is too large Load Diff

220
docs/00-系统总体设计/03-数据库架构说明.md
View File

@@ -1,19 +1,19 @@
# 数据库架构说明
# <EFBFBD>唳旿摨𤘪沲<EFBFBD><EFBFBD>秩<EFBFBD>?
> **创建日期：** 2025-11-06
> **文档目的：** 澄清数据库部署方式和架构
> **<EFBFBD>𥕦遣<EFBFBD>交<EFBFBD>嚗?* 2025-11-06
> **<EFBFBD><EFBFBD>﹝<EFBFBD>桃<EFBFBD>嚗?* 瞉<><E79E89><EFBFBD>唳旿摨㯄<E691A8>蝵脫䲮撘誩<E69298><E8AAA9>嗆<EFBFBD>
---
## <20><> <20>詨<EFBFBD>瞉<EFBFBD><E79E89>
### ✅ 您有自己独立的PostgreSQL数据库！
### <EFBFBD>?<3F>冽<EFBFBD><E586BD>芸楛<E88AB8>祉<EFBFBD><E7A589><EFBFBD>ostgreSQL<EFBFBD>唳旿摨橒<EFBFBD>
**关键事实：**
1. ✅ PostgreSQL是通过Docker部署的（`docker-compose.yml`）
2. ✅ 这是您项目的独立数据库，不是Dify的
3. ✅ Dify有自己完全独立的数据库（在`dify/docker/`目录下）
4. ✅ 您不需要手动安装PostgreSQL，Docker会自动创建
**<EFBFBD>喲睸鈭见<EFBFBD>嚗?*
1. <EFBFBD>?PostgreSQL<EFBFBD>舫<EFBFBD>朞<EFBFBD>Docker<EFBFBD>函蔡<EFBFBD><EFBFBD><EFBFBD>`docker-compose.yml`嚗?
2. <EFBFBD>?餈蹱糓<E8B9B1>券★<E588B8>桃<EFBFBD><E6A183>祉<EFBFBD><E7A589>唳旿摨橒<E691A8>銝齿糓Dify<EFBFBD>?
3. <EFBFBD>?Dify<EFBFBD>㕑䌊撌勗<EFBFBD><EFBFBD>函𡠺蝡讠<EFBFBD><EFBFBD>唳旿摨橒<EFBFBD><EFBFBD>灼dify/docker/`<EFBFBD>桀<EFBFBD>銝页<EFBFBD>
4. <EFBFBD>?<3F>其<EFBFBD><E585B6><EFBFBD>閬<EFBFBD><E996AC><EFBFBD>典<EFBFBD>鋆<EFBFBD>ostgreSQL嚗㷉ocker隡朞䌊<EFBFBD>典<EFBFBD>撱?
---
@@ -25,18 +25,18 @@
# 雿滨蔭嚗鋫Iclinicalresearch/docker-compose.yml
services:
# PostgreSQL 数据库
# PostgreSQL <EFBFBD>唳旿摨?
postgres:
image: postgres:15-alpine # 雿輻鍂摰䀹䲮PostgreSQL<51>𨅯<EFBFBD>
container_name: ai-clinical-postgres
environment:
POSTGRES_DB: ai_clinical_research # <20>唳旿摨枏<E691A8>
POSTGRES_USER: postgres # 用户名
POSTGRES_USER: postgres # <EFBFBD>冽<EFBFBD><EFBFBD>?
POSTGRES_PASSWORD: postgres123 # 撖<><E69296>
ports:
- "5432:5432" # 蝡臬藁<E887AC>惩<EFBFBD>
volumes:
- postgres_data:/var/lib/postgresql/data # 数据持久化
- postgres_data:/var/lib/postgresql/data # <EFBFBD>唳旿<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
networks:
- ai-clinical-network
healthcheck:
@@ -58,14 +58,14 @@ services:
volumes:
postgres_data: # PostgreSQL<51>唳旿<E594B3>瘀<EFBFBD><E79880>唳旿<E594B3><E697BF><EFBFBD><EFBFBD>硋<EFBFBD><E7A18B>剁<EFBFBD>
redis_data: # Redis数据卷
redis_data: # Redis<EFBFBD>唳旿<EFBFBD>?
```
---
## <20><> <20>臬𢆡瘚<F0A286A1><E7989A>
### 一键启动脚本（一键启动.bat）
### 銝<EFBFBD><EFBFBD>桀鍳<EFBFBD>刻<EFBFBD><EFBFBD>穿<EFBFBD>銝<EFBFBD><EFBFBD>桀鍳<EFBFBD>?bat嚗?
```batch
[甇仿炊2/7] <20>臬𢆡PostgreSQL<51>朙edis摰孵膥
@@ -79,14 +79,14 @@ docker-compose up -d
5. <20>臬𢆡摰孵膥撟嗅銁<E59785>𤾸蝱餈鞱<E9A488>
```
**您不需要手动安装PostgreSQL！**
- ✅ Docker会自动创建和管理
- ✅ 数据存储在Docker数据卷中，不会丢失
- ✅ 可以通过`localhost:5432`连接
**<EFBFBD>其<EFBFBD><EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD><EFBFBD>典<EFBFBD>鋆<EFBFBD>ostgreSQL嚗?*
- <EFBFBD>?Docker隡朞䌊<EFBFBD>典<EFBFBD>撱箏<EFBFBD>蝞∠<EFBFBD>
- <EFBFBD>?<3F>唳旿摮睃<E691AE><E79D83>求ocker<65>唳旿<E594B3>瑚葉嚗䔶<E59A97>隡帋腺憭?
- <EFBFBD>?<3F>臭誑<E887AD>朞<EFBFBD>`localhost:5432`餈墧𦻖
---
## 🗄️ 数据库连接信息
## <EFBFBD><EFBFBD>儭?<3F>唳旿摨栞<E691A8><E6A09E>乩縑<E4B9A9>?
### 餈墧𦻖<E5A2A7>滨蔭
@@ -95,18 +95,18 @@ docker-compose up -d
postgresql://postgres:postgres123@localhost:5432/ai_clinical_research
```
**拆解：**
- **协议：** postgresql://
**<EFBFBD><EFBFBD>圾嚗?*
- **<EFBFBD>讛悅嚗?* postgresql://
- **<2A>冽<EFBFBD><E586BD>㵪<EFBFBD>** postgres
- **密码：** postgres123
- **主机：** localhost（Docker映射到本地）
- **端口：** 5432
- **数据库名：** ai_clinical_research
- **撖<EFBFBD><EFBFBD>嚗?* postgres123
- **銝餅㦤嚗?* localhost嚗㇄ocker<EFBFBD>惩<EFBFBD><EFBFBD>唳𧋦<EFBFBD>堆<EFBFBD>
- **蝡臬藁嚗?* 5432
- **<EFBFBD>唳旿摨枏<EFBFBD>嚗?* ai_clinical_research
### 后端配置（backend/.env）
### <EFBFBD>𡒊垢<EFBFBD>滨蔭嚗Ê̄ackend/.env嚗?
```bash
# 数据库连接
# <EFBFBD>唳旿摨栞<EFBFBD><EFBFBD>?
DATABASE_URL=postgresql://postgres:postgres123@localhost:5432/ai_clinical_research
# 餈嗘葵餈墧𦻖<E5A2A7><F0A6BB96>糓<EFBFBD>刻䌊撌梁<E6928C>PostgreSQL嚗䔶<E59A97><E494B6>浴ify<66><79><EFBFBD>
@@ -118,85 +118,85 @@ DATABASE_URL=postgresql://postgres:postgres123@localhost:5432/ai_clinical_resear
### 蝟餌<E89D9F>撖寞<E69296>
| 项目 | 您的数据库 | Dify的数据库 |
| 憿寧𤌍 | <20>函<EFBFBD><E587BD>唳旿摨?| Dify<66><79>㺭<EFBFBD>桀<EFBFBD> |
|------|----------|-------------|
| **雿滨蔭** | `AIclinicalresearch/docker-compose.yml` | `dify/docker/docker-compose.yml` |
| **容器名** | `ai-clinical-postgres` | `dify-db`（猜测） |
| **摰孵膥<EFBFBD>?* | `ai-clinical-postgres` | `dify-db`嚗<EFBFBD><EFBFBD>瘚页<EFBFBD> |
| **蝡臬藁** | `5432` | <20>航<EFBFBD><E888AA>畔5433`<60>碶<EFBFBD><E7A2B6>湧蠧 |
| **<2A>唳旿摨枏<E691A8>** | `ai_clinical_research` | `dify` |
| **用途** | 存储您项目的业务数据 | 存储Dify的数据 |
| **<EFBFBD>券<EFBFBD>?* | 摮睃<E691AE><E79D83>券★<E588B8>桃<EFBFBD>銝𡁜𦛚<F0A1819C>唳旿 | 摮睃<E691AE>Dify<66><79>㺭<EFBFBD>?|
| **霈輸䔮<E8BCB8>孵<EFBFBD>** | <20>湔𦻖Prisma霈輸䔮 | <20>朞<EFBFBD>Dify API霈輸䔮 |
### 架构图
### <EFBFBD>嗆<EFBFBD><EFBFBD>?
```
┌─────────────────────────────────────────────────────────┐
│ AIclinicalresearch项目 │
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Backend │──────│ PostgreSQL │ │
│ │ (Node.js) │ SQL │ (Docker) │ │
│ │ │ │ │ │
│ │ Prisma │ │ Port: 5432 │ │
│ └──────────────┘ └──────────────┘ │
│ │ │
│ │ HTTP API │
│ ↓ │
│ ┌──────────────┐ │
│ │ Dify │──────> Dify自己的PostgreSQL │
│ │ (Docker) │ (完全独立) │
│ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? AIclinicalresearch憿寧𤌍 <EFBFBD>?
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>𢞖<EFBFBD><F0A29E96><EFBFBD><EFBFBD><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><F0A29E96><EFBFBD><EFBFBD><EFBFBD><EFBFBD><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>? Backend <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? PostgreSQL <EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>? (Node.js) <EFBFBD>?SQL <EFBFBD>? (Docker) <EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>? <EFBFBD>? <EFBFBD>? <EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>? Prisma <EFBFBD>? <EFBFBD>?Port: 5432 <EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>婙<EFBFBD><E5A999><EFBFBD><EFBFBD><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><E5A999><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD>?HTTP API <EFBFBD>?
<EFBFBD>? <EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>𢞖<EFBFBD><F0A29E96><EFBFBD><EFBFBD><EFBFBD><EFBFBD><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>? Dify <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>> Dify<EFBFBD>芸楛<EFBFBD><EFBFBD>ostgreSQL <EFBFBD>?
<EFBFBD>? <20>? (Docker) <EFBFBD>? (摰<EFBFBD><EFBFBD><EFBFBD>祉<EFBFBD>) <EFBFBD>?
<EFBFBD>? <20>婙<EFBFBD><E5A999><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD>?
<EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><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><> 敶枏<E695B6><E69E8F>唳旿摨栞”蝏𤘪<E89D8F>
### 您的PostgreSQL中的表
### <EFBFBD>函<EFBFBD>PostgreSQL銝剔<EFBFBD>銵?
```sql
-- <20>交<EFBFBD>嚗颹ackend/prisma/schema.prisma
-- <20>冽<EFBFBD>璅∪<E79285>
users -- 用户表
users -- <EFBFBD>冽<EFBFBD>銵?
-- 憿寧𤌍璅∪<E79285>
projects -- 项目表
projects -- 憿寧𤌍銵?
-- AI<41>桃<EFBFBD>璅∪<E79285>
conversations -- 对话表
messages -- 消息表
general_conversations -- 通用对话表
general_messages -- 通用消息表
conversations -- 撖寡<EFBFBD>銵?
messages -- 瘨<EFBFBD><EFBFBD>銵?
general_conversations -- <EFBFBD>𡁶鍂撖寡<EFBFBD>銵?
general_messages -- <EFBFBD>𡁶鍂瘨<EFBFBD><EFBFBD>銵?
-- 知识库模块
-- <20>亥<EFBFBD>摨𤘪芋<F0A498AA>?
knowledge_bases -- <20>亥<EFBFBD>摨栞”
documents -- 文档表
documents -- <EFBFBD><EFBFBD>﹝銵?
-- 批处理模块（Phase 3）
-- <20>孵<EFBFBD><E5ADB5><EFBFBD>芋<EFBFBD>梹<EFBFBD>Phase 3嚗?
batch_tasks -- <20>孵<EFBFBD><E5ADB5><EFBFBD>遙<EFBFBD>∟”
batch_results -- <20>孵<EFBFBD><E5ADB5><EFBFBD><EFBFBD><EFBFBD>𡏭”
task_templates -- 任务模板表
task_templates -- 隞餃𦛚璅⊥踎銵?
-- 蝔蹂辣摰⊥䰻璅∪<E79285>
review_tasks -- 稿件审查任务表
review_tasks -- 蝔蹂辣摰⊥䰻隞餃𦛚銵?
-- 餈鞱𨯫蝞∠<E89D9E>璅∪<E79285>
admin_logs -- 蝞∠<E89D9E><E288A0>䀹𠯫敹𡑒”
```
**总计：16张表，全部在您自己的PostgreSQL中。**
**<EFBFBD>餉恣嚗?6撘㰘”嚗<E2809D><E59A97><EFBFBD>典銁<E585B8>刻䌊撌梁<E6928C>PostgreSQL銝准<EFBFBD>?*
---
## <20>圲 撣貊鍂<E8B28A>滢<EFBFBD>
### 查看Docker容器状态
### <EFBFBD>亦<EFBFBD>Docker摰孵膥<EFBFBD>嗆<EFBFBD>?
```bash
# 查看所有容器
# <20>亦<EFBFBD><E4BAA6><EFBFBD><EFBFBD>匧捆<E58CA7>?
docker ps
# 摨磰砲<E7A3B0>賜<EFBFBD><E8B39C>堆<EFBFBD>
@@ -211,15 +211,15 @@ docker ps
# 餈𥕦<E9A488>PostgreSQL摰孵膥
docker exec -it ai-clinical-postgres psql -U postgres -d ai_clinical_research
# 然后可以执行SQL：
# <EFBFBD>嗅<EFBFBD><EFBFBD>臭誑<EFBFBD>扯<EFBFBD>SQL嚗?
\dt # <20>亦<EFBFBD><E4BAA6><EFBFBD><EFBFBD>㕑”
\d users # 查看users表结构
\d users # <EFBFBD>亦<EFBFBD>users銵函<EFBFBD><EFBFBD>?
SELECT * FROM users LIMIT 10;
```
**方法2：使用数据库客户端**
**<EFBFBD>寞<EFBFBD>2嚗帋蝙<EFBFBD>冽㺭<EFBFBD>桀<EFBFBD>摰Ｘ<EFBFBD>蝡?*
- **DBeaver** / **pgAdmin** / **DataGrip** / **Navicat**
- 连接信息：
- 餈墧𦻖靽⊥<E99DBD>嚗?
- Host: `localhost`
- Port: `5432`
- Database: `ai_clinical_research`
@@ -239,7 +239,7 @@ docker-compose up -d
docker-compose restart postgres
```
### 查看数据库日志
### <EFBFBD>亦<EFBFBD><EFBFBD>唳旿摨𤘪𠯫敹?
```bash
# <20>亦<EFBFBD>PostgreSQL<51>亙<EFBFBD>
@@ -251,7 +251,7 @@ docker logs -f ai-clinical-postgres
---
## 💾 数据持久化
## <EFBFBD>𠒣 <20>唳旿<E594B3><E697BF><EFBFBD><EFBFBD>?
### <20>唳旿摮睃<E691AE>雿滨蔭
@@ -260,22 +260,22 @@ docker logs -f ai-clinical-postgres
postgres_data:/var/lib/postgresql/data
```
**实际存储位置：**
**摰鮋<EFBFBD>摮睃<EFBFBD>雿滨蔭嚗?*
- Windows: `C:\ProgramData\Docker\volumes\aiclinicalresearch_postgres_data\_data`
- Mac/Linux: `/var/lib/docker/volumes/aiclinicalresearch_postgres_data/_data`
**重要：**
- ✅ 即使删除容器（`docker-compose down`），数据不会丢失
- ✅ 数据存储在Docker数据卷中，持久化保存
- ⚠️ 只有执行`docker-compose down -v`（删除数据卷）才会清空数据
**<EFBFBD>滩<EFBFBD>嚗?*
- <20>?<3F>喃蝙<E59683>𣳇膄摰孵膥嚗Ǒdocker-compose down`嚗㚁<EFBFBD><EFBFBD>唳旿銝滢<EFBFBD>銝Ｗ仃
- <EFBFBD>?<3F>唳旿摮睃<E691AE><E79D83>求ocker<65>唳旿<E594B3>瑚葉嚗峕<E59A97>銋<EFBFBD><E98A8B>靽嘥<E99DBD>
- <EFBFBD>𩤃<EFBFBD> <20>芣<EFBFBD><E88AA3>扯<EFBFBD>`docker-compose down -v`嚗<EFBFBD><EFBFBD><EFBFBD>斗㺭<EFBFBD>桀㭘嚗㗇<EFBFBD>隡𡁏<EFBFBD>蝛箸㺭<EFBFBD>?
### 备份数据库
### 憭<EFBFBD>遢<EFBFBD>唳旿摨?
```bash
# 备份（导出SQL）
# 憭<EFBFBD>遢嚗<EFBFBD>紡<EFBFBD>搴QL嚗?
docker exec ai-clinical-postgres pg_dump -U postgres ai_clinical_research > backup.sql
# 恢复（导入SQL）
# <EFBFBD>Ｗ<EFBFBD>嚗<EFBFBD>紡<EFBFBD>兄QL嚗?
docker exec -i ai-clinical-postgres psql -U postgres ai_clinical_research < backup.sql
```
@@ -283,7 +283,7 @@ docker exec -i ai-clinical-postgres psql -U postgres ai_clinical_research < back
## <20>㴓 <20>芣䔉嚗锭chema<6D>𠉛氖霈∪<E99C88>
### 当前状态
### 敶枏<EFBFBD><EFBFBD>嗆<EFBFBD>?
```sql
-- <20><><EFBFBD>㕑”<E39591>賢銁public schema
@@ -296,7 +296,7 @@ public.review_tasks
...
```
### 目标架构（Schema隔离）
### <EFBFBD>格<EFBFBD><EFBFBD>嗆<EFBFBD>嚗𠄎chema<EFBFBD>𠉛氖嚗?
```sql
-- 撟喳蝱撅<E89DB1>chema
@@ -311,7 +311,7 @@ aia_schema.projects
aia_schema.conversations
aia_schema.messages
CREATE SCHEMA pkb_schema; -- 个人知识库
CREATE SCHEMA pkb_schema; -- 銝芯犖<EFBFBD>亥<EFBFBD>摨?
pkb_schema.knowledge_bases
pkb_schema.documents
@@ -325,15 +325,15 @@ review_schema.review_tasks
review_schema.review_journals
```
**实施计划：**
- **阶段一（立即）：** 逻辑隔离，使用表名前缀（`aia_projects`, `asl_projects`）
**摰墧鴌霈∪<EFBFBD>嚗?*
- **<EFBFBD>嗆挾銝<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>喉<EFBFBD>嚗?* <20>餉<EFBFBD><E9A489>𠉛氖嚗䔶蝙<E494B6>刻”<E588BB>滚<EFBFBD>蝻<EFBFBD>嚗Ǒaia_projects`, `asl_projects`嚗?
- **<2A>嗆挾鈭䕘<E988AD>敺格<E695BA><E6A0BC>⊥<EFBFBD><E28AA5><EFBFBD>𧒄嚗㚁<E59A97>** <20>拍<EFBFBD><E68B8D>𠉛氖嚗<E6B096><E59A97>撱箇<E692B1>甇<EFBFBD><E79487>Schema
---
## 🔍 Dify数据库（独立系统）
## <EFBFBD><EFBFBD> Dify<EFBFBD>唳旿摨橒<EFBFBD><EFBFBD>祉<EFBFBD>蝟餌<EFBFBD>嚗?
### Dify的部署
### Dify<EFBFBD><EFBFBD><EFBFBD>蝵?
```
dify/docker/docker-compose.yml
@@ -345,17 +345,17 @@ dify/docker/docker-compose.yml
```
**<EFBFBD>喲睸<EFBFBD>對<EFBFBD>**
- ✅ Dify有自己完全独立的docker-compose.yml
- ✅ Dify的PostgreSQL是独立的容器
- ✅ 您的项目不直接访问Dify的数据库
- ✅ 通过Dify API（HTTP REST）调用Dify功能
- <EFBFBD>?Dify<EFBFBD>㕑䌊撌勗<EFBFBD><EFBFBD>函𡠺蝡讠<EFBFBD>docker-compose.yml
- <EFBFBD>?Dify<EFBFBD><EFBFBD>ostgreSQL<EFBFBD>舐𡠺蝡讠<EFBFBD>摰孵膥
- <EFBFBD>?<3F>函<EFBFBD>憿寧𤌍銝滨凒<E6BBA8>亥挪<E4BAA5>唏ify<66><79>㺭<EFBFBD>桀<EFBFBD>
- <EFBFBD>?<3F>朞<EFBFBD>Dify API嚗𠃍TTP REST嚗㕑<EFBFBD><EFBFBD>求ify<EFBFBD>蠘<EFBFBD>
### <20>函<EFBFBD>憿寧𤌍憒<F0A48C8D><E68692>雿輻鍂Dify
```typescript
// 銝齿糓<E9BDBF>湔𦻖霈輸䔮Dify<66>唳旿摨橒<E691A8><E6A992>峕糓<E5B395>朞<EFBFBD>API
// 创建知识库
// <EFBFBD>𥕦遣<EFBFBD>亥<EFBFBD>摨?
const response = await fetch('http://localhost/v1/datasets', {
method: 'POST',
headers: {
@@ -363,7 +363,7 @@ const response = await fetch('http://localhost/v1/datasets', {
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '我的知识库'
name: '<EFBFBD>𤑳<EFBFBD><EFBFBD>亥<EFBFBD>摨?
})
});
@@ -379,12 +379,12 @@ await fetch(`http://localhost/v1/datasets/${datasetId}/document/create-by-file`,
});
```
**您的数据库中存储：**
**<EFBFBD>函<EFBFBD><EFBFBD>唳旿摨㮖葉摮睃<EFBFBD>嚗?*
```sql
-- knowledge_bases表
-- knowledge_bases銵?
{
id: 'uuid',
name: '我的知识库',
name: '<EFBFBD>𤑳<EFBFBD><EFBFBD>亥<EFBFBD>摨?,
dify_dataset_id: 'xxx' -- <20>唾<EFBFBD>Dify<66><79>ataset_id
}
```
@@ -395,39 +395,39 @@ await fetch(`http://localhost/v1/datasets/${datasetId}/document/create-by-file`,
### <20>詨<EFBFBD>閬<EFBFBD><E996AC>
1. ✅ **您有自己的PostgreSQL数据库**
- 通过Docker部署（`docker-compose.yml`）
1. <EFBFBD>?**<2A>冽<EFBFBD><E586BD>芸楛<E88AB8><E6A59B>ostgreSQL<EFBFBD>唳旿摨?*
- <EFBFBD>朞<EFBFBD>Docker<EFBFBD>函蔡嚗Ǒdocker-compose.yml`嚗?
- 摰孵膥<E5ADB5>㵪<EFBFBD>`ai-clinical-postgres`
- <20>唳旿摨枏<E691A8>嚗䫤ai_clinical_research`
2. ✅ **您不需要手动安装PostgreSQL**
- `docker-compose up -d`会自动创建
2. <EFBFBD>?**<2A>其<EFBFBD><E585B6><EFBFBD>閬<EFBFBD><E996AC><EFBFBD>典<EFBFBD>鋆<EFBFBD>ostgreSQL**
- `docker-compose up -d`隡朞䌊<EFBFBD>典<EFBFBD>撱?
- <20>唳旿<E594B3><E697BF><EFBFBD><EFBFBD>硋<EFBFBD><E7A18B>典銁Docker<65>唳旿<E594B3>瑚葉
3. ✅ **Dify是完全独立的系统**
- 有自己的PostgreSQL数据库
- 您通过Dify API访问，不直接访问数据库
3. <EFBFBD>?**Dify<EFBFBD>臬<EFBFBD><EFBFBD>函𡠺蝡讠<EFBFBD>蝟餌<EFBFBD>**
- <EFBFBD>㕑䌊撌梁<EFBFBD>PostgreSQL<EFBFBD>唳旿摨?
- <EFBFBD>券<EFBFBD>朞<EFBFBD>Dify API霈輸䔮嚗䔶<EFBFBD><EFBFBD>湔𦻖霈輸䔮<EFBFBD>唳旿摨?
4. ✅ **当前16张表全部在您的PostgreSQL中**
4. <EFBFBD>?**敶枏<E695B6>16撘㰘”<E3B098>券<EFBFBD><E588B8>冽<EFBFBD><E586BD><EFBFBD>ostgreSQL銝?*
- <20>冽<EFBFBD><E586BD><EFBFBD>★<EFBFBD>柴<EFBFBD><E69FB4>笆霂腈<E99C82><E88588>䰻霂<E4B0BB><E99C82><EFBFBD><EFBFBD><EFBFBD>獢<EFBFBD><E78DA2><EFBFBD>鸌憭<E9B88C><E686AD><EFBFBD><EFBFBD>阮隞嗅恣<E59785>亦<EFBFBD>
- <20>券<EFBFBD><E588B8>灼public` schema嚗<61>𧊋<EFBFBD>仿<EFBFBD>閬<EFBFBD><E996AC>蝳鳴<E89DB3>
### 为什么您不记得安装PostgreSQL？
### 銝箔<EFBFBD>銋<EFBFBD><EFBFBD>銝滩扇敺堒<EFBFBD>鋆<EFBFBD>ostgreSQL嚗?
**<EFBFBD>牐蛹<EFBFBD>冽覔<EFBFBD>祆瓷<EFBFBD>㗇<EFBFBD><EFBFBD>典<EFBFBD>鋆<EFBFBD><EFBFBD>** <20><>
- ✅ Docker自动下载镜像
- ✅ Docker自动创建容器
- ✅ 一键启动脚本自动启动
- ✅ 您只需要运行`一键启动.bat`
- <EFBFBD>?Docker<EFBFBD>芸𢆡銝贝蝸<EFBFBD>𨅯<EFBFBD>
- <EFBFBD>?Docker<EFBFBD>芸𢆡<EFBFBD>𥕦遣摰孵膥
- <EFBFBD>?銝<><E98A9D>桀鍳<E6A180>刻<EFBFBD><E588BB>祈䌊<E7A588>典鍳<E585B8>?
- <EFBFBD>?<3F>典蘨<E585B8><E898A8>閬<EFBFBD><E996AC>銵䈣銝<E488A3><E98A9D>桀鍳<E6A180>?bat`
**餈坔停<E59D94>浴ocker<65><72><EFBFBD><EFBFBD>𨥈<EFBFBD>**
---
**需要进一步了解的内容：**
1. 如何备份和恢复数据库？
2. 如何迁移到Schema隔离架构？
**<EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD>銝<EFBFBD>甇乩<EFBFBD>閫<EFBFBD><EFBFBD><EFBFBD><EFBFBD>捆嚗?*
1. 憒<EFBFBD><EFBFBD>憭<EFBFBD>遢<EFBFBD>峕<EFBFBD>憭齿㺭<EFBFBD>桀<EFBFBD>嚗?
2. 憒<EFBFBD><EFBFBD>餈<EFBFBD>宏<EFBFBD>訕chema<EFBFBD>𠉛氖<EFBFBD>嗆<EFBFBD>嚗?
3. 憒<><E68692>餈墧𦻖<E5A2A7>唳旿摨栞<E691A8>銵峕<E98AB5><E5B395>冽䰻霂ｇ<E99C82>
4. Prisma憒<61><E68692>蝞∠<E89D9E><E288A0>唳旿摨栞<E691A8>蝘鳴<E89D98>

608
docs/00-系统总体设计/04-运营管理端架构设计.md
View File

File diff suppressed because it is too large Load Diff

594
docs/00-系统总体设计/05-Schema隔离方案与成本分析.md
View File

File diff suppressed because it is too large Load Diff

768
docs/00-系统总体设计/06-模块独立部署与单机版方案.md
View File

File diff suppressed because it is too large Load Diff

478
docs/00-系统总体设计/07-Monorepo架构评估.md
View File

@@ -1,15 +1,15 @@
# Monorepo鏋舵瀯璇勪及 - 褰撳墠闃舵<E99783>鏄<EFBFBD>惁闇€瑕侊紵
> **文档版本：** v1.0
> **创建日期：** 2025-11-06
> **文档目的：** 评估当前阶段采用Monorepo架构的必要性和成本
> **鏂囨。鐗堟湰锛?* v1.0
> **鍒涘缓鏃ユ湡锛?* 2025-11-06
> **鏂囨。鐩<EFBFBD>殑锛?* 璇勪及褰撳墠闃舵<E99783>閲囩敤Monorepo鏋舵瀯鐨勫繀瑕佹€у拰鎴愭湰
---
## 馃<> 鏍稿績闂<E7B8BE><E99782>
1. 褰撳墠闃舵<E99783>闇€瑕佷娇鐢∕onorepo鏋舵瀯鍚楋紵
2. 对当前阶段的成本高吗？
2. 瀵瑰綋鍓嶉樁娈电殑鎴愭湰楂樺悧锛?
3. 浠€涔堟椂鍊欐槸鏈€浣虫椂鏈猴紵
---
@@ -20,32 +20,32 @@
```
AIclinicalresearch/
├── frontend/ # 前端（React + Vite）
│ ├── src/
│ ├── package.json
│ └── node_modules/
│
├── backend/ # 后端（Node.js + Fastify）
│ ├── src/
│ ├── package.json
│ └── node_modules/
│
鈹溾攢鈹€ frontend/ # 鍓嶇<EFBFBD>锛圧eact + Vite锛?
鈹? 鈹溾攢鈹€ src/
鈹? 鈹溾攢鈹€ package.json
鈹? 鈹斺攢鈹€ node_modules/
鈹?
鈹溾攢鈹€ backend/ # 鍚庣<EFBFBD>锛圢ode.js + Fastify锛?
鈹? 鈹溾攢鈹€ src/
鈹? 鈹溾攢鈹€ package.json
鈹? 鈹斺攢鈹€ node_modules/
鈹?
鈹溾攢鈹€ extraction_service/ # Python鏂囨。鎻愬彇鏈嶅姟
│ ├── main.py
│ ├── requirements.txt
│ └── venv/
│
鈹? 鈹溾攢鈹€ main.py
鈹? 鈹溾攢鈹€ requirements.txt
鈹? 鈹斺攢鈹€ venv/
鈹?
鈹溾攢鈹€ docker-compose.yml # Docker閰嶇疆
鈹斺攢鈹€ ...
```
**当前特点：**
- ✅ 结构简单，易于理解
- ✅ 前后端分离，职责清晰
- ✅ 各自独立的依赖管理
- ❌ 没有代码共享机制
- ❌ 重复的配置文件
- ❌ 不支持模块独立打包
**褰撳墠鐗圭偣锛?*
- 鉁?缁撴瀯绠€鍗曪紝鏄撲簬鐞嗚В
- 鉁?鍓嶅悗绔<E68297>垎绂伙紝鑱岃矗娓呮櫚
- 鉁?鍚勮嚜鐙<E59A9C>珛鐨勪緷璧栫<E792A7>鐞?
- 鉂?娌℃湁浠ｇ爜鍏变韩鏈哄埗
- 鉂?閲嶅<E996B2>鐨勯厤缃<E58EA4>枃浠?
- 鉂?涓嶆敮鎸佹ā鍧楃嫭绔嬫墦鍖?
---
@@ -55,59 +55,59 @@ AIclinicalresearch/
```
AIclinicalresearch/
├── packages/ # 共享包
│ ├── platform-core/ # 平台核心（可复用）
│ │ ├── auth/
│ │ ├── storage/
│ │ ├── package.json
│ │ └── tsconfig.json
│ │
│ ├── capabilities-core/ # 通用能力（可复用）
│ │ ├── llm-gateway/
│ │ ├── document-processor/
│ │ ├── package.json
│ │ └── tsconfig.json
│ │
│ └── shared-types/ # 共享类型定义
│ ├── src/
│ ├── package.json
│ └── tsconfig.json
│
鈹溾攢鈹€ packages/ # 鍏变韩鍖?
鈹? 鈹溾攢鈹€ platform-core/ # 骞冲彴鏍稿績锛堝彲澶嶇敤锛?
鈹? 鈹? 鈹溾攢鈹€ auth/
鈹? 鈹? 鈹溾攢鈹€ storage/
鈹? 鈹? 鈹溾攢鈹€ package.json
鈹? 鈹? 鈹斺攢鈹€ tsconfig.json
鈹? 鈹?
鈹? 鈹溾攢鈹€ capabilities-core/ # 閫氱敤鑳藉姏锛堝彲澶嶇敤锛?
鈹? 鈹? 鈹溾攢鈹€ llm-gateway/
鈹? 鈹? 鈹溾攢鈹€ document-processor/
鈹? 鈹? 鈹溾攢鈹€ package.json
鈹? 鈹? 鈹斺攢鈹€ tsconfig.json
鈹? 鈹?
鈹? 鈹斺攢鈹€ shared-types/ # 鍏变韩绫诲瀷瀹氫箟
鈹? 鈹溾攢鈹€ src/
鈹? 鈹溾攢鈹€ package.json
鈹? 鈹斺攢鈹€ tsconfig.json
鈹?
鈹溾攢鈹€ apps/ # 搴旂敤
│ ├── frontend/ # Web前端
│ │ ├── src/
│ │ └── package.json
│ │
│ ├── backend/ # Web后端
│ │ ├── src/
│ │ └── package.json
│ │
│ └── admin-frontend/ # 运营管理端（未来）
│ ├── src/
│ └── package.json
│
鈹? 鈹溾攢鈹€ frontend/ # Web鍓嶇<EFBFBD>
鈹? 鈹? 鈹溾攢鈹€ src/
鈹? 鈹? 鈹斺攢鈹€ package.json
鈹? 鈹?
鈹? 鈹溾攢鈹€ backend/ # Web鍚庣<EFBFBD>
鈹? 鈹? 鈹溾攢鈹€ src/
鈹? 鈹? 鈹斺攢鈹€ package.json
鈹? 鈹?
鈹? 鈹斺攢鈹€ admin-frontend/ # 杩愯惀绠＄悊绔<EFBFBD>紙鏈<EFBFBD>潵锛?
鈹? 鈹溾攢鈹€ src/
鈹? 鈹斺攢鈹€ package.json
鈹?
鈹溾攢鈹€ products/ # 鐙<>珛浜у搧鎵撳寘锛堟湭鏉ワ級
│ ├── review-system/
│ └── literature-system/
│
├── package.json # 根package.json（Workspace配置）
鈹? 鈹溾攢鈹€ review-system/
鈹? 鈹斺攢鈹€ literature-system/
鈹?
鈹溾攢鈹€ package.json # 鏍筽ackage.json锛圵orkspace閰嶇疆锛?
鈹溾攢鈹€ pnpm-workspace.yaml # Workspace閰嶇疆
鈹斺攢鈹€ tsconfig.base.json # 鍏变韩TS閰嶇疆
```
---
## 💰 成本分析：现在 vs 以后
## 馃挵 鎴愭湰鍒嗘瀽锛氱幇鍦?vs 浠ュ悗
### 鏂规<E98F82>A锛氱幇鍦ㄨ浆鎹<E6B586>onorepo
#### 成本（2-3天）
#### 鎴愭湰锛?-3澶╋級
**Day 1：学习和设计（0.5-1天）**
**Day 1锛氬<EFBFBD>涔犲拰璁捐<EFBFBD>锛?.5-1澶╋級**
```
学习内容：
- pnpm workspaces 或 npm workspaces
- 包依赖管理（workspace:*）
瀛︿範鍐呭<EFBFBD>锛?
- pnpm workspaces 鎴?npm workspaces
- 鍖呬緷璧栫<EFBFBD>鐞嗭紙workspace:*锛?
- TypeScript path mapping
- 鍏变韩閰嶇疆锛坱sconfig, eslint绛夛級
@@ -117,7 +117,7 @@ AIclinicalresearch/
**Day 2锛氶噸鏋勭幇鏈変唬鐮侊紙1澶╋級**
```
任务清单：
浠诲姟娓呭崟锛?
1. 鍒涘缓packages/鍜宎pps/鐩<>綍缁撴瀯
2. 绉诲姩frontend鍜宐ackend鍒癮pps/
3. 鎻愬彇鍏变韩绫诲瀷鍒皃ackages/shared-types/
@@ -127,72 +127,72 @@ AIclinicalresearch/
宸ヤ綔閲忥細8灏忔椂
闅惧害锛氣瓙猸愨瓙 涓<>瓑
风险：⭐⭐ 低（有回滚方案）
椋庨櫓锛氣瓙猸?浣庯紙鏈夊洖婊氭柟妗堬級
```
**Day 3：测试和优化（0.5-1天）**
**Day 3锛氭祴璇曞拰浼樺寲锛?.5-1澶╋級**
```
测试内容：
- 前端启动和构建
- 后端启动和构建
娴嬭瘯鍐呭<EFBFBD>锛?
- 鍓嶇<EFBFBD>鍚<EFBFBD>姩鍜屾瀯寤?
- 鍚庣<EFBFBD>鍚<EFBFBD>姩鍜屾瀯寤?
- 渚濊禆瀹夎<E780B9>閫熷害
- 开发体验
- 寮€鍙戜綋楠?
宸ヤ綔閲忥細4-8灏忔椂
```
**总成本：2-3天**
**鎬绘垚鏈<EFBFBD>細2-3澶?*
#### 鏀剁泭
**立即收益：**
1. ✅ 代码共享变容易（类型定义、工具函数等）
2. ✅ 统一的依赖管理（减少重复安装）
3. ✅ 统一的配置（TypeScript、ESLint等）
4. ✅ 为未来打基础
**绔嬪嵆鏀剁泭锛?*
1. 鉁?浠ｇ爜鍏变韩鍙樺<E98D99>鏄擄紙绫诲瀷瀹氫箟銆佸伐鍏峰嚱鏁扮瓑锛?
2. 鉁?缁熶竴鐨勪緷璧栫<E792A7>鐞嗭紙鍑忓皯閲嶅<E996B2>瀹夎<E780B9>锛?
3. 鉁?缁熶竴鐨勯厤缃<E58EA4>紙TypeScript銆丒SLint绛夛級
4. 鉁?涓烘湭鏉ユ墦鍩虹<E98DA9>
**未来收益：**
1. ✅ 新增模块时，可以复用platform-core和capabilities-core
2. ✅ 独立产品打包变简单
3. ✅ Electron单机版开发变容易
4. ✅ 避免未来大规模重构
**鏈<EFBFBD>潵鏀剁泭锛?*
1. 鉁?鏂板<E98F82>妯″潡鏃讹紝鍙<E7B49D>互澶嶇敤platform-core鍜宑apabilities-core
2. 鉁?鐙<>珛浜у搧鎵撳寘鍙樼畝鍗?
3. 鉁?Electron鍗曟満鐗堝紑鍙戝彉瀹规槗
4. 鉁?閬垮厤鏈<E58EA4>潵澶ц<E6BEB6>妯￠噸鏋?
---
### 鏂规<E98F82>B锛氱户缁<E688B7>綋鍓嶇粨鏋勶紝浠ュ悗鍐嶈浆
#### 短期成本（0天）
#### 鐭<EFBFBD>湡鎴愭湰锛?澶╋級
**优点：**
- ✅ 无需学习新技术
- ✅ 无需重构代码
- ✅ 可以立即开始ASL模块开发
**浼樼偣锛?*
- 鉁?鏃犻渶瀛︿範鏂版妧鏈?
- 鉁?鏃犻渶閲嶆瀯浠ｇ爜
- 鉁?鍙<>互绔嬪嵆寮€濮婣SL妯″潡寮€鍙?
**缺点：**
- ❌ 代码重复（前后端类型定义、工具函数等）
- ❌ 依赖管理分散
- ❌ 为未来埋下技术债
**缂虹偣锛?*
- 鉂?浠ｇ爜閲嶅<E996B2>锛堝墠鍚庣<E98D9A>绫诲瀷瀹氫箟銆佸伐鍏峰嚱鏁扮瓑锛?
- 鉂?渚濊禆绠＄悊鍒嗘暎
- 鉂?涓烘湭鏉ュ煁涓嬫妧鏈<E5A6A7>€?
#### 未来成本（1-2周）
#### 鏈<EFBFBD>潵鎴愭湰锛?-2鍛<32>級
**触发条件：**
**瑙﹀彂鏉′欢锛?*
- 闇€瑕佸紑鍙戣繍钀ョ<E99280>鐞嗙<E9909E>锛堢嫭绔嬪墠绔<E5A2A0>級
- 需要开发独立产品包（审稿系统、AI文献）
- 需要开发Electron单机版
- 代码重复严重，维护困难
- 闇€瑕佸紑鍙戠嫭绔嬩骇鍝佸寘锛堝<EFBFBD>绋跨郴缁熴€丄I鏂囩尞锛?
- 闇€瑕佸紑鍙慐lectron鍗曟満鐗?
- 浠ｇ爜閲嶅<EFBFBD>涓ラ噸锛岀淮鎶ゅ洶闅?
**重构成本（估算）：**
**閲嶆瀯鎴愭湰锛堜及绠楋級锛?*
```
未来重构成本：
鏈<EFBFBD>潵閲嶆瀯鎴愭湰锛?
- 瀛︿範鍜岃<E98D9C>璁★細1澶╋紙鍚岀幇鍦<E5B987>級
- 重构代码：3-5天（代码量更大）
* 多个前端应用（Web、Admin、Electron）
- 閲嶆瀯浠ｇ爜锛?-5澶╋紙浠ｇ爜閲忔洿澶э級
* 澶氫釜鍓嶇<EFBFBD>搴旂敤锛圵eb銆丄dmin銆丒lectron锛?
* 澶氫釜鍚庣<E98D9A>妯″潡
* 大量共享代码需要提取
- 测试验证：2-3天
- 修复问题：1-2天
* 澶ч噺鍏变韩浠ｇ爜闇€瑕佹彁鍙?
- 娴嬭瘯楠岃瘉锛?-3澶?
- 淇<EFBFBD><EFBFBD>闂<EFBFBD><EFBFBD>锛?-2澶?
总成本：7-11天
鎬绘垚鏈<EFBFBD>細7-11澶?
鏄<EFBFBD>幇鍦ㄧ殑3-5鍊嶏紒
```
@@ -203,75 +203,75 @@ AIclinicalresearch/
| 缁村害 | 鏂规<E98F82>A锛氱幇鍦ㄨ浆 | 鏂规<E98F82>B锛氫互鍚庤浆 |
|------|-------------|-------------|
| **立即成本** | ⭐⭐⭐ 中（2-3天） | ⭐⭐⭐⭐⭐ 零 |
| **未来成本** | ⭐⭐⭐⭐⭐ 零 | ⭐⭐ 高（7-11天） |
| **学习难度** | ⭐⭐⭐ 中等 | ⭐⭐⭐ 中等（延后） |
| **风险** | ⭐⭐ 低 | ⭐⭐⭐ 中（技术债） |
| **代码复用** | ⭐⭐⭐⭐⭐ 优秀 | ⭐⭐ 困难 |
| **模块独立打包** | ⭐⭐⭐⭐⭐ 容易 | ⭐⭐ 困难 |
| **团队协作** | ⭐⭐⭐⭐ 好 | ⭐⭐⭐ 一般 |
| **开发体验** | ⭐⭐⭐⭐ 好 | ⭐⭐⭐ 一般 |
| **绔嬪嵆鎴愭湰** | 猸愨瓙猸?涓<>紙2-3澶╋級 | 猸愨瓙猸愨瓙猸?闆?|
| **鏈<EFBFBD>潵鎴愭湰** | 猸愨瓙猸愨瓙猸?闆?| 猸愨瓙 楂橈紙7-11澶╋級 |
| **瀛︿範闅惧害** | 猸愨瓙猸?涓<>瓑 | 猸愨瓙猸?涓<>瓑锛堝欢鍚庯級 |
| **椋庨櫓** | 猸愨瓙 浣?| 猸愨瓙猸?涓<>紙鎶€鏈<E282AC>€猴級 |
| **浠ｇ爜澶嶇敤** | 猸愨瓙猸愨瓙猸?浼樼<E6B5BC> | 猸愨瓙 鍥伴毦 |
| **妯″潡鐙<EFBFBD>珛鎵撳寘** | 猸愨瓙猸愨瓙猸?瀹规槗 | 猸愨瓙 鍥伴毦 |
| **鍥㈤槦鍗忎綔** | 猸愨瓙猸愨瓙 濂?| 猸愨瓙猸?涓€鑸?|
| **寮€鍙戜綋楠?* | 猸愨瓙猸愨瓙 濂?| 猸愨瓙猸?涓€鑸?|
---
## 馃幆 褰撳墠闃舵<E99783>璇勪及
### 当前项目状态
### 褰撳墠椤圭洰鐘舵€?
**宸插畬鎴愶細**
- ✅ 前端（React + Vite）
- ✅ 后端（Node.js + Fastify）
- ✅ Python文档提取服务
- ✅ 基础功能（AIA、PKB）
- 鉁?鍓嶇<E98D93>锛圧eact + Vite锛?
- 鉁?鍚庣<E98D9A>锛圢ode.js + Fastify锛?
- 鉁?Python鏂囨。鎻愬彇鏈嶅姟
- 鉁?鍩虹<E98DA9>鍔熻兘锛圓IA銆丳KB锛?
**鍗冲皢寮€鍙戯細**
- ⏳ ASL模块（AI智能文献）
- ⏳ ADMIN（运营管理端）- 独立前端应用
- 鈴?ASL妯″潡锛圓I鏅鸿兘鏂囩尞锛?
- 鈴?ADMIN锛堣繍钀ョ<EFBFBD>鐞嗙<EFBFBD>锛? 鐙<>珛鍓嶇<E98D93>搴旂敤
**未来规划：**
- ⏳ DC、SSA、ST、RVW模块
- ⏳ 独立产品包（审稿系统、AI文献）
- ⏳ Electron单机版
**鏈<EFBFBD>潵瑙勫垝锛?*
- 鈴?DC銆丼SA銆丼T銆丷VW妯″潡
- 鈴?鐙<>珛浜у搧鍖咃紙瀹＄ǹ绯荤粺銆丄I鏂囩尞锛?
- 鈴?Electron鍗曟満鐗?
---
### 是否需要Monorepo？
### 鏄<EFBFBD>惁闇€瑕丮onorepo锛?
**评估标准：**
**璇勪及鏍囧噯锛?*
#### ✅ 需要 - 如果满足以下条件：
#### 鉁?闇€瑕?- 濡傛灉婊¤冻浠ヤ笅鏉′欢锛?
1. **近期（1-3个月）会开发多个独立应用**
- ✅ 运营管理端（独立前端）
- ✅ ASL、DC等新模块
1. **杩戞湡锛?-3涓<33>湀锛変細寮€鍙戝<E98D99>涓<EFBFBD>嫭绔嬪簲鐢?*
- 鉁?杩愯惀绠＄悊绔<E6828A>紙鐙<E7B499>珛鍓嶇<E98D93>锛?
- 鉁?ASL銆丏C绛夋柊妯″潡
2. **有代码共享需求**
- ✅ 类型定义（User、Project等）
- ✅ API客户端（apiClient）
- ✅ 工具函数（日期格式化、验证等）
2. **鏈変唬鐮佸叡浜<EFBFBD>渶姹?*
- 鉁?绫诲瀷瀹氫箟锛圲ser銆丳roject绛夛級
- 鉁?API瀹㈡埛绔<EFBFBD>紙apiClient锛?
- 鉁?宸ュ叿鍑芥暟锛堟棩鏈熸牸寮忓寲銆侀獙璇佺瓑锛?
3. **未来有模块独立部署需求**
- ✅ 审稿系统独立产品
- ✅ AI文献独立产品
- ✅ Electron单机版
3. **鏈<EFBFBD>潵鏈夋ā鍧楃嫭绔嬮儴缃查渶姹?*
- 鉁?瀹＄ǹ绯荤粺鐙<E7B2BA>珛浜у搧
- 鉁?AI鏂囩尞鐙<E5B09E>珛浜у搧
- 鉁?Electron鍗曟満鐗?
4. **团队能够接受2-3天的学习和重构**
- ✅ 学习曲线不陡峭
- ✅ 文档和最佳实践丰富
4. **鍥㈤槦鑳藉<EFBFBD>鎺ュ彈2-3澶╃殑瀛︿範鍜岄噸鏋?*
- 鉁?瀛︿範鏇茬嚎涓嶉櫋宄?
- 鉁?鏂囨。鍜屾渶浣冲疄璺典赴瀵?
#### ❌ 不需要 - 如果满足以下条件：
#### 鉂?涓嶉渶瑕?- 濡傛灉婊¤冻浠ヤ笅鏉′欢锛?
1. **只有一个前端 + 一个后端**
- ❌ 当前已有运营管理端需求
1. **鍙<EFBFBD>湁涓€涓<EFBFBD>墠绔?+ 涓€涓<E282AC>悗绔?*
- 鉂?褰撳墠宸叉湁杩愯惀绠＄悊绔<E6828A>渶姹?
2. **没有代码共享需求**
- ❌ 已有大量重复代码（类型定义等）
2. **娌℃湁浠ｇ爜鍏变韩闇€姹?*
- 鉂?宸叉湁澶ч噺閲嶅<E996B2>浠ｇ爜锛堢被鍨嬪畾涔夌瓑锛?
3. **不打算模块化和独立部署**
- ❌ 已规划模块独立销售
3. **涓嶆墦绠楁ā鍧楀寲鍜岀嫭绔嬮儴缃?*
- 鉂?宸茶<E5AEB8>鍒掓ā鍧楃嫭绔嬮攢鍞?
4. **团队完全没有时间学习新技术**
- ⚠️ 只需2-3天
4. **鍥㈤槦瀹屽叏娌℃湁鏃堕棿瀛︿範鏂版妧鏈?*
- 鈿狅笍 鍙<>渶2-3澶?
---
@@ -279,52 +279,52 @@ AIclinicalresearch/
### 寤鸿<E5AFA4>锛氱幇鍦ㄨ浆鎹<E6B586>onorepo 猸愨瓙猸愨瓙 **鎺ㄨ崘**
**理由：**
**鐞嗙敱锛?*
**1. 投入产出比极高**
**1. 鎶曞叆浜у嚭姣旀瀬楂?*
```
投入：2-3天
节省：未来7-11天（节省5-8天）
ROI：300%+
鎶曞叆锛?-3澶?
鑺傜渷锛氭湭鏉?-11澶╋紙鑺傜渷5-8澶╋級
ROI锛?00%+
```
**2. 正处于最佳时机**
**2. 姝ｅ<EFBFBD>浜庢渶浣虫椂鏈?*
```
当前：
褰撳墠锛?
- 浠ｇ爜閲忛€備腑锛堜笉澶氫笉灏戯級
- 鍗冲皢寮€鍙戝<E98D99>涓<EFBFBD>柊妯″潡
- 鍥㈤槦灏忥紝娌熼€氭垚鏈<E59E9A>綆
未来：
鏈<EFBFBD>潵锛?
- 浠ｇ爜閲忓ぇ锛堥噸鏋勫洶闅撅級
- 澶氫釜搴旂敤鍚屾椂杩愯<E69DA9>
- 重构影响范围大
- 閲嶆瀯褰卞搷鑼冨洿澶?
```
**3. 符合未来需求**
**3. 绗﹀悎鏈<EFBFBD>潵闇€姹?*
```
近期需求（3个月内）：
- ✅ 运营管理端（独立前端）
- ✅ 多个业务模块（ASL、DC等）
- ✅ 代码共享（类型、工具函数）
杩戞湡闇€姹傦紙3涓<EFBFBD>湀鍐咃級锛?
- 鉁?杩愯惀绠＄悊绔<E6828A>紙鐙<E7B499>珛鍓嶇<E98D93>锛?
- 鉁?澶氫釜涓氬姟妯″潡锛圓SL銆丏C绛夛級
- 鉁?浠ｇ爜鍏变韩锛堢被鍨嬨€佸伐鍏峰嚱鏁帮級
鏈<EFBFBD>潵闇€姹傦紙6-12涓<32>湀锛夛細
- ✅ 独立产品打包
- ✅ Electron单机版
- ✅ 微服务拆分
- 鉁?鐙<>珛浜у搧鎵撳寘
- 鉁?Electron鍗曟満鐗?
- 鉁?寰<>湇鍔℃媶鍒?
```
**4. 瀛︿範鎴愭湰涓嶉珮**
```
Monorepo工具：
Monorepo宸ュ叿锛?
- pnpm workspaces锛堟帹鑽愶紝鏈€绠€鍗曪級
- npm workspaces（内置，无需安装）
- npm workspaces锛堝唴缃<EFBFBD>紝鏃犻渶瀹夎<EFBFBD>锛?
- yarn workspaces锛堟垚鐔燂級
学习资源：
- ✅ 官方文档完善
- ✅ 社区最佳实践丰富
- ✅ AI助手（我）可以全程指导
瀛︿範璧勬簮锛?
- 鉁?瀹樻柟鏂囨。瀹屽杽
- 鉁?绀惧尯鏈€浣冲疄璺典赴瀵?
- 鉁?AI鍔╂墜锛堟垜锛夊彲浠ュ叏绋嬫寚瀵?
```
---
@@ -338,16 +338,16 @@ Monorepo工具：
// 鍒涘缓鍏变韩鐩<E99FA9>綍
shared/
鈹溾攢鈹€ types/ # 鍏变韩绫诲瀷瀹氫箟
│ ├── user.ts
│ ├── project.ts
│ └── index.ts
│
鈹? 鈹溾攢鈹€ user.ts
鈹? 鈹溾攢鈹€ project.ts
鈹? 鈹斺攢鈹€ index.ts
鈹?
鈹斺攢鈹€ utils/ # 鍏变韩宸ュ叿鍑芥暟
鈹溾攢鈹€ date.ts
鈹溾攢鈹€ validation.ts
鈹斺攢鈹€ index.ts
// 前后端引用
// 鍓嶅悗绔<EFBFBD>紩鐢?
import { User } from '../../shared/types';
```
@@ -357,7 +357,7 @@ tsconfig.base.json # 共享TS配置
.eslintrc.shared.js # 鍏变韩ESLint閰嶇疆
```
**3. 严格的代码规范**
**3. 涓ユ牸鐨勪唬鐮佽<EFBFBD>鑼?*
```
- 绂佹<E7BB82>澶嶅埗绮樿创浠ｇ爜
- 寮哄埗浣跨敤鍏变韩绫诲瀷
@@ -366,37 +366,37 @@ tsconfig.base.json # 共享TS配置
**瑙﹀彂Monorepo杞<6F>崲鐨勪俊鍙凤細**
- 寮€濮嬪紑鍙戣繍钀ョ<E99280>鐞嗙<E9909E>
- 代码重复超过3处
- 新增第3个应用
- 浠ｇ爜閲嶅<EFBFBD>瓒呰繃3澶?
- 鏂板<EFBFBD>绗?涓<>簲鐢?
---
## 🚀 实施方案（如果选择转换）
## 馃殌 瀹炴柦鏂规<E98F82>锛堝<E9949B>鏋滈€夋嫨杞<E5ABA8>崲锛?
### 阶段一：准备（半天）
### 闃舵<EFBFBD>涓€锛氬噯澶囷紙鍗婂ぉ锛?
**学习pnpm workspaces：**
**瀛︿範pnpm workspaces锛?*
```bash
# 1. 瀹夎<E780B9>pnpm锛堝<E9949B>鏋滄病鏈夛級
npm install -g pnpm
# 2. 阅读文档（30分钟）
# 2. 闃呰<EFBFBD>鏂囨。锛?0鍒嗛挓锛?
https://pnpm.io/workspaces
# 3. 看示例项目（30分钟）
# 3. 鐪嬬ず渚嬮」鐩<EFBFBD>紙30鍒嗛挓锛?
```
**设计目录结构：**
**璁捐<EFBFBD>鐩<EFBFBD>綍缁撴瀯锛?*
```
决定：
鍐冲畾锛?
- packages/ 鏀句粈涔堬紵锛坰hared-types銆乸latform-core绛夛級
- apps/ 放什么？（frontend、backend、admin-frontend）
- apps/ 鏀句粈涔堬紵锛坒rontend銆乥ackend銆乤dmin-frontend锛?
- 鏄<>惁闇€瑕乸roducts/锛燂紙鏆傛椂涓嶉渶瑕侊級
```
---
### 阶段二：重构（1-1.5天）
### 闃舵<EFBFBD>浜岋細閲嶆瀯锛?-1.5澶╋級
**Step 1锛氬垱寤哄熀纭€缁撴瀯**
```bash
@@ -415,7 +415,7 @@ mkdir -p packages/shared-types
mkdir -p apps
```
**Step 2：移动现有代码**
**Step 2锛氱Щ鍔ㄧ幇鏈変唬鐮?*
```bash
# 绉诲姩frontend
mv frontend apps/frontend
@@ -423,18 +423,18 @@ mv frontend apps/frontend
# 绉诲姩backend
mv backend apps/backend
# extraction_service保持原位（Python不需要Monorepo）
# extraction_service淇濇寔鍘熶綅锛圥ython涓嶉渶瑕丮onorepo锛?
```
**Step 3：提取共享代码**
**Step 3锛氭彁鍙栧叡浜<EFBFBD>唬鐮?*
```bash
# 创建shared-types包
# 鍒涘缓shared-types鍖?
cd packages/shared-types
pnpm init
# 绉诲姩绫诲瀷瀹氫箟
```
**Step 4：配置依赖**
**Step 4锛氶厤缃<EFBFBD>緷璧?*
```json
// apps/frontend/package.json
{
@@ -453,14 +453,14 @@ pnpm init
**Step 5锛氭洿鏂癷mport**
```typescript
// 修改前
// 淇<EFBFBD>敼鍓?
import { User } from '../types/user';
// 修改后
// 淇<EFBFBD>敼鍚?
import { User } from '@yizhengxun/shared-types';
```
**Step 6：安装依赖**
**Step 6锛氬畨瑁呬緷璧?*
```bash
# 鏍圭洰褰曟墽琛岋紙浼氬畨瑁呮墍鏈夊寘鐨勪緷璧栵級
pnpm install
@@ -470,16 +470,16 @@ pnpm install
### 闃舵<E99783>涓夛細娴嬭瘯楠岃瘉锛堝崐澶╋級
**测试清单：**
- [ ] 前端启动正常（`cd apps/frontend && pnpm dev`）
- [ ] 后端启动正常（`cd apps/backend && pnpm dev`）
- [ ] 类型提示正常（VSCode智能提示）
- [ ] 构建成功（`pnpm build`）
- [ ] 所有功能正常
**娴嬭瘯娓呭崟锛?*
- [ ] 鍓嶇<EFBFBD>鍚<EFBFBD>姩姝ｅ父锛坄cd apps/frontend && pnpm dev`锛?
- [ ] 鍚庣<EFBFBD>鍚<EFBFBD>姩姝ｅ父锛坄cd apps/backend && pnpm dev`锛?
- [ ] 绫诲瀷鎻愮ず姝ｅ父锛圴SCode鏅鸿兘鎻愮ず锛?
- [ ] 鏋勫缓鎴愬姛锛坄pnpm build`锛?
- [ ] 鎵€鏈夊姛鑳芥<EFBFBD>甯?
**回滚方案：**
**鍥炴粴鏂规<EFBFBD>锛?*
```bash
# 如果出现问题，可以立即回滚
# 濡傛灉鍑虹幇闂<EFBFBD><EFBFBD>锛屽彲浠ョ珛鍗冲洖婊?
git reset --hard HEAD
```
@@ -491,66 +491,66 @@ git reset --hard HEAD
| 椤圭洰 | 绔嬪嵆杞<E5B586>崲 | 寤跺悗杞<E68297>崲 |
|------|---------|---------|
| **时间成本** | 2-3天 | 未来7-11天 |
| **鏃堕棿鎴愭湰** | 2-3澶?| 鏈<>潵7-11澶?|
| **瀛︿範鎴愭湰** | 涓<>瓑 | 涓<>瓑锛堝欢鍚庯級 |
| **风险** | 低 | 中（技术债） |
| **代码质量** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| **开发效率** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| **未来扩展** | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| **投入产出比** | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| **椋庨櫓** | 浣?| 涓<>紙鎶€鏈<E282AC>€猴級 |
| **浠ｇ爜璐ㄩ噺** | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸?|
| **寮€鍙戞晥鐜?* | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸?|
| **鏈<EFBFBD>潵鎵╁睍** | 猸愨瓙猸愨瓙猸?| 猸愨瓙 |
| **鎶曞叆浜у嚭姣?* | 猸愨瓙猸愨瓙猸?| 猸愨瓙 |
---
## 🎯 最终建议
## 馃幆 鏈€缁堝缓璁?
### 推荐方案：立即转换Monorepo ⭐⭐⭐⭐⭐
### 鎺ㄨ崘鏂规<EFBFBD>锛氱珛鍗宠浆鎹<EFBFBD>onorepo 猸愨瓙猸愨瓙猸?
**核心理由：**
1. ✅ **投入小，收益大**：2-3天换来未来5-8天的节省
2. ✅ **正处于最佳时机**：代码量适中，即将开发多模块
3. ✅ **符合未来规划**：运营管理端、独立产品包、Electron单机版
4. ✅ **学习成本可控**：有AI全程指导，有详细文档
**鏍稿績鐞嗙敱锛?*
1. 鉁?**鎶曞叆灏忥紝鏀剁泭澶?*锛?-3澶╂崲鏉ユ湭鏉?-8澶╃殑鑺傜渷
2. 鉁?**姝ｅ<E5A79D>浜庢渶浣虫椂鏈?*锛氫唬鐮侀噺閫備腑锛屽嵆灏嗗紑鍙戝<E98D99>妯″潡
3. 鉁?**绗﹀悎鏈<E6828E>潵瑙勫垝**锛氳繍钀ョ<E99280>鐞嗙<E9909E>銆佺嫭绔嬩骇鍝佸寘銆丒lectron鍗曟満鐗?
4. 鉁?**瀛︿範鎴愭湰鍙<E6B9B0>帶**锛氭湁AI鍏ㄧ▼鎸囧<E98EB8>锛屾湁璇︾粏鏂囨。
**实施计划：**
**瀹炴柦璁″垝锛?*
```
本周：Monorepo重构（2-3天）
Day 1：学习 + 设计（半天）
鏈<EFBFBD>懆锛歁onorepo閲嶆瀯锛?-3澶╋級
Day 1锛氬<EFBFBD>涔?+ 璁捐<E79281>锛堝崐澶╋級
Day 2锛氶噸鏋勫疄鏂斤紙1澶╋級
Day 3：测试验证（半天）
Day 3锛氭祴璇曢獙璇侊紙鍗婂ぉ锛?
下周：继续ASL模块开发
- 享受Monorepo带来的便利
- 代码复用变简单
- 类型共享开箱即用
涓嬪懆锛氱户缁瑼SL妯″潡寮€鍙?
- 浜<EFBFBD>彈Monorepo甯︽潵鐨勪究鍒?
- 浠ｇ爜澶嶇敤鍙樼畝鍗?
- 绫诲瀷鍏变韩寮€绠卞嵆鐢?
```
**濡傛灉鎮ㄥ喅瀹氶噰绾筹紝鎴戝彲浠ワ細**
1. ✅ 提供详细的step-by-step指导
2. ✅ 帮您设计目录结构
3. ✅ 编写配置文件
4. ✅ 协助重构和测试
1. 鉁?鎻愪緵璇︾粏鐨剆tep-by-step鎸囧<EFBFBD>
2. 鉁?甯<>偍璁捐<E79281>鐩<EFBFBD>綍缁撴瀯
3. 鉁?缂栧啓閰嶇疆鏂囦欢
4. 鉁?鍗忓姪閲嶆瀯鍜屾祴璇?
---
### 鏇夸唬鏂规<E98F82>锛氬欢鍚庤浆鎹<E6B586>紙涓嶆帹鑽愶級
**如果时间确实紧迫：**
**濡傛灉鏃堕棿纭<EFBFBD>疄绱ц揩锛?*
**鏈€浣庤<E6B5A3>姹傦細**
1. ✅ 创建`shared/`目录存放共享代码
2. ✅ 制定代码复用规范
3. ✅ 在开发运营管理端前必须转换
1. 鉁?鍒涘缓`shared/`鐩<EFBFBD>綍瀛樻斁鍏变韩浠ｇ爜
2. 鉁?鍒跺畾浠ｇ爜澶嶇敤瑙勮寖
3. 鉁?鍦ㄥ紑鍙戣繍钀ョ<E99280>鐞嗙<E9909E>鍓嶅繀椤昏浆鎹?
**触发条件：**
**瑙﹀彂鏉′欢锛?*
- 寮€濮嬪紑鍙戣繍钀ョ<E99280>鐞嗙<E9909E>
- 浠ｇ爜閲嶅<E996B2>涓ラ噸
- 团队成员抱怨
- 鍥㈤槦鎴愬憳鎶辨€?
---
**您觉得呢？** 😊
**鎮ㄨ<EFBFBD>寰楀憿锛?* 馃槉
是否愿意投入2-3天，为未来节省5-8天？
鏄<EFBFBD>惁鎰挎剰鎶曞叆2-3澶╋紝涓烘湭鏉ヨ妭鐪?-8澶╋紵

902
docs/00-系统总体设计/08-架构设计全景图.md
View File

File diff suppressed because it is too large Load Diff

112
docs/00-系统总体设计/09-总体需求文档(PRD).md
View File

@@ -1,88 +1,88 @@
# **壹证循科技 \- AI科研产品需求文档 (PRD)**
# **憯寡<EFBFBD>敺芰<EFBFBD><EFBFBD><EFBFBD> \- AI蝘𤑳<E89D98>鈭批<E988AD><E689B9><EFBFBD>瘙<EFBFBD><E79899>獢?(PRD)**
<EFBFBD><EFBFBD>﹝<EFBFBD><EFBFBD>𧋦: 1.0
日期: 2025年11月5日
致： 产品部、市场部、销售部、技术部及全体同仁
<EFBFBD>交<EFBFBD>: 2025撟?1<>?<3F>?
<EFBFBD>湛<EFBFBD> 鈭批<E988AD><E689B9>具<EFBFBD><E585B7><EFBFBD><EFBFBD>粹<EFBFBD><E7B2B9><EFBFBD><EFBFBD><EFBFBD>桅<EFBFBD><E6A185><EFBFBD><EFBFBD><EFBFBD>舫<EFBFBD><E888AB>𠰴<EFBFBD>雿枏<E99BBF>隞?
## **1\. <20><>﹝<EFBFBD>桃<EFBFBD>**
本需求文档 (Product Requirements Document, PRD) 旨在清晰定义"壹证循科技AI科研产品"的核心功能、目标用户及关键的非功能性需求。
<EFBFBD>祇<EFBFBD>瘙<EFBFBD><EFBFBD>獢?(Product Requirements Document, PRD) <EFBFBD>典銁皜<EFBFBD>苊摰帋<EFBFBD>"憯寡<E686AF>敺芰<E695BA><E88AB0><EFBFBD>AI蝘𤑳<E89D98>鈭批<E988AD>"<22><>瓲敹<E793B2><E695B9><EFBFBD>賬<EFBFBD><E8B3AC>𤌍<EFBFBD><F0A48C8D>鍂<EFBFBD>瑕<EFBFBD><E79195>喲睸<E596B2><E79DB8><EFBFBD><EFBFBD>蠘<EFBFBD><E8A098>折<EFBFBD>瘙<EFBFBD><E79899>?
本文档是跨部门协作的基石，用于确保技术实现、产品设计与市场策略保持高度一致，特别是应对我们复杂的商业模式和多样的客户部署需求。
<EFBFBD>祆<EFBFBD>獢<EFBFBD>糓頝券<EFBFBD><EFBFBD>典<EFBFBD>雿𦦵<EFBFBD><EFBFBD>箇𨺗嚗𣬚鍂鈭𡒊＆靽脲<EFBFBD><EFBFBD>臬<EFBFBD><EFBFBD>啜<EFBFBD><EFBFBD>漣<EFBFBD><EFBFBD>挽霈∩<EFBFBD>撣<EFBFBD>㦤蝑𣇉裦靽脲<EFBFBD>擃睃漲銝<EFBFBD><EFBFBD>湛<EFBFBD><EFBFBD>孵<EFBFBD><EFBFBD>臬<EFBFBD>撖寞<EFBFBD>隞砍<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>璅∪<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>瑞<EFBFBD>摰Ｘ<EFBFBD><EFBFBD>函蔡<EFBFBD><EFBFBD>瘙<EFBFBD><EFBFBD>?
## **2\. 产品愿景与目标**
## **2\. 鈭批<EFBFBD><EFBFBD>踵艶銝𡒊𤌍<EFBFBD>?*
产品愿景：
打造一个覆盖临床科研全生命周期、AI驱动的一站式智能科研平台。
核心目标：
赋能临床医生和科研人员，通过AI与自动化工具，极大地提升科研效率、数据处理质量和文献分析深度，缩短从数据到洞察的周期。
鈭批<EFBFBD><EFBFBD>踵艶嚗?
<EFBFBD>㯄<EFBFBD>牐<EFBFBD>銝芾<EFBFBD><EFBFBD>碶葩摨羓<EFBFBD><EFBFBD>𥪜<EFBFBD><EFBFBD>笔𦶢<EFBFBD>冽<EFBFBD><EFBFBD><EFBFBD>I撽勗𢆡<EFBFBD><EFBFBD><EFBFBD>蝡坔<EFBFBD><EFBFBD>箄<EFBFBD>蝘𤑳<EFBFBD>撟喳蝱<EFBFBD>?
<EFBFBD>詨<EFBFBD><EFBFBD>格<EFBFBD>嚗?
韏贝<EFBFBD>銝游<EFBFBD><EFBFBD>餌<EFBFBD><EFBFBD>𣬚<EFBFBD><EFBFBD>𥪯犖<EFBFBD>矋<EFBFBD><EFBFBD>朞<EFBFBD>AI銝舘䌊<EFBFBD>典<EFBFBD>撌亙<EFBFBD>嚗峕<EFBFBD>憭批𧑐<EFBFBD>𣂼<EFBFBD>蝘𤑳<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>㺭<EFBFBD>桀<EFBFBD><EFBFBD><EFBFBD>捶<EFBFBD>誩<EFBFBD><EFBFBD><EFBFBD>讃<EFBFBD><EFBFBD><EFBFBD>瘛勗漲嚗𣬚憬<EFBFBD>凋<EFBFBD><EFBFBD>唳旿<EFBFBD>唳<EFBFBD>撖毺<EFBFBD><EFBFBD>冽<EFBFBD><EFBFBD>?
## **3\. <20>格<EFBFBD><E6A0BC>冽<EFBFBD><E586BD>餃<EFBFBD> (User Personas)**
1. **临床医生/研究者**：
* **画像**：三甲医院的科室主任、主治医师、研究生。
* **痛点**：有科研项目（如国自然、GCP、回顾性研究）压力，但临床工作繁忙，缺乏专业统计和数据处理时间。
* **需求**：需要"开箱即用"的工具，快速处理院内数据、分析文献、完成统计、撰写论文。**极其关注患者数据隐私与安全**。
2. **医院科室/IT部门**：
* **画像**：医院的科研管理科室、信息中心。
* **痛点**：需要为全院提供合规、可控的科研工具；希望科研数据（尤其是HIS、LIS数据）保留在院内。
* **需求**：采购的工具必须支持**私有化部署**，且安全、稳定、易于管理。
1. **銝游<EFBFBD><EFBFBD>餌<EFBFBD>/<2F>𠉛弦<F0A0899B>?*嚗?
* **<EFBFBD>餃<EFBFBD>**嚗帋<E59A97><E5B88B>脣龫<E884A3>Ｙ<EFBFBD>蝘穃恕銝颱遙<E9A2B1><E98199>蜓瘝餃龫撣<E9BEAB><E692A3><EFBFBD><EFBFBD>蝛嗥<E89D9B><E597A5>?
* **<EFBFBD>𤤿<EFBFBD>**嚗𡁏<E59A97>蝘𤑳<E89D98>憿寧𤌍嚗<F0A48C8D><E59A97><EFBFBD>質䌊<E8B3AA>嗚<EFBFBD><E5979A>CP<43><50><EFBFBD>憿暹<E686BF>抒<EFBFBD>蝛塚<E89D9B><E5A19A>见<EFBFBD>嚗䔶<E59A97>銝游<E98A9D>撌乩<E6928C>蝜<EFBFBD><E89D9C>嚗𣬚撩銋譍<E98A8B>銝𡁶<E98A9D>霈∪<E99C88><E288AA>唳旿憭<E697BF><E686AD><EFBFBD>園𡢿<E59C92>?
* **<EFBFBD><EFBFBD>瘙?*嚗𡁻<E59A97>閬?撘<>蝞勗朖<E58B97>?<3F><>極<EFBFBD>瘀<EFBFBD>敹恍<E695B9>笔<EFBFBD><E7AC94><EFBFBD>堺<EFBFBD><E5A0BA>㺭<EFBFBD>柴<EFBFBD><E69FB4><EFBFBD><EFBFBD>鞉<EFBFBD><E99E89>柴<EFBFBD><E69FB4><EFBFBD><EFBFBD>鞟<EFBFBD>霈～<E99C88><EFBD9E>兛<EFBFBD>躰捏<E8BAB0><E68D8F><EFBFBD>?*<2A><><EFBFBD><EFBFBD>單釣<E596AE><E987A3><EFBFBD><EFBFBD>㺭<EFBFBD>桅<EFBFBD>蝘<EFBFBD><E89D98>摰匧<E691B0>**<2A>?
2. **<EFBFBD>駁堺蝘穃恕/IT<49>券秄**嚗?
* **<EFBFBD>餃<EFBFBD>**嚗𡁜龫<F0A1819C>Ｙ<EFBFBD>蝘𤑳<E89D98>蝞∠<E89D9E>蝘穃恕<E7A983><E68195>縑<EFBFBD>臭葉敹<E89189><E695B9>?
* **<EFBFBD>𤤿<EFBFBD>**嚗𡁻<E59A97>閬<EFBFBD>蛹<EFBFBD>券堺<E588B8>𣂷<EFBFBD><F0A382B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD>虾<EFBFBD>抒<EFBFBD>蝘𤑳<E89D98>撌亙<E6928C>嚗𥕦<E59A97><F0A595A6>𤤿<EFBFBD><F0A4A4BF>娍㺭<E5A88D>殷<EFBFBD>撠文<E692A0><E69687>浹IS<49><53>IS<49>唳旿嚗劐<E59A97><E58A90>坔銁<E59D94>Ｗ<EFBFBD><EFBCB7>?
* **<EFBFBD><EFBFBD>瘙?*嚗𡁻<E59A97>韐剔<E99F90>撌亙<E6928C>敹<EFBFBD>◆<EFBFBD>舀<EFBFBD>**蝘<><E89D98><EFBFBD>㚚<EFBFBD>蝵?*嚗䔶<E59A97>摰匧<E691B0><E58CA7><EFBFBD>迅摰𠾼<E691B0><F0A0BEBC><EFBFBD>鈭𡒊恣<F0A1928A><E681A3><EFBFBD>?
## **4\. 核心功能需求 (Functional Requirements)**
## **4\. <EFBFBD>詨<EFBFBD><EFBFBD>蠘<EFBFBD><EFBFBD><EFBFBD>瘙?(Functional Requirements)**
产品功能矩阵共分为7大核心模块，共同构成科研全流程闭环。
鈭批<EFBFBD><EFBFBD>蠘<EFBFBD><EFBFBD>拚猐<EFBFBD>勗<EFBFBD>銝?憭扳瓲敹<E793B2>芋<EFBFBD>梹<EFBFBD><E6A2B9>勗<EFBFBD><E58B97><EFBFBD><EFBFBD>蝘𤑳<E89D98><F0A491B3>冽<EFBFBD>蝔钅𡡒<E99285>胯<EFBFBD>?
| 璅∪<E79285>ID | 璅∪<E79285><E288AA>滨妍 | <20>詨<EFBFBD><E8A9A8>蠘<EFBFBD><E8A098>讛膩 |
| :---- | :---- | :---- |
| **F1** | **智能统计分析 (SSA)** | 提供3条核心分析路径：队列研究、预测模型、RCT研究。实现从数据上传、质控、分析到报告导出的完整流程。 |
| **F2** | **统计分析工具 (ST)** | 提供一个包含100+种轻量化统计工具的工具箱，满足即时、小型的分析需求。 |
| **F3** | **AI智能回答 (AIA)** | 提供10+个专业AI智能体，覆盖科研关键节点：选题评价、PICO梳理、样本量计算、研究方案制定、文章润色与翻译等。 |
| **F4** | **AI智能文献 (ASL)** | 提供AI驱动的文献工作流：智能检索、标题摘要初筛、全文复筛、信息提取，并支持Meta分析、证据图谱等应用。 |
| **F5** | **个人知识库 (PKB)** | 允许用户创建私人文献库（如每个库50篇），并能基于库内文献进行AI问答（RAG）。 |
| **F6** | **数据清洗整理 (DC)** | **(核心难点)** 提供专业工具，处理医院导出的海量（百万行级）、多表格（10+张）的Excel数据，实现两大功能： 1\. **表格ETL**：将多张散乱的流水表，按"患者ID"和"时间"重组为一张干净的分析宽表。 2\. **文本提取(NER)**：从病理报告、住院小结等大段文本中，自动提取结构化的关键字段（如TNM分期）。 |
| **F7** | **个人中心 (UAM)** | 提供账户管理、版本信息、帮助中心、订单管理等基础支撑功能。 |
| **F1** | **<EFBFBD>箄<EFBFBD>蝏蠘恣<EFBFBD><EFBFBD><EFBFBD> (SSA)** | <EFBFBD>𣂷<EFBFBD>3<EFBFBD>⊥瓲敹<EFBFBD><EFBFBD><EFBFBD>鞱楝敺<EFBFBD><EFBFBD><EFBFBD>笔<EFBFBD><EFBFBD>𠉛弦<EFBFBD><EFBFBD><EFBFBD>瘚𧢲芋<EFBFBD>卝<EFBFBD><EFBFBD>CT<EFBFBD>𠉛弦<EFBFBD><EFBFBD><EFBFBD><EFBFBD>唬<EFBFBD><EFBFBD>唳旿銝𠹺<EFBFBD><EFBFBD><EFBFBD>捶<EFBFBD>扼<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𣂼<EFBFBD><EFBFBD>亙<EFBFBD>撖澆枂<EFBFBD><EFBFBD><EFBFBD><EFBFBD>湔<EFBFBD>蝔卝<EFBFBD>?|
| **F2** | **蝏蠘恣<EFBFBD><EFBFBD><EFBFBD>撌亙<EFBFBD> (ST)** | <EFBFBD>𣂷<EFBFBD>銝<EFBFBD>銝芸<EFBFBD><EFBFBD>?00+蝘滩蝠<E6BBA9>誩<EFBFBD>蝏蠘恣撌亙<E6928C><E4BA99><EFBFBD>極<EFBFBD>瑞拳嚗峕說頞喳朖<E596B3>嗚<EFBFBD><E5979A><EFBFBD><EFBFBD>讠<EFBFBD><E8AEA0><EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘙<EFBFBD><E79899>?|
| **F3** | **AI<EFBFBD>箄<EFBFBD><EFBFBD>䂿<EFBFBD> (AIA)** | <EFBFBD>𣂷<EFBFBD>10+銝芯<E98A9D>銝鋫I<E98BAB>箄<EFBFBD>雿橒<E99BBF>閬<EFBFBD><E996AC>蝘𤑳<E89D98><F0A491B3>喲睸<E596B2><E79DB8><EFBFBD>嚗𡁻<E59A97>厰<EFBFBD>霂<EFBFBD>遠<EFBFBD><E981A0>ICO璇喟<E79287><E5969F><EFBFBD>甅<EFBFBD>祇<EFBFBD>霈∠<E99C88><E288A0><EFBFBD><EFBFBD>蝛嗆䲮獢<E4B2AE><E78DA2>摰𠾼<E691B0><F0A0BEBC><EFBFBD>蝡䭾隋<E4ADBE>脖<EFBFBD>蝧餉<E89DA7>蝑剹<E89D91>?|
| **F4** | **AI<EFBFBD>箄<EFBFBD><EFBFBD><EFBFBD>讃 (ASL)** | <EFBFBD>𣂷<EFBFBD>AI撽勗𢆡<EFBFBD><EFBFBD><EFBFBD><EFBFBD>桀極雿𨀣<EFBFBD>嚗𡁏惣<EFBFBD>賣<EFBFBD>蝝Ｕ<EFBFBD><EFBFBD><EFBFBD>憸䀹<EFBFBD>閬<EFBFBD><EFBFBD>蝑䜘<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑䜘<EFBFBD><EFBFBD>縑<EFBFBD>舀<EFBFBD><EFBFBD>吔<EFBFBD>撟嗆𣈲<EFBFBD><EFBFBD>eta<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>桀㦛靚梁<EFBFBD>摨𠉛鍂<EFBFBD>?|
| **F5** | **銝芯犖<EFBFBD>亥<EFBFBD>摨?(PKB)** | <EFBFBD><EFBFBD>捂<EFBFBD>冽<EFBFBD><EFBFBD>𥕦遣蝘<EFBFBD>犖<EFBFBD><EFBFBD>讃摨橒<EFBFBD>憒<EFBFBD><EFBFBD>銝芸<EFBFBD>50蝭<EFBFBD><EFBFBD>嚗<EFBFBD>僎<EFBFBD>賢抅鈭𤾸<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>株<EFBFBD>銵淾I<EFBFBD>桃<EFBFBD>嚗㇌AG嚗剹<EFBFBD>?|
| **F6** | **<EFBFBD>唳旿皜<EFBFBD><EFBFBD><EFBFBD>渡<EFBFBD> (DC)** | **(<EFBFBD>詨<EFBFBD><EFBFBD>曄<EFBFBD>)** <20>𣂷<EFBFBD>銝㮖<E98A9D>撌亙<E6928C>嚗<EFBFBD><E59A97><EFBFBD><EFBFBD>龫<EFBFBD>Ｗ紡<EFBCB7>箇<EFBFBD>瘚琿<E7989A>嚗<EFBFBD>蓡銝<E893A1><E98A9D>蝥改<E89DA5><E694B9><EFBFBD><EFBFBD>銵冽聢嚗?0+撘𩤃<E69298><F0A9A483><EFBFBD>xcel<65>唳旿嚗<E697BF><E59A97><EFBFBD>唬舅憭批<E686AD><E689B9>踝<EFBFBD> 1\. **銵冽聢ETL**嚗𡁜<E59A97>憭𡁜<E686AD><F0A1819C><EFBFBD>僚<EFBFBD><E5839A><EFBFBD>瘞渲”嚗峕<E59A97>"<22><><EFBFBD><EFBFBD>D"<22>?<3F>園𡢿"<22>滨<EFBFBD>銝箔<E98A9D>撘惩僕<E683A9><E58395><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𣂼捐銵具<E98AB5>?2\. **<EFBFBD><EFBFBD>𧋦<EFBFBD>𣂼<EFBFBD>(NER)**嚗帋<E59A97><E5B88B><EFBFBD><EFBFBD><EFBFBD>亙<EFBFBD><E4BA99><EFBFBD><EFBFBD><EFBFBD>Ｗ<EFBFBD>蝏梶<E89D8F>憭扳挾<E689B3><E68CBE>𧋦銝哨<E98A9D><E593A8>芸𢆡<E88AB8>𣂼<EFBFBD>蝏𤘪<E89D8F><F0A498AA>𣇉<EFBFBD><F0A38789>喲睸摮埈挾嚗<E68CBE><E59A97>TNM<4E><4D><EFBFBD>嚗剹<E59A97>?|
| **F7** | **銝芯犖銝剖<EFBFBD> (UAM)** | <EFBFBD>𣂷<EFBFBD>韐行<EFBFBD>蝞∠<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>砌縑<EFBFBD>胯<EFBFBD><EFBFBD>葬<EFBFBD>拐葉敹<EFBFBD><EFBFBD><EFBFBD>恥<EFBFBD>閧恣<EFBFBD><EFBFBD><EFBFBD><EFBFBD>箇<EFBFBD><EFBFBD>舀<EFBFBD><EFBFBD>蠘<EFBFBD><EFBFBD>?|
## **5\. 关键非功能性需求 (Non-Functional Requirements)**
## **5\. <EFBFBD>喲睸<EFBFBD>𧼮<EFBFBD><EFBFBD>賣<EFBFBD>折<EFBFBD>瘙?(Non-Functional Requirements)**
这是本产品在商业推广中**最复杂、最核心**的需求，是技术架构必须解决的关键挑战。
餈蹱糓<EFBFBD>砌漣<EFBFBD><EFBFBD>銁<EFBFBD><EFBFBD><EFBFBD><EFBFBD>典嘀銝?*<2A><>憭齿<E686AD><E9BDBF><EFBFBD><EFBFBD><EFBFBD>詨<EFBFBD>**<2A><><EFBFBD>瘙<EFBFBD><E79899><EFBFBD>舀<EFBFBD><E88880>舀沲<E88880><E6B2B2><EFBFBD>憿餉圾<E9A489>喟<EFBFBD><E5969F>喲睸<E596B2>烐<EFBFBD><E78390>?
### **NFR-1: 部署模式灵活性 (Deployment Flexibility)**
### **NFR-1: <EFBFBD>函蔡璅∪<EFBFBD><EFBFBD>菜暑<EFBFBD>?(Deployment Flexibility)**
产品必须支持以下四种部署形态，以满足不同客户（尤其是医院）对数据安全和合规性的严苛要求。
鈭批<EFBFBD>敹<EFBFBD>◆<EFBFBD>舀<EFBFBD>隞乩<EFBFBD><EFBFBD>𤤿<EFBFBD><EFBFBD>函蔡敶Ｘ<EFBFBD><EFBFBD><EFBFBD>隞交說頞喃<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>喲睸閬<E79DB8><E996AC> |
| :---- | :---- | :---- |
| **云端SaaS版** | (默认) 产品部署在公有云，用户通过浏览器按需订阅使用。 | 必须支持多租户、高可用。 |
| **私有化部署** | (医院/机构) 将**整个平台**或**指定模块**（如DC, SSA）部署在客户的内网服务器上。 | 必须提供容器化（Docker/K8s）的一键部署方案。数据100%不出内网。 |
| **单机版** | (个人医生) 提供**可安装的桌面应用(Windows/Mac)**，针对DC、SSA、ASL等核心模块。 | **数据100%本地化**。文献、病例原始文件严禁上传。必须支持离线运行（如DC, SSA）。 *(例外：ASL模块可受控调用云端LLM，但仅限发送"摘要"而非"原文")* |
| **鈭𤑳垢SaaS<EFBFBD>?* | (暺䁅恕) 鈭批<E988AD><E689B9>函蔡<E587BD>典<EFBFBD><E585B8>劐<EFBFBD>嚗𣬚鍂<F0A3AC9A>琿<EFBFBD>朞<EFBFBD>瘚讛<E7989A><E8AE9B>冽<EFBFBD><E586BD><EFBFBD>霈ａ<E99C88>雿輻鍂<E8BCBB>?| 敹<>◆<EFBFBD>舀<EFBFBD>憭𡁶<E686AD><F0A181B6>瑯<EFBFBD><E791AF><EFBFBD><EFBFBD>舐鍂<E88890>?|
| **蝘<EFBFBD><EFBFBD><EFBFBD>㚚<EFBFBD>蝵?* | (<28>駁堺/<2F>箸<EFBFBD>) 撠?*<2A>港葵撟喳蝱**<EFBFBD>?*<2A><><EFBFBD>璅∪<E79285>**嚗<><E59A97>DC, SSA嚗厰<E59A97>蝵脣銁摰Ｘ<E691B0><EFBCB8><EFBFBD><EFBFBD>蝵烐<E89DB5><E78390>∪膥銝𨳍<E98A9D>?| 敹<>◆<EFBFBD>𣂷<EFBFBD>摰孵膥<E5ADB5>吔<EFBFBD>Docker/K8s嚗厩<E59A97>銝<EFBFBD><E98A9D>桅<EFBFBD>蝵脫䲮獢<E4B2AE><E78DA2><EFBFBD>㺭<EFBFBD>?00%銝滚枂<E6BB9A><E69E82><EFBFBD><EFBFBD>?|
| **<EFBFBD>閙㦤<EFBFBD>?* | (銝芯犖<E88AAF>餌<EFBFBD>) <20>𣂷<EFBFBD>**<2A>臬<EFBFBD>鋆<EFBFBD><E98B86>獢屸𢒰摨𠉛鍂(Windows/Mac)**嚗屸<E59A97>撖道C<E98193><43>SA<53><41>SL蝑㗇瓲敹<E793B2>芋<EFBFBD>𨰜<EFBFBD>?| **<EFBFBD>唳旿100%<25>砍𧑐<E7A08D>?*<2A><><EFBFBD><EFBFBD>柴<EFBFBD><E69FB4><EFBFBD>靘见<E99D98>憪𧢲<E686AA>隞嗡艇蝳<E88987><E89DB3>隡𨬭<E99AA1><F0A8ACAD><EFBFBD>憿餅𣈲<E9A485><F0A388B2>氖蝥輯<E89DA5>銵䕘<E98AB5>憒<EFBFBD>C, SSA嚗剹<E59A97>?*(靘见<E99D98>嚗鋫SL璅∪<E79285><E288AA>臬<EFBFBD><E887AC>扯<EFBFBD><E689AF>其<EFBFBD>蝡烊LM嚗䔶<E59A97>隞<EFBFBD><E99A9E><EFBFBD>煾<EFBFBD>?<3F>䁅<EFBFBD>"<22>屸<EFBFBD>"<22><><EFBFBD>")* |
### **NFR-2: 商业模式可配置 (Commercial Flexibility)**
### **NFR-2: <EFBFBD><EFBFBD><EFBFBD>璅∪<EFBFBD><EFBFBD>舫<EFBFBD>蝵?(Commercial Flexibility)**
产品架构必须支持销售和市场策略的灵活性。
鈭批<EFBFBD><EFBFBD>嗆<EFBFBD>敹<EFBFBD>◆<EFBFBD>舀<EFBFBD><EFBFBD><EFBFBD><EFBFBD>桀<EFBFBD>撣<EFBFBD>㦤蝑𣇉裦<EFBFBD><EFBFBD><EFBFBD>瘣餅<EFBFBD>扼<EFBFBD>?
1. **SaaS多版本 (Tiered SaaS)**
* **需求**：云端SaaS版必须支持至少三个等级：**专业版、高级版、旗舰版**。
* **实现**：后端需具备完善的\*\*功能开关(Feature Flag)\*\*系统，能按版本限制用户可用的功能模块、使用次数、AI模型等。
2. **模块化售卖 (Modular Sales)**
* **需求**：任何一个功能模块（如F4: AI智能文献）都**必须能**被独立打包，作为单独的产品进行售卖。
* **实现**：技术架构必须是"松耦合"的，确保模块间没有硬依赖。
1. **SaaS憭𡁶<EFBFBD><EFBFBD>?(Tiered SaaS)**
* **<EFBFBD><EFBFBD>瘙?*嚗帋<E59A97>蝡特aaS<61><53><EFBFBD>憿餅𣈲<E9A485><F0A388B2>秐撠睲<E692A0>銝芰<E98A9D>蝥改<E89DA5>**銝㮖<E98A9D><E3AE96><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝥抒<E89DA5><E68A92><EFBFBD><EFBFBD><EFBFBD>啁<EFBFBD>**<2A>?
* **摰䂿緵**嚗𡁜<E59A97>蝡舫<E89DA1><E888AB>瑕<EFBFBD>摰<EFBFBD><E691B0><EFBFBD><EFBFBD>*\*<2A>蠘<EFBFBD>撘<EFBFBD><E69298>?Feature Flag)\*\*蝟餌<E89D9F>嚗諹<E59A97><E8ABB9>厩<EFBFBD><E58EA9>祇<EFBFBD><E7A587>嗥鍂<E597A5>瑕虾<E79195>函<EFBFBD><E587BD>蠘<EFBFBD>璅∪<E79285><E288AA><EFBFBD>蝙<EFBFBD>冽活<E586BD>啜<EFBFBD><E5959C>I璅∪<E79285>蝑剹<E89D91>?
2. **璅∪<EFBFBD><EFBFBD>硋睸<EFBFBD>?(Modular Sales)**
* **<EFBFBD><EFBFBD>瘙?*嚗帋遙雿蓥<E99BBF>銝芸<E98A9D><E88AB8>賣芋<E8B3A3>梹<EFBFBD>憒<EFBFBD>4: AI<41>箄<EFBFBD><E7AE84><EFBFBD>讃嚗厰<E59A97>**敹<>◆<EFBFBD>?*鋡怎𡠺蝡𧢲<E89DA1><F0A7A2B2><EFBFBD><EFBFBD>雿靝蛹<E99D9D>閧𡠺<E996A7><F0A1A0BA>漣<EFBFBD><E6BCA3><EFBFBD>銵<EFBFBD>睸<EFBFBD>硔<EFBFBD>?
* **摰䂿緵**嚗𡁏<E59A97><F0A1818F>舀沲<E88880><E6B2B2><EFBFBD>憿餅糓"<22>曇<EFBFBD>血<EFBFBD>"<22><><EFBFBD>蝖桐<E89D96>璅∪<E79285><E288AA>湔瓷<E6B994>厩′靘肽<E99D98><E882BD>?
3. **AI<41>鞉𧋦<E99E89>舀綉 (Configurable AI)**
* **需求**：为应对不同客户的成本敏感度，平台必须支持**动态切换**后端的大语言模型。
* **实现**：例如，专业版用户默认调用成本较低的DeepSeek，旗舰版用户可调用更高质量的Claude或GPT。
* **<EFBFBD><EFBFBD>瘙?*嚗帋蛹摨𥪜笆銝滚<E98A9D>摰Ｘ<E691B0><EFBCB8><EFBFBD><EFBFBD><EFBFBD>祆<EFBFBD><E7A586>笔漲嚗<E6BCB2>像<EFBFBD>啣<EFBFBD>憿餅𣈲<E9A485>?*<2A>冽<EFBFBD><E586BD><EFBFBD><EFBFBD>?*<2A>𡒊垢<F0A1928A><E59EA2>之霂剛<E99C82>璅∪<E79285><E288AA>?
* **摰䂿緵**嚗帋<E59A97>憒<EFBFBD><E68692>銝㮖<E98A9D><E3AE96><EFBFBD>鍂<EFBFBD>琿<EFBFBD>霈方<E99C88><E696B9>冽<EFBFBD><E586BD>祈<EFBFBD>雿𡒊<E99BBF>DeepSeek嚗峕<E59A97><E5B395>啁<EFBFBD><E59581>冽<EFBFBD><E586BD>航<EFBFBD><E888AA>冽凒擃䁅捶<E48185>讐<EFBFBD>Claude<64>𨰦PT<50>?
### **NFR-3: 撟喳蝱銝擧<E98A9D>扯<EFBFBD> (Platform & Performance)**
1. **平台兼容性**：
* Web版：必须支持所有现代浏览器（Chrome, Edge, Firefox, Safari）。
* 单机版：必须支持 **Windows 10 (64位)及以上** 和 **macOS (Intel & Apple Silicon)**。
* **【重点】明确不支持**：为保证产品稳定性和数据安全，单机版**不支持**任何32位操作系统及Windows 7等已停止服务的系统。
2. **数据处理性能 (DC模块)**：
* 产品（尤其是单机版）必须能稳定处理百万行级别的多表Excel数据，**严禁**因内存溢出而导致程序崩溃。
* 产品（服务器版）在处理相同数据时，应追求极致效率，在数分钟内完成处理。
3. **文本提取质量 (DC模块)**：
* 产品必须能提供高准确率的医学文本提取。
* **服务器版（最优解）**：应使用SOTA（业界顶尖）的LLM（如Claude 3）以保证最高质量。
* **单机版（妥协解）**：为保证数据隐私，必须使用100%本地运行的NLP模型（如spaCy），在保护隐私的前提下尽力提高准确率。
1. **撟喳蝱<EFBFBD>澆捆<EFBFBD>?*嚗?
* Web<EFBFBD><EFBFBD><EFBFBD>敹<EFBFBD>◆<EFBFBD>舀<EFBFBD><EFBFBD><EFBFBD><EFBFBD>厩緵隞<EFBFBD><EFBFBD>閫<EFBFBD>膥嚗㇃hrome, Edge, Firefox, Safari嚗剹<EFBFBD>?
* <EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>敹<EFBFBD>◆<EFBFBD>舀<EFBFBD> **Windows 10 (64雿?<3F>𠹺誑銝?* <20>?**macOS (Intel & Apple Silicon)**<EFBFBD>?
* **<EFBFBD>鞾<EFBFBD><EFBFBD>嫘<EFBFBD>烐<EFBFBD>蝖桐<EFBFBD><EFBFBD>舀<EFBFBD>**嚗帋蛹靽肽<E99DBD>鈭批<E988AD>蝔喳<E89D94><E596B3>批<EFBFBD><E689B9>唳旿摰匧<E691B0>嚗<EFBFBD><E59A97><EFBFBD>箇<EFBFBD>**銝齿𣈲<E9BDBF>?*隞颱<E99A9E>32雿齿<E99BBF>雿𦦵頂蝏笔<E89D8F>Windows 7蝑匧歇<E58CA7>𨀣迫<F0A880A3>滚𦛚<E6BB9A><F0A69B9A>頂蝏麄<E89D8F>?
2. **<EFBFBD>唳旿憭<EFBFBD><EFBFBD><EFBFBD>扯<EFBFBD> (DC璅∪<E79285>)**嚗?
* 鈭批<EFBFBD>嚗<EFBFBD>陘<EFBFBD>嗆糓<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>敹<EFBFBD>◆<EFBFBD>賜迅摰𡁜<EFBFBD><EFBFBD><EFBFBD>蓡銝<EFBFBD><EFBFBD>蝥批<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵汞xcel<EFBFBD>唳旿嚗?*銝亦<E98A9D>**<2A>惩<EFBFBD>摮䀹滯<E480B9>箄<EFBFBD><E7AE84>紡<EFBFBD>渡<EFBFBD>摨誩援皞<E68FB4><E79A9E>?
* 鈭批<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>∪膥<EFBFBD><EFBFBD><EFBFBD><EFBFBD>典<EFBFBD><EFBFBD><EFBFBD>㮾<EFBFBD>峕㺭<EFBFBD>格𧒄嚗<EFBFBD><EFBFBD>餈賣<EFBFBD><EFBFBD><EFBFBD>稲<EFBFBD><EFBFBD><EFBFBD>嚗<EFBFBD>銁<EFBFBD>啣<EFBFBD><EFBFBD>笔<EFBFBD>摰峕<EFBFBD>憭<EFBFBD><EFBFBD><EFBFBD>?
3. **<EFBFBD><EFBFBD>𧋦<EFBFBD>𣂼<EFBFBD>韐券<EFBFBD> (DC璅∪<E79285>)**嚗?
* 鈭批<EFBFBD>敹<EFBFBD>◆<EFBFBD>賣<EFBFBD>靘偦<EFBFBD><EFBFBD><EFBFBD>＆<EFBFBD><EFBFBD><EFBFBD><EFBFBD>餃郎<EFBFBD><EFBFBD>𧋦<EFBFBD>𣂼<EFBFBD><EFBFBD>?
* **<EFBFBD>滚𦛚<EFBFBD>函<EFBFBD>嚗<EFBFBD><EFBFBD>隡䁅圾嚗?*嚗𡁜<E59A97>雿輻鍂SOTA嚗<41><E59A97><EFBFBD>屸▲撠吔<E692A0><E59094><EFBFBD>LM嚗<4D><E59A97>Claude 3嚗劐誑靽肽<E99DBD><E882BD><EFBFBD>擃䁅捶<E48185>譌<EFBFBD>?
* **<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>憒亙<EFBFBD>閫<EFBFBD><EFBFBD>**嚗帋蛹靽肽<E99DBD><E882BD>唳旿<E594B3>鞟<EFBFBD>嚗<EFBFBD><E59A97>憿颱蝙<E9A2B1>?00%<25>砍𧑐餈鞱<E9A488><E99EB1><EFBFBD>LP璅∪<E79285>嚗<EFBFBD><E59A97>spaCy嚗㚁<E59A97><E39A81>其<EFBFBD><E585B6>日<EFBFBD>蝘<EFBFBD><E89D98><EFBFBD>齿<EFBFBD>銝见偷<E8A781>𥟇<EFBFBD>擃睃<E69383>蝖桃<E89D96><E6A183>?

346
docs/00-系统总体设计/10-核心业务规则总览.md
View File

@@ -1,8 +1,8 @@
# 鏍稿績涓氬姟瑙勫垯鎬昏<E98EAC>
> **版本：** v1.0
> **创建日期：** 2025-10-10
> **适用范围：** 整个系统
> **鐗堟湰锛?* v1.0
> **鍒涘缓鏃ユ湡锛?* 2025-10-10
> **閫傜敤鑼冨洿锛?* 鏁翠釜绯荤粺
---
@@ -10,9 +10,9 @@
1. [鐢ㄦ埛绠＄悊瑙勫垯](#鐢ㄦ埛绠＄悊瑙勫垯)
2. [椤圭洰绠＄悊瑙勫垯](#椤圭洰绠＄悊瑙勫垯)
3. [智能体管理规则](#智能体管理规则)
3. [鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒橾(#鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒?
4. [瀵硅瘽绠＄悊瑙勫垯](#瀵硅瘽绠＄悊瑙勫垯)
5. [知识库管理规则](#知识库管理规则)
5. [鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒橾(#鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒?
6. [鏉冮檺鎺у埗瑙勫垯](#鏉冮檺鎺у埗瑙勫垯)
7. [閰嶉<EFBFBD>闄愬埗瑙勫垯](#閰嶉<E996B0>闄愬埗瑙勫垯)
@@ -22,43 +22,43 @@
### 娉ㄥ唽瑙勫垯
**BR-U001: 邮箱唯一性**
- 规则：每个邮箱只能注册一个账号
**BR-U001: 閭<EFBFBD><EFBFBD>鍞<EFBFBD>竴鎬?*
- 瑙勫垯锛氭瘡涓<EFBFBD>偖绠卞彧鑳芥敞鍐屼竴涓<EFBFBD>处鍙?
- 楠岃瘉鏃舵満锛氭敞鍐屾椂
- 错误提示："该邮箱已被注册"
- 閿欒<EFBFBD>鎻愮ず锛?璇ラ偖绠卞凡琚<E587A1>敞鍐?
**BR-U002: 閭<><E996AD>鏍煎紡楠岃瘉**
- 规则：必须是有效的邮箱格式
- 瑙勫垯锛氬繀椤绘槸鏈夋晥鐨勯偖绠辨牸寮?
- 姝ｅ垯锛歚^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}$`
- 错误提示："邮箱格式不正确"
- 閿欒<EFBFBD>鎻愮ず锛?閭<><E996AD>鏍煎紡涓嶆<E6B693>纭?
**BR-U003: 瀵嗙爜寮哄害**
- 规则：密码至少8位，包含字母和数字
- 瑙勫垯锛氬瘑鐮佽嚦灏?浣嶏紝鍖呭惈瀛楁瘝鍜屾暟瀛?
- 姝ｅ垯锛歚^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d@$!%*#?&]{8,}$`
- 错误提示："密码至少8位，需包含字母和数字"
- 閿欒<EFBFBD>鎻愮ず锛?瀵嗙爜鑷冲皯8浣嶏紝闇€鍖呭惈瀛楁瘝鍜屾暟瀛?
**BR-U004: 默认试用期**
**BR-U004: 榛樿<EFBFBD>璇曠敤鏈?*
- 瑙勫垯锛氭柊鐢ㄦ埛榛樿<E6A69B>鑾峰緱30澶╄瘯鐢ㄦ湡
- 瀹炵幇锛歚trial_ends_at = now() + 30澶ー
### 鐧诲綍瑙勫垯
**BR-U005: 账户状态检查**
- 规则：只有status=active的用户可以登录
**BR-U005: 璐︽埛鐘舵€佹<EFBFBD>鏌?*
- 瑙勫垯锛氬彧鏈塻tatus=active鐨勭敤鎴峰彲浠ョ櫥褰?
- 鐘舵€侊細
- `active` - 可登录
- `active` - 鍙<EFBFBD>櫥褰?
- `inactive` - 鏈<>縺娲伙紝涓嶅彲鐧诲綍
- `suspended` - 宸叉殏鍋滐紝涓嶅彲鐧诲綍
**BR-U006: 瀵嗙爜閿欒<E996BF>娆℃暟闄愬埗**
- 规则：5分钟内最多5次错误尝试
- 超过次数：临时锁定账户15分钟
- 瑙勫垯锛?鍒嗛挓鍐呮渶澶?娆￠敊璇<E6958A>皾璇?
- 瓒呰繃娆℃暟锛氫复鏃堕攣瀹氳处鎴?5鍒嗛挓
- 瀹炵幇锛氫娇鐢≧edis璁板綍澶辫触娆℃暟
**BR-U007: JWT Token有效期**
- Access Token：7天
- Refresh Token：30天
- 过期后需要重新登录
**BR-U007: JWT Token鏈夋晥鏈?*
- Access Token锛?澶?
- Refresh Token锛?0澶?
- 杩囨湡鍚庨渶瑕侀噸鏂扮櫥褰?
---
@@ -66,92 +66,92 @@
### 鍒涘缓瑙勫垯
**BR-P001: 项目数量无限制**
**BR-P001: 椤圭洰鏁伴噺鏃犻檺鍒?*
- 瑙勫垯锛氱敤鎴峰彲浠ュ垱寤轰换鎰忔暟閲忕殑椤圭洰
- 理由：项目是核心功能，不应限制
- 鐞嗙敱锛氶」鐩<EFBFBD>槸鏍稿績鍔熻兘锛屼笉搴旈檺鍒?
**BR-P002: 椤圭洰鍚嶇О蹇呭～**
- 规则：项目名称不能为空
- 长度：1-200字符
- 错误提示："项目名称不能为空"
- 瑙勫垯锛氶」鐩<EFBFBD>悕绉颁笉鑳戒负绌?
- 闀垮害锛?-200瀛楃<EFBFBD>
- 閿欒<EFBFBD>鎻愮ず锛?椤圭洰鍚嶇О涓嶈兘涓虹┖"
**BR-P003: 椤圭洰鎻忚堪蹇呭～**
- 瑙勫垯锛氶」鐩<E3808D>弿杩颁笉鑳戒负绌猴紙鐢ㄤ簬涓婁笅鏂囨敞鍏ワ級
- 鏈€灏忛暱搴︼細10瀛楃<E7809B>
- 错误提示："请输入项目背景信息，至少10个字符"
- 閿欒<EFBFBD>鎻愮ず锛?璇疯緭鍏ラ」鐩<E3808D>儗鏅<E58497>俊鎭<E4BF8A>紝鑷冲皯10涓<30>瓧绗?
### 鏇存柊瑙勫垯
**BR-P004: 项目背景动态更新**
- 规则：用户可以随时编辑项目描述
- 规则：可以"固定"AI回复到项目描述中
**BR-P004: 椤圭洰鑳屾櫙鍔ㄦ€佹洿鏂?*
- 瑙勫垯锛氱敤鎴峰彲浠ラ殢鏃剁紪杈戦」鐩<EFBFBD>弿杩?
- 瑙勫垯锛氬彲浠?鍥哄畾"AI鍥炲<E98DA5>鍒伴」鐩<E3808D>弿杩颁腑
- 瀹炵幇锛氳拷鍔犲埌description瀛楁<E7809B>鏈<EFBFBD>熬
**BR-P005: 椤圭洰鎵€鏈夋潈楠岃瘉**
- 规则：只能修改/删除自己的项目
- 瑙勫垯锛氬彧鑳戒慨鏀?鍒犻櫎鑷<E6AB8E>繁鐨勯」鐩?
- 楠岃瘉锛歚project.userId === currentUser.id`
- 错误提示："无权限操作该项目"
- 閿欒<EFBFBD>鎻愮ず锛?鏃犳潈闄愭搷浣滆<E6B5A3>椤圭洰"
### 鍒犻櫎瑙勫垯
**BR-P006: 绾ц仈鍒犻櫎**
- 瑙勫垯锛氬垹闄ら」鐩<E3808D>椂锛岀骇鑱斿垹闄ゅ叾鎵€鏈夊<E98F88>璇濆拰娑堟伅
- 瀹炵幇锛氭暟鎹<E69A9F>簱ON DELETE CASCADE
- 确认：前端需要二次确认
- 纭<EFBFBD><EFBFBD>锛氬墠绔<EFBFBD>渶瑕佷簩娆＄‘璁?
**BR-P007: 杞<>垹闄わ紙鍙<E7B499>€夛級**
- 规则：重要项目可以先软删除，保留30天
- 瑙勫垯锛氶噸瑕侀」鐩<EFBFBD>彲浠ュ厛杞<EFBFBD>垹闄わ紝淇濈暀30澶?
- 瀹炵幇锛氭坊鍔燿eleted_at瀛楁<E7809B>
- 备注：当前版本暂不实现
- 澶囨敞锛氬綋鍓嶇増鏈<EFBFBD>殏涓嶅疄鐜?
---
## 智能体管理规则
## 鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒?
### 智能体配置
### 鏅鸿兘浣撻厤缃?
**BR-A001: 鏅鸿兘浣撻厤缃<E58EA4>寲绠＄悊**
- 瑙勫垯锛氭櫤鑳戒綋閰嶇疆瀛樺偍鍦╜config/agents.yaml`
- 规则：不通过数据库管理
- 规则：修改配置后需要重启服务
- 瑙勫垯锛氫笉閫氳繃鏁版嵁搴撶<EFBFBD>鐞?
- 瑙勫垯锛氫慨鏀归厤缃<EFBFBD>悗闇€瑕侀噸鍚<EFBFBD>湇鍔?
**BR-A002: 智能体状态**
**BR-A002: 鏅鸿兘浣撶姸鎬?*
- `active` - 鍙<>敤锛岀敤鎴峰彲浠ラ€夋嫨
- `inactive` - 涓嶅彲鐢<E5BDB2>紝闅愯棌
- `testing` - 娴嬭瘯涓<E798AF>紝浠呯<E6B5A0>鐞嗗憳鍙<E686B3><E98D99>
**BR-A003: 智能体分类**
- 选题阶段：选题评价、科学问题梳理
- 研究设计：PICOS构建、观察指标设计、CRF制定、样本量计算、临床研究方案撰写
- 论文阶段：论文润色、论文翻译、方法学评审、期刊方法学评审、期刊稿约评审
**BR-A003: 鏅鸿兘浣撳垎绫?*
- 閫夐<EFBFBD>闃舵<EFBFBD>锛氶€夐<EFBFBD>璇勪环銆佺<EFBFBD>瀛﹂棶棰樻⒊鐞?
- 鐮旂┒璁捐<EFBFBD>锛歅ICOS鏋勫缓銆佽<EFBFBD>瀵熸寚鏍囪<EFBFBD>璁°€丆RF鍒跺畾銆佹牱鏈<EFBFBD>噺璁＄畻銆佷复搴婄爺绌舵柟妗堟挵鍐?
- 璁烘枃闃舵<EFBFBD>锛氳<EFBFBD>鏂囨鼎鑹层€佽<EFBFBD>鏂囩炕璇戙€佹柟娉曞<EFBFBD>璇勫<EFBFBD>銆佹湡鍒婃柟娉曞<EFBFBD>璇勫<EFBFBD>銆佹湡鍒婄ǹ绾﹁瘎瀹?
### Prompt绠＄悊
**BR-A004: Prompt鏂囦欢绠＄悊**
- 瑙勫垯锛歅rompt瀛樺偍鍦╜backend/prompts/`鐩<>綍
- 命名：`{agent_id}_system.txt` 和 `{agent_id}_user.txt`
- 鍛藉悕锛歚{agent_id}_system.txt` 鍜?`{agent_id}_user.txt`
- 鐗堟湰锛氶€氳繃Git绠＄悊鐗堟湰
**BR-A005: Prompt鍙橀噺娉ㄥ叆**
- 规则：Prompt中可以使用变量
- 瑙勫垯锛歅rompt涓<EFBFBD>彲浠ヤ娇鐢ㄥ彉閲?
- 鏍煎紡锛歚{variable_name}`
- 绀轰緥锛歚{project_description}`, `{user_question}`
### 妯″瀷閰嶇疆
**BR-A006: 妯″瀷鍙傛暟閰嶇疆**
- 规则：每个智能体可以配置不同模型的参数
- 参数：
- 瑙勫垯锛氭瘡涓<EFBFBD>櫤鑳戒綋鍙<EFBFBD>互閰嶇疆涓嶅悓妯″瀷鐨勫弬鏁?
- 鍙傛暟锛?
- `temperature`: 0.0-1.0
- `max_tokens`: 最大输出token数
- `max_tokens`: 鏈€澶ц緭鍑簍oken鏁?
- `top_p`: 0.0-1.0
**BR-A007: 妯″瀷鍒囨崲**
- 规则：用户可以在对话中切换模型
- 瑙勫垯锛氱敤鎴峰彲浠ュ湪瀵硅瘽涓<EFBFBD>垏鎹㈡ā鍨?
- 鍙<>€夋ā鍨嬶細
- `deepseek-v3` (榛樿<E6A69B>)
- `qwen3-72b`
- `gemini-2.0-flash` (可选)
- `gemini-2.0-flash` (鍙<EFBFBD>€?
---
@@ -160,40 +160,40 @@
### 鍒涘缓瀵硅瘽
**BR-C001: 瀵硅瘽褰掑睘**
- 规则：对话可以属于项目，也可以是全局快速问答
- 瑙勫垯锛氬<EFBFBD>璇濆彲浠ュ睘浜庨」鐩<EFBFBD>紝涔熷彲浠ユ槸鍏ㄥ眬蹇<EFBFBD>€熼棶绛?
- 椤圭洰瀵硅瘽锛歚projectId` 涓嶄负null
- 鍏ㄥ眬蹇<E79CAC>€熼棶绛旓細`projectId` 涓簄ull
**BR-C002: 瀵硅瘽鏍囬<E98F8D>鑷<EFBFBD>姩鐢熸垚**
- 规则：首次创建对话时，标题为"与{智能体名称}的对话"
- 规则：可以手动修改标题
- 瑙勫垯锛氶<EFBFBD>娆″垱寤哄<EFBFBD>璇濇椂锛屾爣棰樹负"涓巤鏅鸿兘浣撳悕绉皚鐨勫<E990A8>璇?
- 瑙勫垯锛氬彲浠ユ墜鍔ㄤ慨鏀规爣棰?
### 上下文管理
### 涓婁笅鏂囩<EFBFBD>鐞?
**BR-C003: 椤圭洰鑳屾櫙鑷<E6AB99>姩娉ㄥ叆**
- 规则：如果对话属于项目，自动将项目description注入上下文
- 瑙勫垯锛氬<EFBFBD>鏋滃<EFBFBD>璇濆睘浜庨」鐩<EFBFBD>紝鑷<EFBFBD>姩灏嗛」鐩甦escription娉ㄥ叆涓婁笅鏂?
- 娉ㄥ叆浣嶇疆锛歋ystem prompt涔嬪悗
- 鏍煎紡锛歚# 椤圭洰鑳屾櫙\n{project.description}`
**BR-C004: 鍘嗗彶瀵硅瘽绠＄悊**
- 规则：保留最近10轮对话作为上下文
- 规则：超过10轮的对话，进行摘要压缩
- 瑙勫垯锛氫繚鐣欐渶杩?0杞<30><E69D9E>璇濅綔涓轰笂涓嬫枃
- 瑙勫垯锛氳秴杩?0杞<30>殑瀵硅瘽锛岃繘琛屾憳瑕佸帇缂?
- Token闄愬埗锛氫笂涓嬫枃鎬籺oken鏁颁笉瓒呰繃6000
**BR-C005: 知识库引用**
- 规则：用户可以通过`@知识库名称`引用知识库
- 规则：最多同时引用3个知识库
**BR-C005: 鐭ヨ瘑搴撳紩鐢?*
- 瑙勫垯锛氱敤鎴峰彲浠ラ€氳繃`@鐭ヨ瘑搴撳悕绉癭寮曠敤鐭ヨ瘑搴?
- 瑙勫垯锛氭渶澶氬悓鏃跺紩鐢?涓<>煡璇嗗簱
- 妫€绱㈡暟閲忥細姣忎釜鐭ヨ瘑搴撴<E690B4>绱<EFBFBD>op 5缁撴灉
### 娑堟伅鍥哄畾
**BR-C006: 固定消息到项目背景**
- 规则：只有AI回复可以被固定
- 规则：只有项目内对话可以固定（全局对话不可）
**BR-C006: 鍥哄畾娑堟伅鍒伴」鐩<EFBFBD>儗鏅?*
- 瑙勫垯锛氬彧鏈堿I鍥炲<EFBFBD>鍙<EFBFBD>互琚<EFBFBD>浐瀹?
- 瑙勫垯锛氬彧鏈夐」鐩<EFBFBD>唴瀵硅瘽鍙<EFBFBD>互鍥哄畾锛堝叏灞€瀵硅瘽涓嶅彲锛?
- 瀹炵幇锛氳拷鍔犲埌project.description鏈<6E>熬
- 格式：
- 鏍煎紡锛?
```
--- 来自对话的补充 ---
--- 鏉ヨ嚜瀵硅瘽鐨勮ˉ鍏?---
{message.content}
```
@@ -205,83 +205,83 @@
**BR-C008: Server-Sent Events**
- 瑙勫垯锛氫娇鐢⊿SE瀹炵幇娴佸紡杈撳嚭
- 事件类型：
- `start`: 开始生成
- 浜嬩欢绫诲瀷锛?
- `start`: 寮€濮嬬敓鎴?
- `token`: 姣忎釜token
- `done`: 瀹屾垚
- `error`: 閿欒<E996BF>
**BR-C009: 娴佸紡杈撳嚭瓒呮椂**
- 规则：单个请求最长60秒
- 瑙勫垯锛氬崟涓<EFBFBD><EFBFBD>姹傛渶闀?0绉?
- 瓒呮椂鍚庯細杩斿洖宸茬敓鎴愮殑鍐呭<E98D90>
- 错误提示："生成超时，请重试"
- 閿欒<EFBFBD>鎻愮ず锛?鐢熸垚瓒呮椂锛岃<E9949B>閲嶈瘯"
---
## 知识库管理规则
## 鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒?
### 鏁伴噺闄愬埗
**BR-K001: 知识库数量限制**
- 规则：每个用户最多创建3个知识库
- 验证时机：创建知识库时
- 错误提示："已达到知识库数量上限（3个）"
**BR-K001: 鐭ヨ瘑搴撴暟閲忛檺鍒?*
- 瑙勫垯锛氭瘡涓<EFBFBD>敤鎴锋渶澶氬垱寤?涓<>煡璇嗗簱
- 楠岃瘉鏃舵満锛氬垱寤虹煡璇嗗簱鏃?
- 閿欒<EFBFBD>鎻愮ず锛?宸茶揪鍒扮煡璇嗗簱鏁伴噺涓婇檺锛?涓<>級"
**BR-K002: 鏂囨。鏁伴噺闄愬埗**
- 规则：每个知识库最多上传50个文档
- 瑙勫垯锛氭瘡涓<EFBFBD>煡璇嗗簱鏈€澶氫笂浼?0涓<30>枃妗?
- 楠岃瘉鏃舵満锛氫笂浼犳枃妗ｆ椂
- 错误提示："该知识库文档数量已达上限（50个）"
- 閿欒<EFBFBD>鎻愮ず锛?璇ョ煡璇嗗簱鏂囨。鏁伴噺宸茶揪涓婇檺锛?0涓<30>級"
### 鏂囨。涓婁紶
**BR-K003: 鏂囦欢鏍煎紡闄愬埗**
- 瑙勫垯锛氬彧鏀<E5BDA7>寔PDF鍜孌OCX鏍煎紡
- MIME类型：
- MIME绫诲瀷锛?
- `application/pdf`
- `application/vnd.openxmlformats-officedocument.wordprocessingml.document`
- 错误提示："仅支持PDF和DOCX格式"
- 閿欒<EFBFBD>鎻愮ず锛?浠呮敮鎸丳DF鍜孌OCX鏍煎紡"
**BR-K004: 鏂囦欢澶у皬闄愬埗**
- 规则：单个文件最大50MB
- 瑙勫垯锛氬崟涓<EFBFBD>枃浠舵渶澶?0MB
- 楠岃瘉鏃舵満锛氫笂浼犲墠锛堝墠绔<E5A2A0>級鍜屼笂浼犲悗锛堝悗绔<E68297>級
- 错误提示："文件大小超过限制（最大50MB）"
- 閿欒<EFBFBD>鎻愮ず锛?鏂囦欢澶у皬瓒呰繃闄愬埗锛堟渶澶?0MB锛?
**BR-K005: 文件名唯一性**
**BR-K005: 鏂囦欢鍚嶅敮涓€鎬?*
- 瑙勫垯锛氬悓涓€鐭ヨ瘑搴撳唴锛屾枃浠跺悕涓嶈兘閲嶅<E996B2>
- 楠岃瘉锛氭<E9949B>鏌ユ槸鍚﹀凡瀛樺湪鍚屽悕鏂囦欢
- 处理：自动重命名（添加时间戳）
- 澶勭悊锛氳嚜鍔ㄩ噸鍛藉悕锛堟坊鍔犳椂闂存埑锛?
### 鏂囨。澶勭悊
**BR-K006: 文档处理状态**
**BR-K006: 鏂囨。澶勭悊鐘舵€?*
- 鐘舵€佹祦杞<E7A5A6>細
1. `uploading` - 上传中
2. `processing` - Dify处理中
1. `uploading` - 涓婁紶涓?
2. `processing` - Dify澶勭悊涓?
3. `completed` - 澶勭悊瀹屾垚
4. `failed` - 澶勭悊澶辫触
**BR-K007: 澶勭悊澶辫触閲嶈瘯**
- 规则：处理失败的文档不自动重试
- 瑙勫垯锛氬<EFBFBD>鐞嗗け璐ョ殑鏂囨。涓嶈嚜鍔ㄩ噸璇?
- 瑙勫垯锛氱敤鎴峰彲浠ュ垹闄ゅ悗閲嶆柊涓婁紶
- 閿欒<E996BF>淇℃伅锛氳<E9949B>褰曞湪error_message瀛楁<E7809B>
**BR-K008: 寮傛<E5AFAE>澶勭悊**
- 瑙勫垯锛氭枃妗ｄ笂浼犲悗绔嬪嵆杩斿洖
- 瑙勫垯锛氬悗鍙板紓姝ユ彁浜ゅ埌Dify澶勭悊
- 规则：前端轮询获取处理状态
- 瑙勫垯锛氬墠绔<EFBFBD>疆璇㈣幏鍙栧<EFBFBD>鐞嗙姸鎬?
### 知识库检索
### 鐭ヨ瘑搴撴<EFBFBD>绱?
**BR-K009: 混合检索**
- 规则：使用关键词检索 + 语义检索
- 规则：启用Reranking重排序
- Top K：5个结果
**BR-K009: 娣峰悎妫€绱?*
- 瑙勫垯锛氫娇鐢ㄥ叧閿<EFBFBD>瘝妫€绱?+ 璇<>箟妫€绱?
- 瑙勫垯锛氬惎鐢≧eranking閲嶆帓搴?
- Top K锛?涓<>粨鏋?
- 鐩镐技搴﹂槇鍊硷細0.5
**BR-K010: 检索结果引用**
**BR-K010: 妫€绱㈢粨鏋滃紩鐢?*
- 瑙勫垯锛欰I鍥炵瓟蹇呴』娉ㄦ槑寮曠敤鏉ユ簮
- 鏍煎紡锛歚[鏂囨。鍚峕 鍐呭<E98D90>...`
- 规则：前端显示可点击的引用标记
- 瑙勫垯锛氬墠绔<E5A2A0>樉绀哄彲鐐瑰嚮鐨勫紩鐢ㄦ爣璁?
---
@@ -290,27 +290,27 @@
### 鐢ㄦ埛鏉冮檺
**BR-P001: 瑙掕壊瀹氫箟**
- `user` - 普通用户
- 可以使用所有功能
- 受配额限制
- `admin` - 管理员
- `user` - 鏅<EFBFBD>€氱敤鎴?
- 鍙<>互浣跨敤鎵€鏈夊姛鑳?
- 鍙楅厤棰濋檺鍒?
- `admin` - 绠＄悊鍛?
- 鎵€鏈塽ser鏉冮檺
- 鍙<>互璁块棶杩愯惀鍚庡彴
- 可以查看所有用户数据
- 鍙<>互鏌ョ湅鎵€鏈夌敤鎴锋暟鎹?
### 鏁版嵁闅旂<E99785>
**BR-P002: 鐢ㄦ埛鏁版嵁闅旂<E99785>**
- 瑙勫垯锛氱敤鎴峰彧鑳借<E991B3>闂<EFBFBD>嚜宸卞垱寤虹殑鏁版嵁
- 楠岃瘉锛氭墍鏈夋煡璇㈠繀椤诲寘鍚玼serId杩囨护
- 实现：
- 瀹炵幇锛?
```sql
WHERE user_id = currentUser.id
```
**BR-P003: 椤圭洰鏉冮檺楠岃瘉**
- 规则：修改/删除项目前，验证所有权
- 实现：
- 瑙勫垯锛氫慨鏀?鍒犻櫎椤圭洰鍓嶏紝楠岃瘉鎵€鏈夋潈
- 瀹炵幇锛?
```typescript
const project = await prisma.project.findFirst({
where: { id: projectId, userId: currentUser.id }
@@ -318,33 +318,33 @@
if (!project) throw new UnauthorizedError()
```
### 管理员权限
### 绠＄悊鍛樻潈闄?
**BR-P004: 鐢ㄦ埛绠＄悊鏉冮檺**
- 瑙勫垯锛氬彧鏈塧dmin鍙<6E>互鏌ョ湅鐢ㄦ埛鍒楄〃
- 规则：只有admin可以修改用户状态
- 瑙勫垯锛氬彧鏈塧dmin鍙<EFBFBD>互淇<EFBFBD>敼鐢ㄦ埛鐘舵€?
- 瑙勫垯锛歛dmin涓嶈兘鍒犻櫎鐢ㄦ埛锛堝彧鑳芥殏鍋滐級
**BR-P005: 瀵硅瘽鏌ョ湅鏉冮檺**
- 瑙勫垯锛氬彧鏈塧dmin鍙<6E>互鏌ョ湅鐢ㄦ埛瀵硅瘽
- 规则：必须记录审计日志
- 规则：敏感信息需要脱敏（如邮箱、手机号）
- 瑙勫垯锛氬繀椤昏<EFBFBD>褰曞<EFBFBD>璁℃棩蹇?
- 瑙勫垯锛氭晱鎰熶俊鎭<EFBFBD>渶瑕佽劚鏁忥紙濡傞偖绠便€佹墜鏈哄彿锛?
---
## 閰嶉<E996B0>闄愬埗瑙勫垯
### 知识库配额
### 鐭ヨ瘑搴撻厤棰?
**BR-Q001: 知识库数量配额**
- 默认配额：3个知识库
**BR-Q001: 鐭ヨ瘑搴撴暟閲忛厤棰?*
- 榛樿<EFBFBD>閰嶉<EFBFBD>锛?涓<>煡璇嗗簱
- 璁板綍瀛楁<E7809B>锛歚users.kb_quota`, `users.kb_used`
- 更新时机：创建/删除知识库时
- 鏇存柊鏃舵満锛氬垱寤?鍒犻櫎鐭ヨ瘑搴撴椂
**BR-Q002: 鏂囨。鏁伴噺閰嶉<E996B0>**
- 默认配额：50个文档/知识库
- 检查时机：上传文档前
- 实现：
- 榛樿<E6A69B>閰嶉<E996B0>锛?0涓<30>枃妗?鐭ヨ瘑搴?
- 妫€鏌ユ椂鏈猴細涓婁紶鏂囨。鍓?
- 瀹炵幇锛?
```sql
SELECT COUNT(*) FROM documents
WHERE kb_id = ? AND status != 'failed'
@@ -353,72 +353,72 @@
### 瀛樺偍閰嶉<E996B0>锛堥<E9949B>鐣欙級
**BR-Q003: 瀛樺偍绌洪棿閰嶉<E996B0>**
- 默认配额：1GB/用户
- 榛樿<EFBFBD>閰嶉<EFBFBD>锛?GB/鐢ㄦ埛
- 褰撳墠鐗堟湰锛氫笉寮哄埗闄愬埗
- 未来：可以根据实际需求启用
- 鏈<EFBFBD>潵锛氬彲浠ユ牴鎹<EFBFBD>疄闄呴渶姹傚惎鐢?
### API闄愭祦
**BR-Q004: API璇锋眰棰戠巼闄愬埗**
- 普通用户：100次/分钟
- 管理员：500次/分钟
- 鏅<EFBFBD>€氱敤鎴凤細100娆?鍒嗛挓
- 绠＄悊鍛橈細500娆?鍒嗛挓
- 瀹炵幇锛氫娇鐢≧edis + 婊戝姩绐楀彛绠楁硶
**BR-Q005: 鐧诲綍鎺ュ彛闄愭祦**
- 规则：5次/分钟
- 规则：IP和账户双重限制
- 瑙勫垯锛?娆?鍒嗛挓
- 瑙勫垯锛欼P鍜岃处鎴峰弻閲嶉檺鍒?
- 瓒呰繃鍚庯細涓存椂灏佺<E7818F>15鍒嗛挓
---
## 涓氬姟娴佺▼
### 完整的对话流程
### 瀹屾暣鐨勫<EFBFBD>璇濇祦绋?
```
1. 用户选择智能体
↓
1. 鐢ㄦ埛閫夋嫨鏅鸿兘浣?
鈫?
2. 鍒涘缓瀵硅瘽锛堝彲閫夊叧鑱旈」鐩<E3808D>級
↓
3. 用户发送消息（可选引用知识库）
↓
鈫?
3. 鐢ㄦ埛鍙戦€佹秷鎭<EFBFBD>紙鍙<EFBFBD>€夊紩鐢ㄧ煡璇嗗簱锛?
鈫?
4. 鍚庣<E98D9A>缁勮<E7BC81>涓婁笅鏂囷細
- 椤圭洰鑳屾櫙锛堝<E9949B>鏈夛級
- 鏅鸿兘浣揝ystem Prompt
- 历史对话（最近10轮）
- 知识库检索结果（如有）
- 鍘嗗彶瀵硅瘽锛堟渶杩?0杞<30>級
- 鐭ヨ瘑搴撴<EFBFBD>绱㈢粨鏋滐紙濡傛湁锛?
- 褰撳墠鐢ㄦ埛闂<E59F9B><E99782>
↓
鈫?
5. 璋冪敤LLM锛堟祦寮忚緭鍑猴級
↓
鈫?
6. 淇濆瓨娑堟伅鍒版暟鎹<E69A9F>簱
↓
7. 用户可选：固定消息到项目背景
鈫?
7. 鐢ㄦ埛鍙<EFBFBD>€夛細鍥哄畾娑堟伅鍒伴」鐩<EFBFBD>儗鏅?
```
### 知识库文档处理流程
### 鐭ヨ瘑搴撴枃妗ｅ<EFBFBD>鐞嗘祦绋?
```
1. 鐢ㄦ埛涓婁紶鏂囨。
↓
2. 验证：
鈫?
2. 楠岃瘉锛?
- 鏂囦欢鏍煎紡
- 鏂囦欢澶у皬
- 鏁伴噺闄愬埗
↓
3. 上传到对象存储（OSS）
↓
4. 创建document记录（status: uploading）
↓
5. 异步提交到Dify：
鈫?
3. 涓婁紶鍒板<EFBFBD>璞″瓨鍌<EFBFBD>紙OSS锛?
鈫?
4. 鍒涘缓document璁板綍锛坰tatus: uploading锛?
鈫?
5. 寮傛<EFBFBD>鎻愪氦鍒癉ify锛?
- 璋冪敤Dify涓婁紶API
- 鑾峰彇dify_document_id
↓
6. 轮询处理状态（每2秒）：
- processing → 更新progress
- completed → 更新status, segments_count, tokens_count
- failed → 更新status, error_message
↓
鈫?
6. 杞<EFBFBD><EFBFBD>澶勭悊鐘舵€侊紙姣?绉掞級锛?
- processing 鈫?鏇存柊progress
- completed 鈫?鏇存柊status, segments_count, tokens_count
- failed 鈫?鏇存柊status, error_message
鈫?
7. 鏇存柊鐭ヨ瘑搴撶粺璁★細
- file_count
- total_size_bytes
@@ -426,29 +426,29 @@
---
## 数据一致性规则
## 鏁版嵁涓€鑷存€ц<EFBFBD>鍒?
### 缁熻<E7BC81>瀛楁<E7809B>鏇存柊
**BR-D001: 项目对话数统计**
**BR-D001: 椤圭洰瀵硅瘽鏁扮粺璁?*
- 瀛楁<E7809B>锛歚projects.conversation_count`
- 更新时机：创建/删除对话时
- 实现：使用事务保证一致性
- 鏇存柊鏃舵満锛氬垱寤?鍒犻櫎瀵硅瘽鏃?
- 瀹炵幇锛氫娇鐢ㄤ簨鍔′繚璇佷竴鑷存€?
**BR-D002: 鐭ヨ瘑搴撴枃妗ｆ暟缁熻<E7BC81>**
- 瀛楁<E7809B>锛歚knowledge_bases.file_count`
- 鏇存柊鏃舵満锛氭枃妗ｇ姸鎬佸彉涓篶ompleted鎴栧垹闄ゆ椂
- 计算：只统计status='completed'的文档
- 璁＄畻锛氬彧缁熻<E7BC81>status='completed'鐨勬枃妗?
**BR-D003: 鐢ㄦ埛鐭ヨ瘑搴撴暟缁熻<E7BC81>**
- 瀛楁<E7809B>锛歚users.kb_used`
- 更新时机：创建/删除知识库时
- 鏇存柊鏃舵満锛氬垱寤?鍒犻櫎鐭ヨ瘑搴撴椂
- 楠岃瘉锛氬垱寤哄墠妫€鏌ユ槸鍚﹁秴杩噏uota
### 绾ц仈鍒犻櫎
**BR-D004: 鐢ㄦ埛鍒犻櫎绾ц仈**
- 规则：删除用户时，级联删除所有关联数据
- 瑙勫垯锛氬垹闄ょ敤鎴锋椂锛岀骇鑱斿垹闄ゆ墍鏈夊叧鑱旀暟鎹?
- 鍖呮嫭锛歱rojects, conversations, messages, knowledge_bases, documents
- 瀹炵幇锛氭暟鎹<E69A9F>簱ON DELETE CASCADE
@@ -456,7 +456,7 @@
- 瑙勫垯锛氬垹闄ら」鐩<E3808D>椂锛岀骇鑱斿垹闄ゆ墍鏈夊<E98F88>璇濆拰娑堟伅
- 瀹炵幇锛氭暟鎹<E69A9F>簱ON DELETE CASCADE
**BR-D006: 知识库删除级联**
**BR-D006: 鐭ヨ瘑搴撳垹闄ょ骇鑱?*
- 瑙勫垯锛氬垹闄ょ煡璇嗗簱鏃讹細
1. 绾ц仈鍒犻櫎鏁版嵁搴撲腑鐨刣ocuments
2. 璋冪敤Dify API鍒犻櫎dataset
@@ -487,7 +487,7 @@
"success": false,
"error": {
"code": "QUOTA_EXCEEDED",
"message": "知识库数量已达上限",
"message": "鐭ヨ瘑搴撴暟閲忓凡杈句笂闄?,
"details": {
"resource": "knowledge_base",
"quota": 3,
@@ -506,11 +506,11 @@
**BR-S001: 瀵嗙爜鍔犲瘑**
- 绠楁硶锛歜crypt
- 成本因子：12
- 规则：永不存储明文密码
- 鎴愭湰鍥犲瓙锛?2
- 瑙勫垯锛氭案涓嶅瓨鍌ㄦ槑鏂囧瘑鐮?
**BR-S002: Token瀹夊叏**
- 规则：Token包含用户ID和角色
- 瑙勫垯锛歍oken鍖呭惈鐢ㄦ埛ID鍜岃<E98D9C>鑹?
- 瑙勫垯锛歍oken绛惧悕浣跨敤JWT_SECRET
- 瑙勫垯锛氳繃鏈烼oken鑷<6E>姩澶辨晥
@@ -524,7 +524,7 @@
### XSS闃叉姢
**BR-S004: 杈撳叆杞<E58F86>箟**
- 规则：所有用户输入在显示前转义
- 瑙勫垯锛氭墍鏈夌敤鎴疯緭鍏ュ湪鏄剧ず鍓嶈浆涔?
- 瑙勫垯锛氫娇鐢≧eact榛樿<E6A69B>杞<EFBFBD>箟
- 瑙勫垯锛氱<E9949B>姝<EFBFBD>娇鐢╠angerouslySetInnerHTML锛堥櫎闈炲繀瑕侊級
@@ -534,22 +534,22 @@
### 缂撳瓨瑙勫垯
**BR-O001: 智能体列表缓存**
**BR-O001: 鏅鸿兘浣撳垪琛ㄧ紦瀛?*
- 瑙勫垯锛氭櫤鑳戒綋鍒楄〃缂撳瓨1灏忔椂
- 瀹炵幇锛歊edis缂撳瓨
- 澶辨晥锛氫慨鏀筧gents.yaml鍚庨渶娓呴櫎缂撳瓨
**BR-O002: 鐢ㄦ埛淇℃伅缂撳瓨**
- 规则：用户信息缓存5分钟
- 瑙勫垯锛氱敤鎴蜂俊鎭<E4BF8A>紦瀛?鍒嗛挓
- Key锛歚user:{userId}`
- 澶辨晥锛氱敤鎴蜂俊鎭<E4BF8A>洿鏂版椂
### 鏌ヨ<E98F8C>浼樺寲
**BR-O003: 鍒嗛〉鏌ヨ<E98F8C>**
- 规则：列表查询必须分页
- 默认：20条/页
- 最大：100条/页
- 瑙勫垯锛氬垪琛ㄦ煡璇㈠繀椤诲垎椤?
- 榛樿<EFBFBD>锛?0鏉?椤?
- 鏈€澶э細100鏉?椤?
**BR-O004: 绱㈠紩浣跨敤**
- 瑙勫垯锛氶<E9949B>绻佹煡璇㈢殑瀛楁<E7809B>蹇呴』寤虹珛绱㈠紩
@@ -563,30 +563,30 @@
### 鏁版嵁褰掓。
**BR-R001: 瀵硅瘽褰掓。锛堟湭鏉ワ級**
- 规则：超过6个月的对话自动归档
- 瑙勫垯锛氳秴杩?涓<>湀鐨勫<E990A8>璇濊嚜鍔ㄥ綊妗?
- 褰掓。琛<E38082>細conversations_archive
- 鏌ヨ<E98F8C>锛氶粯璁や笉鏌ヨ<E98F8C>褰掓。鏁版嵁
**BR-R002: 鏃ュ織娓呯悊**
- 瑙勫垯锛歛dmin_logs淇濈暀3涓<33>湀
- 执行：定时任务每月清理
- 鎵ц<EFBFBD>锛氬畾鏃朵换鍔℃瘡鏈堟竻鐞?
---
## 涓氬姟瑙勫垯鍙樻洿娴佺▼
1. **提出变更**：填写变更申请
2. **影响评估**：评估对系统的影响
1. **鎻愬嚭鍙樻洿**锛氬～鍐欏彉鏇寸敵璇?
2. **褰卞搷璇勪及**锛氳瘎浼板<E6B5BC>绯荤粺鐨勫奖鍝?
3. **Review**锛氭妧鏈<E5A6A7>洟闃烺eview
4. **鏇存柊鏂囨。**锛氬悓姝ユ洿鏂版湰鏂囨。
5. **实施变更**：修改代码
5. **瀹炴柦鍙樻洿**锛氫慨鏀逛唬鐮?
6. **娴嬭瘯楠岃瘉**锛氭祴璇曟柊瑙勫垯
7. **涓婄嚎鍙戝竷**锛氬彂甯冨埌鐢熶骇
---
**文档维护：** 业务规则变更需同步更新
**Review频率：** 每个里程碑Review一次
**鏂囨。缁存姢锛?* 涓氬姟瑙勫垯鍙樻洿闇€鍚屾<E98D9A>鏇存柊
**Review棰戠巼锛?* 姣忎釜閲岀▼纰慠eview涓€娆?
**鏈€鍚庢洿鏂帮細** 2025-10-10
**缁存姢鑰咃細** 浜у搧缁忕悊 + 鎶€鏈<E282AC>礋璐ｄ汉

514
docs/00-系统总体设计/99-下一步行动决策建议.md
View File

@@ -1,106 +1,106 @@
# 下一步行动决策建议
# 銝衤<EFBFBD>甇亥<EFBFBD><EFBFBD>典<EFBFBD>蝑硋遣霈?
> **文档版本：** v1.0
> **创建日期：** 2025-11-06
> **文档目的：** 帮助您做出明确的技术和业务决策
> **<EFBFBD><EFBFBD>﹝<EFBFBD><EFBFBD>𧋦嚗?* v1.0
> **<EFBFBD>𥕦遣<EFBFBD>交<EFBFBD>嚗?* 2025-11-06
> **<EFBFBD><EFBFBD>﹝<EFBFBD>桃<EFBFBD>嚗?* 撣桀𨭌<E6A180>典<EFBFBD><E585B8>箸<EFBFBD>蝖桃<E89D96><E6A183><EFBFBD><EFBFBD>臬<EFBFBD>銝𡁜𦛚<F0A1819C>喟<EFBFBD>
---
## 🎯 当前状态
## <EFBFBD>㴓 敶枏<E695B6><E69E8F>嗆<EFBFBD>?
### ✅ 今日已完成
### <EFBFBD>?隞𦠜𠯫撌脣<E6928C><E884A3>?
**架构设计（100%完成）：**
- ✅ 8个核心文档（6000+行）
- ✅ 三层架构设计
- ✅ 8个业务模块规划
- ✅ 4种部署方案
- ✅ 完整的技术路线图
**<EFBFBD>嗆<EFBFBD>霈曇恣嚗?00%摰峕<E691B0>嚗㚁<E59A97>**
- <EFBFBD>?8銝芣瓲敹<E793B2><E695B9>獢<EFBFBD><E78DA2>6000+銵䕘<EFBFBD>
- <EFBFBD>?銝匧<E98A9D><E58CA7>嗆<EFBFBD>霈曇恣
- <EFBFBD>?8銝芯<E98A9D><E88AAF>⊥芋<E28AA5>𡑒<EFBFBD><F0A19192>?
- <EFBFBD>?4蝘漤<E89D98>蝵脫䲮獢?
- <EFBFBD>?摰峕㟲<E5B395><E39FB2><EFBFBD><EFBFBD>航楝蝥踹㦛
**核心决策（100%完成）：**
- ✅ 明确了运营管理端的定位和功能
- ✅ 明确了模块独立部署方案
- ✅ 明确了Electron单机版方案
- ✅ 明确了Schema隔离的时机和成本
- ✅ 明确了Monorepo的必要性和时机
**<EFBFBD>詨<EFBFBD><EFBFBD>喟<EFBFBD>嚗?00%摰峕<E691B0>嚗㚁<E59A97>**
- <EFBFBD>?<3F>𡒊＆鈭<EFBC86><E988AD><EFBFBD>亦恣<E4BAA6><E681A3>垢<EFBFBD><E59EA2><EFBFBD>雿滚<E99BBF><E6BB9A>蠘<EFBFBD>
- <EFBFBD>?<3F>𡒊＆鈭<EFBC86>芋<EFBFBD>㛖𡠺蝡钅<E89DA1>蝵脫䲮獢?
- <EFBFBD>?<3F>𡒊＆鈭<EFBC86>lectron<6F>閙㦤<E99699><E3A6A4>䲮獢?
- <EFBFBD>?<3F>𡒊＆鈭<EFBC86>chema<6D>𠉛氖<F0A0899B><E6B096>𧒄<EFBFBD>箏<EFBFBD><E7AE8F>鞉𧋦
- <EFBFBD>?<3F>𡒊＆鈭<EFBC86>onorepo<70><6F><EFBFBD>閬<EFBFBD><E996AC>批<EFBFBD><E689B9>嗆㦤
---
## 🤔 需要您决策的关键问题
## <EFBFBD><EFBFBD> <20><>閬<EFBFBD><E996AC><EFBFBD>喟<EFBFBD><E5969F><EFBFBD><EFBFBD><EFBFBD>桅䔮憸?
### <20>桅<EFBFBD>1嚗𡁏糓<F0A1818F>衣緵<E8A1A3>典<EFBFBD>Schema<6D>𠉛氖嚗麨<E59A97>潃鐥<E6BD83>潃鐥<E6BD83>
**<EFBFBD>厰★A嚗𡁶緵<EFBFBD>典<EFBFBD>嚗<EFBFBD>撩<EFBFBD><EFBFBD>綫<EFBFBD>琜<EFBFBD>**
```
投入：1周（3天开发 + 2天测试）
收益：避免未来3-5周改造
ROI：300-500%
<EFBFBD>訫<EFBFBD>嚗?<3F>剁<EFBFBD>3憭拙<E686AD><E68B99>?+ 2憭拇<E686AD>霂𤏪<E99C82>
<EFBFBD>嗥<EFBFBD>嚗𡁻<EFBFBD><EFBFBD>齿𧊋<EFBFBD>?-5<>冽㺿<E586BD>?
ROI嚗?00-500%
优势：
✅ 数据量小（< 1万行），迁移快
✅ 为7个模块打基础
✅ 支持模块独立部署
✅ 支持微服务拆分
隡睃飵嚗?
<EFBFBD>?<3F>唳旿<E594B3>誩<EFBFBD>嚗? 1銝<31><E98A9D>嚗㚁<E59A97>餈<EFBFBD>宏敹?
<EFBFBD>?銝?銝芣芋<E88AA3>埈<EFBFBD><E59F88>箇<EFBFBD>
<EFBFBD>?<3F>舀<EFBFBD>璅∪<E79285><E288AA>祉<EFBFBD><E7A589>函蔡
<EFBFBD>?<3F>舀<EFBFBD>敺格<E695BA><E6A0BC>⊥<EFBFBD><E28AA5>?
劣势：
⚠️ ASL模块延迟1周
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>𩤃<EFBFBD> ASL璅∪<EFBFBD>撱嗉<EFBFBD>1<EFBFBD>?
```
**<EFBFBD>厰★B嚗𡁜辣<EFBFBD>𠬍<EFBFBD>銝齿綫<EFBFBD>琜<EFBFBD>**
```
投入：0（当前）
成本：未来3-5周改造
<EFBFBD>訫<EFBFBD>嚗?嚗<><E59A97><EFBFBD>㵪<EFBFBD>
<EFBFBD>鞉𧋦嚗𡁏𧊋<EFBFBD>?-5<>冽㺿<E586BD>?
优势：
✅ 立即开始ASL开发
隡睃飵嚗?
<EFBFBD>?蝡见朖撘<E69C96>憪𧘹SL撘<4C><E69298>?
劣势：
❌ 技术债累积
❌ 未来成本5倍
❌ 数据量大，迁移风险高
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>?<3F><><EFBFBD>臬<EFBFBD>箇敞蝘?
<EFBFBD>?<3F>芣䔉<E88AA3>鞉𧋦5<F0A78BA6>?
<EFBFBD>?<3F>唳旿<E594B3>誩之嚗諹<E59A97>蝘駁<E89D98><E9A781>拚<EFBFBD>
```
**我的建议：选择A（现在做）** ⭐⭐⭐⭐⭐
**<EFBFBD>𤑳<EFBFBD>撱箄悅嚗𡁻<EFBFBD>㗇𥋘A嚗<EFBFBD>緵<EFBFBD>典<EFBFBD>嚗?* 潃鐥<E6BD83>潃鐥<E6BD83>潃?
---
### <20>桅<EFBFBD>2嚗𡁏糓<F0A1818F>衣緵<E8A1A3>刻蓮<E588BB>﹪onorepo嚗麨<E59A97>潃鐥<E6BD83>潃鐥<E6BD83>
**选项A：现在转换（强烈推荐）**
**<EFBFBD>厰★A嚗𡁶緵<EFBFBD>刻蓮<EFBFBD>ｇ<EFBFBD>撘箇<EFBFBD><EFBFBD>刻<EFBFBD>嚗?*
```
投入：2-3天
收益：节省未来7-11天
ROI：300-400%
<EFBFBD>訫<EFBFBD>嚗?-3憭?
<EFBFBD>嗥<EFBFBD>嚗朞<EFBFBD><EFBFBD><EFBFBD>𧊋<EFBFBD>?-11憭?
ROI嚗?00-400%
优势：
✅ 近期开发运营管理端（独立前端）
✅ 代码复用变容易
✅ 为Electron单机版打基础
✅ 为独立产品打包打基础
隡睃飵嚗?
<EFBFBD>?餈烐<E9A488>撘<EFBFBD><E69298>𤏸<EFBFBD><F0A48FB8>亦恣<E4BAA6><E681A3>垢嚗<E59EA2>𡠺蝡见<E89DA1>蝡荔<E89DA1>
<EFBFBD>?隞<><E99A9E>憭滨鍂<E6BBA8>睃捆<E79D83>?
<EFBFBD>?銝慟lectron<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD><EFBFBD>箇<EFBFBD>
<EFBFBD>?銝箇𡠺蝡衤漣<E8A1A4><E6BCA3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>箇<EFBFBD>
劣势：
⚠️ 需要学习新技术（但有AI全程指导）
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>𩤃<EFBFBD> <20><>閬<EFBFBD>郎銋䭾鰵<E4ADBE><E9B0B5><EFBFBD>荔<EFBFBD>雿<EFBFBD><E99BBF>AI<41>函<EFBFBD><E587BD><EFBFBD>紡嚗?
```
**<EFBFBD>厰★B嚗𡁜辣<EFBFBD>𠬍<EFBFBD>銝齿綫<EFBFBD>琜<EFBFBD>**
```
投入：0（当前）
成本：未来7-11天改造
<EFBFBD>訫<EFBFBD>嚗?嚗<><E59A97><EFBFBD>㵪<EFBFBD>
<EFBFBD>鞉𧋦嚗𡁏𧊋<EFBFBD>?-11憭拇㺿<E68B87>?
优势：
✅ 立即开始ASL开发
隡睃飵嚗?
<EFBFBD>?蝡见朖撘<E69C96>憪𧘹SL撘<4C><E69298>?
劣势：
❌ 代码重复（类型定义、工具函数等）
❌ 运营管理端开发时必须转换
❌ 未来成本更高
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>?隞<><E99A9E><EFBFBD>滚<EFBFBD>嚗<EFBFBD>掩<EFBFBD>见<EFBFBD>銋剹<E98A8B><E589B9>極<EFBFBD>瑕遆<E79195>啁<EFBFBD>嚗?
<EFBFBD>?餈鞱𨯫蝞∠<E89D9E>蝡臬<E89DA1><E887AC>烐𧒄敹<F0A79284>◆頧祆揢
<EFBFBD>?<3F>芣䔉<E88AA3>鞉𧋦<E99E89>湧<EFBFBD>
```
**我的建议：选择A（现在转换）** ⭐⭐⭐⭐⭐
**<EFBFBD>𤑳<EFBFBD>撱箄悅嚗𡁻<EFBFBD>㗇𥋘A嚗<EFBFBD>緵<EFBFBD>刻蓮<EFBFBD>ｇ<EFBFBD>** 潃鐥<E6BD83>潃鐥<E6BD83>潃?
**补充说明：**
- 如果近期（1-2个月）开发运营管理端，Monorepo是必须的
- 如果6个月内不开发运营管理端，可以延后
**銵亙<EFBFBD>霂湔<EFBFBD>嚗?*
- 憒<EFBFBD><EFBFBD>餈烐<EFBFBD>嚗?-2銝芣<E98A9D>嚗匧<E59A97><E58CA7>𤏸<EFBFBD><F0A48FB8>亦恣<E4BAA6><E681A3>垢嚗愢onorepo<EFBFBD>臬<EFBFBD>憿餌<EFBFBD>
- 憒<EFBFBD><EFBFBD>6銝芣<EFBFBD><EFBFBD><EFBFBD><EFBFBD>撘<EFBFBD><EFBFBD>𤏸<EFBFBD><EFBFBD>亦恣<EFBFBD><EFBFBD>垢嚗<EFBFBD>虾隞亙辣<EFBFBD>?
---
@@ -108,141 +108,141 @@ ROI：300-400%
**<EFBFBD>厰★A嚗𡁶<EFBFBD><EFBFBD>喳<EFBFBD><EFBFBD>飊SL璅∪<EFBFBD>**
```
时间：从明天开始
内容：标题摘要初筛 + 全文复筛
<EFBFBD>園𡢿嚗帋<EFBFBD><EFBFBD>𤾸予撘<EFBFBD>憪?
<EFBFBD><EFBFBD>捆嚗𡁏<EFBFBD>憸䀹<EFBFBD>閬<EFBFBD><EFBFBD>蝑?+ <20>冽<EFBFBD>憭滨<E686AD>
优势：
✅ 快速推进业务
✅ 满足市场需求
隡睃飵嚗?
<EFBFBD>?敹恍<E695B9><E6818D>綫餈𥕢<E9A488><F0A595A2>?
<EFBFBD>?皛∟雲撣<E99BB2>㦤<EFBFBD><E3A6A4>瘙?
劣势：
❌ 技术债累积
❌ 未来改造成本高
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>?<3F><><EFBFBD>臬<EFBFBD>箇敞蝘?
<EFBFBD>?<3F>芣䔉<E88AA3>寥<EFBFBD>䭾<EFBFBD><E4ADBE>祇<EFBFBD>
```
**<EFBFBD>厰★B嚗𡁜<EFBFBD><EFBFBD>𡁏沲<EFBFBD><EFBFBD>㺿<EFBFBD>𩤃<EFBFBD><EFBFBD>滚<EFBFBD><EFBFBD>飊SL**
```
时间：
- Week 1：Schema隔离 + Monorepo（6天）
- Week 2+：ASL模块开发
<EFBFBD>園𡢿嚗?
- Week 1嚗锭chema<EFBFBD>𠉛氖 + Monorepo嚗?憭抬<E686AD>
- Week 2+嚗鋫SL璅∪<EFBFBD>撘<EFBFBD><EFBFBD>?
优势：
✅ 架构清晰，长期收益
✅ 代码复用便利
✅ 避免未来1个月改造成本
隡睃飵嚗?
<EFBFBD>?<3F>嗆<EFBFBD>皜<EFBFBD>苊嚗屸鵭<E5B1B8><E9B5AD>𤣰<EFBFBD>?
<EFBFBD>?隞<><E99A9E>憭滨鍂靘踹⏚
<EFBFBD>?<3F>踹<EFBFBD><E8B8B9>芣䔉1銝芣<E98A9D><E88AA3>寥<EFBFBD>䭾<EFBFBD><E4ADBE>?
劣势：
⚠️ ASL模块延迟1周
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>𩤃<EFBFBD> ASL璅∪<EFBFBD>撱嗉<EFBFBD>1<EFBFBD>?
```
**<EFBFBD>厰★C嚗𡁜蘨<EFBFBD>鐝onorepo嚗<EFBFBD>辣<EFBFBD>燑chema<EFBFBD>𠉛氖**
```
时间：
<EFBFBD>園𡢿嚗?
- Day 1-3嚗鐝onorepo頧祆揢
- Day 4+：ASL模块开发
- Day 4+嚗鋫SL璅∪<EFBFBD>撘<EFBFBD><EFBFBD>?
- <20>芣䔉嚗锭chema<6D>𠉛氖嚗<E6B096>㺭<EFBFBD>桅<EFBFBD>憓鮋鵭<E9AE8B>㵪<EFBFBD>
优势：
✅ 解决最紧迫的问题（运营管理端需要）
✅ 快速推进业务
隡睃飵嚗?
<EFBFBD>?閫<><E996AB><EFBFBD><EFBFBD>蝝扯翰<E689AF><E7BFB0>䔮憸矋<E686B8>餈鞱𨯫蝞∠<E89D9E>蝡舫<E89DA1>閬<EFBFBD><E996AC>
<EFBFBD>?敹恍<E695B9><E6818D>綫餈𥕢<E9A488><F0A595A2>?
劣势：
⚠️ Schema隔离成本会增加
<EFBFBD><EFBFBD>飵嚗?
<EFBFBD>𩤃<EFBFBD> Schema<EFBFBD>𠉛氖<EFBFBD>鞉𧋦隡𡁜<EFBFBD><EFBFBD>?
```
**我的建议：选择B（先做架构改造）** ⭐⭐⭐⭐⭐
**<EFBFBD>𤑳<EFBFBD>撱箄悅嚗𡁻<EFBFBD>㗇𥋘B嚗<EFBFBD><EFBFBD><EFBFBD>𡁏沲<EFBFBD><EFBFBD>㺿<EFBFBD>𩤃<EFBFBD>** 潃鐥<E6BD83>潃鐥<E6BD83>潃?
---
## <20><> 銝劐葵<E58A90>寞<EFBFBD>撖寞<E69296>
| 维度 | 方案A：立即开发 | 方案B：先改造 | 方案C：折中 |
| 蝏游漲 | <20>寞<EFBFBD>A嚗𡁶<E59A97><F0A181B6>喳<EFBFBD><E596B3>?| <20>寞<EFBFBD>B嚗𡁜<E59A97><F0A1819C>寥<EFBFBD>?| <20>寞<EFBFBD>C嚗𡁏<E59A97>銝?|
|------|---------------|-------------|-----------|
| **ASL銝羓瑪<E7BE93>園𡢿** | <20><>敹恬<E695B9>2<EFBFBD>剁<EFBFBD> | 撱嗉<E692B1>1<EFBFBD>剁<EFBFBD>3<EFBFBD>剁<EFBFBD> | 撱嗉<E692B1>3憭抬<E686AD>2.5<EFBFBD>剁<EFBFBD> |
| **技术债** | 累积 | 还清 | 部分还清 |
| **未来改造成本** | 1个月 | 0 | 3-5周 |
| **代码质量** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **长期收益** | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **投入产出比** | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **推荐度** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **<EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>?* | 蝝舐妖 | 餈䀹<E9A488> | <20>典<EFBFBD>餈䀹<E9A488> |
| **<EFBFBD>芣䔉<EFBFBD>寥<EFBFBD>䭾<EFBFBD><EFBFBD>?* | 1銝芣<EFBFBD> | 0 | 3-5<EFBFBD>?|
| **隞<EFBFBD><EFBFBD>韐券<EFBFBD>** | 潃鐥<EFBFBD>潃?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?| 潃鐥<E6BD83>潃鐥<E6BD83> |
| **<EFBFBD>踵<EFBFBD><EFBFBD>嗥<EFBFBD>** | 潃鐥<EFBFBD> | 潃鐥<E6BD83>潃鐥<E6BD83>潃?| 潃鐥<E6BD83>潃鐥<E6BD83> |
| **<EFBFBD>訫<EFBFBD>鈭批枂瘥?* | 潃鐥<E6BD83> | 潃鐥<E6BD83>潃鐥<E6BD83>潃?| 潃鐥<E6BD83>潃鐥<E6BD83> |
| **<EFBFBD>刻<EFBFBD>摨?* | 潃鐥<E6BD83>潃?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?| 潃鐥<E6BD83>潃鐥<E6BD83> |
---
## 🎯 我的最终建议
## <EFBFBD>㴓 <20>𤑳<EFBFBD><F0A491B3><EFBFBD>蝏<EFBFBD>遣霈?
### 推荐：方案B（先做架构改造，再开发）⭐⭐⭐⭐⭐
### <EFBFBD>刻<EFBFBD>嚗𡁏䲮獢㇂嚗<EFBFBD><EFBFBD><EFBFBD>𡁏沲<EFBFBD><EFBFBD>㺿<EFBFBD>𩤃<EFBFBD><EFBFBD>滚<EFBFBD><EFBFBD>𡢅<EFBFBD>潃鐥<EFBFBD>潃鐥<EFBFBD>潃?
### <20>詨<EFBFBD><E8A9A8><EFBFBD>眏
**1. <20>訫<EFBFBD>1<EFBFBD>剁<EFBFBD><E58981><EFBFBD><EFBFBD><EFBFBD>芣䔉1銝芣<E98A9D>**
```
现在投入：6天
- Schema隔离：3天
- Monorepo转换：3天
<EFBFBD>啣銁<EFBFBD>訫<EFBFBD>嚗?憭?
- Schema<EFBFBD>𠉛氖嚗?憭?
- Monorepo頧祆揢嚗?憭?
未来节省：22-36天
- Schema隔离：15-25天
- Monorepo转换：7-11天
<EFBFBD>芣䔉<EFBFBD><EFBFBD><EFBFBD>嚗?2-36憭?
- Schema<EFBFBD>𠉛氖嚗?5-25憭?
- Monorepo頧祆揢嚗?-11憭?
<EFBFBD>訫<EFBFBD>鈭批枂瘥䈑<EFBFBD>300-500%
```
**2. 正处于最佳时机**
**2. 甇<EFBFBD><EFBFBD>鈭擧<EFBFBD>雿單𧒄<EFBFBD>?*
```
当前：
✅ 数据量小（< 1万行）
✅ 代码量适中
✅ 只有2个已完成模块（AIA、PKB）
✅ 即将开发多个新模块（ASL、DC、ADMIN等）
敶枏<EFBFBD>嚗?
<EFBFBD>?<3F>唳旿<E594B3>誩<EFBFBD>嚗? 1銝<31><E98A9D>嚗?
<EFBFBD>?隞<><E99A9E><EFBFBD>誯<EFBFBD><E8AAAF>葉
<EFBFBD>?<3F>芣<EFBFBD>2銝芸歇摰峕<E691B0>璅∪<E79285>嚗㇁IA<49><41>KB嚗?
<EFBFBD>?<3F>喳<EFBFBD>撘<EFBFBD><E69298>穃<EFBFBD>銝芣鰵璅∪<E79285>嚗㇁SL<53><4C>C<EFBFBD><43>DMIN蝑㚁<EFBFBD>
未来：
❌ 数据量大（100万行+）
❌ 代码量大
❌ 7-8个模块同时运行
❌ 重构影响范围巨大
<EFBFBD>芣䔉嚗?
<EFBFBD>?<3F>唳旿<E594B3>誩之嚗?00銝<30><E98A9D>+嚗?
<EFBFBD>?隞<><E99A9E><EFBFBD>誩之
<EFBFBD>?7-8銝芣芋<EFBFBD>堒<EFBFBD><EFBFBD>嗉<EFBFBD>銵?
<EFBFBD>?<3F>齿<EFBFBD>敶勗<E695B6><E58B97><EFBFBD>凒撌典之
```
**3. 为7个模块打下坚实基础**
**3. 銝?銝芣芋<E88AA3>埈<EFBFBD>銝见<E98A9D>摰𧼮抅蝖<E68A85>**
```
即将开发的模块：
- ASL（AI智能文献）
<EFBFBD>喳<EFBFBD>撘<EFBFBD><EFBFBD>𤑳<EFBFBD>璅∪<EFBFBD>嚗?
- ASL嚗㇁I<EFBFBD>箄<EFBFBD><EFBFBD><EFBFBD>讃嚗?
- DC嚗<43>㺭<EFBFBD>格<EFBFBD>瘣梹<E798A3>
- SSA嚗<41>惣<EFBFBD>賜<EFBFBD>霈∴<E99C88>
- ST嚗<54><E59A97><EFBFBD>𣂼極<F0A382BC>瘀<EFBFBD>
- RVW<56>拙<EFBFBD>嚗<EFBFBD><E59A97><EFBFBD>游恣蝔輻頂蝏<E9A082><E89D8F>
- ADMIN（运营管理端）
- ADMIN嚗<EFBFBD><EFBFBD><EFBFBD>亦恣<EFBFBD><EFBFBD>垢嚗?
餈嗘<EFBFBD>璅∪<EFBFBD><EFBFBD>賢<EFBFBD><EFBFBD>㛖<EFBFBD>鈭𠬍<EFBFBD>
✅ Schema隔离（清晰的数据架构）
✅ Monorepo（代码复用便利）
<EFBFBD>?Schema<EFBFBD>𠉛氖嚗<EFBFBD><EFBFBD><EFBFBD>啁<EFBFBD><EFBFBD>唳旿<EFBFBD>嗆<EFBFBD>嚗?
<EFBFBD>?Monorepo嚗<EFBFBD>誨<EFBFBD><EFBFBD><EFBFBD><EFBFBD>其噶<EFBFBD>抬<EFBFBD>
```
**4. 避免技术债累积**
**4. <EFBFBD>踹<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>箇敞蝘?*
```
技术债的特点：
- 时间越久，利息越高
- 改造成本成倍增长
<EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>箇<EFBFBD><EFBFBD>寧<EFBFBD>嚗?
- <EFBFBD>園𡢿頞𠹺<EFBFBD>嚗<EFBFBD>⏚<EFBFBD>航<EFBFBD>擃?
- <EFBFBD>寥<EFBFBD>䭾<EFBFBD><EFBFBD>祆<EFBFBD><EFBFBD>滚<EFBFBD><EFBFBD>?
- 敶勗<E695B6>銝𡁜𦛚<F0A1819C>𥟇鰵<F0A59F87>笔漲
现在改造 = 一次性还清
轻装上阵，专注业务
<EFBFBD>啣銁<EFBFBD>寥<EFBFBD>?= 銝<>甈⊥<E79488>扯<EFBFBD>皜?
頧餉<EFBFBD>銝𢠃猐嚗䔶<EFBFBD>瘜其<EFBFBD><EFBFBD>?
```
---
## 📅 详细实施计划（方案B）
## <EFBFBD><EFBFBD> 霂衣<E99C82>摰墧鴌霈∪<E99C88>嚗<EFBFBD>䲮獢㇂嚗?
### Week 1嚗𡁏沲<F0A1818F><E6B2B2>㺿<EFBFBD>𩤃<EFBFBD>6憭抬<E686AD>
**Day 1-3嚗锭chema<6D>𠉛氖**
```
Day 1（准备）：
Day 1嚗<EFBFBD><EFBFBD>憭<EFBFBD><EFBFBD>嚗?
- [ ] 霈曇恣Schema蝏𤘪<E89D8F>
* platform_schema（用户、权限、Feature Flag）
* aia_schema（AI问答）
* asl_schema（AI文献）
* pkb_schema（知识库）
* platform_schema嚗<EFBFBD>鍂<EFBFBD>瑯<EFBFBD><EFBFBD><EFBFBD><EFBFBD>僐<EFBFBD><EFBFBD>eature Flag嚗?
* aia_schema嚗㇁I<EFBFBD>桃<EFBFBD>嚗?
* asl_schema嚗㇁I<EFBFBD><EFBFBD>讃嚗?
* pkb_schema嚗<EFBFBD>䰻霂<EFBFBD><EFBFBD>嚗?
* dc_schema嚗<61>㺭<EFBFBD>格<EFBFBD>瘣梹<E798A3>
* review_schema嚗<61>阮隞嗅恣<E59785>伐<EFBFBD>
* admin_schema嚗<61><E59A97><EFBFBD>亦恣<E4BAA6><E681A3><EFBFBD>
@@ -250,19 +250,19 @@ Day 1（准备）：
- [ ] 蝻硋<E89DBB>餈<EFBFBD>宏<EFBFBD>𡁏𧋦
- [ ] <20><><EFBFBD>瘚贝<E7989A><E8B49D>其<EFBFBD>
Day 2（开发环境改造）：
- [ ] 创建所有Schema（10分钟）
- [ ] 修改Prisma Schema（2-4小时）
Day 2嚗<EFBFBD><EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD>㺿<EFBFBD>𩤃<EFBFBD>嚗?
- [ ] <EFBFBD>𥕦遣<EFBFBD><EFBFBD><EFBFBD>农chema嚗?0<><30><EFBFBD>嚗?
- [ ] 靽格㺿Prisma Schema嚗?-4撠𤩺𧒄嚗?
* 銝箸<E98A9D>銝杯odel瘛餃<E7989B>@@schema<6D><61><EFBFBD>
* <20>湔鰵憭㚚睸<E39A9A>唾<EFBFBD>
* 启用multiSchema特性
* <EFBFBD>舐鍂multiSchema<EFBFBD>寞<EFBFBD>?
- [ ] 餈鞱<E9A488>Prisma Migrate
- [ ] <20>扯<EFBFBD><E689AF>唳旿餈<E697BF>宏
- [ ] 餈鞱<E9A488>瘚贝<E7989A>
Day 3（生产环境迁移 + 验证）：
- [ ] 备份生产数据库
Day 3嚗<EFBFBD><EFBFBD>鈭抒㴓憓<EFBFBD><EFBFBD>蝘?+ 撉諹<E69289>嚗㚁<E59A97>
- [ ] 憭<EFBFBD>遢<EFBFBD>煺漣<EFBFBD>唳旿摨?
- [ ] <20>扯<EFBFBD>Schema餈<61>宏
- [ ] <20>唳旿餈<E697BF>宏
- [ ] 撉諹<E69289>瘚贝<E7989A>
@@ -273,17 +273,17 @@ Day 3（生产环境迁移 + 验证）：
**Day 4-6嚗鐝onorepo頧祆揢**
```
Day 4（学习 + 设计）：
- [ ] 学习pnpm workspaces（1-2小时）
Day 4嚗<EFBFBD>郎銋?+ 霈曇恣嚗㚁<E59A97>
- [ ] 摮虫<EFBFBD>pnpm workspaces嚗?-2撠𤩺𧒄嚗?
- [ ] 霈曇恣<E69B87>桀<EFBFBD>蝏𤘪<E89D8F>
* packages/（放什么？）
* apps/（放什么？）
* packages/嚗<EFBFBD>𦆮隞<EFBFBD>銋<EFBFBD><EFBFBD>嚗?
* apps/嚗<EFBFBD>𦆮隞<EFBFBD>銋<EFBFBD><EFBFBD>嚗?
- [ ] 设计共享包
- [ ] 霈曇恣<EFBFBD>曹澈<EFBFBD>?
* shared-types嚗<73>掩<EFBFBD>见<EFBFBD>銋㚁<E98A8B>
* platform-core（平台核心，暂时不拆）
* platform-core嚗<EFBFBD>像<EFBFBD>唳瓲敹<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𧒄銝齿<EFBFBD>嚗?
Day 5（重构实施）：
Day 5嚗<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>踝<EFBFBD>嚗?
- [ ] <20>𥕦遣<F0A595A6>雷ackage.json<6F>俰npm-workspace.yaml
- [ ] <20>𥕦遣packages/shared-types/
- [ ] 蝘餃𢆡frontend<6E>軒pps/frontend/
@@ -292,27 +292,27 @@ Day 5（重构实施）：
- [ ] <20>滨蔭workspace靘肽<E99D98>
- [ ] <20>湔鰵import頝臬<E9A09D>
Day 6（测试验证）：
Day 6嚗<EFBFBD><EFBFBD>霂閖<EFBFBD>霂<EFBFBD><EFBFBD>嚗?
- [ ] 瘚贝<E7989A><E8B49D>滨垢<E6BBA8>臬𢆡
- [ ] 瘚贝<E7989A><E8B49D>𡒊垢<F0A1928A>臬𢆡
- [ ] 瘚贝<E7989A>蝐餃<E89D90><E9A483>鞟內
- [ ] 瘚贝<E7989A><E8B49D><EFBFBD>遣
- [ ] 验证所有功能
- [ ] 撉諹<EFBFBD><EFBFBD><EFBFBD><EFBFBD>匧<EFBFBD><EFBFBD>?
- [ ] 隡睃<E99AA1><E79D83>滨蔭
```
---
### Week 2-4：ASL模块开发
### Week 2-4嚗鋫SL璅∪<EFBFBD>撘<EFBFBD><EFBFBD>?
**Week 2：标题摘要初筛**
- [ ] 数据库设计（asl_schema）
**Week 2嚗𡁏<EFBFBD>憸䀹<EFBFBD>閬<EFBFBD><EFBFBD>蝑?*
- [ ] <EFBFBD>唳旿摨栞挽霈∴<EFBFBD>asl_schema嚗?
- [ ] API霈曇恣
- [ ] <20>𡒊垢摰䂿緵嚗㇊ICO<43>滨蔭<E6BBA8><E894AD>I<EFBFBD>斗鱏<E69697><E9B18F><EFBFBD><EFBFBD>厩<EFBFBD><E58EA9>頣<EFBFBD>
- [ ] <20>滨垢摰䂿緵嚗<E7B7B5>”<EFBFBD>澆極雿𨅯蝱<F0A885AF><E89DB1>恣<EFBFBD>亙撕蝒梹<E89D92>
**Week 3：全文复筛**
- [ ] PDF查看器集成
**Week 3嚗𡁜<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑?*
- [ ] PDF<EFBFBD>亦<EFBFBD><EFBFBD>券<EFBFBD><EFBFBD>?
- [ ] <20>冽<EFBFBD>AI<41>斗鱏
- [ ] <20>滨垢摰䂿緵嚗<E7B7B5><E59A97><EFBFBD><EFBFBD>恣<EFBFBD>亦<EFBFBD><E4BAA6>ｇ<EFBFBD>
@@ -327,28 +327,28 @@ Day 6（测试验证）：
### 憒<><E68692><EFBFBD>㗇𥋘<E39787>寞<EFBFBD>B嚗<42>沲<EFBFBD><E6B2B2>㺿<EFBFBD>𩤃<EFBFBD>
**成功要素：**
1. ✅ **坚定的决心**：相信长期价值，不急功近利
2. ✅ **AI全程协助**：我会全程指导每一步
3. ✅ **详细的计划**：每天的任务都清晰明确
4. ✅ **充足的时间**：愿意投入6天做架构改造
**<EFBFBD>𣂼<EFBFBD>閬<EFBFBD><EFBFBD>嚗?*
1. <EFBFBD>?**<2A>𡁜<EFBFBD><F0A1819C><EFBFBD><EFBFBD>敹?*嚗𡁶㮾靽⊿鵭<E28ABF>煺遠<E785BA>潘<EFBFBD>銝齿<E98A9D>亙<EFBFBD>餈穃⏚
2. <EFBFBD>?**AI<EFBFBD>函<EFBFBD><EFBFBD>誩𨭌**嚗𡁏<E59A97>隡𡁜<E99AA1>蝔𧢲<E89D94>撖潭<E69296>銝<EFBFBD>甇?
3. <EFBFBD>?**霂衣<E99C82><E8A1A3><EFBFBD>恣<EFBFBD>?*嚗𡁏<E59A97>憭拍<E686AD>隞餃𦛚<E9A483>賣<EFBFBD><E8B3A3>唳<EFBFBD>蝖?
4. <EFBFBD>?**<2A><>雲<EFBFBD><E99BB2>𧒄<EFBFBD>?*嚗𡁏<E59A97><F0A1818F>𤩺<EFBFBD><F0A4A9BA>?憭拙<E686AD><E68B99>嗆<EFBFBD><E59786>寥<EFBFBD>?
**预期结果：**
- ✅ 1周后，拥有清晰、健壮的架构
- ✅ 为未来7个模块打下坚实基础
- ✅ 避免未来1个月的技术债偿还
**憸<EFBFBD><EFBFBD>蝏𤘪<EFBFBD>嚗?*
- <EFBFBD>?1<>典<EFBFBD>嚗峕𥅾<E5B395>㗇<EFBFBD><E39787>啜<EFBFBD><E5959C><EFBFBD>憯桃<E686AF><E6A183>嗆<EFBFBD>
- <EFBFBD>?銝箸𧊋<E7AEB8>?銝芣芋<E88AA3>埈<EFBFBD>銝见<E98A9D>摰𧼮抅蝖<E68A85>
- <EFBFBD>?<3F>踹<EFBFBD><E8B8B9>芣䔉1銝芣<E98A9D><E88AA3><EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>箏<EFBFBD>餈?
---
### 憒<><E68692><EFBFBD>㗇𥋘<E39787>寞<EFBFBD>A嚗<41><E59A97><EFBFBD>喳<EFBFBD><E596B3>𡢅<EFBFBD>
**成功要素：**
1. ⚠️ **严格的代码规范**：必须使用表名前缀（asl_projects）
**<EFBFBD>𣂼<EFBFBD>閬<EFBFBD><EFBFBD>嚗?*
1. <EFBFBD>𩤃<EFBFBD> **銝交聢<E4BAA4><E881A2>誨<EFBFBD><E8AAA8><EFBFBD><EFBFBD>?*嚗𡁜<E59A97>憿颱蝙<E9A2B1>刻”<E588BB>滚<EFBFBD>蝻<EFBFBD>嚗Òsl_projects嚗?
2. <20>𩤃<EFBFBD> **撱嗅<E692B1>雿<EFBFBD><E99BBF><EFBFBD>曉<EFBFBD>**嚗𡁏㺭<F0A1818F>桅<EFBFBD>憓鮋鵭<E9AE8B>滚<EFBFBD>憿餃<E686BF>Schema<6D>𠉛氖
3. <20>𩤃<EFBFBD> **<EFBFBD>𦠜𧒄頧祆揢**嚗𡁜<E59A97><F0A1819C>𤏸<EFBFBD><F0A48FB8>亦恣<E4BAA6><E681A3>垢<EFBFBD>滚<EFBFBD>憿餃<E686BF>Monorepo
**触发架构改造的条件：**
- 数据量超过50万行
**閫血<EFBFBD><EFBFBD>嗆<EFBFBD><EFBFBD>寥<EFBFBD>删<EFBFBD><EFBFBD>∩辣嚗?*
- <EFBFBD>唳旿<EFBFBD>讛<EFBFBD>餈?0銝<30><E98A9D>
- 撘<>憪见<E686AA><E8A781>𤏸<EFBFBD><F0A48FB8>亦恣<E4BAA6><E681A3>垢
- 隞<><E99A9E><EFBFBD>滚<EFBFBD>銝仿<E98A9D>
@@ -360,116 +360,116 @@ Day 6（测试验证）：
**<EFBFBD>睲<EFBFBD><EFBFBD>㗇𥋘<EFBFBD>寞<EFBFBD>B嚗<EFBFBD><EFBFBD><EFBFBD>𡁏沲<EFBFBD><EFBFBD>㺿<EFBFBD>𩤃<EFBFBD>**
**理由：**
**<EFBFBD><EFBFBD>眏嚗?*
**1. <20><><EFBFBD>臬<EFBFBD>箇<EFBFBD><E7AE87>拇<EFBFBD>憭芷<E686AD>**
```
<EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>箸𧋦<EFBFBD>𡢅<EFBFBD>6憭拙極雿𣈯<EFBFBD>
6-12个月后利息：22-36天
6-12銝芣<EFBFBD><EFBFBD>𤾸⏚<EFBFBD>荔<EFBFBD>22-36憭?
利率：300-500%
<EFBFBD>拍<EFBFBD>嚗?00-500%
这是任何投资都无法企及的回报率
餈蹱糓隞颱<EFBFBD><EFBFBD>閗<EFBFBD><EFBFBD>賣<EFBFBD>瘜蓥<EFBFBD><EFBFBD>羓<EFBFBD><EFBFBD>墧𥁒<EFBFBD>?
```
**2. 现在是最佳时机**
**2. <EFBFBD>啣銁<EFBFBD>舀<EFBFBD>雿單𧒄<EFBFBD>?*
```
<EFBFBD>唳旿<EFBFBD>𧶏<EFBFBD>撠𧶏<EFBFBD>餈<EFBFBD>宏敹恬<EFBFBD>
隞<EFBFBD><EFBFBD><EFBFBD>𧶏<EFBFBD><EFBFBD><EFBFBD>葉嚗<EFBFBD><EFBFBD><EFBFBD><EFBFBD>捆<EFBFBD>橒<EFBFBD>
璅∪<EFBFBD><EFBFBD>堆<EFBFBD>撠𡢅<EFBFBD>瘚贝<EFBFBD>蝞<EFBFBD><EFBFBD>𤏪<EFBFBD>
团队规模：小（沟通成本低）
<EFBFBD>ａ<EFBFBD>閫<EFBFBD>芋嚗𡁜<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>𡁏<EFBFBD><EFBFBD>砌<EFBFBD>嚗?
6个月后，以上所有条件都会恶化
6銝芣<EFBFBD><EFBFBD>𠬍<EFBFBD>隞乩<EFBFBD><EFBFBD><EFBFBD><EFBFBD>㗇辺隞園<EFBFBD>隡𡁏<EFBFBD><EFBFBD>?
```
**3. 为未来7个模块负责**
**3. 銝箸𧊋<EFBFBD>?銝芣芋<E88AA3>𡑒<EFBFBD>韐?*
```
如果现在不做：
- ASL模块：可能有一定技术债
- DC模块：继承ASL的技术债
- SSA模块：继承DC的技术债
憒<EFBFBD><EFBFBD><EFBFBD>啣銁銝滚<EFBFBD>嚗?
- ASL璅∪<EFBFBD>嚗𡁜虾<EFBFBD>賣<EFBFBD>銝<EFBFBD>摰𡁏<EFBFBD><EFBFBD>臬<EFBFBD>?
- DC璅∪<EFBFBD>嚗𡁶誧<EFBFBD>澤SL<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>?
- SSA璅∪<EFBFBD>嚗𡁶誧<EFBFBD>澳C<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>?
- ...
- 7个模块叠加，技术债巨大
- 7銝芣芋<EFBFBD>堒<EFBFBD><EFBFBD>𩤃<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>箏楊憭?
憒<EFBFBD><EFBFBD><EFBFBD>啣銁<EFBFBD>𡄯<EFBFBD>
- ASL模块：享受清晰架构
- DC模块：享受清晰架构
- ASL璅∪<EFBFBD>嚗帋澈<EFBFBD>埈<EFBFBD><EFBFBD>唳沲<EFBFBD>?
- DC璅∪<EFBFBD>嚗帋澈<EFBFBD>埈<EFBFBD><EFBFBD>唳沲<EFBFBD>?
- ...
- 7銝芣芋<E88AA3>烾<EFBFBD><E783BE>㛖<EFBFBD>
```
**4. <20>踵<EFBFBD>vs<76>剜<EFBFBD>**
```
短期思维：
- 快1周上线ASL
- 但未来付出1个月代价
<EFBFBD>剜<EFBFBD><EFBFBD>萘輕嚗?
- 敹?<3F>其<EFBFBD>蝥澤SL
- 雿<EFBFBD>𧊋<EFBFBD>乩<EFBFBD><EFBFBD>?銝芣<E98A9D>隞<EFBFBD>遠
长期思维：
- 投入1周改造
<EFBFBD>踵<EFBFBD><EFBFBD>萘輕嚗?
- <EFBFBD>訫<EFBFBD>1<EFBFBD>冽㺿<EFBFBD>?
- <20>芣䔉7銝芣芋<E88AA3>烾<EFBFBD><E783BE>㛖<EFBFBD>
- <20>踵<EFBFBD><E8B8B5>嗥<EFBFBD>撌典之
```
---
## 📋 实施清单（方案B）
## <EFBFBD><EFBFBD> 摰墧鴌皜<E9B48C><E79A9C>嚗<EFBFBD>䲮獢㇂嚗?
### 憒<><E68692><EFBFBD>典<EFBFBD>摰𡁻<E691B0>蝥單䲮獢㇂
**我会帮您：**
**<EFBFBD>睲<EFBFBD>撣格<EFBFBD>嚗?*
**Schema<6D>𠉛氖嚗㇄ay 1-3嚗㚁<E59A97>**
1. ✅ 设计完整的Schema结构
2. ✅ 编写Prisma Schema修改方案
3. ✅ 编写数据迁移脚本
4. ✅ 提供详细的实施步骤
5. ✅ 全程指导和答疑
1. <EFBFBD>?霈曇恣摰峕㟲<E5B395><E39FB2>chema蝏𤘪<EFBFBD>
2. <EFBFBD>?蝻硋<E89DBB>Prisma Schema靽格㺿<EFBFBD>寞<EFBFBD>
3. <EFBFBD>?蝻硋<E89DBB><E7A18B>唳旿餈<E697BF>宏<EFBFBD>𡁏𧋦
4. <EFBFBD>?<3F>𣂷<EFBFBD>霂衣<E99C82><E8A1A3><EFBFBD><EFBFBD><EFBFBD>賣郊撉?
5. <EFBFBD>?<3F>函<EFBFBD><E587BD><EFBFBD>紡<EFBFBD>𣬚<EFBFBD><F0A3AC9A>?
**Monorepo頧祆揢嚗㇄ay 4-6嚗㚁<E59A97>**
1. ✅ 设计Monorepo目录结构
2. ✅ 编写pnpm-workspace.yaml配置
3. ✅ 提供重构步骤清单
4. ✅ 帮助提取共享代码
5. ✅ 全程指导和答疑
1. <EFBFBD>?霈曇恣Monorepo<EFBFBD>桀<EFBFBD>蝏𤘪<EFBFBD>
2. <EFBFBD>?蝻硋<E89DBB>pnpm-workspace.yaml<EFBFBD>滨蔭
3. <EFBFBD>?<3F>𣂷<EFBFBD><F0A382B7>齿<EFBFBD>甇仿炊皜<E7828A><E79A9C>
4. <EFBFBD>?撣桀𨭌<E6A180>𣂼<EFBFBD><F0A382BC>曹澈隞<E6BE88><E99A9E>
5. <EFBFBD>?<3F>函<EFBFBD><E587BD><EFBFBD>紡<EFBFBD>𣬚<EFBFBD><F0A3AC9A>?
**ASL璅∪<E79285>撘<EFBFBD><E69298>𡢅<EFBFBD>Week 2+嚗㚁<E59A97>**
1. ✅ 数据库设计
2. ✅ API设计
3. ✅ 前后端实现指导
1. <EFBFBD>?<3F>唳旿摨栞挽霈?
2. <EFBFBD>?API霈曇恣
3. <EFBFBD>?<3F>滚<EFBFBD>蝡臬<E89DA1><E887AC>唳<EFBFBD>撖?
---
## <20>㴓 <20>喟<EFBFBD><E5969F>拚猐
### 如何选择？
### 憒<EFBFBD><EFBFBD><EFBFBD>㗇𥋘嚗?
**选择方案B，如果您：**
- ✅ 重视长期架构健康
- ✅ 愿意投入1周做改造
- ✅ 相信投入产出比（300-500%）
- ✅ 未来有多个模块要开发
- ✅ 未来有模块独立部署需求
**<EFBFBD>㗇𥋘<EFBFBD>寞<EFBFBD>B嚗<EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD>嚗?*
- <EFBFBD>?<3F>滩<EFBFBD><E6BBA9>踵<EFBFBD><E8B8B5>嗆<EFBFBD><E59786>亙熒
- <EFBFBD>?<3F>踵<EFBFBD><E8B8B5>訫<EFBFBD>1<EFBFBD>典<EFBFBD><E585B8>寥<EFBFBD>?
- <EFBFBD>?<3F>訾縑<E8A8BE>訫<EFBFBD>鈭批枂瘥䈑<E798A5>300-500%嚗?
- <EFBFBD>?<3F>芣䔉<E88AA3>匧<EFBFBD>銝芣芋<E88AA3>𡑒<EFBFBD>撘<EFBFBD><E69298>?
- <EFBFBD>?<3F>芣䔉<E88AA3>㗇芋<E39787>㛖𡠺蝡钅<E89DA1>蝵脤<E89DB5>瘙?
**选择方案C，如果您：**
- ⚠️ 愿意做Monorepo（必需）
**<EFBFBD>㗇𥋘<EFBFBD>寞<EFBFBD>C嚗<EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD>嚗?*
- <EFBFBD>𩤃<EFBFBD> <20>踵<EFBFBD><E8B8B5>鐝onorepo嚗<6F><E59A97><EFBFBD><EFBFBD>嚗?
- <20>𩤃<EFBFBD> 雿<><E99BBF><EFBFBD>𥕦偷敹怎<E695B9><E6808E>蚊SL餈𥕦<E9A488>
- ⚠️ 接受未来Schema隔离成本会增加
- <EFBFBD>𩤃<EFBFBD> <20>亙<EFBFBD><E4BA99>芣䔉Schema<6D>𠉛氖<F0A0899B>鞉𧋦隡𡁜<E99AA1><F0A1819C>?
**选择方案A，如果您：**
- ⚠️ 时间极其紧迫（如：有硬性deadline）
- ⚠️ ASL必须在2周内上线
- ⚠️ 接受未来1个月的改造成本
- ⚠️ 愿意承担技术债
**<EFBFBD>㗇𥋘<EFBFBD>寞<EFBFBD>A嚗<EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD>嚗?*
- <EFBFBD>𩤃<EFBFBD> <20>園𡢿<E59C92><F0A1A2BF><EFBFBD>蝝扯翰嚗<E7BFB0><E59A97>嚗𡁏<E59A97>蝖祆<E89D96>吳eadline嚗?
- <EFBFBD>𩤃<EFBFBD> ASL敹<EFBFBD>◆<EFBFBD>?<3F>典<EFBFBD>銝羓瑪
- <EFBFBD>𩤃<EFBFBD> <20>亙<EFBFBD><E4BA99>芣䔉1銝芣<E98A9D><E88AA3><EFBFBD>㺿<EFBFBD>䭾<EFBFBD><E4ADBE>?
- <EFBFBD>𩤃<EFBFBD> <20>踵<EFBFBD><E8B8B5>踵<EFBFBD><E8B8B5><EFBFBD><EFBFBD>臬<EFBFBD>?
---
## <20><> <20>訫<EFBFBD>鈭批枂瘥娍<E798A5>餌<EFBFBD>
| 方案 | 立即投入 | 未来成本 | ASL上线时间 | 长期收益 | 推荐度 |
| <EFBFBD>寞<EFBFBD> | 蝡见朖<E8A781>訫<EFBFBD> | <20>芣䔉<E88AA3>鞉𧋦 | ASL銝羓瑪<E7BE93>園𡢿 | <20>踵<EFBFBD><E8B8B5>嗥<EFBFBD> | <20>刻<EFBFBD>摨?|
|------|---------|---------|------------|---------|-------|
| **方案A** | 0 | 22-36天 | 2周 | ⭐⭐ | ⭐⭐⭐ |
| **方案B** | 6天 | 0 | 3周 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **方案C** | 2-3天 | 15-25天 | 2.5周 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **<EFBFBD>寞<EFBFBD>A** | 0 | 22-36憭?| 2<EFBFBD>?| 潃鐥<E6BD83> | 潃鐥<E6BD83>潃?|
| **<EFBFBD>寞<EFBFBD>B** | 6憭?| 0 | 3<EFBFBD>?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?|
| **<EFBFBD>寞<EFBFBD>C** | 2-3憭?| 15-25憭?| 2.5<EFBFBD>?| 潃鐥<E6BD83>潃鐥<E6BD83> | 潃鐥<E6BD83>潃鐥<E6BD83> |
---
@@ -480,7 +480,7 @@ Day 6（测试验证）：
**<EFBFBD>𤾸予撘<EFBFBD>憪页<EFBFBD>**
```bash
# Day 1嚗锭chema<6D>𠉛氖霈曇恣
我会帮您：
<EFBFBD>睲<EFBFBD>撣格<EFBFBD>嚗?
1. 霈曇恣摰峕㟲<E5B395><E39FB2>chema蝏𤘪<E89D8F>
2. 靽格㺿Prisma Schema
3. 蝻硋<E89DBB>餈<EFBFBD>宏<EFBFBD>𡁏𧋦
@@ -499,7 +499,7 @@ Day 6（测试验证）：
**<EFBFBD>𤾸予撘<EFBFBD>憪页<EFBFBD>**
```bash
# Day 1嚗鐝onorepo頧祆揢
我会帮您：
<EFBFBD>睲<EFBFBD>撣格<EFBFBD>嚗?
1. 霈曇恣Monorepo<70>桀<EFBFBD>蝏𤘪<E89D8F>
2. 蝻硋<E89DBB><E7A18B>滨蔭<E6BBA8><E894AD>辣
3. <20>𣂷<EFBFBD><F0A382B7>齿<EFBFBD>甇仿炊
@@ -517,16 +517,16 @@ Day 6（测试验证）：
**<EFBFBD>𤾸予撘<EFBFBD>憪页<EFBFBD>**
```bash
# Day 1：ASL模块数据库设计
我会帮您：
1. 设计asl_schema表结构
# Day 1嚗鋫SL璅∪<EFBFBD><EFBFBD>唳旿摨栞挽霈?
<EFBFBD>睲<EFBFBD>撣格<EFBFBD>嚗?
1. 霈曇恣asl_schema銵函<EFBFBD><EFBFBD>?
2. 蝻硋<E89DBB>Prisma Schema
3. API霈曇恣
4. <20>滨垢蝏<E59EA2>辣霈曇恣
<EFBFBD>券<EFBFBD>閬<EFBFBD><EFBFBD>
1. 摰⊿<E691B0>霈曇恣<E69B87>寞<EFBFBD>
2. 确认后开始实施
2. 蝖株恕<EFBFBD>𤾸<EFBFBD>憪见<EFBFBD><EFBFBD>?
```
---
@@ -535,77 +535,77 @@ Day 6（测试验证）：
### 憒<><E68692><EFBFBD>芾<EFBFBD>霈唬<E99C88>銝<EFBFBD>隞嗡<E99A9E>
**记住这个：**
**霈唬<EFBFBD>餈嗘葵嚗?*
```
现在投入1周（Schema隔离 + Monorepo）
节省未来1个月（22-36天）
<EFBFBD>啣銁<EFBFBD>訫<EFBFBD>1<EFBFBD>剁<EFBFBD>Schema<EFBFBD>𠉛氖 + Monorepo嚗?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>芣䔉1銝芣<EFBFBD>嚗?2-36憭抬<EFBFBD>
餈蹱糓300-500%<25><><EFBFBD>韏<EFBFBD><E99F8F><EFBFBD>亦<EFBFBD>
而且：
<EFBFBD>䔶<EFBFBD>嚗?
- <20>啣銁<E595A3>舀<EFBFBD><E88880>祆<EFBFBD>雿𡒊<E99BBF><F0A1928A>嗆㦤
- 未来成本会成倍增长
- 这是为7个模块打基础
- <EFBFBD>芣䔉<EFBFBD>鞉𧋦隡𡁏<EFBFBD><EFBFBD>滚<EFBFBD><EFBFBD>?
- 餈蹱糓銝?銝芣芋<E88AA3>埈<EFBFBD><E59F88>箇<EFBFBD>
```
### 憒<><E68692>餈睃銁<E79D83>寡惚
**问自己3个问题：**
**<EFBFBD>株䌊撌?銝芷䔮憸矋<E686B8>**
1. **<EFBFBD>𤑳<EFBFBD><EFBFBD>格<EFBFBD><EFBFBD>臭<EFBFBD>銋<EFBFBD><EFBFBD>**
- 快速上线1个模块？→ 方案A
- 敹恍<EFBFBD>煺<EFBFBD>蝥?銝芣芋<E88AA3>梹<EFBFBD><E6A2B9>?<3F>寞<EFBFBD>A
- <20><>遣<EFBFBD>舀<EFBFBD>蝏剔<E89D8F>鈭批<E988AD>嚗麨<E59A97> <20>寞<EFBFBD>B
2. **<EFBFBD>𤏸<EFBFBD><EFBFBD>亙<EFBFBD>撱嗉<EFBFBD><EFBFBD>梹<EFBFBD>**
- 完全不能接受1周延迟？→ 方案A
- 摰<EFBFBD><EFBFBD>銝滩<EFBFBD><EFBFBD>亙<EFBFBD>1<EFBFBD>典辣餈<EFBFBD><EFBFBD><EFBFBD>?<3F>寞<EFBFBD>A
- <20>臭誑<E887AD>亙<EFBFBD>1<EFBFBD>冽揢1銝芣<E98A9D>嚗麨<E59A97> <20>寞<EFBFBD>B
3. **<EFBFBD>𤑳<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>箄<EFBFBD>敹蛛<EFBFBD>**
- 先上线，后还债？→ 方案A
- 架构优先，稳步推进？→ 方案B
- <EFBFBD><EFBFBD><EFBFBD>蝥選<EFBFBD><EFBFBD>舘<EFBFBD><EFBFBD>綽<EFBFBD><EFBFBD>?<3F>寞<EFBFBD>A
- <EFBFBD>嗆<EFBFBD>隡睃<EFBFBD>嚗𣬚迅甇交綫餈𨥈<EFBFBD><EFBFBD>?<3F>寞<EFBFBD>B
---
## <20><> 隞𦠜𠯫<F0A6A09C>鞉<EFBFBD><E99E89>鮋▽
**<EFBFBD>睲賑隞𠰴予摰峕<EFBFBD>鈭<EFBFBD><EFBFBD>**
- ✅ 8个核心架构文档（6000+行）
- ✅ 完整的技术路线图
- ✅ 清晰的决策建议
- <EFBFBD>?8銝芣瓲敹<E793B2>沲<EFBFBD><E6B2B2><EFBFBD>獢<EFBFBD><E78DA2>6000+銵䕘<EFBFBD>
- <EFBFBD>?摰峕㟲<E5B395><E39FB2><EFBFBD><EFBFBD>航楝蝥踹㦛
- <EFBFBD>?皜<>苊<EFBFBD><E88B8A><EFBFBD>蝑硋遣霈?
**餈嗘<E9A488><E59798>鞉<EFBFBD><E99E89><EFBFBD>遠<EFBFBD>潘<EFBFBD>**
- ✅ 指导未来6-12个月的开发
- ✅ 避免走弯路
- ✅ 支持模块化销售和多种部署
- <EFBFBD>?<3F><>紡<EFBFBD>芣䔉6-12銝芣<E98A9D><E88AA3><EFBFBD><EFBFBD><EFBFBD>?
- <EFBFBD>?<3F>踹<EFBFBD>韏啣摩頝?
- <EFBFBD>?<3F>舀<EFBFBD>璅∪<E79285><E288AA>㚚<EFBFBD><E39A9A>桀<EFBFBD>憭𡁶<E686AD><F0A181B6>函蔡
**您现在拥有的：**
- ✅ 清晰的架构设计
- ✅ 明确的实施路径
- ✅ 具体的成本收益分析
**<EFBFBD>函緵<EFBFBD>冽𥅾<EFBFBD>厩<EFBFBD>嚗?*
- <EFBFBD>?皜<>苊<EFBFBD><E88B8A>沲<EFBFBD><E6B2B2>挽霈?
- <EFBFBD>?<3F>𡒊＆<F0A1928A><EFBC86><EFBFBD><EFBFBD>質楝敺?
- <EFBFBD>?<3F>瑚<EFBFBD><E7919A><EFBFBD><EFBFBD><EFBFBD>祆𤣰<E7A586>𠰴<EFBFBD><F0A0B0B4>?
---
## <20><> <20>𤑳<EFBFBD><F0A491B3>輯笑
**无论您选择哪个方案，我都会全程协助！**
**<EFBFBD>㰘捏<EFBFBD>券<EFBFBD>㗇𥋘<EFBFBD>芯葵<EFBFBD>寞<EFBFBD>嚗峕<EFBFBD><EFBFBD>賭<EFBFBD><EFBFBD>函<EFBFBD><EFBFBD>誩𨭌嚗?*
**方案B：**
- ✅ Day 1-3：Schema隔离全程指导
- ✅ Day 4-6：Monorepo转换全程指导
- ✅ Week 2+：ASL模块开发全程协助
**<EFBFBD>寞<EFBFBD>B嚗?*
- <EFBFBD>?Day 1-3嚗锭chema<EFBFBD>𠉛氖<EFBFBD>函<EFBFBD><EFBFBD><EFBFBD>紡
- <EFBFBD>?Day 4-6嚗鐝onorepo頧祆揢<EFBFBD>函<EFBFBD><EFBFBD><EFBFBD>紡
- <EFBFBD>?Week 2+嚗鋫SL璅∪<EFBFBD>撘<EFBFBD><EFBFBD>穃<EFBFBD>蝔见<EFBFBD><EFBFBD>?
**方案C：**
- ✅ Day 1-3：Monorepo转换全程指导
- ✅ Day 4+：ASL模块开发全程协助
**<EFBFBD>寞<EFBFBD>C嚗?*
- <EFBFBD>?Day 1-3嚗鐝onorepo頧祆揢<EFBFBD>函<EFBFBD><EFBFBD><EFBFBD>紡
- <EFBFBD>?Day 4+嚗鋫SL璅∪<EFBFBD>撘<EFBFBD><EFBFBD>穃<EFBFBD>蝔见<EFBFBD><EFBFBD>?
**方案A：**
- ✅ 立即开始ASL模块开发全程协助
- ⚠️ 提醒技术债风险
- ⚠️ 在关键时机提醒架构改造
**<EFBFBD>寞<EFBFBD>A嚗?*
- <EFBFBD>?蝡见朖撘<E69C96>憪𧘹SL璅∪<E79285>撘<EFBFBD><E69298>穃<EFBFBD>蝔见<E89D94><E8A781>?
- <EFBFBD>𩤃<EFBFBD> <20>鞾<EFBFBD><E99EBE><EFBFBD><EFBFBD>臬<EFBFBD>粹<EFBFBD><E7B2B9>?
- <EFBFBD>𩤃<EFBFBD> <20>典<EFBFBD><E585B8>格𧒄<E6A0BC>箸<EFBFBD><E7AEB8>埝沲<E59F9D><E6B2B2>㺿<EFBFBD>?
---
**您的决定？** 😊
**<EFBFBD>函<EFBFBD><EFBFBD>喳<EFBFBD>嚗?* <20><>
霂瑕<EFBFBD>霂㗇<EFBFBD><EFBFBD>函<EFBFBD><EFBFBD>㗇𥋘嚗峕<EFBFBD>隞祉<EFBFBD><EFBFBD>喳<EFBFBD>憪贝<EFBFBD><EFBFBD>剁<EFBFBD>

239
docs/00-系统总体设计/README.md
View File

@@ -1,78 +1,61 @@
# 绯荤粺鎬讳綋璁捐<E79281>
> **目录说明：** 本目录包含壹证循AI科研平台的系统总体设计文档
> **文档层级：** 总体层面（Platform Level）
> **鐩<EFBFBD>綍璇存槑锛?* 鏈<>洰褰曞寘鍚<E5AF98>９璇佸惊AI绉戠爺骞冲彴鐨勭郴缁熸€讳綋璁捐<E79281>鏂囨。
> **鏂囨。灞傜骇锛?* 鎬讳綋灞傞潰锛圥latform Level锛?
> **鐩<>爣璇昏€咃細** 鎶€鏈<E282AC>灦鏋勫笀銆佷骇鍝佺粡鐞嗐€侀」鐩<E3808D>礋璐ｄ汉
---
## 馃摎 鏂囨。瀵艰埅
### 📌 快速导航
**🎉 重要：** [2025-11-06 架构设计完成报告](./%5B重要%5D%202025-11-06%20架构设计完成报告.md) - 今日重大里程碑！
### 馃搶 蹇<>€熷<E282AC>鑸?
**馃帀 閲嶈<E996B2>锛?* [2025-11-06 鏋舵瀯璁捐<E79281>瀹屾垚鎶ュ憡](./%5B閲嶈<E996B2>%5D%202025-11-06%20鏋舵瀯璁捐<E79281>瀹屾垚鎶ュ憡.md) - 浠婃棩閲嶅ぇ閲岀▼纰戯紒
**馃憠 绗<>竴娆￠槄璇伙細** [00-闃呰<E99783>鎸囧崡](./00-闃呰<E99783>鎸囧崡.md) - 濡備綍闃呰<E99783>杩欎簺鏂囨。
**👉 需要决策：** [99-下一步行动决策建议](./99-下一步行动决策建议.md) - 3个方案对比
**馃憠 闇€瑕佸喅绛栵細** [99-涓嬩竴姝ヨ<EFBFBD>鍔ㄥ喅绛栧缓璁甝(./99-涓嬩竴姝ヨ<E5A79D>鍔ㄥ喅绛栧缓璁?md) - 3涓<EFBFBD>柟妗堝<EFBFBD>姣?
---
### 鏍稿績鏂囨。
| 文档 | 说明 | 状态 | 优先级 |
| 鏂囨。 | 璇存槑 | 鐘舵€?| 浼樺厛绾?|
|------|------|------|-------|
| **[00-阅读指南](./00-阅读指南.md)** | **如何阅读这些文档？** | ✅ 完成 | ⭐⭐⭐ **首次必读** |
| [00-今日架构设计总结](./00-今日架构设计总结.md) | 2025-11-06工作总结 | ✅ 完成 | ⭐⭐ 推荐阅读 |
| **[99-下一步行动决策建议](./99-下一步行动决策建议.md)** | **3个方案对比+决策建议** | ✅ 完成 | ⭐⭐⭐ **决策必读** |
| [00-核心问题解答](./00-核心问题解答.md) | 回答关键架构问题 | ✅ 完成 | P0 |
| [01-系统架构分层设计](./01-系统架构分层设计.md) | 三层架构设计（平台、能力、业务） | ✅ 完成 | P0 |
| [02-文档体系重构方案](./02-文档体系重构方案.md) | 文档结构重组方案v2.0 | ✅ 完成 | P0 |
| [03-数据库架构说明](./03-数据库架构说明.md) | PostgreSQL Docker部署说明 | ✅ 完成 | P0 |
| [04-运营管理端架构设计](./04-运营管理端架构设计.md) | 15个功能模块设计 | ✅ 完成 | P0 |
| [05-Schema隔离方案与成本分析](./05-Schema隔离方案与成本分析.md) | 逻辑隔离vs物理隔离 | ✅ 完成 | P0 |
| [06-模块独立部署与单机版方案](./06-模块独立部署与单机版方案.md) | 完整打包+Electron方案 | ✅ 完成 | P0 |
| [07-Monorepo架构评估](./07-Monorepo架构评估.md) | 当前阶段是否需要Monorepo | ✅ 完成 | P0 |
| [08-架构设计全景图](./08-架构设计全景图.md) | 一图看懂整个系统架构 | ✅ 完成 | ⭐ 推荐阅读 |
| 09-总体需求文档(PRD).md | 产品总体需求 | ⏳ 待迁移 | P1 |
| 10-技术架构白皮书.md | 技术架构总览 | ⏳ 待迁移 | P1 |
| 11-商业模式设计.md | 商业模式与定价 | ⏳ 待创建 | P2 |
| 12-版本规划.md | 版本演进路线图 | ⏳ 待创建 | P2 |
| **[00-闃呰<E99783>鎸囧崡](./00-闃呰<EFBFBD>鎸囧崡.md)** | **濡備綍闃呰<EFBFBD>杩欎簺鏂囨。锛?* | 鉁?瀹屾垚 | 猸愨瓙猸?**棣栨<E6A3A3>蹇呰<E8B987>** |
| [00-浠婃棩鏋舵瀯璁捐<EFBFBD>鎬荤粨](./00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨.md) | 2025-11-06宸ヤ綔鎬荤粨 | 鉁?瀹屾垚 | 猸愨瓙 鎺ㄨ崘闃呰<E99783> |
| **[99-涓嬩竴姝ヨ<EFBFBD>鍔ㄥ喅绛栧缓璁甝(./99-涓嬩竴姝ヨ<E5A79D>鍔ㄥ喅绛栧缓璁?md)** | **3涓<EFBFBD>柟妗堝<EFBFBD>姣?鍐崇瓥寤鸿<E5AFA4>** | 鉁?瀹屾垚 | 猸愨瓙猸?**鍐崇瓥蹇呰<E8B987>** |
| [00-鏍稿績闂<EFBFBD><EFBFBD>瑙ｇ瓟](./00-鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟.md) | 鍥炵瓟鍏抽敭鏋舵瀯闂<E780AF><E99782> | 鉁?瀹屾垚 | P0 |
| [01-绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>](./01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md) | 涓夊眰鏋舵瀯璁捐<E79281>锛堝钩鍙般€佽兘鍔涖€佷笟鍔★級 | 鉁?瀹屾垚 | P0 |
| [02-鏂囨。浣撶郴閲嶆瀯鏂规<EFBFBD>](./02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>.md) | 鏂囨。缁撴瀯閲嶇粍鏂规<E98F82>v2.0 | 鉁?瀹屾垚 | P0 |
| [03-鏁版嵁搴撴灦鏋勮<EFBFBD>鏄嶿(./03-鏁版嵁搴撴灦鏋勮<E98F8B>鏄?md) | PostgreSQL Docker閮ㄧ讲璇存槑 | 鉁?瀹屾垚 | P0 |
| [04-杩愯惀绠＄悊绔<EFBFBD>灦鏋勮<EFBFBD>璁<EFBFBD>(./04-杩愯惀绠＄悊绔<E6828A>灦鏋勮<E98F8B>璁?md) | 15涓<EFBFBD>姛鑳芥ā鍧楄<EFBFBD>璁?| 鉁?瀹屾垚 | P0 |
| [05-Schema闅旂<EFBFBD>鏂规<EFBFBD>涓庢垚鏈<EFBFBD>垎鏋怾(./05-Schema闅旂<E99785>鏂规<E98F82>涓庢垚鏈<E59E9A>垎鏋?md) | 閫昏緫闅旂<EFBFBD>vs鐗╃悊闅旂<EFBFBD> | 鉁?瀹屾垚 | P0 |
| [06-妯″潡鐙<EFBFBD>珛閮ㄧ讲涓庡崟鏈虹増鏂规<EFBFBD>](./06-妯″潡鐙<E6BDA1>珛閮ㄧ讲涓庡崟鏈虹増鏂规<E98F82>.md) | 瀹屾暣鎵撳寘+Electron鏂规<EFBFBD> | 鉁?瀹屾垚 | P0 |
| [07-Monorepo鏋舵瀯璇勪及](./07-Monorepo鏋舵瀯璇勪及.md) | 褰撳墠闃舵<EFBFBD>鏄<EFBFBD>惁闇€瑕丮onorepo | 鉁?瀹屾垚 | P0 |
| [08-鏋舵瀯璁捐<EFBFBD>鍏ㄦ櫙鍥綸(./08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md) | 涓€鍥剧湅鎳傛暣涓<EFBFBD>郴缁熸灦鏋?| 鉁?瀹屾垚 | 猸?鎺ㄨ崘闃呰<E99783> |
| 09-鎬讳綋闇€姹傛枃妗?PRD).md | 浜у搧鎬讳綋闇€姹?| 鈴?寰呰縼绉?| P1 |
| 10-鎶€鏈<EFBFBD>灦鏋勭櫧鐨<EFBFBD>功.md | 鎶€鏈<E282AC>灦鏋勬€昏<E282AC> | 鈴?寰呰縼绉?| P1 |
| 11-鍟嗕笟妯″紡璁捐<EFBFBD>.md | 鍟嗕笟妯″紡涓庡畾浠?| 鈴?寰呭垱寤?| P2 |
| 12-鐗堟湰瑙勫垝.md | 鐗堟湰婕旇繘璺<E7B998>嚎鍥?| 鈴?寰呭垱寤?| P2 |
---
## 馃幆 鏍稿績鍐呭<E98D90>姒傝<E5A792>
### 📌 快速开始
**如果您是第一次阅读，强烈推荐：**
1. ⭐ [今日架构设计总结](./00-今日架构设计总结.md) - 快速了解今天的成果
2. ⭐ [架构设计全景图](./08-架构设计全景图.md) - 一图看懂整个系统
### 馃搶 蹇<>€熷紑濮?
**濡傛灉鎮ㄦ槸绗<E6A7B8>竴娆￠槄璇伙紝寮虹儓鎺ㄨ崘锛?*
1. 猸?[浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨](./00-浠婃棩鏋舵瀯璁捐<E79281>鎬荤粨.md) - 蹇<>€熶簡瑙ｄ粖澶╃殑鎴愭灉
2. 猸?[鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥綸(./08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md) - 涓€鍥剧湅鎳傛暣涓<EFBFBD>郴缁?
---
### 1. 绯荤粺鏋舵瀯鍒嗗眰
**涓夊眰鏋舵瀯 + 8涓<38>笟鍔℃ā鍧楋細**
```
┌──────────────────────────────────────────────────┐
│ 业务模块层（8个模块） │
│ AIA | ASL | PKB | DC | SSA | ST | RVW | ADMIN │
└──────────────────────────────────────────────────┘
↓ 依赖
┌──────────────────────────────────────────────────┐
│ 通用能力层（5个能力） │
│ LLM网关(71%) | 文档处理(86%) | RAG(43%) │
│ ETL(29%) | 医学NLP(14%) │
└──────────────────────────────────────────────────┘
↓ 依赖
┌──────────────────────────────────────────────────┐
│ 平台基础层 │
│ 用户权限 | 存储 | 通知 | 监控 | 配置 │
└──────────────────────────────────────────────────┘
```
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? 涓氬姟妯″潡灞傦紙8涓<38>ā鍧楋級 鈹?鈹? AIA | ASL | PKB | DC | SSA | ST | RVW | ADMIN 鈹?鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹? 鈫?渚濊禆
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? 閫氱敤鑳藉姏灞傦紙5涓<35>兘鍔涳級 鈹?鈹? LLM缃戝叧(71%) | 鏂囨。澶勭悊(86%) | RAG(43%) 鈹?鈹? ETL(29%) | 鍖诲<E98D96>NLP(14%) 鈹?鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹? 鈫?渚濊禆
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? 骞冲彴鍩虹<E98DA9>灞? 鈹?鈹? 鐢ㄦ埛鏉冮檺 | 瀛樺偍 | 閫氱煡 | 鐩戞帶 | 閰嶇疆 鈹?鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?```
**详见：** [01-系统架构分层设计.md](./01-系统架构分层设计.md)
**璇﹁<EFBFBD>锛?* [01-绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>.md](./01-绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>.md)
---
@@ -82,97 +65,74 @@
```
docs/
鈹溾攢鈹€ 00-绯荤粺鎬讳綋璁捐<E79281>/ # 鎬讳綋灞傞潰
├── 01-平台基础层/ # 平台层（UAM、存储、通知等）
├── 02-通用能力层/ # 通用能力（LLM网关、文档处理等）
├── 03-业务模块/ # 7个独立业务模块
│ ├── AIA-AI智能问答/
│ ├── ASL-AI智能文献/
│ ├── PKB-个人知识库/
│ ├── DC-数据清洗整理/
│ ├── SSA-智能统计分析/
│ ├── ST-统计分析工具/
│ └── RVW-稿件审查系统/
├── 04-开发规范/
鈹溾攢鈹€ 01-骞冲彴鍩虹<E98DA9>灞? # 骞冲彴灞傦紙UAM銆佸瓨鍌ㄣ€侀€氱煡绛夛級
鈹溾攢鈹€ 02-閫氱敤鑳藉姏灞? # 閫氱敤鑳藉姏锛圠LM缃戝叧銆佹枃妗ｅ<E5A697>鐞嗙瓑锛? 鈹溾攢鈹€ 03-涓氬姟妯″潡/ # 7涓<37>嫭绔嬩笟鍔℃ā鍧? 鈹? 鈹溾攢鈹€ AIA-AI鏅鸿兘闂<E58598>瓟/
鈹? 鈹溾攢鈹€ ASL-AI鏅鸿兘鏂囩尞/
鈹? 鈹溾攢鈹€ PKB-涓<>汉鐭ヨ瘑搴?
鈹? 鈹溾攢鈹€ DC-鏁版嵁娓呮礂鏁寸悊/
鈹? 鈹溾攢鈹€ SSA-鏅鸿兘缁熻<E7BC81>鍒嗘瀽/
鈹? 鈹溾攢鈹€ ST-缁熻<E7BC81>鍒嗘瀽宸ュ叿/
鈹? 鈹斺攢鈹€ RVW-绋夸欢瀹℃煡绯荤粺/
鈹溾攢鈹€ 04-寮€鍙戣<E98D99>鑼?
鈹溾攢鈹€ 05-閮ㄧ讲鏂囨。/
鈹溾攢鈹€ 06-娴嬭瘯鏂囨。/
鈹溾攢鈹€ 07-杩愮淮鏂囨。/
鈹斺攢鈹€ 08-椤圭洰绠＄悊/
```
**详见：** [02-文档体系重构方案.md](./02-文档体系重构方案.md)
**璇﹁<EFBFBD>锛?* [02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>.md](./02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>.md)
---
### 3. 鏍稿績鍐崇瓥
#### 部署模式（4种）
- ✅ 云端SaaS版（P0，当前）
- ✅ 独立产品包（P1，阶段二）- 支持模块化销售
- ✅ Electron单机版（P2，阶段二）- 代码复用85%+
- ✅ 私有化部署（P1，阶段二）
- ❌ ~~混合部署~~（不考虑）
#### 閮ㄧ讲妯″紡锛?绉嶏級
- 鉁?浜戠<E6B59C>SaaS鐗堬紙P0锛屽綋鍓嶏級
- 鉁?鐙<>珛浜у搧鍖咃紙P1锛岄樁娈典簩锛? 鏀<>寔妯″潡鍖栭攢鍞?- 鉁?Electron鍗曟満鐗堬紙P2锛岄樁娈典簩锛? 浠ｇ爜澶嶇敤85%+
- 鉁?绉佹湁鍖栭儴缃诧紙P1锛岄樁娈典簩锛?- 鉂?~~娣峰悎閮ㄧ讲~~锛堜笉鑰冭檻锛?
#### 妯″潡鍒掑垎锛?涓<>笟鍔℃ā鍧楋級
1. **AIA** - AI鏅鸿兘闂<E58598>瓟 鉁?宸插畬鎴?2. **ASL** - AI鏅鸿兘鏂囩尞 鈴?涓嬩竴姝ラ噸鐐?3. **PKB** - 涓<>汉鐭ヨ瘑搴?鉁?宸插畬鎴?4. **DC** - 鏁版嵁娓呮礂鏁寸悊 鈴?瑙勫垝涓?5. **SSA** - 鏅鸿兘缁熻<E7BC81>鍒嗘瀽 鈴?瑙勫垝涓?6. **ST** - 缁熻<E7BC81>鍒嗘瀽宸ュ叿 鈴?瑙勫垝涓?7. **RVW** - 绋夸欢瀹℃煡绯荤粺 鈿?鐙<>珛绯荤粺
8. **ADMIN** - 杩愯惀绠＄悊绔?猸?v2.0鏂板<EFBFBD>
#### 模块划分（8个业务模块）
1. **AIA** - AI智能问答 ✅ 已完成
2. **ASL** - AI智能文献 ⏳ 下一步重点
3. **PKB** - 个人知识库 ✅ 已完成
4. **DC** - 数据清洗整理 ⏳ 规划中
5. **SSA** - 智能统计分析 ⏳ 规划中
6. **ST** - 统计分析工具 ⏳ 规划中
7. **RVW** - 稿件审查系统 ⚡ 独立系统
8. **ADMIN** - 运营管理端 ⭐ v2.0新增
#### 鏍稿績鑳藉姏锛?涓<>€氱敤鑳藉姏锛?1. **LLM缃戝叧** 猸?鏈€楂樹紭鍏堢骇锛?涓<>ā鍧椾緷璧栵紙71%澶嶇敤鐜囷級
2. **鏂囨。澶勭悊寮曟搸** 鉁?宸插疄鐜帮紝6涓<36>ā鍧椾緷璧栵紙86%澶嶇敤鐜囷級
3. **RAG寮曟搸** 鉁?宸插疄鐜帮紝3涓<33>ā鍧椾緷璧栵紙43%澶嶇敤鐜囷級
4. **ETL寮曟搸** 鈴?寰呭疄鐜帮紝2涓<32>ā鍧椾緷璧栵紙29%澶嶇敤鐜囷級
5. **鍖诲<EFBFBD>NLP** 鈴?寰呭疄鐜帮紝1涓<31>ā鍧椾緷璧栵紙14%澶嶇敤鐜囷級
#### 核心能力（5个通用能力）
1. **LLM网关** ⭐ 最高优先级，5个模块依赖（71%复用率）
2. **文档处理引擎** ✅ 已实现，6个模块依赖（86%复用率）
3. **RAG引擎** ✅ 已实现，3个模块依赖（43%复用率）
4. **ETL引擎** ⏳ 待实现，2个模块依赖（29%复用率）
5. **医学NLP** ⏳ 待实现，1个模块依赖（14%复用率）
#### 技术改造决策
1. **Schema隔离** - 建议：现在做（1周）vs 未来做（3-5周）⭐⭐⭐⭐⭐
2. **Monorepo转换** - 建议：现在做（2-3天）vs 未来做（7-11天）⭐⭐⭐⭐⭐
**详见：** [00-核心问题解答.md](./00-核心问题解答.md)
#### 鎶€鏈<EFBFBD>敼閫犲喅绛?1. **Schema闅旂<E99785>** - 寤鸿<E5AFA4>锛氱幇鍦ㄥ仛锛?鍛<>級vs 鏈<>潵鍋氾紙3-5鍛<35>級猸愨瓙猸愨瓙猸?2. **Monorepo杞<6F>崲** - 寤鸿<E5AFA4>锛氱幇鍦ㄥ仛锛?-3澶╋級vs 鏈<>潵鍋氾紙7-11澶╋級猸愨瓙猸愨瓙猸?
**璇﹁<E79287>锛?* [00-鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟.md](./00-鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟.md)
---
## 馃殌 鏋舵瀯婕旇繘璺<E7B998>緞
### 阶段一：模块化单体（当前 - 6个月）
### 闃舵<EFBFBD>涓€锛氭ā鍧楀寲鍗曚綋锛堝綋鍓?- 6涓<36>湀锛?
**鐩<>爣锛?* 浜戠<E6B59C>SaaS鐗圡VP
**目标：** 云端SaaS版MVP
**关键纪律：**
- ✅ 严格按模块划分代码
- ✅ 数据表使用模块前缀（逻辑隔离）
- ✅ 模块间不直接import
**鍏抽敭绾<EFBFBD>緥锛?*
- 鉁?涓ユ牸鎸夋ā鍧楀垝鍒嗕唬鐮?- 鉁?鏁版嵁琛ㄤ娇鐢ㄦā鍧楀墠缂€锛堥€昏緫闅旂<E99785>锛?- 鉁?妯″潡闂翠笉鐩存帴import
**浼樺厛寮€鍙戯細**
- ASL（AI智能文献）
- DC（数据清洗）
- ASL锛圓I鏅鸿兘鏂囩尞锛?- DC锛堟暟鎹<E69A9F>竻娲楋級
- LLM缃戝叧
- Schema闅旂<E99785>
---
### 阶段二：首次拆分（6-18个月）
**触发条件：**
### 闃舵<EFBFBD>浜岋細棣栨<EFBFBD>鎷嗗垎锛?-18涓<38>湀锛?
**瑙﹀彂鏉′欢锛?*
- 鏈夊<E98F88>鎴疯<E98EB4>姹傜<E5A7B9>鏈夊寲閮ㄧ讲
- 鏈夊<E98F88>鎴疯<E98EB4>姹傚崟鏈虹増
- 需要独立销售某个模块
**架构调整：**
- 闇€瑕佺嫭绔嬮攢鍞<EFBFBD>煇涓<EFBFBD>ā鍧?
**鏋舵瀯璋冩暣锛?*
- 寮曞叆API缃戝叧
- 寮曞叆K8s锛堝彲閫夛級
- 拆分RVW（审稿系统）为独立服务
- 鎷嗗垎RVW锛堝<EFBFBD>绋跨郴缁燂級涓虹嫭绔嬫湇鍔?
---
### 阶段三：全面微服务（18个月+）
**目标：** 所有模块独立部署，支持灵活组合
### 闃舵<EFBFBD>涓夛細鍏ㄩ潰寰<EFBFBD>湇鍔★紙18涓<EFBFBD>湀+锛?
**鐩<>爣锛?* 鎵€鏈夋ā鍧楃嫭绔嬮儴缃诧紝鏀<E7B49D>寔鐏垫椿缁勫悎
---
@@ -180,7 +140,7 @@ docs/
### 妯″潡澶嶇敤鍒嗘瀽
| 通用能力 | 使用频率 | 复用模块数 | 优先级 |
| 閫氱敤鑳藉姏 | 浣跨敤棰戠巼 | 澶嶇敤妯″潡鏁?| 浼樺厛绾?|
|---------|---------|-----------|--------|
| LLM缃戝叧 | 71% | 5/7 | P0 |
| 鏂囨。澶勭悊 | 86% | 6/7 | P0 |
@@ -188,89 +148,70 @@ docs/
| ETL寮曟搸 | 29% | 2/7 | P2 |
| 鍖诲<E98D96>NLP | 14% | 1/7 | P2 |
### 模块独立性分析
| 模块 | 独立性 | 商业价值 | 可独立销售 |
### 妯″潡鐙<EFBFBD>珛鎬у垎鏋?
| 妯″潡 | 鐙<>珛鎬?| 鍟嗕笟浠峰€?| 鍙<>嫭绔嬮攢鍞?|
|------|-------|---------|-----------|
| RVW（审稿） | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ✅ 是 |
| ASL（文献） | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ✅ 是 |
| DC（数据清洗） | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ✅ 是 |
| SSA（统计分析） | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⚠️ 与ST协同 |
| RVW锛堝<EFBFBD>绋匡級 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙猸?| 鉁?鏄?|
| ASL锛堟枃鐚<EFBFBD>級 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙猸?| 鉁?鏄?|
| DC锛堟暟鎹<EFBFBD>竻娲楋級 | 猸愨瓙猸愨瓙猸?| 猸愨瓙猸愨瓙猸?| 鉁?鏄?|
| SSA锛堢粺璁″垎鏋愶級 | 猸愨瓙猸愨瓙 | 猸愨瓙猸愨瓙猸?| 鈿狅笍 涓嶴T鍗忓悓 |
| ST锛堝垎鏋愬伐鍏凤級 | 猸愨瓙猸愨瓙 | 猸愨瓙猸愨瓙 | 鈿狅笍 涓嶴SA鍗忓悓 |
| AIA（AI问答） | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⚠️ 与PKB关联 |
| PKB（知识库） | ⭐⭐⭐ | ⭐⭐⭐ | ⚠️ 与AIA关联 |
| AIA锛圓I闂<EFBFBD>瓟锛?| 猸愨瓙猸?| 猸愨瓙猸愨瓙 | 鈿狅笍 涓嶱KB鍏宠仈 |
| PKB锛堢煡璇嗗簱锛?| 猸愨瓙猸?| 猸愨瓙猸?| 鈿狅笍 涓嶢IA鍏宠仈 |
---
## ✅ 当前任务清单
## 鉁?褰撳墠浠诲姟娓呭崟
### P0浠诲姟锛堝凡瀹屾垚锛夆渽
- [x] 绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>
- [x] 鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>v2.0
- [x] 鏍稿績闂<E7B8BE><E99782>瑙ｇ瓟
- [x] 数据库架构说明
- [x] 运营管理端架构设计
- [x] Schema隔离方案与成本分析
- [x] 模块独立部署与单机版方案
- [x] 鏁版嵁搴撴灦鏋勮<EFBFBD>鏄?- [x] 杩愯惀绠＄悊绔<E6828A>灦鏋勮<E98F8B>璁?- [x] Schema闅旂<E99785>鏂规<E98F82>涓庢垚鏈<E59E9A>垎鏋?- [x] 妯″潡鐙<E6BDA1>珛閮ㄧ讲涓庡崟鏈虹増鏂规<E98F82>
- [x] Monorepo鏋舵瀯璇勪及
- [x] 架构设计全景图
- [x] 今日工作总结
- [x] 鏋舵瀯璁捐<EFBFBD>鍏ㄦ櫙鍥?- [x] 浠婃棩宸ヤ綔鎬荤粨
### P1浠诲姟锛堝緟鍐崇瓥锛夆彸
**鍏抽敭鍐崇瓥鐐癸細**
- [ ] 是否现在做Schema隔离？（建议：是，1周）
- [ ] 是否现在转换Monorepo？（建议：是，2-3天）
- [ ] 鏄<EFBFBD>惁鐜板湪鍋歋chema闅旂<EFBFBD>锛燂紙寤鸿<EFBFBD>锛氭槸锛?鍛<>級
- [ ] 鏄<EFBFBD>惁鐜板湪杞<EFBFBD>崲Monorepo锛燂紙寤鸿<EFBFBD>锛氭槸锛?-3澶╋級
**濡傛灉鍐冲畾鍏堝仛鏋舵瀯鏀归€狅紙鏂规<E98F82>B锛夛細**
- [ ] Week 1：Schema隔离 + Monorepo转换（6天）
- [ ] Week 2+：ASL模块开发
- [ ] Week 1锛歋chema闅旂<EFBFBD> + Monorepo杞<EFBFBD>崲锛?澶╋級
- [ ] Week 2+锛欰SL妯″潡寮€鍙?
**濡傛灉鍐冲畾绔嬪嵆寮€鍙戯紙鏂规<E98F82>A锛夛細**
- [ ] Week 1+：ASL模块开发
- [ ] 未来：架构改造（成本更高）
- [ ] Week 1+锛欰SL妯″潡寮€鍙?- [ ] 鏈<>潵锛氭灦鏋勬敼閫狅紙鎴愭湰鏇撮珮锛?
### P2浠诲姟锛堝悗缁<E68297>級
- [ ] 杩佺Щ鎬讳綋闇€姹傛枃妗ｅ拰鎶€鏈<E282AC>灦鏋勭櫧鐨<E6ABA7>功
- [ ] 琛ュ厖ASL妯″潡缂哄け鏂囨。
- [ ] LLM缃戝叧璇︾粏璁捐<E79281>
- [ ] RVW鐙<57>珛绯荤粺瑙勫垝
- [ ] 补充运营管理端详细文档
- [ ] 琛ュ厖杩愯惀绠＄悊绔<EFBFBD><EFBFBD>缁嗘枃妗?
---
## 馃摉 鐩稿叧鏂囨。
### 平台基础层
- [01-平台基础层/](../01-平台基础层/) - 用户权限、存储、通知等
### 通用能力层
- [02-通用能力层/](../02-通用能力层/) - LLM网关、文档处理、RAG等
### 骞冲彴鍩虹<EFBFBD>灞?- [01-骞冲彴鍩虹<E98DA9>灞?](../01-骞冲彴鍩虹<E98DA9>灞?) - 鐢ㄦ埛鏉冮檺銆佸瓨鍌ㄣ€侀€氱煡绛?
### 閫氱敤鑳藉姏灞?- [02-閫氱敤鑳藉姏灞?](../02-閫氱敤鑳藉姏灞?) - LLM缃戝叧銆佹枃妗ｅ<E5A697>鐞嗐€丷AG绛?
### 涓氬姟妯″潡
- [03-业务模块/](../03-业务模块/) - 7个独立业务模块
- [03-涓氬姟妯″潡/](../03-涓氬姟妯″潡/) - 7涓<EFBFBD>嫭绔嬩笟鍔℃ā鍧?
### 椤圭洰绠＄悊
- [08-项目管理/](../08-项目管理/) - 开发计划、里程碑、每日进度
- [08-椤圭洰绠＄悊/](../08-椤圭洰绠＄悊/) - 寮€鍙戣<E98D99>鍒掋€侀噷绋嬬<E7BB8B>銆佹瘡鏃ヨ繘搴?
---
## 馃<> 璐＄尞鎸囧崡
### 濡備綍鏇存柊鏂囨。
1. **总体架构调整**：需要团队讨论，更新本目录文档
2. **模块设计调整**：更新对应模块目录文档
3. **文档格式**：遵循Markdown规范，包含目录、表格、代码块
1. **鎬讳綋鏋舵瀯璋冩暣**锛氶渶瑕佸洟闃熻<E99783>璁猴紝鏇存柊鏈<E69F8A>洰褰曟枃妗?2. **妯″潡璁捐<E79281>璋冩暣**锛氭洿鏂板<E98F82>搴旀ā鍧楃洰褰曟枃妗?3. **鏂囨。鏍煎紡**锛氶伒寰狹arkdown瑙勮寖锛屽寘鍚<E5AF98>洰褰曘€佽〃鏍笺€佷唬鐮佸潡
### 鏂囨。瀹℃牳娴佺▼
1. 鎶€鏈<E282AC>灦鏋勫笀瀹℃牳鎬讳綋鏂囨。
2. 模块负责人审核模块文档
3. 定期同步文档与代码
2. 妯″潡璐熻矗浜哄<EFBFBD>鏍告ā鍧楁枃妗?3. 瀹氭湡鍚屾<E98D9A>鏂囨。涓庝唬鐮?
---
**鏈€鍚庢洿鏂帮細** 2025-11-06

1705
docs/00-系统总体设计/前后端模块化架构设计-V2.md
View File

File diff suppressed because it is too large Load Diff