AIclinicalresearch/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-22_Day2-Day3_LLM服务与验证系统开发.md

# 蜈ｨ譁<EFBDA8>､咲ｭ帛ｼ€蜿題ｮｰ蠖?- Day 2 & Day 3

**譌･譛<EFBDA5>**: 2025蟷?1譛?2譌? 
**蠑€蜿鷹亳谿?*: MVP譬ｸ蠢<EFBDB8>粥閭ｽ蠑€蜿? 
**雍溯ｴ｣莠?*: AI Assistant  
**迥ｶ諤?*: 笨?蟾ｲ螳梧<E89EB3>?

---

## <20>搭 蠑€蜿第ｦりｧ?

譛ｬ谺｡蠑€蜿大ｮ梧<EFBFBD>莠<EFBFBD><EFBFBD>譁<EFBFBD>､咲ｭ帷噪譬ｸ蠢キLM譛榊苅蜥碁ｪ瑚ｯ∫ｳｻ扈滂ｼ梧ｶｵ逶縫ay 2蜥轡ay 3逧<33>園譛芽ｮ｡蛻剃ｻｻ蜉｡<E89C89>悟ｹｶ霑幄｡御ｺ<E5BEA1><EFBDBA>髱｢逧<EFBDA2>寔謌先ｵ玖ｯ募柱髣ｮ鬚倅ｿｮ螟阪€?

---

## 笨?蟾ｲ螳梧<E89EB3>蜉溯<E89C89>?

### Day 2: LLM 12蟄玲ｮｵ譛榊苅

#### 2.1 謠千､ｺ隸榊ｷ･遞倶ｽ鍋ｳ?

**譬ｸ蠢<EFBDB8>枚莉ｶ**:
- `backend/src/modules/asl/fulltext-screening/prompts/system_prompt.md` (6,601蟄礼ｬｦ)
  - 9000+蟄苓ｯｦ扈<EFBDA6>ystem Prompt
  - Section-Aware遲也払<E4B99F>?豁･螟<EFBDA5>炊豕包ｼ?
  - Lost in the Middle邇ｰ雎｡郛楢ｧ｣
  - 閾ｪ鬪瑚ｯ∵惻蛻ｶ<E89BBB><EFBDB6>elf-Verification<6F>?
  - Chain-of-Thought蠑募ｯｼ

