# BAT-007 Index

- Status: release-candidate
- Batch: BAT-007
- Profile: batch-lite
- Created: 2026-05-11

## Included REQ

| REQ | 제목 | Type | Priority |
|-----|------|------|----------|
| REQ-001 | 로컬 DB 초기화 및 마이그레이션 검증 시나리오 정의 | Testing | High |
| REQ-002 | Alembic와 runtime schema ownership 경계 정리 | Migration | High |
| REQ-003 | 로컬 DB 운영 runbook 및 baseline 문서 갱신 | Documentation | Medium |

## Source Discovery

- [dcy-001_20260430_real-db-migration-validation-and-operations-readiness](../../discovery/dcy-001_20260430_real-db-migration-validation-and-operations-readiness.md)

## Scope Summary

- 로컬 docker compose 기반 DB 환경에서 init-db, migrate-db, health-check, smoke flow 검증 매트릭스 정의 (REQ-001)
- Alembic migration 경로와 runtime `ensure_schema()` 경로의 schema ownership 경계 분석 및 문서화 (REQ-002)
- README, docs/runtime-flows.md, docs/project-structure.md에 로컬 DB 검증 절차, release gate 기준, rollback 판단 기준 반영 (REQ-003)
- 구조/인터페이스/런타임 흐름 신규 추가 없음 — 분석 결과 기반 문서화 및 기존 코드 경계 명시

## Impacted Area

- Docs:
  - `README.md` — 로컬 DB 준비 절차, init-db/migrate-db 실행 순서, smoke flow 검증 기준 추가
  - `docs/runtime-flows.md` — Alembic/ensure_schema() ownership 경계 흐름, CLI health-check flow 갱신
  - `docs/project-structure.md` — schema ownership 경계 및 local DB 운영 제약 반영
  - `docs/data-model.md` — Alembic ownership 객체 목록 명시 (필요 시)
  - `docs/discovery/dcy-001_20260430_real-db-migration-validation-and-operations-readiness.md` — 검증 시나리오 결과 링크 추가 (필요 시)
- Modules:
  - `docker-compose.local-test.yml` — 검증 시나리오 실행 환경 확인 (변경 필요 시 반영)
  - `app/cli/commands/health.py` — health-check 출력 형식 확인 (변경 필요 시 반영)
  - `app/db/migrations.py` — ownership 경계 확인 (변경 필요 시 반영)
  - `app/repositories/postgres.py` — ensure_schema() ownership 확인 (변경 필요 시 반영)
  - `migrations/versions/*.py` — Alembic revision 대상 객체 확인
- Tests:
  - 로컬 docker compose 기반 수동 검증 체크리스트 (REQ-001 AC-1~3)
  - Alembic/ensure_schema() 충돌 시나리오 검증 절차 문서 (REQ-002 AC-1~3)

## Stage Documents

| Stage | File | Status |
|-------|------|--------|
| Planning | [planning.md](./planning.md) | confirmed |
| Design | [design.md](./design.md) | confirmed |
| Implementation | [implementation.md](./implementation.md) | completed |
| Verification | [verification.md](./verification.md) | passed |