docs

ontology_platform/docs/phases/PHASE0_ACCEPTANCE_GATE.md

@@ -7,17 +7,20 @@
 | # | Acceptance Gate 항목 | 상태 | 검증 방법 |
 |---|---|---|---|
 | 1 | 단일 PDF/JSON 입력 → ontology TTL + facts TTL이 filesystem에 생성됨 | ⚠️ **e2e 검증 대기** (로컬 LLM/API 키 필요) | `tests/e2e/test_phase0_full_pipeline.py` |
-| 2 | `/health`, `/info`, `/process` (FastAPI) 정상 동작 | ✅ **통합 테스트 10/10 통과** (2026-05-14) | `tests/integration/test_api_smoke.py` |
+| 2 | `/health`, `/info`, `/process` (FastAPI) 정상 동작 | ✅ **통합 테스트 11/11 통과** (2026-05-19) | `tests/integration/test_api_smoke.py` |
 | 3 | BudgetTracker가 LLM call/triple count를 정확히 기록 | ⚠️ **e2e 검증 대기** (mock 검증은 통합 테스트로 통과) | e2e 테스트가 실제 검증 |
 | 4 | LangGraph 워크플로우 (CONVERT→CHUNK→...→SERIALIZE) 전 노드 traceable | ✅ **OntoCast 원본 워크플로우 무수정 채택** | `vendored/ontocast/ontocast/stategraph/` 그대로 사용 |
 
 추가로 **단위 테스트 16/16 통과** (test_convert_document 7, test_platform_config 5, test_select_ontology 4).
+자동 검증 기준으로는 **unit + integration 27/27 통과**가 현재 Phase 0 기본선이다.
 
-**현재 진척 (2026-05-14)**:
-- Python 3.13.13 환경 + `pip install -e ".[dev]"` 완료
+**현재 진척 (2026-05-19)**:
+- Python 3.14.5 `.venv` 환경에서 unit + integration 27/27 통과
+- `python-multipart`를 Phase 0 FastAPI multipart upload 필수 의존성으로 추가
+- Phase 0 production app에서 Phase 1 Trafilatura route가 기본 mount되지 않도록 lazy phase route gate 적용
+- `pip install -e ".[dev]"` 또는 동등한 의존성 설치 필요
 - `pip install -e vendored/ontocast` 로 OntoCast 의존성 설치 완료
 - 패키지 이름 충돌 수정: `platform/` → `ont_platform/` (Python 내장 `platform` 모듈과 충돌)
-- 단위 + 통합 테스트 26/26 모두 통과
 - **남은 작업**: e2e 테스트 (Acceptance Gate #1, #3) 실행 — 로컬 Ollama 또는 OpenAI 키 필요
 
 ## 다음 작업자가 실행할 검증 절차
@@ -45,7 +48,7 @@ Copy-Item .env.example .env
 
 ```powershell
 # 단위 + 통합 테스트만 (LLM 호출 없음, 빠름)
-pytest tests/unit tests/integration -v
+.venv\Scripts\python.exe -m pytest tests/unit tests/integration -v
 ```
 
 **기대 결과**: 모든 케이스 PASS.
@@ -53,7 +56,16 @@ pytest tests/unit tests/integration -v
 - `tests/unit/test_select_ontology.py` (4 케이스) — Phase 0.2 검증
 - `tests/unit/test_convert_document.py` (7 케이스) — Phase 0.3 검증
 - `tests/unit/test_platform_config.py` (5 케이스) — Phase 0.5 검증
-- `tests/integration/test_api_smoke.py` (10 케이스) — Phase 0.4 + 0.6 mock 검증
+- `tests/integration/test_api_smoke.py` (11 케이스) — Phase 0.4 + 0.6 mock 검증, Phase 0 future dependency route gate 검증
+
+Windows에서 `%TEMP%` 권한 문제 또는 `.pytest_cache` 쓰기 문제가 발생하면 아래처럼 pytest temp/cache 위치를 workspace 내부로 고정한다.
+
+```powershell
+$env:TMP=(Join-Path (Resolve-Path '.').Path 'pytest_tmp')
+$env:TEMP=$env:TMP
+New-Item -ItemType Directory -Force -Path $env:TMP | Out-Null
+.venv\Scripts\python.exe -m pytest tests/unit tests/integration -v --basetemp "$env:TMP\basetemp" -o cache_dir="$env:TMP\cache"
+```
 
 ### 3) End-to-end 검증 (Acceptance Gate #1, #3, #4)
 
@@ -116,4 +128,5 @@ curl -X POST http://localhost:8000/process `
 |---|---|---|
 | 2026-05-13 | (코드 작성: ontology-platform agent) | 코드 준비 완료. 실 환경 검증 보류. |
 | 2026-05-14 | lasta + Claude | **unit 16/16, integration 10/10 통과** (Gate #2 ✅). 패키지 이름 충돌 수정 (`platform`→`ont_platform`). e2e는 LLM 필요로 대기. |
+| 2026-05-19 | Codex | **unit 16/16, integration 11/11, 총 27/27 통과**. Phase 0 route gate 추가로 Trafilatura route는 PHASE>=1에서만 lazy mount. e2e는 LLM 필요로 대기. |
 | ____-__-__ | ________________ | __________________________________ |