# BAT-001: asset catalog DB 기반 도입

- Status: verified
- 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](./planning.md)
- Design: [design.md](./design.md)
- Implementation: [implementation.md](./implementation.md)
- Verification: [verification.md](./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 재설계 선행 필요)