portfolio-hub/docs/batches/bat-002_20260519_asset-catalog-api-completion/index.md

BAT-002: asset catalog API 완결

• Status: release-candidate
• 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

• Planning: planning.md
• Design: design.md
• Implementation: implementation.md
• Verification: verification.md

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 모두 존재 확인됨