Files
portfolio-hub/docs/batches/bat-008_20260511_trex-basic-baseline-docs-update/index.md
T
genichin 829629fa8f feat: implement portfolio UUID migration and v1 API finalization (BAT-006, BAT-001 re-verified)
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
2026-05-11 09:27:57 +00:00

1.6 KiB

BAT-008 Index

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

Included REQ

REQ 제목 Type Priority
REQ-011 trex-basic 계약 반영을 위한 baseline 문서 갱신 Documentation Medium

Source Discovery

  • dcy-002 (trex-basic v1 API contract — FR/NFR 구현 완료 후 documentation closure)

Scope Summary

  • docs/interface-contract.md: GET /health, GET /v1/assets, GET /v1/user_info, POST /v1/assets/{asset_id}/ledger/trades 엔드포인트 명세 및 service-token bearer 인증 방식 추가 (REQ-011 AC-1)
  • docs/data-model.md: broker_credentials, ledger_trades 테이블, portfolios.market, auth_tokens.runtime_id 컬럼 추가 (REQ-011 AC-2)
  • docs/runtime-flows.md: v1 API 처리 흐름, runtime_id 발급 흐름 추가 (REQ-011 AC-3)
  • 신규 코드/모듈/스키마 변경 없음 — 구현 완료(REQ-004~010 Implemented) 후 문서 동기화

Impacted Area

  • Docs:
    • docs/interface-contract.md — v1 API 엔드포인트 명세, service-token 인증 방식 추가
    • docs/data-model.md — broker_credentials, ledger_trades 테이블 및 컬럼 추가
    • docs/runtime-flows.md — v1 API 처리 흐름 및 runtime_id 발급 흐름 추가
  • Modules: 없음
  • Tests: 없음

Stage Documents

Stage File Status
Planning planning.md confirmed
Design design.md confirmed
Implementation implementation.md completed
Verification verification.md passed