genichin
829629fa8f
Core Changes: - Migrate portfolio_id from string to UUID in schema and repository layer - Update portfolio CLI commands to use name+user combination for identification - Update HTTP API to accept portfolio_id as UUID path parameter - Implement portfolio ownership validation in repository queries Requirements Completed (REQ-016 to REQ-019): - REQ-016: portfolios table UUID schema migration with data migration script - REQ-017: CLI portfolio commands with name+user identification - REQ-018: HTTP API portfolio path parameters and v1 asset_id UUID returns - REQ-019: Portfolio UUID baseline documentation updates BAT-001 Re-verification: - REQ-004~010 marked as Implemented after verification evidence validation - All v1 API endpoints verified with comprehensive test coverage Documentation Updates: - Update data-model.md with portfolio UUID structure - Update interface-contract.md with UUID path parameters - Update runtime-flows.md with ownership-based resolution flows - Update project-structure.md with database layer changes - Add migration script for portfolio UUID transition Testing: - Add test_portfolio_uuid.py for migration validation - Update test_cli.py and test_portfolio_ownership.py for ownership checks
2.7 KiB
2.7 KiB
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
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 | confirmed |
| Design | design.md | confirmed |
| Implementation | implementation.md | completed |
| Verification | verification.md | passed |