Files

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

3.0 KiB

Raw Blame History

BAT-001: asset catalog DB 기반 도입

Status: released
Profile: standard
Source Discovery: dcy-001
Included REQ: REQ-009, REQ-011, REQ-014
Excluded REQ: REQ-010, REQ-012, REQ-013, REQ-015 (→ BAT-002 예정)

Summary

dcy-001의 핵심 DB 변경을 단일 delivery 단위로 묶는다.
assets catalog 테이블을 신규 도입(REQ-009)하고, portfolios 테이블을 asset_id FK 참조 구조로 재설계하며 symbol/market 컬럼을 제거(REQ-011)한다.
기존 운영 데이터를 손실 없이 assets catalog로 이전하고 portfolios.asset_id를 채운 후 레거시 컬럼을 삭제하는 데이터 마이그레이션(REQ-014)을 원자적 Alembic revision으로 완성한다.
이 batch 완료 후 admin CRUD API/CLI(REQ-010), portfolio 생성 검증(REQ-012), GET /v1/assets 분기 재작성(REQ-013) 착수가 가능해진다.

Scope

In Scope:
- assets 테이블 Alembic revision (asset_id UUID PK, symbol UNIQUE, markets TEXT[], GIN index)
- MarketCode Enum(KRX, NXT, SOR, NASDAQ, NYSE, UPBIT, BITTHUMB) — app/domain/models.py
- Asset 도메인 모델 — app/domain/models.py
- asset CRUD Protocol 선언 — app/repositories/portfolio_repository.py
- asset CRUD Postgres 구현 — app/repositories/postgres.py
- portfolios.asset_id UUID NOT NULL FK REFERENCES assets(asset_id) ON DELETE RESTRICT 추가 Alembic revision
- portfolios.symbol, portfolios.market 컬럼 제거 Alembic revision
- portfolios 기존 데이터를 assets catalog로 이전하는 데이터 마이그레이션 Alembic revision (ARRAY_AGG(DISTINCT market), 단일 트랜잭션)
- Portfolio 도메인 모델 symbol/market 제거, asset_id 추가 — app/domain/models.py
- app/repositories/postgres.py portfolios 쿼리 — assets JOIN 반영, symbol/market 참조 제거
- symbol/market 직접 참조 모듈 전수 수정 (app/api, app/cli, app/schemas)
- tests/test_asset_catalog.py 신규 — REQ-009 AC-1~~5, REQ-011 AC-1~~5, REQ-014 AC-1~6
Out of Scope:
- admin asset CRUD HTTP API/CLI (→ REQ-010, BAT-002)
- pfhub portfolio create catalog 검증 (→ REQ-012, BAT-002)
- GET /v1/assets token-type 분기 재작성 (→ REQ-013, BAT-002)
- baseline 문서 갱신 (→ REQ-015, BAT-002)
- tag 모델 관련 모든 변경 (→ dcy-002 batches)

Documents

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

Notes

R-2(High): 구현 착수 전 grep -rn "\.symbol\|\.market" app/ 전수 조사 필수 — 6개 이상 모듈에 참조 잔존 가능성
REQ-011 schema 변경과 REQ-014 데이터 이전은 같은 Alembic revision 또는 순서 보장된 revision 시퀀스로 처리해야 한다 (REQ-014 Notes)
운영 데이터 migration이 포함되므로 로컬 DB에서 사전 dry-run 검증 권장
dcy-002 REQ-002, REQ-003는 이 batch 완료 후에 착수 가능 (portfolios 재설계 선행 필요)

3.0 KiB Raw Blame History

BAT-001: asset catalog DB 기반 도입

Summary

Scope

Documents

Notes

3.0 KiB

Raw Blame History