Files
AIclinicalresearch/docs/08-项目管理/04-技术决策/2025-11-18-MSE与ARMS采购决策分析.md
HaHafeng 1b53ab9d52 feat(aia): Complete AIA V2.0 with universal streaming capabilities
Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

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

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

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

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)
2026-01-14 19:15:01 +08:00

660 lines
17 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# MSE荳拶RMS驥<53>エュ蜀ウ遲門<E981B2><EFBFBD>
> **蛻<>梵譌・譛滂シ?* 2025-11-18
> **鬘ケ逶ョ髦カ谿オ<E8B0BF>?* 蛻帑ク壼<EFBDB8>譛滂シ窟SL讓。蝮怜セ<E6809C>€蜿?
> **髣ョ鬚假シ?* 譏ッ蜷ヲ髴€隕∬エュ荵ー髦ソ驥御コ閃SE<53>亥セョ譛榊苅蠑墓梼<E5A293>牙柱ARMS<4D>亥コ皮畑逶第而<E7ACAC>会シ?
> **扈楢ョコ<EFBDAE>?* **蛻帑ク壼<EFBDB8>譛滉ク埼怙隕<E68099>シ檎鴫譛牙渕遑€隶セ譁ス雜ウ螟<EFBDB3>** 笨?
---
## <20>投 蜉溯<E89C89>蟇ケ豈泌<E8B188><EFBFBD>
### 1<>Ε 髦ソ驥御コ閃SE vs 謌台サャ逧<EFBDAC>渕遑€隶セ譁ス
| MSE蜉溯<E89C89> | 謌台サャ逧<EFBDAC>ョ樒<EFBDAE>?| 譏ッ蜷ヲ髴€SE | 逅<>罰 |
|---------|-----------|------------|------|
| **豕ィ蜀碁<E89C80>鄂ョ荳ュ蠢<EFBDAD>** (Nacos/ZooKeeper) | `config/env.ts` 邇ッ蠅<EFBDAF>序驥<E5BA8F> | 笶?**荳埼怙隕?* | 謌台サャ譏?*蜊穂ス鉄erverless蠎皮畑**<2A>御ク肴弍蠕ョ譛榊苅譫カ譫<EFBDB6>シ御ク埼怙隕∵恪蜉。豕ィ蜀?|
| **蠕ョ譛榊苅豐サ逅?* (Spring Cloud/Dubbo) | 荳埼€ら畑 | 笶?**荳埼怙隕?* | 謌台サャ譏ッNode.js蜊穂ス灘コ皮畑<E79AAE>御ク堺スソ逕ィSpring Cloud謌縫ubbo |
| **莠大次逕溽ス大<EFBDBD>?* (Ingress) | SAE閾ェ蟶ヲ鄂大<E98482> | 笶?**荳埼怙隕?* | SAE蟾イ謠蝉セ姨TTP霍ッ逕ア蜥瑚エ溯スス蝮<EFBDBD>。?|
| **蛻<><EFBFBD>シ丈ササ蜉。隹<EFBDA1>コ?* (XXL-JOB) | `common/jobs/` (MemoryQueue/DatabaseQueue) | 笞<><E7AC9E><EFBFBD> **證ゆク埼怙隕?* | 蛻帑ク壼<EFBDB8>譛滓<E8AD9B>莉ャ逧<EFBDAC>obQueue螟溽畑<E6BABD>悟錘扈ュ蜿ッ蜊<EFBDAF>コァ |
**譬ク蠢<EFBDB8>キョ蠑ゑシ?*
```
MSE騾ら畑蝨コ譎ッ<EFBFBD>?
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏?譛榊苅A 笏や楳笏€笏€笏?譛榊苅B 笏や楳笏€笏€笏?譛榊苅C 笏? 竊?髴€隕∵ウィ蜀御クュ蠢?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏?
謌台サャ逧<EFBFBD>楔譫<EFBFBD><EFBFBD>
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? 蜊穂ス鉄erverless蠎皮畑<E79AAE><E79591>astify<66>? 笏? 竊?荳埼怙隕∵ウィ蜀御クュ蠢?
笏? - legacy讓。蝮暦シ<E69AA6>IA/PKB/RVW<56>? 笏?
笏? - ASL讓。蝮暦シ亥セ<E4BAA5>€蜿托シ<E68998> 笏?
笏? - 蟷ウ蜿ー蝓コ遑€隶セ譁ス<E8AD81>?荳ェ蜀<EFBDAA>Κ讓。蝮暦シ<E69AA6> 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
```
---
### 2<>Ε 髦ソ驥御コ羨RMS vs 謌台サャ逧<EFBDAC>尅謗ァ譁ケ譯?
| ARMS蜉溯<E89C89> | 謌台サャ逧<EFBDAC>ョ樒<EFBDAE>?| 譏ッ蜷ヲ髴€隕、RMS | 逅<>罰 |
|---------|-----------|-------------|------|
| **蠎皮畑逶第而** | `common/monitoring/metrics.ts` | 笞<><E7AC9E><EFBFBD> **證ゆク埼怙隕?* | 謌台サャ譛牙渕遑€逶第而<E7ACAC><EFBFBD>荳壼<E88DB3>譛溷、溽<EFBDA4>?|
| **謗・蜿」隹<EFBDA3>畑逶第而** | `common/logging/logger.ts` | 笞<><E7AC9E><EFBFBD> **證ゆク埼怙隕?* | Winston扈捺桷蛹匁律蠢怜庄霑ス雕ェ |
| **諤ァ閭ス蛻<EFBDBD>** | `/health` + Metrics | 笞<><E7AC9E><EFBFBD> **證ゆク埼怙隕?* | 邂€蜊募惻譎ッ螟溽<E89E9F>?|
| **髞呵ッッ隸頑妙** | 扈捺桷蛹匁律蠢?+ SLS | 笞<><E7AC9E><EFBFBD> **證ゆク埼怙隕?* | 譌・蠢礼ウサ扈溷庄霑ス雕ェ髞呵ッ?|
| **隹<>畑體セ霑ス雕?* | 譌?| 笞<><E7AC9E><EFBFBD> **蛻晄悄荳埼怙隕?* | 蜊穂ス灘コ皮畑隹<E79591>畑體セ邂€蜊?|
**譬ク蠢<EFBDB8>キョ蠑ゑシ?*
```
ARMS騾ら畑蝨コ譎ッ<EFBFBD>?
- 螟肴揩逧<E68FA9>セョ譛榊苅隹<E88B85>畑體?
- 髴€隕∵キア蠎ヲ諤ァ閭ス蛻<EFBDBD>
- 螟ァ隗<EFBDA7>ィ。逕滉コァ邇ッ蠅<EFBDAF>シ域律豢サ>10荳<30><EFBFBD>
謌台サャ逧<EFBFBD>惻譎ッ<EFBFBD><EFBFBD>
- 蜊穂ス灘コ皮畑<E79AAE>瑚ー<E7919A>畑體セ貂<EFBDBE>
- 蛻帑ク壼<EFBDB8>譛滂シ梧オ<E6A2A7>㍼蟆<E38DBC>
- 蝓コ遑€逶第而 + 譌・蠢苓カウ螟<EFBDB3>
```
---
## <20>腸 謌先悽謨育寢蛻<E5AFA2>
### MSE謌先悽<E58588>井シー邂暦シ<E69AA6>
| 鬘ケ逶ョ | 驟咲スョ | 莉キ譬シ/譛?| 隸エ譏<EFBDB4> |
|------|------|--------|------|
| 豕ィ蜀碁<E89C80>鄂ョ荳ュ蠢<EFBDAD> | 譛€蟆剰ァ<E589B0><EFBDA7>?| ~ツ・200 | Nacos荳謎ク夂<EFBDB8>?|
| 莠大次逕溽ス大<EFBDBD>?| 譛€蟆剰ァ<E589B0><EFBDA7>?| ~ツ・300 | 荳埼怙隕<E68099><EFBFBD>AE蟾イ謠蝉セ幢シ<E5B9A2> |
| **諤サ隶。** | - | **~ツ・500** | 蛻帑ク壼<EFBDB8>譛滉ク榊ソ<E6A68A>ヲ?|
### ARMS謌先悽<E58588>井シー邂暦シ<E69AA6>
| 鬘ケ逶ョ | 驟咲スョ | 莉キ譬シ/譛?| 隸エ譏<EFBDB4> |
|------|------|--------|------|
| 蠎皮畑逶第而 | 謖芽ー<E88ABD>畑驥<E79591> | ~ツ・300-1000 | 蜿門<E89CBF>莠手ー<E6898B>畑驥<E79591> |
| **諤サ隶。** | - | **~ツ・300-1000** | 譛牙<E8AD9B>雍ケ鬚晏コヲ<EFBDBA>御ス<E5BEA1>怏髯?|
### 謌台サャ逧<EFBDAC>尅謗ァ謌先<E8AC8C>?
| 鬘ケ逶ョ | 驟咲スョ | 莉キ譬シ/譛?| 隸エ譏<EFBDB4> |
|------|------|--------|------|
| 扈捺桷蛹匁律蠢?| Winston 竊?stdout | ツ・0 | 蜈崎エケ |
| 譌・蠢怜ュ伜お | 髦ソ驥御コ全LS | ツ・0-50 | 蟆乗オ<E4B997>㍼蜈崎エケ鬚晏コヲ蜀<EFBDA6> |
| 蛛・蠎キ譽€譟?| 閾ェ螳樒<E89EB3>?| ツ・0 | 蜈崎エケ |
| **諤サ隶。** | - | **ツ・0-50** | 蛻帑ク壼<EFBDB8>譛溷、溽畑 |
**謌先悽蟇ケ豈費シ?*
```
雍ュ荵ーMSE + ARMS<4D>嘸ツ・800-1500/譛?
謌台サャ逧<EFBFBD>婿譯茨シ<EFBFBD> ~ツ・0-50/譛?
闃ら怐謌先悽<EFBFBD>嘸ツ・800-1500/譛?= ~ツ・10,000-18,000/蟷?
```
---
## 笨?謌台サャ逧<EFBDAC>渕遑€隶セ譁ス vs MSE/ARMS
### 謌台サャ蟾イ扈乗怏逧<E6808F><E980A7><EFBFBD>
#### 1. 驟咲スョ邂。逅<EFBDA1>シ域崛莉」MSE驟咲スョ荳ュ蠢<EFBDAD>シ?
**謌台サャ逧<EFBDAC>婿譯茨シ<E88CA8>**
```typescript
// config/env.ts - 扈滉ク€驟咲スョ邂。逅<EFBDA1>
export const config = {
storageType: process.env.STORAGE_TYPE || 'local',
cacheType: process.env.CACHE_TYPE || 'memory',
queueType: process.env.QUEUE_TYPE || 'memory',
// ... 40+荳ェ驟咲スョ鬘ケ
}
// SAE邇ッ蠅<EFBDAF>序驥擾シ井コ醍ォッ驟咲スョ<EFBDBD><EFBDAE>
STORAGE_TYPE=oss
CACHE_TYPE=redis
QUEUE_TYPE=database
```
**莨伜漢<E4BC9C>?*
- 笨?髮カ謌先<E8AC8C>?
- 笨?邂€蜊慕峩謗?
- 笨?騾ょ粋蜊穂ス灘コ皮畑
- 笨?SAE蜴溽函謾ッ謖<EFBDAF>
**MSE驟咲スョ荳ュ蠢<EFBDAD>噪莨伜漢<E4BC9C><EFBFBD>莉ャ證ゆク埼怙隕<E68099>シ会シ?*
- 蜉ィ諤<EFBDA8><E8ABA4>鄂ョ譖エ譁ー<E8AD81><EFBFBD>莉ャ驥榊星蜊ウ蜿ッ<E89CBF>?
- 螟壼コ皮畑驟咲スョ蜈ア莠ォ<E88EA0><EFBFBD>莉ャ蜿ェ譛<EFBDAA>1荳ェ蠎皮畑<E79AAE><E79591>
- 迚域悽邂。逅<EFBDA1>シ域<EFBDBC>莉ャ逕ィGit + 邇ッ蠅<EFBDAF>序驥擾シ?
---
#### 2. 莉サ蜉。隹<EFBDA1>コヲ<EFBDBA>域崛莉」MSE蛻<45><EFBFBD>シ丈ササ蜉。隹<EFBDA1>コヲ<EFBDBA><EFBDA6>
**謌台サャ逧<EFBDAC>婿譯茨シ<E88CA8>**
```typescript
// common/jobs/ - 邂€蜊穂ササ蜉。髦溷<E9ABA6>?
import { jobQueue } from '@/common/jobs'
const job = await jobQueue.push('asl:screening', data)
// 蠖灘燕螳樒鴫<E6A892>哺emoryQueue<75>域悽蝨ー<E89DA8><EFBDB0>
// 蜷守サュ蜊<EFBDAD>コァ<EFBDBA>咼atabaseQueue<75>井コ醍ォッ<EFBDAB><EFBDAF>
```
**莨伜漢<E4BC9C>?*
- 笨?髮カ謌先<E8AC8C>?
- 笨?莉」遐∫ョ€蜊?
- 笨?貊。雜ウ蝓コ譛ャ髴€豎?
- 笨?蜿ッ蜷守サュ蜊<EFBDAD>コ?
**MSE莉サ蜉。隹<EFBDA1>コヲ逧<EFBDA6>シ伜漢<E4BC9C><EFBFBD>莉ャ證ゆク埼怙隕<E68099>シ会シ?*
- 螟肴揩逧Гron陦ィ霎セ蠑擾シ域<EFBDBC>莉ャ逕ィ邂€蜊暮弌蛻暦シ<E69AA6>
- 莉サ蜉。蛻<EFBDA1><EFBFBD><EFBFBD>莉ャ豬<EFBDAC>㍼蟆擾シ御ク埼怙隕<E68099><EFBFBD>
- 蜿ッ隗<EFBDAF>喧邂。逅<EFBDA1>シ域<EFBDBC>莉ャ莉」遐∫ョ。逅<EFBDA1>叉蜿ッ<E89CBF>?
- 莉サ蜉。螟ア雍・驥崎ッ包シ域<EFBDBC>莉ャ蜿ッ莉・邂€蜊募ョ樒鴫<E6A892><E9B4AB>
**蟇ケ豈費シ?*
```
MSE XXL-JOB<4F>? ツ・200+/譛茨シ悟、肴揩驟咲スョ<EFBDBD>€ょ粋螟ァ隗<EFBDA7>ィ?
謌台サャ逧<EFBFBD>obQueue<EFBFBD>? ツ・0<EFBDA5>檎ョ€蜊慕峩謗・<E8AC97><EFBFBD>荳夐亳谿オ螟溽畑
```
---
#### 3. 蠎皮畑逶第而<E7ACAC>域崛莉」ARMS<4D>?
**謌台サャ逧<EFBDAC>婿譯茨シ<E88CA8>**
```typescript
// common/logging/logger.ts - 扈捺桷蛹匁律蠢?
import { logger } from '@/common/logging'
logger.info('API called', {
path, method, latencyMs, statusCode, userId
})
// common/monitoring/metrics.ts - 蜈ウ髞ョ謖<EFBDAE><E8AC96><EFBFBD>
Metrics.recordDBConnectionCount()
Metrics.recordMemoryUsage()
Metrics.recordApiLatency(path, method, latency, statusCode)
// common/health/ - 蛛・蠎キ譽€譟?
GET /health/liveness - SAE蟄俶エサ譽€?
GET /health/readiness - €<EFBFBD><EFBFBD>/<EFBFBD><EFBFBD>/?
```
**譌・蠢苓セ灘<EFBDBE>蛻ー髦ソ驥御コ全LS<4C><EFBFBD>雍ケ鬚晏コヲ蜀<EFBDA6>シ会シ<E4BC9A>**
```
Winston<EFBFBD><EFBFBD>tdout<EFBFBD>繰SON譬シ蠑擾シ俄<EFBFBD> SAE驥<45>寔 竊?髦ソ驥御コ全LS蟄伜お
蟆乗オ<EFBFBD>㍼蝨コ譎ッ<EFBFBD><EFBFBD>雍ケ鬚晏コヲ螟溽畑<EFBFBD>域ッ乗<EFBFBD>?00MB譌・蠢暦シ?
```
**莨伜漢<E4BC9C>?*
- 笨?蝓コ譛ャ逶第而閭ス蜉帛ョ梧紛
- 笨?譌・蠢怜庄霑ス貅?
- 笨?蛛・蠎キ譽€譟・螳悟<E89EB3>?
- 笨?謌先悽譫∽ス趣シ<E8B6A3>LS蜈崎エケ鬚晏コヲ<EFBDBA>?
**ARMS逧<53>シ伜漢<E4BC9C><EFBFBD>莉ャ證ゆク埼怙隕<E68099>シ会シ?*
- 蜿ッ隗<EFBDAF>喧Dashboard<72><EFBFBD>莉ャ蜿ッ莉・譟・譌・蠢暦シ?
-<>畑體セ霑ス雕ェ<E99B95>亥黒菴灘コ皮畑荳埼怙隕<E68099><EFBFBD>
- 閾ェ蜉ィ蜻願ュヲ<EFBDAD><EFBFBD>莉ャ蜿ッ莉・邂€蜊募ョ樒鴫<E6A892><E9B4AB>
- 豺ア蠎ヲ諤ァ閭ス蛻<EFBDBD><EFBFBD><EFBFBD>荳壼<E88DB3>譛滉ク埼怙隕<E68099><EFBFBD>
---
## <20>嶋 莉€荵域慮蛟咎怙隕SE蜥窟RMS<4D>?
### 蜊<>コァ隗ヲ蜿第擅莉カ
#### 閠<>剔雍ュ荵ーMSE逧<45>慮譛コ<E8AD9B><EFBDBA>
1. **譫カ譫<EFBDB6>シ碑ソ帑クコ蠕ョ譛榊苅**
- 蠖灘燕<E78198>壼黒菴鉄erverless蠎皮畑
- 譛ェ譚・<E8AD9A>壽究蛻<E7A9B6>クコ5+荳ェ迢ャ遶区恪蜉?
- 隗ヲ蜿第擅莉カ<E88E89>壽ィ。蝮礼峡遶矩Κ鄂イ縲∝屬髦?10莠?
2. **莉サ蜉。隹<EFBDA1>コヲ螟肴揩蛹?*
- 蠖灘燕<E78198>夂ョ€蜊暮弌蛻暦シ<E69AA6><1000荳ェ莉サ蜉?螟ゥ<E89E9F><EFBDA9>
- 譛ェ譚・<E8AD9A>壼、肴揩螳壽慮莉サ蜉。縲∽ササ蜉。蛻<EFBDA1><E89BBB>?
- 隗ヲ蜿第擅莉カ<E88E89>壻ササ蜉。驥<EFBDA1>>10,000/螟?
3. **驟咲スョ邂。逅<EFBDA1>、肴揩蛹?*
- 蠖灘燕<E78198>夂識蠅<E8AD98>序驥擾シ<E693BE><50荳ェ驟咲スョ鬘ケ<E9AC98>?
- 譛ェ譚・<E8AD9A>壼勘諤<E58B98><E8ABA4>鄂ョ縲、/B豬玖ッ<E78E96>
- 隗ヲ蜿第擅莉カ<E88E89><EFBFBD>鄂ョ鬘ケ>200荳ェ<E88DB3>碁怙隕∝勘諤∵峩譁?
**莨ー邂玲慮髣エ<E9ABA3>?* 1-2蟷エ蜷趣シ亥ケエ謾カ蜈・>1000荳<30>シ檎畑謌キ>10荳<30><EFBFBD>
---
#### 閠<>剔雍ュ荵ーARMS逧<53>慮譛コ<E8AD9B><EFBDBA>
1. **豬<>㍼隗<E38DBC>ィ。蜿伜、ァ**
- 蠖灘燕<E78198>夐「<E5A490>シー譌・豢?1000<30>悟ケカ蜿?100
- 譛ェ譚・<E8AD9A>壽律豢?10荳<30>シ悟ケカ蜿<EFBDB6>>1000
- 隗ヲ蜿第擅莉カ<E88E89>€ァ閭ス逑カ鬚磯「醍ケ∝<EFBDB9>邇ー
2. **謨<>囿螳壻ス榊峅髫セ**
- 蠖灘燕<E78198>壽律蠢怜庄霑ス雕ェ<E99B95>瑚ー<E7919A>畑體セ邂€蜊?
- 譛ェ譚・<E8AD9A>壼、肴揩隹<E68FA9>畑體セ<E9AB94>碁埓莉・螳壻ス埼琉鬚?
- 隗ヲ蜿第擅莉カ<E88E89>壽腐髫懈賜譟・閠玲慮>1蟆乗慮
3. **髴€隕∵キア蠎ヲ諤ァ閭ス莨伜喧**
- 蠖灘燕<E78198>壼渕遑€逶第而螟溽畑
- 譛ェ譚・<E8AD9A>夐怙隕∫サ<E288AB>イ貞コヲ諤ァ閭ス蛻<EFBDBD>
- 隗ヲ蜿第擅莉カ<E88E89>夂畑謌キ蜿埼ヲ域€ァ閭ス髣ョ鬚<EFBDAE>
**莨ー邂玲慮髣エ<E9ABA3>?* 6荳ェ譛<EFBDAA>-1蟷エ蜷趣シ域オ<E59F9F>㍼蠢ォ騾溷「樣柄譛滂シ?
---
## <20>庁 蜀ウ遲門サコ隶ョ<E99AB6><EFBFBD>荳壼<E88DB3>譛滂シ<E6BB82>
### 笨?謗ィ闕先婿譯茨シ壻ク崎エュ荵ーMSE蜥窟RMS
**逅<><EFBFBD>?譚。<E8AD9A>会シ?*
#### 1. **譫カ譫<EFBDB6>ク榊源驟?*
```
MSE騾ら畑<EFBFBD>壼セョ譛榊苅譫カ譫<EFBFBD>シ亥、壻クェ迢ャ遶区恪蜉。<EFBFBD><EFBFBD>
謌台サャ譫カ譫<EFBFBD>シ壼黒菴鉄erverless蠎皮畑<EFBFBD>井ク€荳ェFastify蠎皮畑<EFBFBD>?
扈楢ョコ<EFBFBD>壻ク埼怙隕SE
```
#### 2. **謌台サャ逧<EFBDAC>渕遑€隶セ譁ス蟾イ雜ウ螟?*
```
笨?驟咲スョ邂。逅<EFBDA1>シ啼nv.ts + SAE邇ッ蠅<EFBDAF>序驥<E5BA8F>
笨?莉サ蜉。隹<EFBDA1>コヲ<EFBDBA>嗚obQueue<75>育ョ€蜊暮弌蛻暦シ<E69AA6>
笨?譌・蠢礼尅謗ァ<E8AC97>啗inston + 髦ソ驥御コ全LS<4C><EFBFBD>雍ケ<E99B8D><EFBDB9>
笨?蛛・蠎キ譽€譟・<E8AD9F><EFBDA5>/health 遶ッ轤ケ
笨?諤ァ閭ス逶第而<E7ACAC>哺etrics邀?
```
#### 3. **謌先悽闃ら怐譏セ闡<EFBDBE>**
```
荳崎エュ荵ー<EFBFBD>堋・0-50/譛茨シ亥宵逕ィSLS蜈崎エケ鬚晏コヲ<EFBDBA>?
雍ュ荵ー<EFBFBD>? ツ・800-1500/譛?
蟷エ闃ら怐<EFBFBD>嘸ツ・10,000-18,000
```
#### 4. **豬<>㍼隗<E38DBC>ィ。蟆?*
```
<EFBFBD>シー<EFBFBD>?
- 蛻晄悄譌・豢サ<E8B1A2>?1000莠?
- 蟷カ蜿題ッキ豎ゑシ?100
- 譌・蠢鈴㍼<E988B4><E38DBC><100MB/螟?
蜈崎エケ鬚晏コヲ雜ウ螟滂シ?
- SLS<4C>?00MB/譛亥<E8AD9B>雍?
- SAE<41><EFBFBD>蟶ヲ蝓コ遑€逶第而
```
#### 5. **蜿ッ蜷守サュ蜊<EFBDAD>コ?*
```
邇ー蝨ィ<EFBFBD>壻スソ逕ィ蜈崎エケ譁ケ譯?
6荳ェ譛亥錘<EFBFBD>壽オ<EFBFBD>㍼蠅樣柄<EFBFBD>瑚ッ<EFBFBD>シー譏ッ蜷ヲ髴€隕?
1蟷エ蜷趣シ壽<EFBFBD>ケ謐ョ螳樣刔諠<EFBFBD><EFBFBD>蜀ウ螳?
```
---
## <20>識 蠖灘燕謗ィ闕先婿譯茨シ磯峺鬚晏、匁<EFBDA4>譛ャ<E8AD9B>?
### 譁ケ譯<EFBDB9>1<EFBFBD>壽律蠢礼尅謗ァ<E8AC97>亥キイ螳樒鴫<E6A892><EFBFBD>?
```typescript
// Winston扈捺桷蛹匁律蠢?竊?stdout 竊?SAE驥<45>寔 竊?髦ソ驥御コ全LS
// 1. 驟咲スョWinston霎灘<E99C8E>JSON<4F>亥キイ螳樒鴫<E6A892>?
logger.info('API called', {
path: '/api/v1/asl/screening',
method: 'POST',
latencyMs: 120,
statusCode: 200,
userId: 123,
projectId: 456
})
// 2. SAE閾ェ蜉ィ驥<EFBDA8>寔stdout譌・蠢<EFBDA5>
// 3. 髦ソ驥御コ全LS譟・隸「譌・蠢暦シ亥<EFBDBC>雍ケ鬚晏コヲ<EFBDBA><EFBDA6>
// 蜿ッ莉・謖疫serId縲ath縲《tatusCode遲牙ュ玲ョオ譟・隸?
```
**謌先悽<E58588>?* ツ・0<EFBDA5><30>LS蜈崎エケ鬚晏コヲ蜀<EFBDA6><EFBFBD>
**閭ス蜉幢シ?*
- 笨?謇€譛陰PI隹<49>畑隶ー蠖<EFBDB0>
- 笨?諤ァ閭ス謖<EFBDBD><E8AC96><EFBFBD>シ亥桃蠎疲慮髣エ<E9ABA3><EFBDB4>
- 笨?髞呵ッッ霑ス雕ェ<E99B95><EFBDAA>rror譌・蠢暦シ?
- 笨?逕ィ謌キ陦御クコ霑ス雕ェ
---
### 譁ケ譯<EFBDB9>2<EFBFBD>壼▼蠎キ譽€譟・荳守尅謗ァ<E8AC97>亥キイ螳樒鴫<E6A892>俄怛
```typescript
// 1. SAE蛛・蠎キ譽€譟・遶ッ轤ケ<E8BDA4>亥キイ螳樒鴫<E6A892><E9B4AB>
GET /health/liveness - €<EFBFBD><EFBFBD><10ms<EFBFBD>?
GET /health/readiness - 蟆ア扈ェ譽€<EFBFBD>亥性DB/<EFBFBD><EFBFBD>/郛灘ュ假シ?
// 2. 蜈ウ髞ョ謖<EFBDAE><E8AC96><EFBFBD>尅謗ァ<E8AC97>亥キイ螳樒鴫<E6A892>?
Metrics.recordDBConnectionCount() // 謨ー謐ョ蠎楢ソ樊磁謨ー
Metrics.recordMemoryUsage() // 蜀<>ュ倅スソ逕ィ
Metrics.recordApiLatency(...) // API蟒カ霑<EFBDB6>
// 3. SAE謗ァ蛻カ蜿ー譟・逵?
- CPU菴ソ逕ィ邇?
- <EFBFBD>ュ倅スソ逕ィ邇?
- 螳樔セ区焚驥<EFBFBD>
- HTTP隸キ豎らサ溯ョ
```
**謌先悽<E58588>?* ツ・0<EFBDA5><30>AE閾ェ蟶ヲ<E89FB6>?
**閭ス蜉幢シ?*
- 笨?螳樊慮逶第而CPU/蜀<><EFBFBD>
- 笨?螳樔セ句▼蠎キ迥カ諤?
- 笨?HTTP隸キ豎らサ溯ョ。
- 笨?閾ェ蜉ィ驥榊星謨<E6989F>囿螳樔セ<E6A894>
---
### 譁ケ譯<EFBDB9>3<EFBFBD>壻ササ蜉。隹<EFBDA1>コヲ<EFBDBA>亥キイ螳樒鴫<E6A892>悟庄蜊<E5BA84>コァ<EFBDBA><EFBFBD>?
**蠖灘燕螳樒鴫<E6A892><E9B4AB>hase 1<>会シ<E4BC9A>**
```typescript
// MemoryQueue - 譛ャ蝨ー蠑€蜿?
QUEUE_TYPE=memory
// 蜉溯<E89C89><E6BAAF>?
- ?
- ??
- ?
```
**蜷守サュ蜊<EFBDAD>コァ<EFBDBA><EFBDA7>hase 2<>会シ<E4BC9A>**
```typescript
// DatabaseQueue - 逕滉コァ邇ッ蠅<EFBDAF>
QUEUE_TYPE=database
// 蜊<>コァ蜀<EFBDA7>ョケ<EFBDAE>?
- ?<EFBFBD><EFBFBD>PostgreSQL<EFBFBD>?
- ?<EFBFBD><EFBFBD><EFBFBD>AE螟壼ョ樔セ狗識蠅<EFBFBD><EFBFBD>
- ??<EFBFBD><EFBFBD>
- ?<EFBFBD>€ron謾ッ謖<EFBFBD>?
```
**謌先悽<E58588>?* ツ・0<EFBDA5>井スソ逕ィ邇ー譛臼ostgreSQL<51>?
**莉€荵域慮蛟咎怙隕SE XXL-JOB<4F>?*
- 莉サ蜉。驥?> 10,000/螟?
-€隕∝、肴揩逧<E68FA9>ササ蜉。蛻<EFBDA1>
-€隕∝庄隗<E5BA84>喧邂。逅<EFBDA1>阜髱「
- 髴€隕∬キィ譛榊苅莉サ蜉。郛匁賜
---
### 譁ケ譯<EFBDB9>4<EFBFBD>夐漠隸ッ蜻願ュヲ<EFBDAD>郁。・蜈<EFBDA5>ョ樒鴫<E6A892>?0蛻<30><EFBFBD>?
**邂€蜊募相隴ヲ譁ケ譯茨シ亥庄騾牙ョ樒鴫<E6A892>会シ?*
```typescript
// common/monitoring/alerting.ts<74>域眠蠅橸シ<E6A9B8>
import { logger } from '../logging/logger.js'
export class Alerting {
/**
* 蜿鷹€<E9B7B9>忠髓牙相隴ヲ<E99AB4><EFBFBD>荳壼<E88DB3>譛滓耳闕撰シ?
*/
static async sendDingTalkAlert(message: string, level: 'info' | 'warn' | 'error') {
if (process.env.NODE_ENV !== 'production') return
const webhook = process.env.DINGTALK_WEBHOOK_URL
if (!webhook) return
// 蜿鷹€∝芦髓蛾忠鄒?
await fetch(webhook, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
msgtype: 'text',
text: { content: `[${level.toUpperCase()}] ${message}` }
})
})
}
/**
* 謨ー謐ョ蠎楢ソ樊磁蜻願ュヲ<EFBDAD><EFBDA6>80%髦亥€<C280><EFBDBC>
*/
static async checkAndAlertDBConnection() {
const current = await getDatabaseConnectionCount()
const max = config.dbMaxConnections
const usage = (current / max) * 100
if (usage > 80) {
await this.sendDingTalkAlert(
`<EFBFBD><EFBFBD><EFBFBD> 謨ー謐ョ蠎楢ソ樊磁謨ー蜻願ュヲ<EFBDAD>?{current}/${max} (${usage.toFixed(1)}%)`,
'warn'
)
}
}
}
```
**謌先悽<E58588>?* ツ・0<EFBDA5>磯忠髓牙<E9AB93>雍ケ<E99B8D><EFBDB9>
---
## <20>搭 蛻帑ク壼<EFBDB8>譛滓耳闕先婿譯茨シ域€サ扈難シ?
### 笨?菴ソ逕ィ<E98095>磯峺謌先悽<E58588>?
| 譛榊苅 | 螳樒鴫譁ケ蠑<EFBDB9> | 謌先悽 | 迥カ諤?|
|------|---------|------|------|
| **譌・蠢礼尅謗ァ** | Winston + 髦ソ驥御コ全LS<4C><EFBFBD>雍ケ鬚晏コヲ<EFBDBA><EFBDA6> | ツ・0 | 笨?蟾イ螳樒<E89EB3>?|
| **蛛・蠎キ譽€譟?* | /health 遶ッ轤ケ + SAE閾ェ蟶ヲ逶第而 | ツ・0 | 笨?蟾イ螳樒<E89EB3>?|
| **莉サ蜉。髦溷<E9ABA6>** | MemoryQueue<75>域悽蝨ー<E89DA8><EFBDB0>/DatabaseQueue<75>井コ醍ォッ<EFBDAB><EFBDAF> | ツ・0 | 笨?蟾イ螳樒<E89EB3>?|
| **驟咲スョ邂。逅<EFBDA1>** | env.ts + SAE邇ッ蠅<EFBDAF>序驥<E5BA8F> | ツ・0 | 笨?蟾イ螳樒<E89EB3>?|
| **髞呵ッッ蜻願ュヲ** | 髓蛾忠Webhook<6F>亥庄騾会シ<E4BC9A> | ツ・0 | <20>搭 蜿ッ騾牙ョ樒<EFBDAE>?|
**諤サ謌先悽<E58588><E682BD>** ツ・0-50/譛?
---
### 笶?證ゆク崎エュ荵ー
| 譛榊苅 | 蜴溷屏 | 菴墓慮髴€隕?|
|------|------|---------|
| **髦ソ驥御コ閃SE** | 謌台サャ譏ッ蜊穂ス灘コ皮畑<E79AAE>御ク肴弍蠕ョ譛榊<E8AD9B>?| 1-2蟷エ蜷趣シ域楔譫<E6A594>合郤ァ荳コ蠕ョ譛榊苅<E6A68A><E88B85> |
| **髦ソ驥御コ羨RMS** | 蝓コ遑€逶第而雜ウ螟滂シ梧オ<E6A2A7>㍼蟆<E38DBC> | 6荳ェ譛<EFBDAA>-1蟷エ蜷趣シ域オ<E59F9F><EFBDB5>?10荳?螟ゥ<E89E9F><EFBDA9> |
---
## <20>売 蜊<>コァ霍ッ蠕<EFBDAF><EFBFBD><EFBDA7>
### Phase 1<>壼ス灘燕髦カ谿オ<E8B0BF><EFBDB5>0-6荳ェ譛茨シ俄ュ<E4BF84> 邇ー蝨ィ
**豬<>㍼隗<E38DBC>ィ。<EFBDA8>?* 譌・豢サ<1000<30>悟ケカ蜿?100
**謗ィ闕先婿譯茨シ?*
```
笨?Winston譌・蠢<EFBDA5> + 髦ソ驥御コ全LS<4C><EFBFBD>雍ケ鬚晏コヲ<EFBDBA><EFBDA6>
笨?/health蛛・蠎キ譽€譟?
笨?MemoryQueue莉サ蜉。髦溷<E9ABA6>
笨?邂€蜊慕噪Metrics逶第而
笨?髓蛾忠蜻願ュヲ<EFBDAD>亥庄騾会シ<E4BC9A>
```
**謌先悽<E58588>?* ツ・0-50/譛?
---
### Phase 2<>壼ソォ騾溷「樣柄譛滂シ?荳ェ譛<EFBDAA>-1蟷エ<E89FB7><EFBDB4>
**豬<>㍼隗<E38DBC>ィ。<EFBDA8>?* 譌・豢サ1000-10000<30>悟ケカ蜿?00-500
**蜊<>コァ蟒コ隶ョ<E99AB6>?*
```
笨?蜊<>コァ蛻ーDatabaseQueue<75>井ササ蜉。謖∽ケ<E288BD><EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><>剔ARMS蝓コ遑€迚茨シ域潔驥丈サ倩エケ<EFBDB4>?
<EFBFBD><EFBFBD><EFBFBD> 蠅槫刈Redis郛灘ュ假シ磯剄菴札B蜴句鴨<E58FA5>?
<EFBFBD><EFBFBD><EFBFBD> 蠅槫刈CDN<44>亥刈騾滄撕諤∬オ<E288AC>コ撰シ<E692B0>
```
**謌先悽<E58588>?* ツ・500-1000/譛?
---
### Phase 3<><EFBFBD>辭滓悄<E6BB93>?蟷?<3F>?
**豬<>㍼隗<E38DBC>ィ。<EFBDA8>?* 譌・豢サ>10荳<30>シ悟ケカ蜿<EFBDB6>>1000
**蜊<>コァ蟒コ隶ョ<E99AB6>?*
```
<EFBFBD><EFBFBD><EFBFBD><>剔MSE<53>亥ヲよ棡諡<E6A3A1><E8ABA1>荳コ蠕ョ譛榊苅<E6A68A><E88B85>
笨?雍ュ荵ーARMS荳謎ク夂沿<E5A482>域キア蠎ヲ諤ァ閭ス蛻<EFBDBD><EFBFBD>?
笨?蠅槫刈Redis髮<73>セ、<EFBDBE>磯ォ伜庄逕ィ<E98095>?
笨?蠅槫刈RDS蜿ェ隸サ螳樔セ具シ郁ッサ蜀吝<E89C80>遖サ<E98196><EFBDBB>
```
**謌先悽<E58588>?* ツ・2000-5000/譛?
---
## <20>識 譛€扈亥サコ隶?
### 笨?蛻帑ク壼<EFBDB8>譛滂シ育鴫蝨ィ<E89DA8><EFBDA8>
**荳埼怙隕∬エュ荵ーMSE蜥窟RMS<4D>悟次蝗<E6ACA1><E89D97><EFBFBD>**
1. **譫カ譫<EFBDB6>ク榊源驟?*
- MSE髱「蜷大セョ譛榊苅<E6A68A><EFBFBD>莉ャ譏ッ蜊穂ス灘コ皮<EFBDBA>?
- ARMS髱「蜷大、ァ豬<EFBDA7><EFBFBD><EFBFBD>莉ャ豬<EFBDAC>㍼蟆?
2. **謌先悽莨伜<E88EA8>**
- 闃ら怐<E38289>堋?00-1500/譛?
- 邏ッ隶。<E99AB6>堋?0,000-18,000/蟷?
3. **邇ー譛画婿譯郁カウ螟<EFBDB3>**
- 謌台サャ逧?荳ェ蝓コ遑€隶セ譁ス讓。蝮<EFBDA1>
- Winston譌・蠢<EFBDA5> + SLS
- 蛛・蠎キ譽€譟?+ 邂€蜊慕尅謗?
4. **蜿ッ蜷守サュ蜊<EFBDAD>コ?*
- 髫冗捩豬<E68DA9>㍼蠅樣柄蜀崎ッ<E5B48E>シ?
- 譫カ譫<EFBDB6>合郤ァ譌カ蜀崎€<E5B48E>
---
### <20>売 譖ソ莉」譁ケ譯茨シ域耳闕撰シ<E692B0>
#### 遶句叉菴ソ逕ィ<E98095><EFBFBD>雍ケ<E99B8D>会シ?
1. **髦ソ驥御コ全LS<4C>域律蠢玲恪蜉。<E89C89><EFBDA1>** - 蜈崎エケ鬚晏コヲ蜀?
- 謾カ髮<EFBDB6>inston譌・蠢<EFBDA5>
- 譌・蠢玲衍隸「蜥悟<E89CA5>譫?
-€蜊慕噪蜻願ュヲ隗<EFBDA6><E99A97>
2. **SAE閾ェ蟶ヲ逶第而** - 蜈崎エケ
- CPU/蜀<>ュ倡尅謗ァ
- HTTP隸キ豎らサ溯ョ。
- 螳樔セ句▼蠎キ迥カ諤?
3. **髓蛾忠蜻願ュヲ<EFBDAD>亥庄騾会シ<E4BC9A>** - 蜈崎エケ
- 蜈ウ髞ョ髞呵ッッ騾夂衍
- 謨ー謐ョ蠎楢ソ樊磁蜻願ュ?
- 莉サ蜉。螟ア雍・騾夂衍
#### 6荳ェ譛亥錘隸<E98C98>シー<EFBDBC><EFBDB0>
1. **螯よ棡豬<E6A3A1>㍼>1荳?螟?*
-<>剔ARMS蝓コ遑€迚茨シ域潔驥丈サ倩エケ<EFBDB4>?
2. **螯よ棡髴€隕∵究蛻<E7A9B6>セョ譛榊苅**
-<>剔MSE豕ィ蜀御クュ蠢<EFBDAD>
---
## <20>投 蟇ケ豈疲€サ扈楢。?
| 扈エ蠎ヲ | 謌台サャ逧<EFBDAC>婿譯?| MSE + ARMS | 扈楢ョコ |
|------|-----------|-----------|------|
| **譫カ譫<EFBDB6>源驟榊コ?* | 笨?螳檎セ趣シ亥黒菴灘コ皮畑<E79AAE><E79591> | 笶?荳榊源驟搾シ亥セョ譛榊苅<E6A68A><E88B85> | 謌台サャ閭懷<E996AD> |
| **蜉溯<E89C89>螳梧紛諤?* | 笨?蝓コ遑€螳梧紛 | 笨?蜉溯<E89C89>蠑コ螟ァ | 蝓コ遑€螟溽畑 |
| **謌先悽** | 笨?ツ・0-50/譛?| 笶?ツ・800-1500/譛?| 謌台サャ閭懷<E996AD> |
| **螳樊命髫セ蠎ヲ** | 笨?邂€蜊?| 笞<><E7AC9E><EFBFBD> 髴€隕∝ュヲ荵?| 謌台サャ閭懷<E996AD> |
| **蜿ッ謇ゥ螻墓€?* | 笨?蜿ッ蜊<EFBDAF>コ?| 笨?蠑?| 蟷ウ謇<EFBDB3> |
| **蛻帑ク壼<EFBDB8>譛滄€ら畑** | 笨?螳檎セ<E6AA8E> | 笶?荳埼€ょ粋 | **謌台サャ閭懷<E996AD>** |
---
## <20>汐 陦悟勘蟒コ隶ョ
### 笨?遶句叉謇ァ陦鯉シ亥<EFBDBC>雍ケ莨伜喧<E4BC9C><E596A7>
1. **驟咲スョ髦ソ驥御コ全LS譌・蠢玲恪蜉。**<EFBFBD>?0蛻<30><EFBFBD>?
- SAE謗ァ蛻カ蜿ー蠑€蜷ッ譌・蠢鈴㊦髮?
- 驟咲スョ譌・蠢玲衍隸「
- 隶セ鄂ョ邂€蜊募相隴ヲ<E99AB4>亥ヲる漠隸ッ謨ー>10/蛻<><EFBFBD>?
2. **豺サ蜉<EFBDBB>髓蛾忠蜻願ュヲ<EFBDAD>亥庄騾会シ<E4BC9A>30蛻<30><EFBFBD>?*
- 蛻帛サコ髓蛾忠鄒、譛コ蝎ィ莠コ
- 豺サ蜉<EFBDBB> `common/monitoring/alerting.ts`
- 蜈ウ髞ョ髞呵ッッ蜿鷹€∝芦髓蛾忠
3. **莨伜喧逶第而謖<E8808C><E8AC96><EFBFBD>シ?0蛻<30><EFBFBD>?*
- 螳悟埋 `Metrics.recordApiLatency()`
- 螳壽悄隶ー蠖募<E8A096>髞ョ謖<EFBDAE><E8AC96><EFBFBD>
- 譌・蠢苓セ灘<EFBDBE>萓ソ莠惨LS蛻<53>
### 笶?證ゆク肴鴬陦鯉シ郁鰍逵∵<E980B5>譛ャ<E8AD9B><EFBDAC>
1. 笶?雍ュ荵ー髦ソ驥御コ閃SE<53>郁鰍逵<E9B08D>?00/譛茨シ<E88CA8>
2. 笶?雍ュ荵ー髦ソ驥御コ羨RMS<4D>郁鰍逵<E9B08D>?00-1000/譛茨シ<E88CA8>
### <20>套 6荳ェ譛亥錘螟崎ッ?
-<>シー豬<EFBDB0>㍼蠅樣柄諠<E69F84><E8ABA0>
-<>シー逶第而髴€豎ょ序蛹?
- 蜀ウ螳壽弍蜷ヲ雍ュ荵ーARMS
-<>シー譏ッ蜷ヲ髴€隕∝セョ譛榊苅譫カ譫<EFBDB6><EFBFBD>SE<53>?
---
## <20>直 扈吝<E68988>遲冶€<E586B6>噪荳€蜿・隸<EFBDA5>
**蛻帑ク壼<EFBDB8>譛滂シ御ク埼怙隕∬エュ荵ーMSE蜥窟RMS縲?*
**逅<><EFBFBD>?*
1. 謌台サャ逧<EFBDAC>渕遑€隶セ譁ス蟾イ扈剰ヲ<E589B0>尠莠<E5B0A0><E88EA0>ク蠢<EFBDB8>怙豎?
2. 闃ら怐ツ・10,000-18,000/蟷エ逧<EFBDB4><E980A7>譛ャ
3.<>㍼隗<E38DBC>ィ。荳埼怙隕∽シ∽ク夂コァ逶第而
4. 蜿ッ莉・蝨ィ謌宣柄蜷主<E89CB7><EFBFBD>コ?
**鬟朱勦<E69CB1>?* 譫∽ス趣シ域<EFBDBC>莉ャ譛牙ョ梧紛逧<E7B49B>尅謗ァ蜥梧律蠢嶺ス鍋ウサ<EFBDB3>?
**蟒コ隶ョ<E99AB6>?* 謚願鰍逵∫噪雍ケ逕ィ謚募<E8AC9A>蛻ーLLM隹<4D>畑謌先悽蜥悟クょ惻謗ィ蟷?
---
**譁<>。」霍ッ蠕<EFBDAF>シ?* `docs/08-鬘ケ逶ョ邂。逅<EFBDA1>/04-謚€譛ッ蜀ウ遲?2025-11-18-MSE荳拶RMS驥<53>エュ蜀ウ遲門<E981B2><EFBFBD>.md`
**蜀ウ遲也サ楢ョコ<EFBDAE>?* 蛻帑ク壼<EFBDB8>譛滉ク崎エュ荵ーMSE蜥窟RMS<4D>御スソ逕ィ邇ー譛牙<E8AD9B>雍ケ譁ケ譯?
**螟崎ッ<E5B48E>慮髣エ<E9ABA3>?* 6荳ェ譛亥錘<E4BAA5><E98C98>2025蟷?譛茨シ画<EFBDBC><EFBFBD>㍼遯∫<E981AF>?荳?螟ゥ譌カ
**扈エ謚、閠<EFBDA4><EFBFBD>** 謚€譛ッ蝗「髦?