docs: confirm monthly settlement discovery scope

2026-07-11 14:31:28 +09:00
parent 5ecd12f05a
commit 6c67b0427c
2 changed files with 33 additions and 32 deletions
@@ -1,11 +1,11 @@
 # 0. 문서 상태
 이 문서의 현재 상태와 식별 정보를 기록한다. 문서 추적과 승인 흐름에 필요한 최소 메타데이터를 적는다.

- 상태: draft
+- 상태: confirmed
 - 문서 ID: dcy-015_20260711_monthly-settlement-page-requirements-wireframe
 - 이슈명: 월정산 페이지 기능 요구사항 및 와이어프레임 수준 섹션 설계
 - 작성 시각(KST): 2026-07-11 10:48 KST
- 마지막 갱신 시각(KST): 2026-07-11 11:03 KST
+- 마지막 갱신 시각(KST): 2026-07-11 14:30 KST
 - 대체됨: 없음
 - 후속 Discovery 참조: 없음
 - 생성된 REQ 참조: 없음
@@ -180,50 +180,51 @@

 - A-1: “월정산”은 회계/세무 공식 결산이 아니라 가계 운영용 월간 마감·검토·요약 workflow를 뜻한다.
 - A-2: 기본 대상 월은 KST 기준 현재 월이며, 집계 기준은 기존 monthly cashflow와 동일하게 `transactions.transaction_date`다.
- A-3: 월정산 페이지는 Streamlit dashboard의 신규 page로 시작하고, MCP/agent-facing tool은 필요성이 확인되면 REQ 또는 후속 범위로 분리한다.
- A-4: 월정산 close가 포함될 경우 기존 snapshot close와 동일하게 append-only/correction 원칙을 따른다.
+- A-3: 월정산 페이지는 Streamlit dashboard의 신규 page로 시작하고, 1차 범위에서는 MCP/finance-agent-facing tool을 제외한다. 다만 내부 summary read model은 후속 MCP 확장이 가능하도록 service boundary를 유지한다.
+- A-4: 1차 범위에서는 월정산 close 상태를 별도 영속화하지 않고 read-only checklist/report 페이지로 시작한다. asset snapshot close는 기존 `자산/마감` 정책과 service를 재사용하며, 월정산 close 영속화는 후속 REQ 후보로 둔다.
+- A-5: PDF/Excel/Markdown export는 1차 범위에서 제외하고 후속 범위로 둔다.

 ## 오픈 질문

 - OQ-1: 월정산 close 상태를 영속화할 것인가, 아니면 read-only checklist/report 페이지로 시작할 것인가?
-  - 상태: Open
-  - 처리 방안: REQ 초안 전 사용자/최총무 확인 필요
-  - 종료 조건: `monthly_settlements` 같은 신규 table 필요 여부가 결정된다.
+  - 상태: Answered
+  - 처리 방안: 1차 범위에서는 월정산 close 상태를 영속화하지 않고 read-only checklist/report 페이지로 시작한다. 별도 `monthly_settlements` table이나 월정산 lock/close 엔티티는 만들지 않는다.
+  - 종료 조건: REQ 초안에서 dashboard read-only checklist/report 범위와 close 영속화 제외가 명시되면 완료.
 - OQ-2: 월정산 결과를 finance agent/MCP tool로 제공해야 하는가?
-  - 상태: Open
-  - 처리 방안: 최총무 운영 방식 확인 후 Interface 범위에 포함 여부 결정
-  - 종료 조건: dashboard-only 또는 dashboard+MCP 범위가 확정된다.
+  - 상태: Answered
+  - 처리 방안: 1차 범위에서는 MCP/finance-agent summary tool을 제외한다. 내부 summary read model은 후속 MCP 확장이 가능하도록 application/service boundary를 유지한다.
+  - 종료 조건: REQ 초안에서 dashboard-only 1차 범위와 MCP 후속 확장 가능성이 명시되면 완료.
 - OQ-3: 월정산 export(PDF/Excel/Markdown)까지 이번 범위에 포함할 것인가?
  - 상태: Deferred
