jarca-ledger-mcp/docs/batches/bat-020_20260712_monthly-settlement-evidence-next-actions-verification-hardening/implementation.md

BAT-020 Implementation Evidence

• Timestamp: 2026-07-12T19:20:23+09:00 (KST 기준)
• Batch: BAT-020
• REQ: REQ-025
• Scope: 월정산 페이지 read-only Evidence / 다음 액션 하드닝, AppTest 검증 강화, docs 정합성 반영

변경 파일

• dashboard/app.py
• tests/test_dashboard_app.py
• docs/project-structure.md
• docs/runtime-flows.md

변경 요약

1. dashboard/app.py

   • page_monthly_settlement() 의 자산 / 순자산 마감 상태 블록 뒤에 월정산 결과 / Evidence 섹션 추가.
   • 해당 섹션에서 읽기 전용 근거 요약과 함께 close 준비 상태, source coverage, 최근 Import, 자산/마감, 미해결 블로커를 read-only 텍스트로 노출.
   • 즉시 뒤 다음 액션 섹션 추가.
   • 문구에 예산 조정 후보, 분류/검토 규칙 후보, 대조/Import/백업 후속 작업, 이번 범위에는 월정산 close 저장/실행이 포함되지 않습니다 포함.
   • 새로운 쓰기/마감 동작이나 close 실행 버튼은 추가하지 않음.

2. tests/test_dashboard_app.py

   • 월정산 페이지 AppTest 분기에서 위 요구 문자열을 검증하도록 assertion 확장.
   • 기존 forbidden 문자열 검증 (fixture.sqlite3, .local/share/jarca/uploads, /home/, raw_payload) 유지.

3. 문서

   • docs/project-structure.md: 월정산 Evidence/다음 액션 책임 반영 및 change log 추가.
   • docs/runtime-flows.md: 월정산 read-only evidence/next-action 운영 플로우 문서화 및 change log 추가.

검증 명령

• /home/ubuntu/workspaces/jarca-ledger-mcp/.venv/bin/python -m ruff check .
• /home/ubuntu/workspaces/jarca-ledger-mcp/.venv/bin/python -m pytest -q tests/test_dashboard_app.py
• /home/ubuntu/workspaces/jarca-ledger-mcp/.venv/bin/python scripts/ci_dashboard_http_smoke.py

AC 대응 매핑 (REQ-025)

• AC-1: 월정산 페이지에 Evidence 헤더/요약 블록 노출
  • 월정산 결과 / Evidence, 읽기 전용 근거 요약 텍스트 추가로 검증.
• AC-2: 다음 액션 제시 및 read-only 경계 유지
  • 다음 액션 및 close 비포함 문구, 후보 항목 텍스트 추가.
• AC-3: 근거 문자열 및 소스 범위 가시성 확보
  • close 준비 상태, source coverage, 최근 Import, 자산/마감 노출.
• AC-4: 기존 경량 UI 노출 및 위험 정보 차단
  • fixture.sqlite3, /home/, .local/share/jarca/uploads, raw_payload 미포함 보장 (테스트로 확인).
• AC-5: 문서 동기화
  • project-structure/runtime-flows에 월정산 완료 하드닝 반영 및 change log 갱신.