jarca-ledger-mcp/docs/batches/bat-008_20260630_asset-snapshots-manual-assets-read-mcp/index.md

BAT-008 Asset snapshots / manual assets / read MCP

• Profile: standard
• Status: release-candidate
• Included REQ: REQ-009, REQ-010
• Discovery: dcy-008
• Owner: 렛저장인
• Date (KST): 2026-06-30

목표

REQ-009/REQ-010에 따라 asset_snapshots/manual_assets 저장 모델을 additive/idempotent하게 도입하고, 월말 수동 스냅샷 정책을 수용하는 집계 계층과 조회성 MCP(기준일 스냅샷/순자산 시계열/수기 자산 조회)를 구현한다. 동시에 대시보드 자산/순자산 표시가 동일 권위 소스와 동일 산식을 사용하도록 정렬한다.

산출물

• asset_snapshots, manual_assets additive/idempotent schema migration
• 수기 자산 저장/조회, 스냅샷 누적, 순자산 시계열 집계 service 함수
• 조회성 MCP tool/응답 계약: 기준일 자산 스냅샷, 순자산 시계열, 수기 자산 조회
• dashboard/app.py의 자산/순자산 표시가 신규 모델과 안전 폴백을 함께 지원하도록 정렬
• docs/data-model.md, docs/interface-contract.md, docs/project-structure.md, docs/runtime-flows.md baseline 갱신
• BAT-008 planning/design/implementation/verification 문서와 synthetic-only 검증 evidence

범위 제한

• 외부 시세/부동산 자동 평가 연동
• 스냅샷 생성 mutation MCP
• 수기 자산 생성/수정/삭제 mutation MCP
• 투자 조언/리밸런싱/세금/수익률 계산
• 운영 DB 실데이터 기반 evidence

문서

• planning.md: delivery plan, dependency, risk, validation entry criteria
• design.md: schema/authority-source/fallback/read-contract design
• implementation.md: changed files, execution log, validation commands
• verification.md: AC mapping, PASS/FAIL, REQ Implemented decision