Files
jarca-ledger-mcp/docs/batches/bat-005_20260629_dashboard-operations-hub-liquidity-monthly-cashflow/implementation.md
T

2.0 KiB

BAT-005 Implementation

코드 변경

  • jarca_ledger_mcp/db.py
    • schema version을 8로 올리고 accounts.liquidity_bucket TEXT NOT NULL DEFAULT 'other'를 schema 및 additive migration 목록에 추가한다.
  • jarca_ledger_mcp/service.py
    • VALID_LIQUIDITY_BUCKETS와 normalize_liquidity_bucket 검증을 추가한다.
    • create_ledger_account/update_ledger_account에서 liquidity_bucket을 저장·수정한다.
    • get_asset_liquidity_report를 추가해 accounts.last_balance 기반 버킷 합계, 총자산, 총부채, 순자산, 미입력 계좌를 반환한다.
  • jarca_ledger_mcp/server.py
    • MCP account create/update tool signature에 liquidity_bucket을 추가하고 get_asset_liquidity_report tool을 노출한다.
  • dashboard/app.py
    • 요약 화면을 REQ-005 운영 허브 순서로 재구성한다.
    • KST 현재 월 기준 월간 실제 수입/지출/순현금흐름/저축률을 최상단에 표시한다.
    • 자산 유동성, 자산 구성, 예산/지출, 운영 경고 섹션을 추가한다.
    • 계좌 화면에 liquidity_bucket 표시/수정 control을 추가한다.
  • scripts/streamlit_browser_evidence.py
    • synthetic fixture에 cash, investment, loan, real_estate bucket 계좌와 월간 수입/지출/예산 데이터를 추가한다.
  • tests/test_service.py
    • schema version, liquidity bucket 검증, account flow, asset liquidity report regression을 추가한다.

문서 변경

  • docs/batches/bat-005_20260629_dashboard-operations-hub-liquidity-monthly-cashflow/
  • docs/batches/index.md
  • docs/srs/Interface/req-005_dashboard-operations-hub-liquidity-monthly-cashflow.md
  • docs/data-model.md
  • docs/project-structure.md
  • docs/runtime-flows.md
  • docs/interface-contract.md

운영 안전

  • 운영 DB와 실제 금융 원본 파일은 사용하지 않는다.
  • browser evidence는 synthetic fixture DB로만 생성한다.
  • migration은 additive/idempotent이며 기존 계좌의 bucket은 other 기본값으로 안전하게 채워진다.