genichinandClaude Sonnet 4.6
4bf6b554a7
dcy-003/004 기반 v1 API surface 완성 및 BAT-008~011 구현·검증 완료:
- BAT-008 (REQ-019~021,024): 토큰 surface baseline 문서 갱신
- BAT-009 (REQ-025~028): POST/PATCH/DELETE/GET /v1/portfolios CRUD 신설
- _require_write_token, _get_portfolio_or_404, soft delete, daemon-scoped list
- BAT-010 (REQ-030~032): portfolio tag/comment 서브 라우트 신설 + baseline 갱신
- GET/POST/DELETE /v1/portfolios/{id}/tags
- POST/GET/PATCH/DELETE /v1/portfolios/{id}/comments
- BAT-011 (REQ-029): ledger path migration
- POST /v1/assets/{asset_id}/ledger/trades → /v1/portfolios/{portfolio_id}/ledger/trades
- v1_ledger.py 제거, disabled 차단(409) 추가
- test_v1.py / test_daemon_assignment.py 구 path 갱신
- 신규 tests: test_v1_portfolios_crud.py, test_v1_portfolios_list.py,
test_v1_portfolios_tags_comments.py, test_v1_portfolios_ledger.py
- 전체 suite: 340 passed
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
BAT-011: v1 portfolios ledger path migration
- Status: release-candidate
- Profile: standard
- Source Discovery: dcy-003
- Included REQ: REQ-029
- Excluded REQ: none
Summary
- 기존
POST /v1/assets/{asset_id}/ledger/trades(app/api/v1_ledger.py)를POST /v1/portfolios/{portfolio_id}/ledger/trades로 이전하고 구 path를 동일 release에서 제거한다. - 동작·인가·idempotency는 그대로 보존하며 REQ-027 정합의 disabled portfolio 차단(HTTP 409)을 신규 추가한다.
- trex-basic 클라이언트와의 동시 배포가 필수이므로 release plan에 배포 순서 잠금·rollback 전제를 명시한다.
Scope
- In Scope:
app/api/v1_portfolios.py—POST /v1/portfolios/{portfolio_id}/ledger/trades라우트 추가app/api/v1_ledger.py— 구 path 라우트 제거 (또는 파일 전체 제거 후app/main.py에서 include 제거)app/main.py— 구 ledger 라우터 include 제거app/services/portfolio_service.py또는app/services/ledger_service.py— disabled 차단 검증 추가tests/test_v1.py— 구 path 케이스 갱신(HTTP 404 확인)tests/test_v1_portfolios_ledger.py(신규) — AC-1~10 검증
- Out of Scope:
ledger_trades.asset_id컬럼명 변경 (별도 migration REQ로 분리 가능)- trex-basic 코드 변경 (별도 레포)
Documents
- Planning: planning.md
- Design: design.md
- Implementation: implementation.md
- Verification: verification.md
Notes
- R-1 (High): trex-basic 동시 배포 — 신 path 단일 서빙, 별칭/redirect 없음. release plan에 배포 순서(trex-basic 사전 빌드 → portfolio-hub 배포 → trex-basic 배포) + rollback 시 trex-basic 동반 rollback 전제 명시 필수.
- R-2 (Low): disabled portfolio 차단(AC-7)은 REQ-027 soft delete 정책 정합 검증으로 신규. 기존 daemon 인가 3단계와 순서 충돌 없이 disabled 체크를 insert 전에 추가.
- 선행 완료: BAT-009(soft delete + disabled 상태 관리, REQ-027) ✅