HaHafeng
1b53ab9d52
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%)
778 lines
22 KiB
Markdown
778 lines
22 KiB
Markdown
# 蟷ｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ隗<EFBDBD><E99A97><EFBFBD><EFBFBD>latform Infrastructure Plan<61>?
|
||
|
||
> **譁<>｡｣迚域悽<E59F9F>?* V1.0
|
||
> **蛻帛ｻｺ譌･譛滂ｼ?* 2025-11-16
|
||
> **騾ら畑蟇ｹ雎｡<E99B8E>?* 譫ｶ譫<EFBDB6>ｸ医∝錘遶ｯ蠑蜿代∬ｿ千ｻ?
|
||
> **譁<>｡｣迥ｶ諤<EFBDB6>ｼ<EFBFBD>** 螳樊命隗<E591BD><E99A97>
|
||
> **扈ｴ謚､閠<EFBDA4>ｼ<EFBFBD>** 譫ｶ譫<EFBDB6>屬髦<E5B1AC>
|
||
|
||
---
|
||
|
||
## <20>搭 譁<>｡｣隸ｴ譏<EFBDB4>
|
||
|
||
譛ｬ譁<EFBFBD>｡｣譏ｯ螢ｹ隸∝ｾｪAI遘醍<EFBFBD>泌ｹｳ蜿ｰ逧?*蟷ｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ隗<EFBDBD><E99A97>譁<EFBFBD>｡｣**<2A>悟ｮ壻ｹ我ｺ<E68891>ｼ?
|
||
|
||
1. **譬ｸ蠢<EFBDB8>怙豎?*<2A>壼ｹｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ髴隕∬ｧ｣蜀ｳ逧<EFBDB3>琉鬚<E79089>
|
||
2. **隶ｾ隶｡譁ｹ譯<EFBDB9>**<EFBFBD>壽橿譛ｯ譫ｶ譫<EFBFBD>柱螳樒鴫譁ｹ譯<EFBFBD>
|
||
3. **螳樊命隶｡蛻<EFBDA1>**<EFBFBD>壼<EFBFBD>髦ｶ谿ｵ逧<EFBFBD>ｮ樊命霍ｯ郤ｿ蝗ｾ
|
||
4. **鬪梧噺譬<E599BA>㊥**<EFBFBD>壽ｯ丈ｸｪ讓｡蝮礼噪鬪梧噺譬<EFBFBD>㊥
|
||
|
||
**譬ｸ蠢<EFBDB8>岼譬<E5B2BC>ｼ?*
|
||
- 笨?謾ｯ謖∵悽蝨ｰ蠑蜿大柱莠醍ｫｯ驛ｨ鄂ｲ譌<EFBDB2>郛晏<E9839B>謐｢
|
||
- 笨?謾ｯ謖￣RD螳壻ｹ臥<EFBDB9>?遘埼Κ鄂ｲ蠖｢諤<EFBDA2>ｼ井ｺ醍ｫｯSaaS縲∫ｧ∵怏蛹悶∝黒譛ｺ迚医∵ｷｷ蜷茨ｼ<E88CA8>
|
||
- 笨?謾ｯ謖∵ｨ｡蝮怜喧扈<E596A7>粋蜚ｮ蜊厄ｼ井ｸ謎ｸ夂沿縲<E6B2BF>ｫ倡ｺｧ迚医∵覧闊ｰ迚茨ｼ?
|
||
- 笨?謠蝉ｾ幃夂畑閭ｽ蜉幢ｼ梧園譛我ｸ壼苅讓｡蝮礼峩謗･螟咲<E89E9F>?
|
||
|
||
---
|
||
|
||
## <20>識 髴豎りレ譎?
|
||
|
||
### 1. 荳壼苅髴豎ゑｼ域擂閾ｪPRD<52>?
|
||
|
||
譬ｹ謐ｮ [09-諤ｻ菴馴怙豎よ枚譯?PRD).md](../00-邉ｻ扈滓ｻ菴楢ｮｾ隶｡/09-諤ｻ菴馴怙豎よ枚譯?PRD).md)<29>悟ｹｳ蜿ｰ蠢<EFBDB0>｡ｻ謾ｯ謖<EFBDAF>ｼ<EFBFBD>
|
||
|
||
| 髴豎<C280>D | 髴豎よ緒霑?| 謚譛ｯ謖第<E8AC96>?|
|
||
|--------|---------|---------|
|
||
| **NFR-1.1** | 莠醍ｫｯSaaS迚茨ｼ亥､夂ｧ滓姐縲<E5A790>ｫ伜庄逕ｨ<E98095>?| Serverless譫ｶ譫<EFBDB6>∬<C280>蜉ｨ謇ｩ郛ｩ螳ｹ |
|
||
| **NFR-1.2** | 遘∵怏蛹夜Κ鄂ｲ<E98482>域焚謐ｮ荳榊<E88DB3>蜀<EFBFBD>ｽ托ｼ?| 譛ｬ蝨ｰ蟄伜お縲∵悽蝨ｰ謨ｰ謐ｮ蠎<EFBDAE> |
|
||
| **NFR-1.3** | 蜊墓惻迚茨ｼ<E88CA8>100%譛ｬ蝨ｰ蛹厄ｼ<E58E84> | 遖ｻ郤ｿ霑占｡後∵悽蝨ｰ譁<EFBDB0>ｻｶ邉ｻ扈?|
|
||
| **NFR-1.4** | 豺ｷ蜷磯Κ鄂ｲ<E98482>磯Κ蛻<CE9A>悽蝨?驛ｨ蛻<EFBDA8>ｺ醍ｫｯ<EFBDAB>?| 轣ｵ豢ｻ逧<EFBDBB><E980A7>鄂ｮ蛻<EFBDAE><E89BBB>?|
|
||
| **NFR-2.1** | SaaS螟夂沿譛ｬ<E8AD9B>井ｸ謎ｸ夂沿縲<E6B2BF>ｫ倡ｺｧ迚医∵覧闊ｰ迚茨ｼ?| Feature Flag縲∵ｨ｡蝮怜喧 |
|
||
| **NFR-2.2** | 讓｡蝮怜喧蜚ｮ蜊厄ｼ井ｻｻ菴墓ｨ｡蝮怜庄迢ｬ遶句醗蜊厄ｼ<E58E84> | 譚ｾ閠ｦ蜷域楔譫<E6A594> |
|
||
| **NFR-2.3** | AI謌先悽蜿ｯ謗ｧ<E8AC97>亥勘諤∝<E8ABA4>謐｢LLM<4C>?| 騾る<E9A8BE>蝎ｨ讓｡蠑?|
|
||
|
||
### 2. 謚譛ｯ髴豎ゑｼ域擂閾ｪ莠大次逕滓楔譫<E6A594>ｼ<EFBFBD>
|
||
|
||
譬ｹ謐ｮ莠大次逕滄Κ鄂ｲ譫ｶ譫<EFBFBD>ｼ磯仭驥御ｺ?Serverless + RDS + OSS<53>会ｼ悟ｹｳ蜿ｰ蠢<EFBDB0>｡ｻ<EFBDA1>?
|
||
|
||
| 謚譛ｯ髴豎?| 隸ｴ譏<EFBDB4> | 莨伜<E88EA8>郤?|
|
||
|---------|------|--------|
|
||
| **譌<>迥ｶ諤∝ｺ皮<EFBDBA>?* | 荳堺ｾ晁ｵ匁悽蝨ｰ譁<EFBDB0>ｻｶ邉ｻ扈滓<E68988>蜀<EFBFBD>ｭ倡憾諤?| P0 |
|
||
| **蟄伜お謚ｽ雎｡** | 謾ｯ謖∵悽蝨ｰ蟄伜お蜥薫SS譌<53>郛晏<E9839B>謐｢ | P0 |
|
||
| **謨ｰ謐ｮ蠎楢ｿ樊磁豎<E7A381>** | 髦ｲ豁｢Serverless謇ｩ螳ｹ蟇ｼ閾ｴ霑樊磁謨ｰ雜<EFBDB0><E99B9C>?| P0 |
|
||
| **譬<>㊥蛹匁律蠢?* | 霎灘<E99C8E>蛻ｰstdout<75>梧髪謖<E9ABAA>寔荳ｭ謾ｶ髮?| P0 |
|
||
| **蠑よｭ･莉ｻ蜉｡** | 髟ｿ譌ｶ髣ｴ莉ｻ蜉｡蠢<EFBDA1>｡ｻ蠑よｭ･螟<EFBDA5>炊<EFBFBD>磯∩蜈崎ｶ<E5B48E>慮<EFBFBD>?| P0 |
|
||
| **蛻<>ｸ<EFBFBD>ｼ冗ｼ灘ｭ?* | 螟壼ｮ樔ｾ句<EFBDBE>莠ｫ郛灘ｭ?| P1 |
|
||
| **蛛･蠎ｷ譽譟?* | SAE蟄俶ｴｻ蜥悟ｰｱ扈ｪ譽譟?| P1 |
|
||
| **逶第而謖<E8808C><E8AC96><EFBFBD>** | 謨ｰ謐ｮ蠎楢ｿ樊磁謨ｰ縲∽ｻｻ蜉｡髦溷<E9ABA6>遲<EFBFBD> | P1 |
|
||
|
||
---
|
||
|
||
## <20>女<EFBFBD>?隶ｾ隶｡譁ｹ譯<EFBDB9>
|
||
|
||
### 譬ｸ蠢<EFBDB8>ｮｾ隶｡蜴溷<E89CB4>
|
||
|
||
> **蟷ｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ騾夊ｿ<E5A48A>る<C280>蝎ｨ讓｡蠑擾ｼ<E693BE>dapter Pattern<72>牙ｮ樒鴫螟夂識蠅<E8AD98>髪謖<E9ABAA>**
|
||
|
||
```
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 荳壼苅讓｡蝮怜ｱ? 笏?
|
||
笏? ASL | AIA | PKB | DC | SSA | ST | UAM 笏?
|
||
笏? 蜿ｪ蜈ｳ豕ｨ荳壼苅騾ｻ霎托ｼ悟､咲畑蟷ｳ蜿ｰ閭ｽ蜉? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?import from '@/common/'
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 蟷ｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ螻ゑｼ<E38291>dapter Pattern<72>? 笏?
|
||
笏懌楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏?蟄伜お<E4BC9C>哭ocalAdapter 竊絶<E7AB8A> OSSAdapter 笏?
|
||
笏?郛灘ｭ假ｼ哺emoryCacheAdapter 竊絶<E7AB8A> RedisCacheAdapter 笏?
|
||
笏?莉ｻ蜉｡<E89C89>哺emoryQueueAdapter 竊絶<E7AB8A> DatabaseQueueAdapter 笏?
|
||
笏?譌･蠢暦ｼ咾onsoleLogger 竊絶<E7AB8A> 髦ｿ驥御ｺ全LS 笏?
|
||
笏?謨ｰ謐ｮ蠎難ｼ壽悽蝨ｰPostgreSQL 竊絶<E7AB8A> 髦ｿ驥御ｺ然DS<44>郁ｿ樊磁豎<E7A381><E8B18E>? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?邇ｯ蠅<EFBDAF>序驥丞<E9A9A5>謐｢
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 驛ｨ鄂ｲ邇ｯ蠅<EFBDAF>ｼ磯峺莉｣遐∵隼蜉ｨ<E89C89>? 笏?
|
||
笏? 譛ｬ蝨ｰ蠑蜿?| 莠醍ｫｯSaaS | 遘∵怏蛹夜Κ鄂?| 蜊墓惻迚? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
```
|
||
|
||
---
|
||
|
||
## <20>逃 蟷ｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ讓｡蝮玲ｸ<E78EB2>黒
|
||
|
||
### 讓｡蝮玲ｻ隗<EFBDBB>
|
||
|
||
| 讓｡蝮<EFBDA1> | 霍ｯ蠕<EFBDAF> | 莨伜<E88EA8>郤?| 隸ｴ譏<EFBDB4> |
|
||
|------|------|--------|------|
|
||
| **蟄伜お譛榊苅** | `common/storage/` | P0 | 譁<>ｻｶ荳贋ｼ<E8B48B>荳玖ｽｽ<EFBDBD>域悽蝨?OSS<53>?|
|
||
| **謨ｰ謐ｮ蠎楢ｿ樊磁豎<E7A381>** | `config/database.ts` | P0 | Prisma霑樊磁豎<E7A381>驟咲ｽ?|
|
||
| **譌･蠢礼ｳｻ扈<EFBDBB>** | `common/logging/` | P0 | 譬<>㊥蛹匁律蠢苓ｾ灘<EFBDBE>?|
|
||
| **邇ｯ蠅<EFBDAF><E8A085>鄂ｮ** | `config/env.ts` | P0 | 邇ｯ蠅<EFBDAF>序驥冗ｮ｡逅<EFBDA1> |
|
||
| **蠑よｭ･莉ｻ蜉｡** | `common/jobs/` | P0 | 髟ｿ譌ｶ髣ｴ莉ｻ蜉｡蠑よｭ･螟<EFBDA5><E89E9F>?|
|
||
| **郛灘ｭ俶恪蜉｡** | `common/cache/` | P1 | 蛻<>ｸ<EFBFBD>ｼ冗ｼ灘ｭ?|
|
||
| **蛛･蠎ｷ譽譟?* | `common/health/` | P1 | SAE蛛･蠎ｷ譽譟･遶ｯ轤?|
|
||
| **逶第而謖<E8808C><E8AC96><EFBFBD>** | `common/monitoring/` | P1 | 蜈ｳ髞ｮ謖<EFBDAE><E8AC96><EFBFBD>尅謗ｧ |
|
||
|
||
---
|
||
|
||
## <20>盗 隸ｦ扈<EFBDA6>ｮｾ隶｡
|
||
|
||
### 1. 蟄伜お譛榊苅<E6A68A><E88B85>torage Service<63>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?謾ｯ謖∵悽蝨ｰ蠑蜿托ｼ<E68998>ocalAdapter<65>?
|
||
- 笨?謾ｯ謖∽ｺ醍ｫｯ驛ｨ鄂ｲ<E98482><EFBDB2>SSAdapter<65>?
|
||
- 笨?荳壼苅莉｣遐<EFBDA3>峺謾ｹ蜉ｨ蛻<EFBDA8><E89BBB>?
|
||
|
||
#### 逶ｮ蠖慕ｻ捺桷
|
||
```
|
||
backend/src/common/storage/
|
||
笏懌楳笏 StorageAdapter.ts # 謗･蜿｣螳壻ｹ<E5A3BB>
|
||
笏懌楳笏 LocalAdapter.ts # 譛ｬ蝨ｰ螳樒鴫
|
||
笏懌楳笏 OSSAdapter.ts # OSS螳樒鴫
|
||
笏懌楳笏 StorageFactory.ts # 蟾･蜴らｱ?
|
||
笏披楳笏 index.ts # 扈滉ｸ蟇ｼ蜃ｺ
|
||
```
|
||
|
||
#### 謗･蜿｣螳壻ｹ<E5A3BB>
|
||
```typescript
|
||
// backend/src/common/storage/StorageAdapter.ts
|
||
export interface StorageAdapter {
|
||
upload(key: string, buffer: Buffer): Promise<string>
|
||
download(key: string): Promise<Buffer>
|
||
delete(key: string): Promise<void>
|
||
getUrl(key: string): string
|
||
}
|
||
```
|
||
|
||
#### 邇ｯ蠅<EFBDAF><E8A085>謐｢
|
||
```bash
|
||
# 譛ｬ蝨ｰ蠑蜿?
|
||
STORAGE_TYPE=local
|
||
|
||
# 逕滉ｺｧ邇ｯ蠅<EFBDAF>
|
||
STORAGE_TYPE=oss
|
||
OSS_REGION=oss-cn-hangzhou
|
||
OSS_BUCKET=aiclinical-prod
|
||
```
|
||
|
||
#### 荳壼苅讓｡蝮嶺ｽｿ逕ｨ
|
||
```typescript
|
||
import { storage } from '@/common/storage'
|
||
|
||
// 菴ｿ逕ｨ<E98095>井ｸ榊<EFBDB8>蠢<EFBFBD>悽蝨ｰ霑俶弍OSS<53>?
|
||
const url = await storage.upload('literature/123.pdf', buffer)
|
||
```
|
||
|
||
---
|
||
|
||
### 2. 謨ｰ謐ｮ蠎楢ｿ樊磁豎<E7A381><E8B18E><EFBFBD>atabase Connection Pool<6F>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?髦ｲ豁｢Serverless謇ｩ螳ｹ蟇ｼ閾ｴ霑樊磁謨ｰ雜<EFBDB0><E99B9C>?
|
||
- 笨?莨倬寉蜈ｳ髣ｭ霑樊磁
|
||
- 笨?霑樊磁謨ｰ逶第<E980B6>?
|
||
|
||
#### 譁<>ｻｶ菴咲ｽｮ
|
||
```
|
||
backend/src/config/database.ts
|
||
```
|
||
|
||
#### 霑樊磁豎<E7A381>驟咲ｽ?
|
||
```typescript
|
||
// 隶｡邂怜<E98282>蠑擾ｼ壽ｯ丞ｮ樔ｾ玖ｿ樊磁謨?= RDS譛螟ｧ霑樊磁謨ｰ / SAE譛螟ｧ螳樔ｾ区焚
|
||
// 遉ｺ萓具ｼ?00霑樊磁 / 20螳樔ｾ<E6A894> = 20霑樊磁/螳樔ｾ<E6A894>
|
||
|
||
import { PrismaClient } from '@prisma/client'
|
||
|
||
const connectionLimit = Math.floor(
|
||
Number(process.env.DB_MAX_CONNECTIONS || 400) /
|
||
Number(process.env.MAX_INSTANCES || 20)
|
||
)
|
||
|
||
export const prisma = new PrismaClient({
|
||
log: process.env.NODE_ENV === 'development' ? ['query', 'error'] : ['error'],
|
||
})
|
||
|
||
// 莨倬寉蜈ｳ髣ｭ
|
||
process.on('SIGTERM', async () => {
|
||
await prisma.$disconnect()
|
||
process.exit(0)
|
||
})
|
||
```
|
||
|
||
#### 邇ｯ蠅<EFBDAF>序驥<E5BA8F>
|
||
```bash
|
||
DB_MAX_CONNECTIONS=400 # RDS譛螟ｧ霑樊磁謨ｰ
|
||
MAX_INSTANCES=20 # SAE譛螟ｧ螳樔ｾ区焚
|
||
DATABASE_URL=postgresql://...
|
||
```
|
||
|
||
---
|
||
|
||
### 3. 譌･蠢礼ｳｻ扈滂ｼ<E6BB82>ogging<6E>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?莠大次逕滂ｼ壼宵霎灘<E99C8E>蛻ｰstdout<75>井ｸ榊<EFBDB8>譛ｬ蝨ｰ譁<EFBDB0>ｻｶ<EFBDBB><EFBDB6>
|
||
- 笨?JSON譬ｼ蠑擾ｼ井ｾｿ莠朱仭驥御ｺ全LS隗｣譫撰ｼ?
|
||
- 笨?扈滉ｸ逧<C280>律蠢玲<E8A0A2>ｼ蠑?
|
||
|
||
#### 逶ｮ蠖慕ｻ捺桷
|
||
```
|
||
backend/src/common/logging/
|
||
笏懌楳笏 logger.ts # 譌･蠢怜ｷ･蜈ｷ
|
||
笏披楳笏 index.ts # 蟇ｼ蜃ｺ
|
||
```
|
||
|
||
#### 螳樒鴫
|
||
```typescript
|
||
// backend/src/common/logging/logger.ts
|
||
import winston from 'winston'
|
||
|
||
export const logger = winston.createLogger({
|
||
level: process.env.LOG_LEVEL || 'info',
|
||
format: winston.format.combine(
|
||
winston.format.timestamp(),
|
||
winston.format.errors({ stack: true }),
|
||
winston.format.json()
|
||
),
|
||
defaultMeta: {
|
||
service: 'aiclinical-backend',
|
||
env: process.env.NODE_ENV,
|
||
instance: process.env.HOSTNAME
|
||
},
|
||
transports: [
|
||
new winston.transports.Console({
|
||
format: winston.format.json() // 箝?JSON譬ｼ蠑<EFBDBC>
|
||
})
|
||
]
|
||
})
|
||
```
|
||
|
||
#### 荳壼苅讓｡蝮嶺ｽｿ逕ｨ
|
||
```typescript
|
||
import { logger } from '@/common/logging'
|
||
|
||
logger.info('Screening started', { projectId, count: 100 })
|
||
logger.error('LLM API failed', { error: err.message })
|
||
```
|
||
|
||
---
|
||
|
||
### 4. 邇ｯ蠅<EFBDAF><E8A085>鄂ｮ<E98482><EFBDAE>nvironment Config<69>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?扈滉ｸ逧<C280><E980A7>鄂ｮ邂｡逅?
|
||
- 笨?譛ｬ蝨ｰ蠑蜿托ｼ<E68998>.env譁<76>ｻｶ
|
||
- 笨?逕滉ｺｧ邇ｯ蠅<EFBDAF>ｼ售AE邇ｯ蠅<EFBDAF>序驥<E5BA8F>
|
||
- 笨?蜷ｯ蜉ｨ譌ｶ鬪瑚ｯ∝ｿ<E2889D>怙驟咲ｽｮ
|
||
|
||
#### 譁<>ｻｶ菴咲ｽｮ
|
||
```
|
||
backend/src/config/env.ts
|
||
```
|
||
|
||
#### 螳樒鴫
|
||
```typescript
|
||
// backend/src/config/env.ts
|
||
import { config } from 'dotenv'
|
||
|
||
// 蜿ｪ蝨ｨ譛ｬ蝨ｰ蠑蜿大刈霓?.env 譁<>ｻｶ
|
||
if (process.env.NODE_ENV !== 'production') {
|
||
config()
|
||
}
|
||
|
||
export const env = {
|
||
// 蠎皮畑驟咲ｽｮ
|
||
NODE_ENV: process.env.NODE_ENV || 'development',
|
||
PORT: Number(process.env.PORT) || 3001,
|
||
|
||
// 謨ｰ謐ｮ蠎馴<E8A08E>鄂?
|
||
DATABASE_URL: process.env.DATABASE_URL!,
|
||
DB_MAX_CONNECTIONS: Number(process.env.DB_MAX_CONNECTIONS) || 400,
|
||
MAX_INSTANCES: Number(process.env.MAX_INSTANCES) || 20,
|
||
|
||
// 蟄伜お驟咲ｽｮ
|
||
STORAGE_TYPE: process.env.STORAGE_TYPE || 'local',
|
||
OSS_REGION: process.env.OSS_REGION,
|
||
OSS_BUCKET: process.env.OSS_BUCKET,
|
||
|
||
// 郛灘ｭ倬<EFBDAD>鄂ｮ
|
||
CACHE_TYPE: process.env.CACHE_TYPE || 'memory',
|
||
REDIS_HOST: process.env.REDIS_HOST,
|
||
|
||
// LLM驟咲ｽｮ
|
||
DEEPSEEK_API_KEY: process.env.DEEPSEEK_API_KEY,
|
||
QWEN_API_KEY: process.env.QWEN_API_KEY,
|
||
|
||
// 蜉溯<E89C89>蠑蜈?
|
||
ENABLED_MODULES: process.env.ENABLED_MODULES?.split(',') || [],
|
||
}
|
||
|
||
// 蜷ｯ蜉ｨ譌ｶ鬪瑚ｯ?
|
||
export function validateEnv() {
|
||
const required = ['DATABASE_URL']
|
||
for (const key of required) {
|
||
if (!process.env[key]) {
|
||
throw new Error(`Missing required env var: ${key}`)
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5. 蠑よｭ･莉ｻ蜉｡<E89C89><EFBDA1>sync Jobs<62>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?髟ｿ譌ｶ髣ｴ莉ｻ蜉｡<E89C89><EFBDA1>>10遘抵ｼ牙ｼよｭ･螟<EFBDA5>炊
|
||
- 笨?驕ｿ蜈拘erverless雜<73>慮<EFBFBD>?0遘抵ｼ<E68AB5>
|
||
- 笨?謾ｯ謖∬ｿ帛ｺｦ譟･隸｢
|
||
|
||
#### 逶ｮ蠖慕ｻ捺桷
|
||
```
|
||
backend/src/common/jobs/
|
||
笏懌楳笏 JobQueue.ts # 莉ｻ蜉｡髦溷<E9ABA6>謗･蜿｣
|
||
笏懌楳笏 MemoryQueue.ts # 譛ｬ蝨ｰ蠑蜿托ｼ亥<EFBDBC>蟄倬弌蛻暦ｼ?
|
||
笏懌楳笏 DatabaseQueue.ts # 逕滉ｺｧ邇ｯ蠅<EFBDAF>ｼ域焚謐ｮ蠎馴弌蛻暦ｼ?
|
||
笏懌楳笏 JobProcessor.ts # 莉ｻ蜉｡螟<EFBDA1>炊蝎?
|
||
笏披楳笏 index.ts
|
||
```
|
||
|
||
#### 謗･蜿｣螳壻ｹ<E5A3BB>
|
||
```typescript
|
||
// backend/src/common/jobs/JobQueue.ts
|
||
export interface Job<T = any> {
|
||
id: string
|
||
type: string
|
||
data: T
|
||
status: 'pending' | 'processing' | 'completed' | 'failed'
|
||
progress: number
|
||
result?: any
|
||
error?: string
|
||
createdAt: Date
|
||
updatedAt: Date
|
||
}
|
||
|
||
export interface JobQueue {
|
||
push<T>(type: string, data: T): Promise<Job<T>>
|
||
process<T>(type: string, handler: (job: Job<T>) => Promise<void>): void
|
||
getJob(id: string): Promise<Job | null>
|
||
updateProgress(id: string, progress: number): Promise<void>
|
||
}
|
||
```
|
||
|
||
#### 荳壼苅讓｡蝮嶺ｽｿ逕ｨ<E98095><EFBDA8>SL讓｡蝮礼､ｺ萓具ｼ?
|
||
```typescript
|
||
import { jobQueue } from '@/common/jobs'
|
||
|
||
// 1. 蛻帛ｻｺ莉ｻ蜉｡<E89C89>育ｫ句叉霑泌屓<E6B38C><E5B193>
|
||
app.post('/screening/start', async (req, res) => {
|
||
const job = await jobQueue.push('asl:screening', {
|
||
projectId: req.body.projectId,
|
||
literatureIds: req.body.literatureIds
|
||
})
|
||
|
||
res.send({ jobId: job.id }) // 箝?遶句叉霑泌屓<E6B38C>御ｸ咲ｭ牙ｾ<E78999>ｮ梧<EFBDAE>
|
||
})
|
||
|
||
// 2. 譟･隸｢霑帛ｺｦ
|
||
app.get('/screening/jobs/:id', async (req, res) => {
|
||
const job = await jobQueue.getJob(req.params.id)
|
||
res.send({
|
||
status: job.status,
|
||
progress: job.progress, // 0-100
|
||
result: job.result
|
||
})
|
||
})
|
||
|
||
// 3. 螟<>炊莉ｻ蜉｡<E89C89>亥錘蜿ｰ<E89CBF><EFBDB0>
|
||
jobQueue.process('asl:screening', async (job) => {
|
||
const { projectId, literatureIds } = job.data
|
||
|
||
for (let i = 0; i < literatureIds.length; i++) {
|
||
await screenLiterature(literatureIds[i])
|
||
await jobQueue.updateProgress(job.id, (i + 1) / literatureIds.length * 100)
|
||
}
|
||
})
|
||
```
|
||
|
||
---
|
||
|
||
### 6. 郛灘ｭ俶恪蜉｡<E89C89><EFBDA1>ache Service<63>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?謾ｯ謖∵悽蝨ｰ蠑蜿托ｼ<E68998>emoryCacheAdapter<65>?
|
||
- 笨?謾ｯ謖∫函莠ｧ邇ｯ蠅<EFBDAF>ｼ<EFBFBD>edisCacheAdapter<65>?
|
||
- 笨?螟壼ｮ樔ｾ句<EFBDBE>莠ｫ郛灘ｭ?
|
||
|
||
#### 逶ｮ蠖慕ｻ捺桷
|
||
```
|
||
backend/src/common/cache/
|
||
笏懌楳笏 CacheAdapter.ts # 謗･蜿｣螳壻ｹ<E5A3BB>
|
||
笏懌楳笏 MemoryCacheAdapter.ts # 譛ｬ蝨ｰ螳樒鴫
|
||
笏懌楳笏 RedisCacheAdapter.ts # Redis螳樒鴫
|
||
笏懌楳笏 CacheFactory.ts # 蟾･蜴らｱ?
|
||
笏披楳笏 index.ts
|
||
```
|
||
|
||
#### 謗･蜿｣螳壻ｹ<E5A3BB>
|
||
```typescript
|
||
export interface CacheAdapter {
|
||
get<T>(key: string): Promise<T | null>
|
||
set(key: string, value: any, ttl?: number): Promise<void>
|
||
delete(key: string): Promise<void>
|
||
clear(): Promise<void>
|
||
}
|
||
```
|
||
|
||
#### 邇ｯ蠅<EFBDAF><E8A085>謐｢
|
||
```bash
|
||
# 譛ｬ蝨ｰ蠑蜿?
|
||
CACHE_TYPE=memory
|
||
|
||
# 逕滉ｺｧ邇ｯ蠅<EFBDAF>
|
||
CACHE_TYPE=redis
|
||
REDIS_HOST=r-***.redis.aliyuncs.com
|
||
```
|
||
|
||
---
|
||
|
||
### 7. 蛛･蠎ｷ譽譟･<E8AD9F><EFBDA5>ealth Check<63>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?SAE蟄俶ｴｻ譽譟･<E8AD9F><EFBDA5>/health/liveness<73>?
|
||
- 笨?SAE蟆ｱ扈ｪ譽譟･<E8AD9F><EFBDA5>/health/readiness<73>?
|
||
- 笨?譽譟･萓晁ｵ匁恪蜉｡<E89C89>域焚謐ｮ蠎難ｼ<E99BA3>
|
||
|
||
#### 逶ｮ蠖慕ｻ捺桷
|
||
```
|
||
backend/src/common/health/
|
||
笏懌楳笏 healthCheck.ts
|
||
笏披楳笏 index.ts
|
||
```
|
||
|
||
#### 螳樒鴫
|
||
```typescript
|
||
import { FastifyInstance } from 'fastify'
|
||
import { prisma } from '@/config/database'
|
||
|
||
export async function registerHealthRoutes(app: FastifyInstance) {
|
||
// 蟄俶ｴｻ譽譟?
|
||
app.get('/health/liveness', async () => {
|
||
return { status: 'ok', timestamp: Date.now() }
|
||
})
|
||
|
||
// 蟆ｱ扈ｪ譽譟?
|
||
app.get('/health/readiness', async () => {
|
||
try {
|
||
await prisma.$queryRaw`SELECT 1`
|
||
return {
|
||
status: 'ready',
|
||
checks: { database: 'ok' }
|
||
}
|
||
} catch (error) {
|
||
return {
|
||
status: 'not_ready',
|
||
checks: { database: 'failed' }
|
||
}
|
||
}
|
||
})
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 8. 逶第而謖<E8808C><E8AC96><EFBFBD>ｼ<EFBFBD>onitoring<6E>?
|
||
|
||
#### 隶ｾ隶｡逶ｮ譬<EFBDAE>
|
||
- 笨?謨ｰ謐ｮ蠎楢ｿ樊磁謨ｰ逶第而
|
||
- 笨?蜈ｳ髞ｮ謖<EFBDAE><E8AC96><EFBFBD>相隴ｦ
|
||
|
||
#### 逶ｮ蠖慕ｻ捺桷
|
||
```
|
||
backend/src/common/monitoring/
|
||
笏懌楳笏 metrics.ts
|
||
笏披楳笏 index.ts
|
||
```
|
||
|
||
#### 螳樒鴫
|
||
```typescript
|
||
import { prisma } from '@/config/database'
|
||
import { logger } from '@/common/logging'
|
||
import { env } from '@/config/env'
|
||
|
||
export class Metrics {
|
||
static async recordDBConnectionCount() {
|
||
const result = await prisma.$queryRaw`
|
||
SELECT count(*) as count
|
||
FROM pg_stat_activity
|
||
WHERE datname = current_database()
|
||
`
|
||
|
||
const count = result[0].count
|
||
logger.info('DB connection count', { count })
|
||
|
||
// 蜻願ｭｦ<EFBDAD>夊ｿ樊磁謨ｰ雜<EFBDB0>ｿ<EFBFBD>80%
|
||
if (count > env.DB_MAX_CONNECTIONS * 0.8) {
|
||
logger.warn('DB connection pool near limit', {
|
||
current: count,
|
||
max: env.DB_MAX_CONNECTIONS
|
||
})
|
||
}
|
||
|
||
return count
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## <20>套 螳樊命隶｡蛻<EFBDA1>
|
||
|
||
### 諤ｻ菴捺慮髣ｴ隗<EFBDB4><E99A97>
|
||
|
||
**鬚<>ｮ｡諤ｻ閠玲慮<E78EB2>?.5螟ｩ<EFBFBD><EFBFBD>20蟆乗慮<EFBFBD>?*
|
||
|
||
```
|
||
Day 1: 譬ｸ蠢<EFBDB8>渕遑隶ｾ譁ｽ<E8AD81><EFBDBD>0讓｡蝮暦ｼ? 8蟆乗慮
|
||
Day 2: 霎<>勧蝓ｺ遑隶ｾ譁ｽ<E8AD81><EFBDBD>1讓｡蝮暦ｼ? 豬玖ｯ<E78E96> 8蟆乗慮
|
||
Day 3: 譁<>｡｣譖ｴ譁ｰ 4蟆乗慮
|
||
```
|
||
|
||
---
|
||
|
||
### Day 1<>壽<EFBFBD>ｸ蠢<EFBDB8>渕遑隶ｾ譁ｽ<E8AD81><EFBDBD>0讓｡蝮暦ｼ?
|
||
|
||
#### 荳雁壕<E99B81>?蟆乗慮<E4B997>?
|
||
|
||
**Task 1.1<EFBFBD>壼ｭ伜お譛榊苅<EFBFBD><EFBFBD>2蟆乗慮<EFBFBD>?*
|
||
- [ ] 蛻帛ｻｺ `backend/src/common/storage/` 逶ｮ蠖<EFBDAE>
|
||
- [ ] 螳樒鴫 `StorageAdapter.ts`<EFBFBD>域磁蜿｣螳壻ｹ会ｼ<EFBFBD>
|
||
- [ ] 螳樒鴫 `LocalAdapter.ts`<EFBFBD>域悽蝨ｰ螳樒鴫<EFBFBD><EFBFBD>
|
||
- [ ] 螳樒鴫 `OSSAdapter.ts`<EFBFBD><EFBFBD>SS螳樒鴫<EFBFBD>碁｢<EFBFBD>蕗<EFBFBD><EFBFBD>
|
||
- [ ] 螳樒鴫 `StorageFactory.ts`<EFBFBD>亥ｷ･蜴らｱｻ<EFBFBD>?
|
||
- [ ] 蛻帛ｻｺ `index.ts`<EFBFBD>育ｻ滉ｸ蟇ｼ蜃ｺ<EFBFBD>?
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?LocalAdapter 蜿ｯ豁｣蟶?upload/download
|
||
- 笨?騾夊ｿ<E5A48A>識蠅<E8AD98>序驥<E5BA8F> `STORAGE_TYPE` 蛻<>困
|
||
- 笨?蜊募<E89C8A>豬玖ｯ暮夊ｿ<E5A48A>
|
||
|
||
**Task 1.2<EFBFBD>壽焚謐ｮ蠎楢ｿ樊磁豎<EFBFBD><EFBFBD><EFBFBD>2蟆乗慮<EFBFBD>?*
|
||
- [ ] 譖ｴ譁ｰ `backend/src/config/database.ts`
|
||
- [ ] 豺ｻ蜉<EFBDBB>霑樊磁豎<E7A381>驟咲ｽ?
|
||
- [ ] 豺ｻ蜉<EFBDBB>莨倬寉蜈ｳ髣ｭ騾ｻ霎<EFBDBB>
|
||
- [ ] 豺ｻ蜉<EFBDBB>邇ｯ蠅<EFBDAF>序驥城ｪ瑚ｯ<E7919A>
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?Prisma Client 豁｣遑ｮ驟咲ｽｮ霑樊磁豎?
|
||
- 笨?蜷ｯ蜉ｨ譌ｶ鬪瑚ｯ∫識蠅<E8AD98>序驥?
|
||
- 笨?SIGTERM菫｡蜿ｷ莨倬寉蜈ｳ髣ｭ
|
||
|
||
---
|
||
|
||
#### 荳句壕<E58FA5>?蟆乗慮<E4B997>?
|
||
|
||
**Task 1.3<EFBFBD>壽律蠢礼ｳｻ扈滂ｼ<EFBFBD>2蟆乗慮<EFBFBD>?*
|
||
- [ ] 蛻帛ｻｺ `backend/src/common/logging/` 逶ｮ蠖<EFBDAE>
|
||
- [ ] 螳樒鴫 `logger.ts`<EFBFBD><EFBFBD>inston驟咲ｽｮ<EFBFBD>?
|
||
- [ ] 驟咲ｽｮJSON譬ｼ蠑剰ｾ灘<EFBDBE>
|
||
- [ ] 蛻帛ｻｺ `index.ts`<EFBFBD>亥ｯｼ蜃ｺ<EFBFBD><EFBFBD>
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?譌･蠢苓ｾ灘<EFBDBE>蛻ｰstdout<75><74>SON譬ｼ蠑擾ｼ?
|
||
- 笨?蛹<>性timestamp縲《ervice縲‘nv遲牙<E981B2>菫｡諱ｯ
|
||
- 笨?謾ｯ謖∽ｸ榊酔譌･蠢礼ｺｧ蛻ｫ<E89BBB><EFBDAB>nfo/warn/error<6F>?
|
||
|
||
**Task 1.4<EFBFBD>壼ｼよｭ･莉ｻ蜉｡<EFBFBD><EFBFBD>2蟆乗慮<EFBFBD>?*
|
||
- [ ] 蛻帛ｻｺ `backend/src/common/jobs/` 逶ｮ蠖<EFBDAE>
|
||
- [ ] 螳樒鴫 `JobQueue.ts`<EFBFBD>域磁蜿｣螳壻ｹ会ｼ<EFBFBD>
|
||
- [ ] 螳樒鴫 `MemoryQueue.ts`<EFBFBD>亥<EFBFBD>蟄倬弌蛻暦ｼ<EFBFBD>
|
||
- [ ] 螳樒鴫 `DatabaseQueue.ts`<EFBFBD>域焚謐ｮ蠎馴弌蛻暦ｼ碁｢<EFBFBD>蕗<EFBFBD><EFBFBD>
|
||
- [ ] 螳樒鴫 `JobProcessor.ts`<EFBFBD>井ｻｻ蜉｡螟<EFBFBD>炊蝎ｨ<EFBFBD>?
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?蜿ｯ蛻帛ｻｺ莉ｻ蜉｡蟷ｶ遶句叉霑泌屓
|
||
- 笨?蜿ｯ譟･隸｢莉ｻ蜉｡霑帛ｺ?
|
||
- 笨?蜿ｯ蝨ｨ蜷主床螟<E5BA8A>炊莉ｻ蜉｡
|
||
|
||
---
|
||
|
||
### Day 2<>夊ｾ<E5A48A>勧蝓ｺ遑隶ｾ譁ｽ<E8AD81><EFBDBD>1讓｡蝮暦ｼ? 豬玖ｯ<E78E96>
|
||
|
||
#### 荳雁壕<E99B81>?蟆乗慮<E4B997>?
|
||
|
||
**Task 2.1<EFBFBD>夂識蠅<EFBFBD><EFBFBD>鄂ｮ<EFBFBD><EFBFBD>1蟆乗慮<EFBFBD>?*
|
||
- [ ] 譖ｴ譁ｰ `backend/src/config/env.ts`
|
||
- [ ] 扈滉ｸ邇ｯ蠅<EFBDAF>序驥丞ｮ壻ｹ<E5A3BB>
|
||
- [ ] 豺ｻ蜉<EFBDBB>蜷ｯ蜉ｨ鬪瑚ｯ∝<EFBDAF>謨ｰ
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?謇譛臥識蠅<E8AD98>序驥城寔荳ｭ邂｡逅?
|
||
- 笨?蜷ｯ蜉ｨ譌ｶ閾ｪ蜉ｨ鬪瑚ｯ∝ｿ<E2889D>怙驟咲ｽｮ
|
||
- 笨?謾ｯ謖∵悽蝨ｰ蠑蜿大柱逕滉ｺｧ邇ｯ蠅<EFBDAF>
|
||
|
||
**Task 2.2<EFBFBD>夂ｼ灘ｭ俶恪蜉｡<EFBFBD><EFBFBD>2蟆乗慮<EFBFBD>?*
|
||
- [ ] 蛻帛ｻｺ `backend/src/common/cache/` 逶ｮ蠖<EFBDAE>
|
||
- [ ] 螳樒鴫 `CacheAdapter.ts`<EFBFBD>域磁蜿｣螳壻ｹ会ｼ<EFBFBD>
|
||
- [ ] 螳樒鴫 `MemoryCacheAdapter.ts`<EFBFBD>亥<EFBFBD>蟄伜ｮ樒鴫<EFBFBD><EFBFBD>
|
||
- [ ] 螳樒鴫 `RedisCacheAdapter.ts`<EFBFBD><EFBFBD>edis螳樒鴫<EFBFBD>碁｢<EFBFBD>蕗<EFBFBD><EFBFBD>
|
||
- [ ] 螳樒鴫 `CacheFactory.ts`<EFBFBD>亥ｷ･蜴らｱｻ<EFBFBD>?
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?MemoryCacheAdapter 蜿ｯ豁｣蟶?get/set
|
||
- 笨?騾夊ｿ<E5A48A>識蠅<E8AD98>序驥丞<E9A9A5>謐｢
|
||
- 笨?謾ｯ謖ゝTL霑<4C>悄
|
||
|
||
**Task 2.3<EFBFBD>壼▼蠎ｷ譽譟･<EFBFBD><EFBFBD>1蟆乗慮<EFBFBD>?*
|
||
- [ ] 蛻帛ｻｺ `backend/src/common/health/` 逶ｮ蠖<EFBDAE>
|
||
- [ ] 螳樒鴫 `healthCheck.ts`
|
||
- [ ] 豕ｨ蜀<EFBDA8> `/health/liveness` 遶ｯ轤ｹ
|
||
- [ ] 豕ｨ蜀<EFBDA8> `/health/readiness` 遶ｯ轤ｹ
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?liveness遶ｯ轤ｹ豁｣蟶ｸ霑泌屓
|
||
- 笨?readiness遶ｯ轤ｹ譽譟･謨ｰ謐ｮ蠎楢ｿ樊磁
|
||
- 笨?髞呵ｯｯ譌ｶ霑泌屓豁｣遑ｮ迥ｶ諤?
|
||
|
||
---
|
||
|
||
#### 荳句壕<E58FA5>?蟆乗慮<E4B997>?
|
||
|
||
**Task 2.4<EFBFBD>夂尅謗ｧ謖<EFBFBD><EFBFBD><EFBFBD>ｼ<EFBFBD>1蟆乗慮<EFBFBD>?*
|
||
- [ ] 蛻帛ｻｺ `backend/src/common/monitoring/` 逶ｮ蠖<EFBDAE>
|
||
- [ ] 螳樒鴫 `metrics.ts`
|
||
- [ ] 螳樒鴫謨ｰ謐ｮ蠎楢ｿ樊磁謨ｰ逶第而
|
||
- [ ] 螳樒鴫蜻願ｭｦ騾ｻ霎<EFBDBB>
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?蜿ｯ譟･隸｢謨ｰ謐ｮ蠎楢ｿ樊磁謨?
|
||
- 笨?霑樊磁謨ｰ雜<EFBDB0>ｿ?0%譌ｶ蜻願ｭ?
|
||
- 笨?譌･蠢苓ｾ灘<EFBDBE>豁｣遑ｮ
|
||
|
||
**Task 2.5<EFBFBD>夐寔謌先ｵ玖ｯ包ｼ<EFBFBD>3蟆乗慮<EFBFBD>?*
|
||
- [ ] 郛門<E9839B>蟄伜お譛榊苅蜊募<E89C8A>豬玖ｯ<E78E96>
|
||
- [ ] 郛門<E9839B>譌･蠢礼ｳｻ扈溷黒蜈<E9BB92>ｵ玖ｯ<E78E96>
|
||
- [ ] 郛門<E9839B>郛灘ｭ俶恪蜉｡蜊募<E89C8A>豬玖ｯ<E78E96>
|
||
- [ ] 郛門<E9839B>蠑よｭ･莉ｻ蜉｡蜊募<E89C8A>豬玖ｯ<E78E96>
|
||
- [ ] 髮<><E9ABAE>豬玖ｯ包ｼ域園譛画ｨ｡蝮暦ｼ<E69AA6>
|
||
|
||
**鬪梧噺譬<E599BA>㊥**<EFBFBD>?
|
||
- 笨?謇譛牙黒蜈<E9BB92>ｵ玖ｯ暮夊ｿ<E5A48A>
|
||
- 笨?髮<><E9ABAE>豬玖ｯ暮夊ｿ<E5A48A>
|
||
- 笨?莉｣遐∬ｦ<E288AC>尠邇?> 80%
|
||
|
||
---
|
||
|
||
### Day 3<>壽枚譯｣譖ｴ譁?
|
||
|
||
#### 荳雁壕<E99B81>?蟆乗慮<E4B997>?
|
||
|
||
**Task 3.1<EFBFBD>壽峩譁ｰ譫ｶ譫<EFBFBD>枚譯｣<EFBFBD><EFBFBD>2蟆乗慮<EFBFBD>?*
|
||
- [ ] 譖ｴ譁ｰ `01-邉ｻ扈滓楔譫<E6A594><E8ADAB>螻りｮｾ隶｡.md`
|
||
- 蝨?蟷ｳ蜿ｰ蝓ｺ遑螻?遶<>闃ゆｸｭ隸ｦ扈<EFBDA6>喧蜷<E596A7>恪蜉?
|
||
- 豺ｻ蜉<EFBDBB>騾る<E9A8BE>蝎ｨ讓｡蠑剰ｯｴ譏?
|
||
- [ ] 譖ｴ譁ｰ `蜑榊錘遶ｯ讓｡蝮怜喧譫ｶ譫<EFBDB6>ｮｾ隶｡-V2.md`
|
||
- 譖ｴ譁ｰ backend 逶ｮ蠖慕ｻ捺桷
|
||
- 菴鍋鴫譁ｰ蠅樒<E8A085>?common/ 蟄先ｨ｡蝮?
|
||
|
||
**Task 3.2<EFBFBD>壽峩譁ｰ螳樊命譁<EFBFBD>｡｣<EFBFBD><EFBFBD>1蟆乗慮<EFBFBD>?*
|
||
- [ ] 譖ｴ譁ｰ `09-譫ｶ譫<EFBDB6>ｮ樊命/03-莠大次逕滄Κ鄂ｲ譫ｶ譫<EFBDB6>欠蜊?md`
|
||
- 豺ｻ蜉<EFBDBB>蟷ｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ遶<EFBDBD>闃<EFBFBD>
|
||
- 譖ｴ譁ｰ邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ遉ｺ萓<EFBDBA>
|
||
|
||
**Task 3.3<EFBFBD>夂ｮ蛹泡SL譁<EFBFBD>｡｣<EFBFBD>?蟆乗慮<E4B997>?*
|
||
- [ ] 譖ｴ譁ｰ `03-荳壼苅讓｡蝮<EFBDA1>/ASL-AI譎ｺ閭ｽ譁<EFBDBD>鍵/04-蠑蜿題ｮ｡蛻?02-譬<>｢俶遭隕∝<E99A95>遲帛ｼ蜿題ｮ｡蛻?md`
|
||
- 遘ｻ髯､"蛻帛ｻｺ蟄伜お謚ｽ雎｡螻?莉ｻ蜉｡
|
||
- 豺ｻ蜉<EFBDBB>"蜑咲ｽｮ譚｡莉ｶ<E88E89>壼ｹｳ蜿ｰ蟾ｲ謠蝉ｾ<E89D89>"
|
||
- [ ] 譖ｴ譁ｰ `03-荳壼苅讓｡蝮<EFBDA1>/ASL-AI譎ｺ閭ｽ譁<EFBDBD>鍵/04-蠑蜿題ｮ｡蛻?03-莉ｻ蜉｡蛻<EFBDA1>ｧ｣.md`
|
||
- 遘ｻ髯､蟄伜お謚ｽ雎｡螻ゆｻｻ蜉?
|
||
- 譖ｴ譁ｰ鬪梧噺譬<E599BA>㊥
|
||
|
||
---
|
||
|
||
## <20>識 鬪梧噺譬<E599BA>㊥
|
||
|
||
### 諤ｻ菴馴ｪ梧噺譬<E599BA>㊥
|
||
|
||
- [ ] **蜉溯<E89C89>螳梧紛諤?*<2A>壽園譛臼0讓｡蝮怜ｮ樒鴫螳梧<E89EB3>
|
||
- [ ] **豬玖ｯ戊ｦ<E6888A>尠**<EFBFBD>壼黒蜈<EFBFBD>ｵ玖ｯ戊ｦ<EFBFBD>尠邇<EFBFBD> > 80%
|
||
- [ ] **譁<>｡｣螳梧紛諤?*<2A>壽園譛画楔譫<E6A594>枚譯｣譖ｴ譁ｰ螳梧<E89EB3>?
|
||
- [ ] **螟夂識蠅<E8AD98>髪謖?*<2A>壽悽蝨ｰ蠑蜿大柱莠醍ｫｯ驛ｨ鄂ｲ鬪瑚ｯ<E7919A>夊ｿ<E5A48A>
|
||
- [ ] **荳壼苅讓｡蝮鈴ｪ瑚ｯ<E7919A>**<EFBFBD>哂SL讓｡蝮怜庄豁｣蟶ｸ菴ｿ逕ｨ蟷ｳ蜿ｰ閭ｽ蜉?
|
||
|
||
### 邇ｯ蠅<EFBDAF>ｪ瑚ｯ∫洸髦ｵ
|
||
|
||
| 鬪瑚ｯ<E7919A>｡?| 譛ｬ蝨ｰ蠑蜿?| 莠醍ｫｯSaaS | 遘∵怏蛹夜Κ鄂?| 蜊墓惻迚?|
|
||
|-------|---------|---------|-----------|--------|
|
||
| 蟄伜お譛榊苅 | 笨?LocalAdapter | 笨?OSSAdapter | 笨?LocalAdapter | 笨?LocalAdapter |
|
||
| 謨ｰ謐ｮ蠎楢ｿ樊<EFBDBF>?| 笨?譛ｬ蝨ｰPostgreSQL | 笨?髦ｿ驥御ｺ然DS | 笨?蜀<>ｽ善ostgreSQL | 笨?SQLite |
|
||
| 郛灘ｭ俶恪蜉｡ | 笨?Memory | 笨?Redis | 笨?蜀<>ｽ然edis | 笨?Memory |
|
||
| 譌･蠢礼ｳｻ扈<EFBDBB> | 笨?Console | 笨?髦ｿ驥御ｺ全LS | 笨?Console | 笨?Console |
|
||
| 蠑よｭ･莉ｻ蜉｡ | 笨?MemoryQueue | 笨?DatabaseQueue | 笨?DatabaseQueue | 笨?MemoryQueue |
|
||
| 蛛･蠎ｷ譽譟?| 笨?OK | 笨?OK | 笨?OK | N/A |
|
||
|
||
---
|
||
|
||
## <20>噫 螳樊命蜷守噪謾ｶ逶<EFBDB6>
|
||
|
||
### 1. 蠑蜿第譜邇<E8AD9C>署蜊?
|
||
|
||
| 謖<><E8AC96><EFBFBD> | 謾ｹ騾<EFBDB9>蜑<EFBFBD> | 謾ｹ騾<EFBDB9>蜷<EFBFBD> | 謠仙合 |
|
||
|------|-------|-------|------|
|
||
| 荳壼苅讓｡蝮怜ｼ蜿第慮髣?| 髴隕∝ｮ樒鴫蟄伜お遲牙渕遑隶ｾ譁ｽ | 逶ｴ謗･菴ｿ逕ｨ蟷ｳ蜿ｰ閭ｽ蜉<EFBDBD> | **闃ら怐30%** |
|
||
| 譁ｰ讓｡蝮嶺ｸ頑焔譌ｶ髣?| 髴隕∝ｭｦ荵<EFBDA6>蝓ｺ遑隶ｾ譁ｽ | 蜿ｪ髴蜈ｳ豕ｨ荳壼苅騾ｻ霎<EFBDBB> | **闃ら怐50%** |
|
||
| 莉｣遐∝､咲畑邇?| 豈丈ｸｪ讓｡蝮鈴㍾螟榊ｮ樒鴫 | 謇譛画ｨ｡蝮怜､咲<EFBDA4>?| **謠仙合80%** |
|
||
|
||
### 2. 驛ｨ鄂ｲ轣ｵ豢ｻ諤?
|
||
|
||
| 驛ｨ鄂ｲ蠖｢諤?| 謾ｯ謖∵ュ蜀ｵ | 蛻<>困謌先悽 |
|
||
|---------|---------|---------|
|
||
| 莠醍ｫｯSaaS | 笨?螳悟<E89EB3>謾ｯ謖<EFBDAF> | 菫ｮ謾ｹ邇ｯ蠅<EFBDAF>序驥<E5BA8F> |
|
||
| 遘∵怏蛹夜Κ鄂?| 笨?螳悟<E89EB3>謾ｯ謖<EFBDAF> | 菫ｮ謾ｹ邇ｯ蠅<EFBDAF>序驥<E5BA8F> |
|
||
| 蜊墓惻迚?| 笨?螳悟<E89EB3>謾ｯ謖<EFBDAF> | 菫ｮ謾ｹ邇ｯ蠅<EFBDAF>序驥<E5BA8F> |
|
||
| 豺ｷ蜷磯Κ鄂ｲ | 笨?螳悟<E89EB3>謾ｯ謖<EFBDAF> | 謖画ｨ｡蝮鈴<E89DAE>鄂?|
|
||
|
||
### 3. 蝠<>ｸ壽ｨ｡蠑冗<E8A091>豢ｻ諤?
|
||
|
||
| 蝠<>ｸ壽ｨ｡蠑<EFBDA1> | 謾ｯ謖∵ュ蜀ｵ |
|
||
|---------|---------|
|
||
| 荳謎ｸ夂沿<E5A482>磯Κ蛻<CE9A>ｨ｡蝮暦ｼ?| 笨?Feature Flag謗ｧ蛻ｶ |
|
||
| 鬮倡ｺｧ迚茨ｼ育ｻ<E882B2>粋讓｡蝮暦ｼ?| 笨?Feature Flag謗ｧ蛻ｶ |
|
||
| 譌苓芦迚茨ｼ亥<EFBDBC>驛ｨ讓｡蝮暦ｼ?| 笨?Feature Flag謗ｧ蛻ｶ |
|
||
| 蜊墓ｨ｡蝮怜醗蜊?| 笨?Docker髟懷ワ蛻<E383AF>ｱ<EFBFBD> |
|
||
|
||
### 4. 謚譛ｯ蛟ｺ蜉｡髯堺ｽ<E5A0BA>
|
||
|
||
- 笨?驕ｿ蜈埼㍾螟堺ｻ｣遐<EFBDA3>
|
||
- 笨?扈滉ｸ逧<C280>楔譫<E6A594>｣取<EFBDA3>?
|
||
- 笨?譏謎ｺ守ｻｴ謚､蜥悟合郤?
|
||
- 笨?譁ｰ莠ｺ蠢ｫ騾滉ｸ頑<EFBDB8>?
|
||
|
||
---
|
||
|
||
## <20>答 逶ｸ蜈ｳ譁<EFBDB3>｡｣
|
||
|
||
- [09-諤ｻ菴馴怙豎よ枚譯?PRD).md](../00-邉ｻ扈滓ｻ菴楢ｮｾ隶｡/09-諤ｻ菴馴怙豎よ枚譯?PRD).md) - 荳壼苅髴豎よ擂貅?
|
||
- [01-邉ｻ扈滓楔譫<E6A594><E8ADAB>螻りｮｾ隶｡.md](../00-邉ｻ扈滓ｻ菴楢ｮｾ隶｡/01-邉ｻ扈滓楔譫<E6A594><E8ADAB>螻りｮｾ隶｡.md) - 諤ｻ菴捺楔譫<E6A594>ｮｾ隶｡
|
||
- [蜑榊錘遶ｯ讓｡蝮怜喧譫ｶ譫<EFBFBD>ｮｾ隶｡-V2.md](../00-邉ｻ扈滓ｻ菴楢ｮｾ隶｡/蜑榊錘遶ｯ讓｡蝮怜喧譫ｶ譫<EFBDB6>ｮｾ隶｡-V2.md) - 莉｣遐∫ｻ<E288AB>ｻ<EFBFBD>楔譫<E6A594>
|
||
- [03-莠大次逕滄Κ鄂ｲ譫ｶ譫<EFBDB6>欠蜊?md](./03-莠大次逕滄Κ鄂ｲ譫ｶ譫<EFBDB6>欠蜊?md) - 莠大次逕滄Κ鄂ｲ隸ｦ扈<EFBDA6>欠蜊?
|
||
- [08-莠大次逕溷ｼ蜿題ｧ<E9A18C><EFBDA7>?md](../04-蠑蜿題ｧ<E9A18C><EFBDA7>?08-莠大次逕溷ｼ蜿題ｧ<E9A18C><EFBDA7>?md) - 蠑蜿題ｧ<E9A18C><EFBDA7>?
|
||
|
||
---
|
||
|
||
## <20>統 蜿俶峩隶ｰ蠖<EFBDB0>
|
||
|
||
| 譌･譛<EFBDA5> | 迚域悽 | 蜿俶峩蜀<E5B3A9>ｮｹ | 蜿俶峩莠?|
|
||
|------|------|---------|--------|
|
||
| 2025-11-16 | V1.0 | 蛻晏ｧ狗沿譛ｬ<E8AD9B>悟ｮ壻ｹ牙ｹｳ蜿ｰ蝓ｺ遑隶ｾ譁ｽ隗<EFBDBD><E99A97> | 譫ｶ譫<EFBDB6>屬髦<E5B1AC> |
|
||
|
||
---
|
||
|
||
**譁<>｡｣扈捺據**
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|