jarca-ledger-mcp/docs/batches/bat-009_20260701_manual-asset-crud-snapshot-close/index.md

BAT-009 Manual asset CRUD / snapshot close

• Profile: standard
• Status: release-candidate
• Included REQ: REQ-011, REQ-012
• Discovery: dcy-009
• Owner: 렛저장인
• Date (KST): 2026-07-01

목표

REQ-011/REQ-012에 따라 manual_assets write lifecycle, month-end snapshot preview/close, append-only correction policy, mutation MCP, operator dashboard UX, source/is_closed 표기 정렬을 구현한다. 동시에 기존 BAT-008 read model/REQ-005 dashboard safety fallback/dcy-007 contract regression을 깨지 않도록 write/read 일관성을 유지한다.

산출물

• manual_assets create/update/deactivate write support and validation
• snapshot preview/close/correction service APIs and additive persistence metadata
• mutation MCP tools/contracts: manual asset CRUD, snapshot preview, snapshot close
• dashboard/app.py operator UX for manual asset management and month-end close preview/execute
• regression tests for write/read consistency, correction policy, contract envelope, dashboard fallback
• docs/data-model.md, docs/interface-contract.md, docs/project-structure.md, docs/runtime-flows.md baseline write-workflow updates
• BAT-009 planning/design/implementation/verification documents and synthetic-only evidence

범위 제한

• 외부 시세/부동산 자동 평가 연동
• 월말 자동 스케줄링/cron close
• 투자 조언/리밸런싱/세금/수익률 계산
• production ledger DB 실데이터 기반 evidence

문서

• planning.md: delivery plan, dependency, risks, validation entry criteria
• design.md: write-model/correction/MCP/UI design
• implementation.md: changed files, execution log, validation commands
• verification.md: AC mapping, PASS/FAIL, REQ Implemented decision