portfolio-hub/docs/batches/bat-015_20260601_rel-001-feedback-cleanup/index.md

BAT-015: REL-001 Feedback 정합화 (ledger 컬럼명 / LoginRequest 엄격화 / health db_enabled)

• Status: release-candidate
• Profile: standard
• Source Discovery: dcy-005
• Included REQ: REQ-033, REQ-034, REQ-035
• Excluded REQ: 없음

Summary

• dcy-005(rel-001-feedback-cleanup) 산출물 3건을 단일 batch로 묶어 일괄 정합화한다. 3건 모두 변경 면적이 좁고 같은 release(REL-002 분리 예정) target으로 일관된 정합화 묶음 trigger를 가진다.

Scope

• In Scope:
  • REQ-033: ledger_trades.asset_id → portfolio_id 컬럼명 정합화 (Alembic 신규 revision + postgres.py SQL 갱신 + 도메인 모델/라우트 정합)
  • REQ-034: LoginRequest에 model_config = ConfigDict(extra="forbid") 적용 + pytest 422 회귀
  • REQ-035: HealthResponse에 db_enabled: bool 필드 추가 + healthcheck() 핸들러 갱신 + docs/runtime-flows.md baseline 명문화 + docs/interface-contract.md /health 응답 schema 갱신
• Out of Scope:
  • ledger_trades 의미 재정의(asset 단위 vs portfolio 단위 — REQ-033 portfolio_id 의미 확정 가정)
  • session token TTL 정책 변경(REQ-021 본문 자체 갱신은 본 batch 범위 밖)
  • /readiness endpoint 분리(production-grade readiness probe, 별도 후속 Discovery로 처리)
  • REL-001 verification 재실행 (별도 REL-002로 분리 — dcy-005 OQ-3 결정)

Documents

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

Notes

• 공통 trigger: REL-001 Feedback Handoff 3건 정합화 묶음
• 공통 release: REL-002 분리 배포 예정(dcy-005 OQ-3 결정, 2026-06-01)
• REQ-033 마이그레이션 staging dry-run을 verification 단계에서 수행해 운영 lock 시간 < 1초(NFR-1) 측정
• REQ-035는 baseline 문서(docs/runtime-flows.md) 갱신 요구를 포함하므로 design 단계에서 architecture impact를 runtime-flows로 표기
• 본 워크스페이스는 개발용이므로 prod 운영 영향 검증은 release 단계에서 별도 수행 (memory: workspace_purpose)