# QA Log — BodyCompMouseDXA

**작업 일자**: 2026-05-11
**빌드 에이전트**: build-agent-2 (idea #2)
**프로젝트 루트**: `2026-05-11-2-body-comp-mouse-dxa/`

## 환경

- Python 3.11+ (시스템 기본)
- 사용 가능: `numpy 2.0.2`, `pandas 2.3.3`, `scipy 1.13.1`, `streamlit`
- 미설치 (정상 — 모두 optional fallback 적용): `statsmodels`, `plotly`, `pydicom`

## 검수 결과

### 1. AST syntax check (요구 1–4)

| 파일 | 결과 |
| --- | --- |
| `main.py` | `OK` |
| `analysis.py` | `OK` |
| `dio_reference.py` | `OK` |
| `data/synthetic_generator.py` | `OK` |

명령: `python3 -c "import ast; ast.parse(open('<file>').read())"` — 4건 모두 0 종료.

### 2. 합성 데이터 생성 (요구 5)

- 명령: `python3 data/synthetic_generator.py`
- 출력: 6개 CSV 파일 정상 생성 (`cohort_C57BL6_DIO.csv`, `cohort_obob.csv`, `cohort_dbdb.csv`, `cohort_STAM.csv`, `cohort_control_chow.csv`, `cohort_GLP1RA_STEP4_mimic.csv`)
- 행 수: 총 300 행 / 50 마리 / 7 그룹 / 6 time-point
- Schema: 18 column canonical schema 헤더 일치 확인 (head 검사)
- Sample head:
  ```
  animal_id,model,group,sex,time_point_wk,day_label,body_weight_g,fat_g,lean_g,water_g,fat_pct,lean_pct,BMD,BMC,visceral_fat_proxy_g,appendicular_lean_g,drug_phase,source_format
  C57BL_6J_HFD60_M01,C57BL_6J_HFD60,DIO_HFD60,M,0,D0,24.37,3.304,19.667,0.828,13.56,80.69,0.0538,0.429,0.405,4.719,none,PIXImus_DICOM_sim
  ```

### 3. CLI demo 실행 (요구 6)

- 명령: `python3 main.py --demo`
- 종료 코드: `0`
- 주요 출력 발췌:
  - 데이터 로드: 300 rows, 50 animals, 7 groups
  - 단일 개체 트라젝토리: `C57BL_6J_HFD60_M01` baseline 24.37 g → 최종 50.97 g (+109.15%), 지방 +570.82%
  - ANCOVA (DIO_HFD60 vs control_chow, endpoint=fat_g): F=120.79, p=2.87e-08, scipy_fallback backend
  - Drug-on/off (treated vs placebo): Δon p=8.66e-07 (treated가 유의하게 덜 증가), Δoff p=0.0185 (treated가 rebound)
  - Mixed-effects RM (scipy fallback per-time): wk0 p=0.30 (NS, baseline 동일), wk4 이후 p<1e-7 (HFD induction 효과 정상 검출)
  - 근감소성 비만 비율: db_db 66.7%, ob_ob 66.7% (예상 부합), DIO/control 0%
  - 참조 밴드 분류 (DIO HFD wk12 fat_pct): 3개 샘플 모두 `normal`로 정확히 매핑

### 4. 데이터 로드 가능성

- pandas로 6개 CSV 모두 load 성공 (analysis.load_demo_data 통해 검증)
- BOM 인코딩 export 동작 검증 (`utf-8-sig`)

### 5. 의도 부합

| 요구 사항 | 구현 상태 |
| --- | --- |
| Multi-format ingest (PIXImus DICOM, EchoMRI, qNMR, SkyScan) | OK — 4개 loader + canonical schema coercion |
| Auto ROI + segmentation heuristic | OK — metadata-driven, image segmentation stub 명시 |
| Multi-time-point trajectory + DIO model reference | OK — 8개 model, 6 time-point reference dict |
| Sarcopenic obesity index + bone+body | OK — FMI, LMI, ALM/BW, SOI, severity tier + BMD 추적 |
| ANCOVA + 한국어 export | OK — baseline-corrected ANCOVA (statsmodels OR scipy fallback), 한국어 report 텍스트 + UTF-8-sig CSV download |
| 의학적 디스클레이머 | OK — README 첫줄 + UI warning + 한국어 report 마지막 줄 |
| `--demo` CLI | OK |
| 합성 데이터 5개 이상 | OK (6개) |
| pydicom optional | OK — friendly RuntimeError fallback |
| 외부 네트워크/pip 설치 금지 | OK — 호출 없음 |

## 결론

✅ 모든 검수 항목 통과. 1차 시도에서 성공.

## 재현 명령

```bash
cd "2026-05-11-2-body-comp-mouse-dxa"
python3 data/synthetic_generator.py     # 합성 데이터 (이미 있어도 안전)
python3 main.py --demo                  # CLI 검증
streamlit run main.py                    # UI (streamlit 설치 시)
```