jarca-ledger-mcp/docs/batches/bat-003_20260629_statement-unavailable-reconciliation/implementation.md

BAT-003 Implementation

코드 변경

• jarca_ledger_mcp/db.py
  • schema version 7
  • accounts.statement_status TEXT NOT NULL DEFAULT 'unknown'
  • 기존 DB용 additive column migration
• jarca_ledger_mcp/service.py
  • VALID_STATEMENT_STATUSES 및 reconciliation 대상 상수
  • create_ledger_account에 statement_status 입력 추가
  • update_ledger_account 신규 추가
  • get_balance_reconciliation_report 신규 추가
• jarca_ledger_mcp/server.py
  • create_ledger_account signature 확장
  • update_ledger_account, get_balance_reconciliation_report MCP tool 추가
• dashboard/app.py
  • 계좌 화면에 statement 상태 표시/수정 UI 추가
  • 최소 잔액대조 결과 표 추가
• tests/test_service.py
  • schema version 7 반영
  • statement status validation 및 balance reconciliation 테스트 추가

운영 안전

• 운영 DB 변경 전 dcy-002 백업 절차를 먼저 수행한다.
• 검증 DB에서 preview/reconcile 후 운영 DB에 반영한다.
• restore는 사용자의 명시 승인 없이 실행하지 않는다.