trex/portfolio-hub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
522a10f26e229b86ff1ab1a1b4b67a48704e389d
portfolio-hub/docs/srs/Documentation/req-015_asset-catalog-baseline-docs-update.md
T
genichinandClaude Sonnet 4.6 6add0ade29 feat: REQ-001~018 Implemented 전환, REQ-010 GET /v1/assets admin catalog 재정의, REL-001 draft 
- confirm-req-implemented: REQ-001~018 (17건, REQ-013 제외) Approved → Implemented
  - BAT-001(REQ-009/011/014), BAT-002(REQ-010/012/015), BAT-003(REQ-001/002/003/006)
  - BAT-004(REQ-004/005), BAT-005(REQ-007/008), BAT-006(REQ-016/017/018)
  - CHG-20260521-01 entry 각 REQ에 추가; SRS index Recent Change Log 갱신

- REQ-010 CHG-20260521-02: GET /v1/assets admin catalog 전용 재정의
  - 기존 token_type 분기 portfolio 조회 코드 제거, admin permission + list_assets() 호출로 대체
  - AssetCatalogListResponse 스키마 추가 (items/total)
  - REQ-010 Status: Implemented → Approved (재검증 필요)
  - 테스트 343건 전체 통과: service/user token 403, admin token 200 + catalog schema 검증

- migration 보강: portfolios_asset_migration market 컬럼 부재 fallback,
  portfolio_tags 빈 테이블 early-return, service_token index fix autocommit_block 정리

- docs/releases/rel-001: REL-001 draft 추가 (BAT-001~011 포함)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-21 10:17:39 +00:00

5.0 KiB
Raw Blame History

REQ-015: asset catalog 도입 baseline 문서 갱신

  • Status: Implemented
  • Type: Documentation
  • Priority: Low
  • Owner: Justin Ko

Intent

  • dcy-001에서 정의한 assets 테이블, portfolios 재설계, admin CRUD API/CLI, GET /v1/assets 토큰 분기 변경 내용을 baseline 문서에 반영하여 다음 Discovery/REQ 작성 시 잘못된 baseline 참조를 방지한다.

Requirement

  • docs/data-model.md에 assets 엔티티(asset_id, symbol, markets, display_name, status, created_at, updated_at)를 추가하고 portfolios 엔티티에서 symbol/market 제거 및 asset_id FK 참조를 반영한다.
  • docs/interface-contract.md에 POST /v1/assets, PATCH /v1/assets/{asset_id}, PATCH /v1/assets/{asset_id}/deactivate 엔드포인트 명세를 추가하고 GET /v1/assets의 토큰 타입별 분기 동작을 갱신한다.
  • docs/runtime-flows.md의 "Flow: v1 API — GET /v1/assets" 섹션을 service-token-only에서 토큰 타입 분기 구조로 교체하고, admin asset CRUD HTTP 흐름을 신규 추가한다.
  • docs/project-structure.md의 app/cli/ Command groups 목록에 asset 커맨드 그룹을 추가하고, app/api/ v1 route surfaces에 admin asset CRUD 엔드포인트를 반영한다.

Acceptance Criteria

  1. Given 구현 완료 후, When docs/data-model.md를 검토, Then assets 테이블 스키마(asset_id, symbol UNIQUE, markets TEXT[], display_name, status)와 portfolios의 asset_id FK 참조, symbol/market 제거가 반영되어 있다.
  2. Given 구현 완료 후, When docs/interface-contract.md를 검토, Then POST/PATCH /v1/assets 및 PATCH /v1/assets/{id}/deactivate 엔드포인트 명세, GET /v1/assets 토큰 타입별 분기 동작이 포함되어 있다.
  3. Given 구현 완료 후, When docs/runtime-flows.md를 검토, Then "GET /v1/assets" 플로우가 토큰 타입 분기 구조(service/user/admin)로 갱신되어 있고 admin asset CRUD 흐름이 추가되어 있다.
  4. Given 구현 완료 후, When docs/project-structure.md를 검토, Then app/cli/ Command groups에 asset이 포함되고 app/api/ v1 route surfaces에 admin asset CRUD 엔드포인트가 반영되어 있다.

Impacted Area

  • Docs:
    • docs/data-model.md
    • docs/interface-contract.md
    • docs/runtime-flows.md
    • docs/project-structure.md
  • Modules: 없음 (문서 전용)
  • Tests: 없음 (문서 검토로 확인)

Notes

  • 이 REQ는 REQ-009~014 구현 완료 후 마지막으로 수행한다.
  • docs/runtime-flows.md Update Triggers: "새 top-level runtime 또는 domain 모듈이 추가되었을 때" — asset CLI 그룹 추가, GET /v1/assets 토큰 분기 재정의 모두 해당.
  • docs/project-structure.md Update Triggers: "새 top-level runtime 또는 domain 모듈이 추가되었을 때" — app/cli/commands/asset.py 신규 추가 해당.
  • Source: dcy-001 In Scope(baseline 문서 갱신)

Change Log

CHG-20260521-01

  • Date: 2026-05-21
  • Author: Justin Ko

Change Summary

  • Status: Approved → Implemented

Intent

  • BAT-002 confirm-batch-verification 완료. data-model/interface-contract/runtime-flows/project-structure 4개 문서 asset catalog 반영 확인. 모든 AC 검증 통과.

Acceptance Criteria Delta

  • No change

Impacted Area Delta

  • No change

Delivery Trace Delta

  • Batches:
    • BAT-002
  • Releases:
    • REL-001

Revalidation Impact

  • Reverification Needed: no
  • Existing Implementation Invalidated: no
  • Status Recommendation: implemented
  • Follow-up Action: none

CHG-20260519-02

  • Date: 2026-05-19
  • Author: Justin Ko

Change Summary

  • Status: Proposed → Approved

Intent

  • 승인 게이트 통과: 필수 필드(Status/Type/Priority/Owner/Intent/Requirement/AC/Impacted Area/Change Log) 모두 충족, AC 구체성 확인 완료

Acceptance Criteria Delta

  • No change

Impacted Area Delta

  • No change

Delivery Trace Delta

  • Batches:
    • none (미정)
  • Releases:
    • none (미정)

Revalidation Impact

  • Reverification Needed: no
  • Existing Implementation Invalidated: no
  • Status Recommendation: promote-to-approved
  • Follow-up Action: batch 계획 편입

CHG-20260519-01

  • Date: 2026-05-19
  • Author: Justin Ko

Change Summary

  • 최초 생성 — dcy-001 confirm-discovery 후 draft-req 실행

Intent

  • dcy-001 구현 범위의 baseline 문서 갱신 요구를 Documentation REQ로 분리

Acceptance Criteria Delta

  • Added:
    • AC-1~4 최초 작성

Impacted Area Delta

  • Docs:
    • docs/data-model.md, docs/interface-contract.md, docs/runtime-flows.md, docs/project-structure.md — 최초 지정
  • Modules:
    • 없음
  • Tests:
    • 없음

Delivery Trace Delta

  • Batches:
    • none (미정)
  • Releases:
    • none (미정)

Revalidation Impact

  • Reverification Needed: no
  • Existing Implementation Invalidated: no
  • Status Recommendation: keep-current
  • Follow-up Action: REQ-009~014 구현 완료 후 일괄 반영

Validation Plan

  • 각 대상 문서를 직접 검토하여 AC-1~4 기술 내용 포함 여부 확인
Reference in New Issue View Git Blame Copy Permalink