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

BAT-005 Verification

검증 계획

1. Python 문법 검증
   • .venv/bin/python -m py_compile jarca_ledger_mcp/db.py jarca_ledger_mcp/service.py jarca_ledger_mcp/server.py dashboard/app.py scripts/streamlit_browser_evidence.py tests/test_service.py
2. 대상 service regression
   • .venv/bin/python -m pytest tests/test_service.py -q
3. 전체 테스트
   • .venv/bin/python -m pytest -q
4. Streamlit browser evidence
   • .venv/bin/python scripts/streamlit_browser_evidence.py --page 요약 --output-dir docs/batches/bat-005_20260629_dashboard-operations-hub-liquidity-monthly-cashflow/evidence/run-<timestamp>
5. 민감정보 검토
   • evidence fixture는 synthetic 데이터만 포함한다.
   • 운영 DB 기본 경로, 실제 금융 원본 파일명, 비밀번호, raw_payload는 포함하지 않는다.

Acceptance Mapping

• AC-1: db.py schema/migration 및 schema version 8.
• AC-2: normalize_liquidity_bucket, create/update validation tests.
• AC-3: account create/list/update regression tests 및 MCP signature.
• AC-4: dashboard/app.py top section 월간 cashflow metrics.
• AC-5/6/7: get_asset_liquidity_report regression 및 overview asset/liability/missing balance sections.
• AC-8: overview operational warning metrics/caption.
• AC-9: pytest 및 browser evidence result.
• AC-10: baseline docs updated.

결과

최종 검증 결과(2026-06-29 KST):

• source .venv/bin/activate && python -m py_compile jarca_ledger_mcp/db.py jarca_ledger_mcp/service.py jarca_ledger_mcp/server.py dashboard/app.py scripts/streamlit_browser_evidence.py tests/test_service.py tests/test_ledger_categories.py — PASS.
• source .venv/bin/activate && pytest tests/test_service.py -q — PASS (9 passed).
• source .venv/bin/activate && pytest -q — PASS (31 passed, 4 skipped).
• source .venv/bin/activate && python scripts/streamlit_browser_evidence.py --page 요약 --output-dir docs/batches/bat-005_20260629_dashboard-operations-hub-liquidity-monthly-cashflow/evidence/run-20260629-2111 — PASS.
  • Evidence directory: docs/batches/bat-005_20260629_dashboard-operations-hub-liquidity-monthly-cashflow/evidence/run-20260629-2111/
  • Manifest: manifest.json (success: true).
  • Captured page: 요약 / overview.png 303,341 bytes / overview.dom.html 30,757 bytes.
  • DOM evidence includes schema v8, KST 이번 달, 이번 달 수입/지출 현황, and 자산 유동성 현황 from a synthetic fixture DB.

Sensitive Evidence Review

• Evidence DB path is the generated fixture path under BAT-005 evidence, not the operating DB default path.
• Fixture rows use Synthetic/SYNTHETIC_* labels and do not include real account numbers, real financial source filenames, passwords, or raw payloads.