Files

T

genichinandClaude Sonnet 4.6 4bf6b554a7 feat: v1 portfolio mutation, sub-resources, ledger path migration (BAT-008~011)

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>

2026-05-21 07:25:39 +00:00

2.8 KiB

Raw Blame History

BAT-011 Planning

Status: confirmed
Batch: BAT-011
Profile: standard

Included REQ

REQ-029: POST /v1/portfolios/{portfolio_id}/ledger/trades 이전 + 구 path 제거 + disabled 차단 추가

Delivery Plan

app/api/v1_portfolios.py — POST /{portfolio_id}/ledger/trades 라우트 추가: daemon 인가 3단계 + disabled 차단 + idempotency + conflict 분기
app/api/v1_ledger.py — 구 POST /v1/assets/{asset_id}/ledger/trades 라우트 제거 (또는 파일 전체 제거)
app/main.py — 구 v1_ledger 라우터 include 제거 (v1_portfolios_router는 BAT-009에서 이미 include됨)
app/services/ledger_service.py 또는 app/services/portfolio_service.py — disabled 차단 검증 추가
tests/test_v1_portfolios_ledger.py 신규 — AC-1~10 검증: 신 path 정상 흐름 + daemon 인가 3단계 + idempotency/conflict + disabled + 404 + 401
tests/test_v1.py 갱신 — 구 path 케이스를 신 path로 갱신 + 구 path HTTP 404 회귀 확인

Dependencies

Internal:
- BAT-009 (release-candidate): soft delete(status='disabled') + managed_by_daemon_id 관리 확정 ✅
- BAT-006 (release-candidate): service token 분기 정책 확정(REQ-016/017/018) ✅
External:
- trex-basic 클라이언트: 신 path POST /v1/portfolios/{portfolio_id}/ledger/trades 사전 빌드 필요. release 단계에서 배포 순서 잠금 확인 필수.

Design Gate

Design Required Before Implementation: yes
Reason: (1) 구 v1_ledger.py 파일 완전 제거 vs. 라우트만 제거 결정 필요, (2) disabled 차단을 서비스 계층과 라우터 계층 중 어디에 위치시킬지 결정 필요, (3) trex-basic 동시 배포 전략(배포 순서 잠금·rollback 계획)을 design 단계에서 명문화.

Milestones

design.md confirmed — 파일 제거 전략, disabled 차단 위치, 배포 순서 잠금 결정
신 path 라우트 구현 완료 (app/api/v1_portfolios.py)
구 path 제거 + app/main.py 갱신 완료
tests/test_v1_portfolios_ledger.py AC-1~10 전부 pass
tests/test_v1.py 구 path HTTP 404 회귀 확인 + 전체 suite pass

Risks

R-1 (High): trex-basic 동시 배포 — 신 path 단일 서빙으로 별칭/redirect 없음. trex-basic이 구 path를 사용 중인 상태에서 portfolio-hub만 배포되면 trex-basic이 즉시 장애. 완화: release plan에 배포 순서(trex-basic 사전 빌드 완료 확인 → portfolio-hub 배포 → trex-basic 배포) 잠금 + rollback 시 trex-basic 동반 rollback 명시.
R-2 (Low): ledger_trades.asset_id 컬럼명은 실제로 portfolio_id 값을 저장하는 혼용 상태가 남으나, 본 REQ에서는 path 명명 정합화만 처리하고 컬럼명 변경은 별도 REQ로 이월.
R-3 (Low): tests/test_v1.py에 구 path 테스트가 얼마나 있는지 design 단계에서 사전 파악 필요.

2.8 KiB Raw Blame History

BAT-011 Planning

Included REQ

Delivery Plan

Dependencies

Design Gate

Milestones

Risks

2.8 KiB

Raw Blame History