# 운영 지원 스크립트

내부망 배포에서 지원하는 스크립트는 다음과 같습니다.

| 스크립트 | 역할 |
|---|---|
| `44_generate_oneline_desc.py` | 후보 한 줄 설명 생성 |
| `45_validate_eval_sets.py` | dev/gold/no-match 평가 데이터 검증 |
| `46_build_dataset_manifest.py` | 버전별 데이터 매니페스트 재생성 |
| `47_eval_retrieval.py` | exact menu ID 검색·서빙 경로 평가 |
| `48_prepare_version_data.py` | 버전별 SQLite를 검수 승계된 검색 데이터로 변환 |
| `49_build_version_indexes.py` | 버전별 BM25와 공용 Qdrant 인덱스 구축 |
| `50_import_version_review.py` | 승인된 키워드·한 줄 설명을 영속 override로 반영 |
| `51_generate_version_candidates.py` | 신규·메뉴명 변경 메뉴의 근거 기반 검색 후보 생성 |
| `52_update_version_release.py` | DB 변환부터 인덱스 생성까지 반복 작업 일괄 실행 |
| `53_ablate_ranking.py` | 쿼리 확장·인기도·Q↔Q 설정의 순위 회귀 비교 |

`00`~`43`은 과거 POC 실험 및 마이그레이션 도구입니다. 운영 Docker
이미지에는 포함하지 않으며, 내부망 첫 배포 승인 전까지 실험 이력으로만
보존합니다.

표준 업데이트 순서:

```powershell
# 승인된 내부 Azure LLM을 사용하는 자동 처리
.\.venv\Scripts\python.exe scripts\52_update_version_release.py

# 현업 검수 결과가 생긴 뒤
.\.venv\Scripts\python.exe scripts\50_import_version_review.py --input <reviewed.csv>
.\.venv\Scripts\python.exe scripts\48_prepare_version_data.py
.\.venv\Scripts\python.exe scripts\49_build_version_indexes.py
.\.venv\Scripts\python.exe scripts\47_eval_retrieval.py --app-version 1.5.5 --serving-path --no-hyde
```

`52`는 운영 버전 SQLite를 자동 발견하고 `48 → 51 → 48 → 45 → 49`
순서로 실행합니다. `51`은 원천 메뉴명·경로·DB 키워드만 근거로 후보를
만들며, 결과는 `auto_generated_unreviewed` 상태로 남습니다. 동일한 원천
fingerprint의 메뉴는 다시 호출하지 않고 신규·변경분만 증분 생성합니다.

비 Azure LLM 백엔드는 기본 차단됩니다. 메뉴 메타데이터의 외부 전송이
승인된 경우에만 `--allow-external-llm`을 명시해야 합니다.

`48`이 만든 `data/versions/review_queue.csv`의 사본에서 검수하고, 승인
결과를 `50`으로 가져온 뒤 `48`과 `49`를 다시 실행하면 승인 데이터가
자동 후보보다 우선 적용됩니다.

컨테이너에서는 `MENU_DB_DIR=/app/menu_db_ver`를 사용합니다.