-  - 처리 방안: 1차 페이지 구현 이후 후속 Discovery/REQ 후보로 둔다.
-  - 종료 조건: export 형식과 소비자가 확정된다.
+  - 처리 방안: PDF/Excel/Markdown export는 1차 범위에서 제외하고 후속 Discovery/REQ 후보로 둔다.
+  - 종료 조건: export 형식과 소비자가 확정되는 후속 범위가 별도로 생성되면 완료.

 # 7. 초기 성공 기준

 - S-1: 월정산 페이지의 섹션 순서와 각 섹션의 표시 지표/CTA가 REQ 작성 가능한 수준으로 확정된다.
 - S-2: 기존 구현과 중복되는 부분과 새로 필요한 read model/close state가 분리되어 구현 범위가 명확해진다.
 - S-3: GitHub issue #3/#4 본문과 Discovery 초안의 gap이 정리된다.
- S-4: 승인 후 REQ는 dashboard-only 1차 구현인지, dashboard+MCP+영속 close state 구현인지 결정 가능한 상태가 된다.
+- S-4: 승인 후 REQ는 dashboard-only read-only checklist/report 1차 구현으로 작성 가능하며, MCP/export/close 영속화는 후속 범위로 분리된다.

 ## 측정 방식 및 데이터 출처

 - S-1 측정 방식: Discovery/REQ 리뷰에서 섹션별 AC 도출 가능 여부 확인 / 데이터 출처: 본 Discovery, dashboard/app.py 현 구현
 - S-2 측정 방식: 영향을 받는 modules/docs 목록과 out-of-scope 항목 검토 / 데이터 출처: docs/project-structure.md, docs/runtime-flows.md, existing REQ-005/REQ-012/REQ-020
 - S-3 측정 방식: GitHub issue #3/#4 title/body 비교 / 데이터 출처: `genichin/jarca-ledger-mcp` issue #3/#4
- S-4 측정 방식: 사용자 결정 항목 OQ-1/OQ-2 해소 여부 / 데이터 출처: 사용자/최총무 확인
+- S-4 측정 방식: 사용자 승인 내용이 REQ 범위 경계에 반영됐는지 확인 / 데이터 출처: 사용자 승인, 본 Discovery

 # 8. REQ로 넘기기 전 확인 체크

 - [x] 최총무가 등록한 두 GitHub issue 본문 확인
  - 기준: repo issue #3/#4를 `gh issue view`로 확인 완료
- [ ] 월정산 close 영속화 여부 결정
-  - 기준: read-only page vs persistent monthly settlement state
- [ ] MCP/finance-agent-facing summary 포함 여부 결정
-  - 기준: dashboard-only vs dashboard+MCP
- [ ] export 범위 포함 여부 결정
-  - 기준: 1차 범위 포함 또는 후속 Deferred
- [ ] 최총무/사용자 승인
-  - 기준: 기능 요구사항과 와이어프레임 섹션 설계안 승인
+- [x] 월정산 close 영속화 여부 결정
+  - 기준: 1차 범위에서는 영속화하지 않고 read-only checklist/report 페이지로 시작
+- [x] MCP/finance-agent-facing summary 포함 여부 결정
+  - 기준: 1차 범위에서는 제외하되 내부 summary read model은 후속 MCP 확장 가능하게 설계
+- [x] export 범위 포함 여부 결정
+  - 기준: PDF/Excel/Markdown export는 후속 범위로 분리
+- [x] 최총무/사용자 승인
+  - 기준: 기능 요구사항과 8개 와이어프레임 섹션 설계안 승인

 # 9. 파일 처리 결과

@@ -242,14 +243,14 @@
 # 10. 사용자 결정 필요 항목 요약

 ## DECIDE
