Files
portfolio-hub/docs/batches/bat-002_20260519_asset-catalog-api-completion/index.md
T
genichinandClaude Opus 4.8 b1c34068e5 docs: batch 상태 released 동기화(REL-001/002) + README 현행화(거래내역/실현PnL API)
batch drift 정합 — REL-001(BAT-001~016)·REL-002(BAT-017) released에 맞춰
batches/index 및 개별 index 상태를 release-candidate→released 동기화(17건).
README: bootstrap 문구 제거, dcy-007 엔드포인트(GET /trades·/pnl/realized) 추가,
planned-next 현행화. 코드 무변경.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHtM5Ws1HKCKQ4JGi6GRb5
2026-06-22 09:51:13 +09:00

1.9 KiB

BAT-002: asset catalog API 완결

  • Status: released
  • Profile: standard
  • Source Discovery: dcy-001
  • Included REQ: REQ-010, REQ-012, REQ-013, REQ-015
  • Excluded REQ: (없음 — dcy-001 잔여 4개 전부 포함)

Summary

  • BAT-001에서 구축한 assets 테이블 및 asset_id FK 기반 위에 admin이 종목 catalog를 관리할 수 있는 CRUD API/CLI를 추가하고(REQ-010), portfolio 생성 시 catalog 검증을 도입하며(REQ-012), GET /v1/assets 엔드포인트를 service/user/admin 토큰 타입별 분기로 재정의한다(REQ-013).
  • 모든 구현이 완료된 후 baseline 문서(data-model, interface-contract, runtime-flows, project-structure)를 갱신한다(REQ-015).

Scope

  • In Scope:
    • pfhub asset create/list/update/deactivate CLI 커맨드 신규 추가 (app/cli/commands/asset.py)
    • POST /v1/assets, PATCH /v1/assets/{id}, PATCH /v1/assets/{id}/deactivate admin 전용 HTTP API 신규 추가
    • GET /v1/assets 토큰 타입별 분기 재작성 (service→daemon 필터, user→본인, admin→본인+?user_id)
    • pfhub portfolio create —--symbol 옵션 추가 + service layer asset catalog 존재/active 검증
    • baseline 문서 4종 갱신 (REQ-015)
  • Out of Scope:
    • tags 관련 모든 변경 (→ dcy-002 batches)
    • portfolio 조회·수정·삭제 흐름의 catalog 검증 (→ 별도 REQ 필요)
    • GET /v1/assets 이외의 v1 엔드포인트 변경

Documents

Notes

  • R-1(High): REQ-010과 REQ-013이 app/api/v1_assets.py 동일 파일 수정 — 구현 순서 엄수 (REQ-010 신규 엔드포인트 → REQ-013 list_assets 재작성)
  • BAT-001(verified) 완료가 선행 조건 — assets 테이블, asset CRUD postgres 구현, asset_id FK 모두 존재 확인됨