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
53 lines
2.7 KiB
Markdown
53 lines
2.7 KiB
Markdown
# 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 |
|