From 6c67b0427c695e1bde7455304c476e6ad18f84f6 Mon Sep 17 00:00:00 2001 From: Jarca Date: Sat, 11 Jul 2026 14:31:28 +0900 Subject: [PATCH] docs: confirm monthly settlement discovery scope --- ...-settlement-page-requirements-wireframe.md | 63 ++++++++++--------- docs/discovery/index.md | 2 +- 2 files changed, 33 insertions(+), 32 deletions(-) diff --git a/docs/discovery/dcy-015_20260711_monthly-settlement-page-requirements-wireframe.md b/docs/discovery/dcy-015_20260711_monthly-settlement-page-requirements-wireframe.md index 3f8e1aa..ee536f1 100644 --- a/docs/discovery/dcy-015_20260711_monthly-settlement-page-requirements-wireframe.md +++ b/docs/discovery/dcy-015_20260711_monthly-settlement-page-requirements-wireframe.md @@ -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 diff --git a/docs/discovery/index.md b/docs/discovery/index.md index 8aed1be..3e91420 100644 --- a/docs/discovery/index.md +++ b/docs/discovery/index.md @@ -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 |