- `{{DECIDE_MONTHLY_SETTLEMENT_CLOSE_STATE}}`: 월정산 close 상태를 영속화할지, read-only checklist/report page로 시작할지 결정한다.
- `{{DECIDE_MONTHLY_SETTLEMENT_MCP_SCOPE}}`: 최총무/finance agent가 소비할 MCP monthly settlement summary tool을 이번 범위에 포함할지 결정한다.
+- 월정산 close 상태: 1차 범위에서는 영속화하지 않고 read-only checklist/report 페이지로 시작한다.
+- MCP/finance-agent summary tool: 1차 범위에서는 제외한다. 단, 내부 summary read model은 후속 MCP 확장 가능하게 설계한다.

 ## CONFIRM
- `{{CONFIRM_WIREFRAME_SECTION_ORDER}}`: Header, KPI, 현금흐름/지출, 예산, blocker, 자산/마감, evidence, 다음 액션 섹션 순서를 승인한다.
+- 와이어프레임 섹션 순서: Header, KPI, 현금흐름/지출, 예산, blocker, 자산/마감, evidence, 다음 액션의 8개 순서를 승인한다.

 ## DATA
- `{{DATA_MONTHLY_SETTLEMENT_EXPORT_NEED}}`: PDF/Excel/Markdown export 필요 여부와 소비자를 확인한다.
+- PDF/Excel/Markdown export: 후속 범위로 둔다.

 # 11. Discovery Freeze
 REQ 초안 작성 인계 시점의 확정 플래그와 섹션 참조만 기록한다. 내용 재작성 없이 원본 섹션을 링크로 대신한다.
@@ -262,8 +263,8 @@ REQ 초안 작성 인계 시점의 확정 플래그와 섹션 참조만 기록
 - 사용자 결정 필요: [# 10. 사용자 결정 필요 항목 요약](#10-사용자-결정-필요-항목-요약)

 ## Freeze 플래그
- Handoff Decision: 보류
- Handoff Rationale: 초기 Discovery 초안 생성 및 GitHub issue #3/#4 본문 확인 완료. 월정산 close/MCP 범위 결정 후 REQ 초안 작성 가능.
- Ready for REQ Drafting: false
- Confirmed By: 없음
- Confirmed At (KST): 없음
+- Handoff Decision: 승인
+- Handoff Rationale: GitHub issue #3/#4 본문 확인 및 사용자 승인으로 1차 범위가 dashboard read-only checklist/report로 확정되었다. 월정산 close 영속화, MCP/finance-agent summary tool, PDF/Excel/Markdown export는 후속 범위로 분리하고, 8개 와이어프레임 섹션 순서를 REQ 입력으로 사용한다.
+- Ready for REQ Drafting: true
+- Confirmed By: 진환 고
+- Confirmed At (KST): 2026-07-11 14:30 KST
@@ -20,4 +20,4 @@
 | dcy-012_20260703_review-queue-reconciliation-workbench-persistence | 20260703 | 확인필요 큐 / 잔액대조 워크벤치 영속화 및 운영 모델 정립 | [Discovery](./dcy-012_20260703_review-queue-reconciliation-workbench-persistence.md) | confirmed |
 | dcy-013_20260707_docker-network-mcp-deployment | 20260707 | Jarca Ledger 독립 Docker 배포 및 network MCP endpoint 제공 | [Discovery](./dcy-013_20260707_docker-network-mcp-deployment.md) | confirmed |
 | dcy-014_20260708_import-provenance-sensitive-data-policy | 20260708 | Import provenance 및 민감자료 저장 정책 정리 | [Discovery](./dcy-014_20260708_import-provenance-sensitive-data-policy.md) | confirmed |
-| dcy-015_20260711_monthly-settlement-page-requirements-wireframe | 20260711 | 월정산 페이지 기능 요구사항 및 와이어프레임 수준 섹션 설계 | [Discovery](./dcy-015_20260711_monthly-settlement-page-requirements-wireframe.md) | draft |
+| dcy-015_20260711_monthly-settlement-page-requirements-wireframe | 20260711 | 월정산 페이지 기능 요구사항 및 와이어프레임 수준 섹션 설계 | [Discovery](./dcy-015_20260711_monthly-settlement-page-requirements-wireframe.md) | confirmed |