- `backend/src/modules/asl/fulltext-screening/prompts/user_prompt_template.md` (199陦?
  - PICOS荳贋ｸ区枚豕ｨ蜈?
  - 譁<>｡｣譬ｼ蠑剰<E8A091>騾ょｺ<E38287>
  - 蛻<>ｫ<EFBFBD>闃よ署蜿匁欠蠑?

- `backend/src/modules/asl/fulltext-screening/prompts/json_schema.json`
  - 荳･譬ｼ逧?2蟄玲ｮｵJSON Schema
  - 譛€蟆丞ｼ慕畑髟ｿ蠎ｦ郤ｦ譚滂ｼ遺<EFBDBC>?0蟄礼ｬｦ<EFBDAC>?
  - 蠢<>怙蟄玲ｮｵ<EFBDAE>嗔rocessing_log縲」erification

**Cochrane譬<65>㊥**<EFBFBD><EFBFBD>VP證ゆｸ榊刈霓ｽ<EFBFBD>?
- `prompts/cochrane_standards/髫乗惻蛹匁婿豕?md`
- `prompts/cochrane_standards/逶ｲ豕<EFBDB2>.md`
- `prompts/cochrane_standards/扈捺棡螳梧紛諤?md`

**Few-shot Examples**<EFBFBD>亥ｷｲ遘ｻ髯､莉･莨伜喧Prompt髟ｿ蠎ｦ<EFBFBD>?
- ~~`prompts/few_shot_examples/菫｡諱ｯ蝨ｨ荳ｭ髣ｴ菴咲ｽｮ譯井ｾ?md`~~ (蟾ｲ蛻<EFBDB2>髯?

**隶ｾ隶｡蜀ｳ遲<EFBDB3>**:
- 笨?菫晉蕗System Prompt蜥袈ser Prompt蜴溷ｧ狗沿譛ｬ<E8AD9B>域悴邊ｾ邂€<E98282>?
- 笨?遘ｻ髯､Few-shot examples莉･蜃丞ｰ善rompt髟ｿ蠎ｦ<E8A08E>井ｻ<E4BA95>74KB髯崎<E9ABAF>52KB<4B>?
- 笨?MVP髦ｶ谿ｵ荳榊刈霓ｽCochrane譬<65>㊥<EFBFBD>亥㍼蟆善rompt髟ｿ蠎ｦ縲<EFBDA6>剄菴取<E88FB4>譛ｬ<E8AD9B><EFBDAC>

#### 2.2 PromptBuilder譛榊苅

**譁<>ｻｶ**: `backend/src/modules/asl/common/llm/PromptBuilder.ts` (275陦?

**譬ｸ蠢<EFBDB8>粥閭ｽ**:
- 蜉ｨ諤∫ｻ<E288AB>｣<EFBFBD>ystem Prompt蜥袈ser Prompt
- 蜿ｯ騾牙刈霓ｽCochrane譬<65>㊥
- 蜿ｯ騾牙刈霓ｽFew-shot examples
- 扈捺棡郛灘ｭ假ｼ亥㍼蟆第枚莉ｶI/O<>?
- 讓｡譚ｿ蜿倬㍼譖ｿ謐｢<E8AC90><EFBDA2>ICOS縲∫ｺｳ蜈?謗帝勁譬<E58B81>㊥<EFBFBD>?

**MVP驟咲ｽｮ**:
```typescript
const DEFAULT_MVP_CONFIG = {
  loadCochraneStandards: false,  // 荳榊刈霓ｽCochrane譬<65>㊥
  fewShotExamples: [],           // 荳榊刈霓ｽFew-shot
};
```

**菫ｮ螟埼琉鬚<E79089>**:
- 笨?菫ｮ螟<EFBDAE> `__dirname` 蝨ｨES讓｡蝮嶺ｸｭ逧<EFBDAD>ｽｿ逕ｨ<E98095>域隼逕?`fileURLToPath`<EFBFBD>?
- 笨?菫ｮ螟肴枚莉ｶ霍ｯ蠕<EFBDAF>漠隸ｯ<E99AB8><EFBDAF>src/modules/modules/asl` 竊?`src/modules/asl`<60>?
- 笨?豺ｻ蜉<EFBDBB> `.js` 謇ｩ螻募錐莉･隨ｦ蜷<EFBDA6>S讓｡蝮苓ｧ<E88B93>激

#### 2.3 LLM12FieldsService譬ｸ蠢<EFBDB8>恪蜉｡

**譁<>ｻｶ**: `backend/src/modules/asl/common/llm/LLM12FieldsService.ts` (547陦?

**譬ｸ蠢<EFBDB8>粥閭ｽ**:
1. **Nougat莨伜<E88EA8>謠仙叙遲也払**
   - 闍ｱ譁⑰DF莨伜<E88EA8>菴ｿ逕ｨNougat<61>育ｻ捺桷蛹邦arkdown<77>?
   - 雍ｨ驥乗｣€譟?+ PyMuPDF髯咲ｺｧ
   - 謾ｯ謖∽ｸｭ譁⑰DF逶ｴ謗･菴ｿ逕ｨPyMuPDF

2. **蜿梧ｨ｡蝙句ｹｶ陦瑚ｰ<E7919A><EFBDB0>?*
   - DeepSeek-V3 + Qwen-Max
   - 菴ｿ逕ｨ `Promise.allSettled` 螳樒鴫螳ｹ髞<EFBDB9>
   - 荳€荳ｪ讓｡蝙句､ｱ雍･荳榊ｽｱ蜩榊嘗荳€荳?

3. **3螻<33>SON隗｣譫千ｭ也払**<EFBFBD>亥<EFBFBD>髞ｮ蛻帶眠<EFBFBD><EFBFBD>
   ```typescript
   Layer 1: 荳･譬ｼ JSON.parse()
   Layer 2: json-repair 閾ｪ蜉ｨ菫ｮ螟搾ｼ亥､<E4BAA5>炊蟶ｸ隗´LM譬ｼ蠑城漠隸ｯ<E99AB8>?
   Layer 3: 謠仙叙Markdown莉｣遐∝摎荳ｭ逧ЙSON
   ```
   - 謌仙粥邇<E7B2A5>ｼ<EFBFBD>100%<25>域ｵ玖ｯ暮ｪ瑚ｯ<E7919A>ｼ<EFBFBD>
   - 閾ｪ蜉ｨ螟<EFBDA8>炊LLM霎灘<E99C8E>逧<EFBFBD>推遘肴<E98198>ｼ蠑城琉鬚?

4. **讓｡蝙句錐遘ｰ譏<EFBDB0>蟆<EFBFBD>**
   ```typescript
   MODEL_NAME_MAP = {
     'deepseek-v3': 'deepseek-chat',
     'qwen-max': 'qwen3-72b',
   };
   ```
   - 隗｣蜀ｳ逕ｨ謌ｷ蜿句･ｽ蜷咲ｧｰ荳主<E88DB3>驛ｨModelType逧<65>丐蟆<E4B890>琉鬚?

5. **扈捺棡郛灘ｭ<E78198>**
   - 蝓ｺ莠主<E88EA0>螳ｹ蜩亥ｸ檎噪郛灘ｭ倬醗
   - 驕ｿ蜈埼㍾螟広LM隹<4D>畑
   - 譏ｾ闡鈴剄菴取ｵ玖ｯ墓<EFBDAF>譛ｬ

6. **謌先悽隶｡邂<EFBDA1>**
   - 荳ｭ闍ｱ譁<EFBDB1>ｷｷ蜷<EFBDB7>oken莨ｰ邂<EFBDB0>
   - 螳樊慮謌先悽霍溯ｸｪ
   - 騾乗<E9A8BE>逧<EFBFBD>ｴｹ逕ｨ扈溯ｮ?

**菫ｮ螟埼琉鬚<E79089>**:
- 笨?菫ｮ螟広LM譁ｹ豕戊ｰ<E6888A>畑<EFBFBD><E79591>generateText` 竊?`chat`<EFBFBD>?
- 笨?菫ｮ螟広LMFactory蟇ｼ蜈･霍ｯ蠕<EFBDAF>
- 笨?豺ｻ蜉<EFBDBB>MODEL_NAME_MAP隗｣蜀ｳ讓｡蝙狗ｱｻ蝙倶ｸ榊源驟?
- 笨?螳樒鴫3螻<33>SON隗｣譫千ｭ也払菫ｮ螟崎ｧ｣譫宣漠隸ｯ
- 笨?謾ｹ逕ｨPromise.allSettled蠅槫ｼｺ蜿梧ｨ｡蝙句ｮｹ髞?

**諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD>**<EFBFBD>亥黒遽⑰DF豬玖ｯ包ｼ?
- 諤ｻ閠玲慮<E78EB2>?62遘?
- DeepSeek-V3<56>?3,404 tokens<6E>個?.0234
- Qwen-Max<61>?8,464 tokens<6E>個?.0739
- 諤ｻ謌先悽<E58588>堋･0.0973

---

### Day 3: 鬪瑚ｯ∵恪蜉｡ + 蜀ｲ遯∵｣€豬?

#### 3.1 MedicalLogicValidator - 蛹ｻ蟄ｦ騾ｻ霎鷹ｪ瑚ｯ<E7919A>

**譁<>ｻｶ**: `backend/src/modules/asl/common/validation/MedicalLogicValidator.ts` (413陦?

**譬ｸ蠢<EFBDB8>粥閭ｽ**:
- 5譚｡蛹ｻ蟄ｦ騾ｻ霎題ｧ<E9A18C><EFBDA7>鬪瑚ｯ<E7919A>
  1. RCT遐皮ｩｶ蠢<EFBDB6>｡ｻ譛蛾囂譛ｺ蛹匁婿豕<E5A9BF>
  2. 逶ｲ豕穂ｸ守<EFBDB8>皮ｩｶ隶ｾ隶｡荳€閾ｴ諤?
  3. 扈灘ｱ€謖<C280><E8AC96><EFBFBD>ｸ守ｻ捺棡螳梧紛諤ｧ荳€閾ｴ諤?
  4. 扈溯ｮ｡譁ｹ豕穂ｸ守<EFBDB8>皮ｩｶ隶ｾ隶｡蛹ｹ驟?
  5. 蝓ｺ郤ｿ蜿ｯ豈疲€ｧ荳朱囂譛ｺ蛹門<E89BB9>邉?

**螳ｹ髞吝｢槫ｼｺ**:
```typescript
safeGetFieldValue(fieldData: any): string {
  // 螟<>炊 null/undefined
  // 螟<>炊蟇ｹ雎｡邀ｻ蝙具ｼ域署蜿紡ssessment蟄玲ｮｵ<EFBDAE>?
  // 螟<>炊蟄礼ｬｦ荳ｲ邀ｻ蝙?
  // 霑泌屓遨ｺ蟄礼ｬｦ荳ｲ菴應ｸｺ鮟倩ｮ､蛟?
}
```
- 笨?謇€譛芽ｧ<E88ABD><EFBDA7>菴ｿ逕?`safeGetFieldValue` 謠仙叙蟄玲ｮｵ蛟?
- 笨?莨倬寉螟<E5AF89>炊LLM霎灘<E99C8E>逧<EFBFBD>推遘肴焚謐ｮ扈捺<E68988>?

**豬玖ｯ慕ｻ捺棡**:
- DeepSeek-V3: 笨?5/5 騾夊ｿ<E5A48A>
- Qwen-Max: 笨?5/5 騾夊ｿ<E5A48A>

#### 3.2 EvidenceChainValidator - 隸∵紺體ｾ鬪瑚ｯ?

**譁<>ｻｶ**: `backend/src/modules/asl/common/validation/EvidenceChainValidator.ts` (464陦?

**譬ｸ蠢<EFBDB8>粥閭ｽ**:
- 鬪瑚ｯ∵ｯ丈ｸｪ蟄玲ｮｵ逧<EFBDB5>ｯ∵紺體ｾ螳梧紛諤?
  - 蜴滓枚蠑慕畑髟ｿ蠎ｦ<E8A08E>遺翁50蟄礼ｬｦ<EFBDAC>?
  - 蠑慕畑菴咲ｽｮ譛画譜諤?
  - 螟<>炊譌･蠢怜ｮ梧紛諤?
  - 閾ｪ鬪瑚ｯ∬ｮｰ蠖募ｮ梧紛諤?

**螳ｹ髞吝｢槫ｼｺ**:
```typescript
if (!fields || typeof fields !== 'object') {
  this.logger.warn('Fields is undefined, null, or not an object');
  return validationResult;
}
```
- 笨?螳牙<E89EB3>螟<EFBFBD>炊 `undefined`/`null` fields
- 笨?驕ｿ蜈<EFBDBF> `Object.entries()` 蟠ｩ貅<EFBDA9>

**豬玖ｯ慕ｻ捺棡**:
- DeepSeek-V3: 笞<><E7AC9E><EFBFBD> 荳榊ｮ梧紛<E6A2A7><E7B49B>ields荳ｺundefined<65>悟ｷｲ螳ｹ髞呻ｼ?
- Qwen-Max: 笨?12/12 蟄玲ｮｵ螳梧紛

#### 3.3 ConflictDetectionService - 蜀ｲ遯∵｣€豬?

**譁<>ｻｶ**: `backend/src/modules/asl/common/validation/ConflictDetectionService.ts` (432陦?

**譬ｸ蠢<EFBDB8>粥閭ｽ**:
1. **蟄玲ｮｵ郤ｧ蜀ｲ遯∵｣€豬?*
   - 蟇ｹ豈比ｸ､荳ｪ讓｡蝙狗<E89D99>?2蟄玲ｮｵ隸<EFBDB5>ｼｰ扈捺棡
   - 隸<>悪隸<E682AA>ｼｰ荳堺ｸ€閾ｴ逧<EFBDB4>ｭ玲ｮｵ

2. **蜈ｳ髞ｮ蟄玲ｮｵ隸<EFBDB5>悪**
   - 蜈ｳ髞ｮ蟄玲ｮｵ<EFBDAE>夐囂譛ｺ蛹匁婿豕輔€∫峇豕輔€∫ｻ捺棡螳梧紛諤?
   - 驥崎ｦ∝ｭ玲ｮｵ<EFBDAE>壻ｺｺ鄒､迚ｹ蠕√€∝ｹｲ鬚<EFBDB2>蒔譁ｽ縲∝ｯｹ辣ｧ謗ｪ譁ｽ縲∫ｻ灘ｱ€謖<C280><E8AC96><EFBFBD>€∫ｻ溯ｮ｡譁ｹ豕?
   - 譎ｮ騾壼ｭ玲ｮｵ<EFBDAE>壼<EFBFBD>莉門ｭ玲ｮｵ

3. **荳･驥咲ｨ句ｺｦ蛻<EFBDA6>ｺｧ**
   - High: 蜈ｳ髞ｮ蟄玲ｮｵ蜀ｲ遯∵<E981AF>諤ｻ菴灘<E88FB4>遲門<E981B2>遯<EFBFBD>
   - Medium: 驥崎ｦ∝ｭ玲ｮｵ蜀ｲ遯<EFBDB2>
   - Low: 莉<>勸騾壼ｭ玲ｮｵ蜀ｲ遯?

4. **螟肴<E89E9F>ｸ莨伜<E88EA8>郤ｧ隶｡邂?*
   - 蝓ｺ莠主<E88EA0>遯∽ｸ･驥咲ｨ句ｺｦ縲∝ｭ玲ｮｵ謨ｰ驥?
   - 0-100蛻<30>宛
   - 閾ｪ蜉ｨ隶｡邂怜ｻｺ隶ｮ螟肴<E89E9F>ｸ謌ｪ豁｢譌ｶ髣ｴ

**螳ｹ髞吝｢槫ｼｺ**:
```typescript
if (!fieldsA || typeof fieldsA !== 'object') {
  logger.warn('fieldsA is null, undefined, or not an object');
  return { conflictFields: [], fieldConflictDetails: [] };
}
```
- 笨?螳牙<E89EB3>螟<EFBFBD>炊 `undefined`/`null` fields
- 笨?菫ｮ螟<EFBDAE> logger 隹<>畑<EFBFBD><E79591>this.logger` 竊?`logger`<60>?

**豬玖ｯ慕ｻ捺棡**:
- 笨?謌仙粥譽€豬句<E8B1AC>遯<EFBFBD>ｼ<EFBFBD>ndefined vs 豁｣蟶ｸfields<64>?
- 笨?螳ｹ髞呎惻蛻ｶ蟾･菴懈ｭ｣蟶ｸ
- 笨?荳榊<E88DB3>蟠ｩ貅<EFBDA9>

---

## <20>ｧｪ 髮<><E9ABAE>豬玖ｯ<E78E96>

### 豬玖ｯ墓枚莉ｶ

1. **`__tests__/integration-test.ts`** (螳梧紛髮<E7B49B><E9ABAE>豬玖ｯ<E78E96>)
   - 豬玖ｯ<E78E96>2-3遽<33>悄螳霸DF
   - 螳梧紛LLM隹<4D>畑豬∫ｨ<E288AB>
   - 閠玲慮<E78EB2>夐｢<E5A490>ｮ?-10蛻<30>帖

2. **`__tests__/quick-test.ts`** (蠢ｫ騾滓ｵ玖ｯ?
   - 豬玖ｯ<E78E96>1遽⑰DF
   - 邂€豢∬ｾ灘<EFBDBE>?
   - 閠玲慮<E78EB2>夂ｺｦ3蛻<33>帖

3. **`__tests__/cached-result-test.ts`** (螳ｹ髞咎ｪ瑚ｯ<E7919A>)
   - 逶ｴ謗･豬玖ｯ暮ｪ瑚ｯ∝<EFBDAF>?
   - 讓｡諡溷推遘榊ｼょｸｸ霎灘<E99C8E>
   - 遘堤ｺｧ螳梧<E89EB3>

### 豬玖ｯ慕ｻ捺棡諤ｻ扈<EFBDBB>

**笨?3螻<33>SON隗｣譫千ｭ也払鬪瑚ｯ<E7919A>**:
- Qwen-Max: Layer 2閾ｪ蜉ｨ菫ｮ螟搾ｼ井ｿｮ螟?0蟄苓鰍譬ｼ蠑城漠隸ｯ<E99AB8>?
- DeepSeek-V3: Layer 3莉皿arkdown莉｣遐∝摎謠仙<E8ACA0>?
- **謌仙粥邇<E7B2A5>ｼ<EFBFBD>100%**

**笨?蜿梧ｨ｡蝙句ｮｹ髞咎ｪ瑚ｯ?*:
- Promise.allSettled豁｣蟶ｸ蟾･菴<EFBDA5>
- 荳､荳ｪ讓｡蝙句ｹｶ陦悟､<E6829F>炊謌仙粥

**笨?蛹ｻ蟄ｦ騾ｻ霎鷹ｪ瑚ｯ<E7919A>**:
- DeepSeek-V3: 5/5 笨?
- Qwen-Max: 5/5 笨?

**笨?蜀ｲ遯∵｣€豬句ｮｹ髞?*:
- 謌仙粥螟<E7B2A5>炊undefined fields
- 荳榊<E88DB3>蟠ｩ貅<EFBDA9>

---

## <20>菅 髣ｮ鬚倅ｿｮ螟崎ｮｰ蠖<EFBDB0>

### 髣ｮ鬚<EFBDAE>1: ES讓｡蝮<EFBDA1> `__dirname` 譛ｪ螳壻ｹ?
**髞呵ｯｯ**: `ReferenceError: __dirname is not defined in ES module scope`

**菫ｮ螟<EFBDAE>**:
```typescript
// 菫ｮ螟榊<E89E9F>?
const promptDir = path.join(__dirname, '../../fulltext-screening/prompts');

// 菫ｮ螟榊<E89E9F>?
import { fileURLToPath } from 'url';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
```

**蠖ｱ蜩肴枚莉ｶ**: `PromptBuilder.ts`

---

### 髣ｮ鬚<EFBDAE>2: 譁<>ｻｶ霍ｯ蠕<EFBDAF>漠隸ｯ
**髞呵ｯｯ**: `ENOENT: no such file or directory, open 'D:\...\src\modules\modules\asl\...'`

**蜴溷屏**: 霍ｯ蠕<EFBDAF>蕎謗･髞呵ｯｯ<EFBDAF>碁㍾螟堺ｺ<E5A0BA>modules`

**菫ｮ螟<EFBDAE>**: 菫ｮ豁｣逶ｸ蟇ｹ霍ｯ蠕<EFBDAF>ｮ｡邂鈴€ｻ霎<EFBDBB>

**蠖ｱ蜩肴枚莉ｶ**: `PromptBuilder.ts`

---

### 髣ｮ鬚<EFBDAE>3: ES讓｡蝮怜ｯｼ蜈･郛ｺ蟆<EFBDBA> `.js` 謇ｩ螻募<E89EBB>?
**髞呵ｯｯ**: `蠖?"--moduleResolution" 荳?"node16" 謌?"nodenext" 譌ｶ<E8AD8C>檎嶌蟇ｹ蟇ｼ蜈･霍ｯ蠕<EFBDAF>怙隕?ECMAScript 蟇ｼ蜈･荳ｭ逧<EFBDAD>仞蠑乗枚莉ｶ謇ｩ螻募錐`

**菫ｮ螟<EFBDAE>**: 謇€譛臥嶌蟇ｹ蟇ｼ蜈･豺ｻ蜉?`.js` 謇ｩ螻募<E89EBB>?
```typescript
import { PromptBuilder } from './PromptBuilder.js';
import type { LLM12FieldsResult } from './types.js';
```

**蠖ｱ蜩肴枚莉ｶ**: `LLM12FieldsService.ts`, `PromptBuilder.ts`, `index.ts`

---

### 髣ｮ鬚<EFBDAE>4: LLM譁ｹ豕穂ｸ榊ｭ伜<EFBDAD>?
**髞呵ｯｯ**: `邀ｻ蝙<EFBFBD>"ILLMAdapter"荳贋ｸ榊ｭ伜惠螻樊€?generateText"`

**蜴溷屏**: ILLMAdapter謗･蜿｣蜿ｪ譛荏chat`譁ｹ豕包ｼ梧ｲ｡譛荏generateText`

**菫ｮ螟<EFBDAE>**:
```typescript
// 菫ｮ螟榊<E89E9F>?
const response = await adapter.generateText(prompt);

// 菫ｮ螟榊<E89E9F>?
const response = await adapter.chat(messages);
```

**蠖ｱ蜩肴枚莉ｶ**: `LLM12FieldsService.ts`

---

### 髣ｮ鬚<EFBDAE>5: 讓｡蝙狗ｱｻ蝙倶ｸ榊源驟?
**髞呵ｯｯ**: `Unsupported model type: qwen-max`

**蜴溷屏**: `LLMFactory`譛滓悍逧МodelType譏ｯ`qwen3-72b`<60>御ｽ<E5BEA1>ｼ<EFBFBD>蜈･逧<EFBDA5>弍`qwen-max`

**菫ｮ螟<EFBDAE>**: 豺ｻ蜉<EFBDBB>讓｡蝙句錐遘ｰ譏<EFBDB0>蟆<EFBFBD>
```typescript
private readonly MODEL_NAME_MAP: Record<string, ModelType> = {
  'deepseek-v3': 'deepseek-chat',
  'qwen-max': 'qwen3-72b',
};
```

**蠖ｱ蜩肴枚莉ｶ**: `LLM12FieldsService.ts`

---

### 髣ｮ鬚<EFBDAE>6: JSON隗｣譫仙､ｱ雍･
**髞呵ｯｯ**: `SyntaxError: Expected ',' or '}' after property value in JSON`

**蜴溷屏**: LLM霎灘<E99C8E>逧ЙSON蜿ｯ閭ｽ譛画<E8AD9B>ｼ蠑城琉鬚俶<E9AC9A>陲ｫ蛹<EFBDAB>｣ｹ蝨ｨMarkdown莉｣遐∝摎荳ｭ

**菫ｮ螟<EFBDAE>**: 螳樒鴫3螻<33>SON隗｣譫千ｭ也払
```typescript
// Layer 1: 荳･譬ｼ隗｣譫<EFBDA3>
try {
  return JSON.parse(text);
} catch {}

// Layer 2: json-repair閾ｪ蜉ｨ菫ｮ螟<EFBDAE>
try {
  return JSON.parse(jsonrepair(text));
} catch {}

// Layer 3: 謠仙叙Markdown莉｣遐∝<E98190>?
const match = text.match(/```json\s*\n([\s\S]*?)\n```/);
if (match) {
  return JSON.parse(match[1]);
}
```

**蠖ｱ蜩肴枚莉ｶ**: `LLM12FieldsService.ts`

**萓晁ｵ<E69981>**: 螳芽｣<E88ABD> `json-repair` 蠎?

---

### 髣ｮ鬚<EFBDAE>7: MedicalLogicValidator譌<72>豕募､<E58B9F>炊蟇ｹ雎｡邀ｻ蝙句ｭ玲ｮｵ
**髞呵ｯｯ**: 蟄玲ｮｵ蛟ｼ蜿ｯ閭ｽ譏ｯ蟇ｹ雎｡<E99B8E><EFBDA1>{ assessment: '螳梧紛', confidence: 0.9 }`<EFBFBD>芽€碁撼蟄礼ｬｦ荳?

**菫ｮ螟<EFBDAE>**: 豺ｻ蜉<EFBDBB> `safeGetFieldValue` 霎<>勧蜃ｽ謨ｰ
```typescript
private safeGetFieldValue(fieldData: any): string {
  if (!fieldData) return '';
  if (typeof fieldData === 'string') return fieldData;
  if (typeof fieldData === 'object' && fieldData.assessment) {
    return fieldData.assessment;
  }
  return '';
}
```

**蠖ｱ蜩肴枚莉ｶ**: `MedicalLogicValidator.ts`

---

### 髣ｮ鬚<EFBDAE>8: EvidenceChainValidator螟<72>炊undefined fields蟠ｩ貅<EFBDA9>
**髞呵ｯｯ**: `Cannot convert undefined or null to object`

**蜴溷屏**: `Object.entries(fields)` 蝨?`fields` 荳?`undefined` 譌ｶ蟠ｩ貅?

**菫ｮ螟<EFBDAE>**: 豺ｻ蜉<EFBDBB>null譽€譟?
```typescript
if (!fields || typeof fields !== 'object') {
  this.logger.warn('Fields is undefined, null, or not an object');
  return validationResult;
}
```

**蠖ｱ蜩肴枚莉ｶ**: `EvidenceChainValidator.ts`

---

### 髣ｮ鬚<EFBDAE>9: ConflictDetectionService logger譛ｪ螳壻ｹ?
**髞呵ｯｯ**: `Cannot read properties of undefined (reading 'warn')`

**蜴溷屏**: 菴ｿ逕ｨ莠?`this.logger.warn`<EFBFBD>御ｽ<EFBFBD>ｯ･邀ｻ菴ｿ逕ｨ蜈ｨ螻€ `logger`

**菫ｮ螟<EFBDAE>**:
```typescript
// 菫ｮ螟榊<E89E9F>?
this.logger.warn('fieldsA is null, undefined, or not an object');

// 菫ｮ螟榊<E89E9F>?
logger.warn('fieldsA is null, undefined, or not an object');
```

**蠖ｱ蜩肴枚莉ｶ**: `ConflictDetectionService.ts`

---

### 髣ｮ鬚<EFBDAE>10: Promise蟷ｶ陦悟､<E6829F>炊郛ｺ荵丞ｮｹ髞<EFBDB9>
**蜴溷屏**: 菴ｿ逕ｨ `Promise.all`<EFBFBD>御ｸ€荳ｪ讓｡蝙句､ｱ雍･莨壼ｯｼ閾ｴ謨ｴ荳ｪ豬∫ｨ句､ｱ雍･

**菫ｮ螟<EFBDAE>**: 謾ｹ逕ｨ `Promise.allSettled`
```typescript
const results = await Promise.allSettled([
  this.process12Fields(pdfBuffer, picosContext, 'deepseek-v3'),
  this.process12Fields(pdfBuffer, picosContext, 'qwen-max'),
]);

// 莨倬寉螟<E5AF89>炊驛ｨ蛻<EFBDA8>､ｱ雍･
if (results[0].status === 'fulfilled') { /* 菴ｿ逕ｨ扈捺棡A */ }
if (results[1].status === 'fulfilled') { /* 菴ｿ逕ｨ扈捺棡B */ }
```

**蠖ｱ蜩肴枚莉ｶ**: `LLM12FieldsService.ts`

---

## <20>逃 譁ｰ蠅樔ｾ晁ｵ<E69981>

```json
{
  "dependencies": {
    "json-repair": "^0.x.x"  // JSON閾ｪ蜉ｨ菫ｮ螟榊ｺ?
  }
}
```

**螳芽｣<E88ABD>多莉､**:
```bash
cd backend
npm install json-repair
```

---

## <20>投 莉｣遐∫ｻ溯ｮ｡

**譁ｰ蠅樊枚莉ｶ**: 22荳?
**諤ｻ莉｣遐∬｡梧<EFBDA1>?*: ~4,500陦?

**譬ｸ蠢<EFBDB8>恪蜉｡**:
- `PromptBuilder.ts`: 275陦?
- `LLM12FieldsService.ts`: 547陦?
- `MedicalLogicValidator.ts`: 413陦?
- `EvidenceChainValidator.ts`: 464陦?
- `ConflictDetectionService.ts`: 432陦?

**謠千､ｺ隸肴枚莉?*:
- `system_prompt.md`: 6,601蟄礼ｬｦ
- `user_prompt_template.md`: 199陦?
- Cochrane譬<65>㊥: 3荳ｪ譁<EFBDAA>ｻ?

**豬玖ｯ墓枚莉ｶ**:
- `integration-test.ts`: ~200陦?
- `quick-test.ts`: 266陦?
- `cached-result-test.ts`: 129陦?

---

## <20>識 雍ｨ驥丈ｿ晁ｯ<E69981>

### 莉｣遐∬ｴｨ驥<EFBDA8>
- 笨?謇€譛瑛inter髞呵ｯｯ蟾ｲ菫ｮ螟?
- 笨?TypeScript邀ｻ蝙句ｮ牙<EFBDAE>
- 笨?ES讓｡蝮苓ｧ<E88B93>激驕ｵ蠕ｪ
- 笨?螳梧紛逧<E7B49B>漠隸ｯ螟<EFBDAF><E89E9F>?
- 笨?隸ｦ扈<EFBDA6>噪譌･蠢苓ｮｰ蠖?

### 豬玖ｯ戊ｦ<E6888A>尠
- 笨?蜊募<E89C8A>豬玖ｯ包ｼ磯ｪ瑚ｯ∝勣<E2889D>?
- 笨?髮<><E9ABAE>豬玖ｯ包ｼ亥ｮ梧紛豬∫ｨ具ｼ<E585B7>
- 笨?螳ｹ髞呎ｵ玖ｯ包ｼ亥ｼょｸｸ螟<EFBDB8>炊<EFBFBD><E7828A>
- 笨?逵溷ｮ霸DF豬玖ｯ<E78E96>

### 諤ｧ閭ｽ莨伜喧
- 笨?扈捺棡郛灘ｭ假ｼ磯∩蜈埼㍾螟崎ｰ<E5B48E>畑<EFBFBD><E79591>
- 笨?蟷ｶ陦悟､<E6829F>炊<EFBFBD>亥曙讓｡蝙具ｼ?
- 笨?Prompt莨伜喧<E4BC9C>育ｧｻ髯､Few-shot<6F>悟㍼蟆?4KB竊?2KB<4B>?
- 笨?謌先悽霑ｽ雕ｪ<E99B95>磯€乗<C280>逧<EFBFBD>ｴｹ逕ｨ扈溯ｮ｡<EFBDAE><EFBDA1>

---

## <20>噫 荳倶ｸ€豁･隶｡蛻?

譬ｹ謐ｮ蠑€蜿題ｮ｡蛻?`04-蜈ｨ譁<EFBDA8>､咲ｭ帛ｼ€蜿題ｮ｡蛻?md`<EFBFBD>?

**Day 4: 謇ｹ螟<EFBDB9>炊莉ｻ蜉｡譛榊<E8AD9B>?* (蠕<>ｼ€蟋?
- 莉ｻ蜉｡髦溷<E9ABA6>邂｡逅<EFBDA1>
- 謇ｹ驥丞､<E4B89E>炊騾ｻ霎<EFBDBB>
- 霑帛ｺｦ霍溯ｸｪ
- 蟷ｶ蜿第而蛻ｶ

**Day 5: 蜑咲ｫｯUI蠑€蜿?* (蠕<>ｼ€蟋?
- 隶ｾ鄂ｮ鬘ｵ髱｢
- 蟾･菴懷床鬘ｵ髱?
- 扈捺棡鬘ｵ髱｢
- 蜿瑚ｧ<E7919A>崟螳｡髦<EFBDA1>ｼｹ遯?

**Day 6: API髮<49><E9ABAE>荳手＃隹?* (蠕<>ｼ€蟋?
- RESTful API螳樒鴫
- 蜑榊錘遶ｯ閨碑ｰ?
- 遶ｯ蛻ｰ遶ｯ豬玖ｯ?

---

## <20>庁 蜈ｳ髞ｮ謚€譛ｯ蜀ｳ遲?

### 蜀ｳ遲<EFBDB3>1: 遘ｻ髯､Few-shot Examples
**逅<>罰**: 
- Prompt莉?4KB髯崎<E9ABAF>52KB
- 髯堺ｽ鮫LM隹<4D>畑謌先悽郤?0%
- MVP髦ｶ谿ｵ莨伜<E88EA8>騾溷ｺｦ蜥梧<E89CA5>譛?

**蜷守ｻｭ**: 蜿ｯ蝨ｨ逕滉ｺｧ邇ｯ蠅<EFBDAF><E8A085>ｹ謐ｮ蜃<EFBDAE>｡ｮ邇<EFBDAE>怙豎る㍾譁ｰ隸<EFBDB0>ｼ?

### 蜀ｳ遲<EFBDB3>2: MVP荳榊刈霓ｽCochrane譬<65>㊥
**逅<>罰**:
- 蜃丞ｰ善rompt髟ｿ蠎ｦ
- 髯堺ｽ鮫LM隹<4D>畑謌先悽
- 荳捺ｳｨ譬ｸ蠢ゴection-Aware遲也払

**蜷守ｻｭ**: 蜿ｯ騾夊ｿ<E5A48A><EFBDBF>鄂ｮ蠑€蜈ｳ轣ｵ豢ｻ蜷ｯ逕?

### 蜀ｳ遲<EFBDB3>3: 3螻<33>SON隗｣譫千ｭ也払
**逅<>罰**:
- LLM霎灘<E99C8E>譬ｼ蠑丈ｸ咲ｨｳ螳?
- 驕ｿ蜈崎ｧ｣譫仙､ｱ雍･蟇ｼ閾ｴ謨ｴ荳ｪ莉ｻ蜉｡螟ｱ雍･
- 豼€霑帑ｿｮ螟咲ｭ也払<E4B99F>悟ｿｫ騾櫪VP莠､莉<EFBDA4>

**謨域棡**: 豬玖ｯ穂ｸ?00%謌仙粥邇?

### 蜀ｳ遲<EFBDB3>4: Promise.allSettled螳ｹ髞<EFBDB9>
**逅<>罰**:
- 荳€荳ｪ讓｡蝙句､ｱ雍･荳榊ｽｱ蜩榊嘗荳€荳?
- 莨倬寉髯咲ｺｧ<EFBDBA><EFBDA7>egraded Mode<64>?
- 謠宣ｫ倡ｳｻ扈溷庄髱<E5BA84>諤?

**謨域棡**: 蜿梧ｨ｡蝙句ｮｹ髞咎ｪ瑚ｯ<E7919A>€夊ｿ<E5A48A>

---

## <20>統 扈城ｪ梧€ｻ扈<EFBDBB>

### 謌仙粥扈城ｪ<E59F8E>

1. **貂占ｿ帛ｼ丞ｼ€蜿?*: 蜈亥ｮ樒鴫譬ｸ蠢<EFBDB8>粥閭ｽ<E996AD>悟<EFBFBD>莨伜喧扈<E596A7><E68988>?
2. **螳梧紛豬玖ｯ<E78E96>**: 蜊募<E89C8A>豬玖ｯ<E78E96> + 髮<><E9ABAE>豬玖ｯ<E78E96> + 螳ｹ髞呎ｵ玖ｯ<E78E96>
3. **螳ｹ髞呵ｮｾ隶｡**: 螟壼ｱる亟謚､<E8AC9A>御ｼ倬寉髯咲ｺ?
4. **諤ｧ閭ｽ莨伜<E88EA8>**: Prompt莨伜喧縲∫ｼ灘ｭ俶惻蛻ｶ縲∝ｹｶ陦悟､<E6829F><EFBDA4>?

### 謨呵ｮｭ

1. **ES讓｡蝮苓ｿ∫ｧｻ**: 髴€隕∵ｳｨ諢?`__dirname`縲～.js` 謇ｩ螻募錐遲臥ｻ<E887A5>鰍
2. **LLM霎灘<E99C8E>荳咲ｨｳ螳?*: 蠢<>｡ｻ譛詠obust逧<74>ｧ｣譫仙柱鬪瑚ｯ∵惻蛻ｶ
3. **TypeScript邀ｻ蝙区｣€譟?*: 譌ｩ譛溷書邇ｰ貎懷惠髣ｮ鬚<EFBDAE>
4. **譌･蠢苓ｮｰ蠖<EFBDB0>**: 隸ｦ扈<EFBDA6>律蠢怜ｯｹ隹<EFBDB9>ｯ戊<EFBDAF>蜈ｳ驥崎ｦ?

---

## <20>梼 逶ｸ蜈ｳ譁<EFBDB3>｡｣

- **蠑€蜿題ｮ｡蛻?*: `04-蠑€蜿題ｮ｡蛻?04-蜈ｨ譁<EFBDA8>､咲ｭ帛ｼ€蜿題ｮ｡蛻?md`
- **雍ｨ驥丈ｿ晞囿遲也払**: `02-謚€譛ｯ隶ｾ隶?08-蜈ｨ譁<EFBDA8>､咲ｭ幄ｴｨ驥丈ｿ晞囿遲也払.md`
- **API隶ｾ隶｡**: `02-謚€譛ｯ隶ｾ隶?02-API隶ｾ隶｡隗<EFBDA1>激.md`
- **謨ｰ謐ｮ蠎楢ｮｾ隶?*: `02-謚€譛ｯ隶ｾ隶?01-謨ｰ謐ｮ蠎楢ｮｾ隶?md`

---

**螳梧<E89EB3>譌･譛<EFBDA5>**: 2025蟷?1譛?2譌? 
**迥ｶ諤?*: 笨?Day 2 & Day 3 蜈ｨ驛ｨ螳梧<E89EB3>  
**荳倶ｸ€豁?*: Day 4 謇ｹ螟<EFBDB9>炊莉ｻ蜉｡譛榊<E8AD9B>?