docs: confirm monthly settlement issue sources
This commit is contained in:
Jarca
@@ -5,12 +5,12 @@
|
||||
- 문서 ID: dcy-015_20260711_monthly-settlement-page-requirements-wireframe
|
||||
- 이슈명: 월정산 페이지 기능 요구사항 및 와이어프레임 수준 섹션 설계
|
||||
- 작성 시각(KST): 2026-07-11 10:48 KST
|
||||
- 마지막 갱신 시각(KST): 2026-07-11 10:48 KST
|
||||
- 마지막 갱신 시각(KST): 2026-07-11 11:03 KST
|
||||
- 대체됨: 없음
|
||||
- 후속 Discovery 참조: 없음
|
||||
- 생성된 REQ 참조: 없음
|
||||
- 요청 출처: 최총무 요청으로 전달된 Project 4 항목 제목 `[Feature] 월정산 페이지 기능 요구사항 정의`, `[Design] 월정산 페이지 와이어프레임 수준 섹션 설계안`
|
||||
- Project 4 확인 상태: GitHub CLI token에 `read:project` scope가 없어 Project item 본문/상태 확인은 blocked. 사용자가 전달한 두 제목을 기준 입력으로 사용한다.
|
||||
- 요청 출처: 최총무가 등록한 GitHub Issues #3 `[Feature] 월정산 페이지 기능 요구사항 정의`, #4 `[Design] 월정산 페이지 와이어프레임 수준 섹션 설계안`
|
||||
- GitHub 확인 상태: repository issue 본문은 확인 완료. GitHub Project 4 API 직접 조회는 현재 CLI token의 `read:project` scope 부족으로 별도 blocked이나, 원문 요구사항은 issue #3/#4에서 확인했다.
|
||||
|
||||
# 1. 계획 상태 요약
|
||||
현재 Discovery가 어떤 배경에서 작성되고 있는지, 연계 문서가 있는지, 지금 시점의 해석이 무엇인지 짧게 요약한다.
|
||||
@@ -18,7 +18,7 @@
|
||||
- 연계 문서 현황:
|
||||
- 관련 Discovery: dcy-005(대시보드 운영 허브/monthly cashflow), dcy-008(자산 스냅샷/평가), dcy-009(월말 스냅샷 생성/마감), dcy-012(확인필요/잔액대조 워크벤치), dcy-014(import provenance)
|
||||
- 관련 REQ: REQ-005, REQ-010, REQ-012, REQ-020, REQ-021
|
||||
- 관련 Project 4 항목: 제목은 전달받았으나 Project API scope 부족으로 본문/상태 미확인
|
||||
- 관련 GitHub Issues: #3 `[Feature] 월정산 페이지 기능 요구사항 정의`, #4 `[Design] 월정산 페이지 와이어프레임 수준 섹션 설계안` — 본문 확인 완료
|
||||
- 해석:
|
||||
- 기존 `요약`과 `자산/마감` 화면은 월중 운영 현황과 자산 스냅샷 close 기능을 제공하지만, 월말 또는 특정 월의 재무 운영을 한 번에 결산·검토·확정하는 전용 `월정산` 페이지는 없다.
|
||||
- 이번 Discovery는 구현에 바로 들어가기 전, 월정산 페이지의 기능 요구사항과 와이어프레임 수준 섹션 구성을 먼저 정의해 최총무/finance workflow가 사용할 운영 화면의 책임 경계를 확정하는 작업이다.
|
||||
@@ -51,7 +51,7 @@
|
||||
- 제약사항:
|
||||
- Jarca Ledger 서비스/DB가 source of truth이며, agent memory에 정산 데이터를 저장하지 않는다.
|
||||
- 운영 DB 변경은 additive/idempotent여야 하며, 월정산 close가 필요하다면 preview와 명시적 확정 단계를 분리해야 한다.
|
||||
- Project 4 상세 본문은 현재 `read:project` scope 부족으로 확인되지 않았으므로, 본 Discovery는 전달받은 제목과 repo 상태 기반 초안이다.
|
||||
- GitHub Project 4의 board metadata는 `read:project` scope 부족으로 직접 조회하지 못했지만, 최총무가 등록한 repo issue #3/#4 본문은 확인했으므로 요구사항 원문 근거는 확보했다.
|
||||
|
||||
## 주요 사용자 시나리오
|
||||
|
||||
@@ -161,7 +161,7 @@
|
||||
- 외부 금융기관 자동 잔액 동기화
|
||||
- 세무/법률 회계 리포트
|
||||
- PDF/Excel export의 최종 양식 확정
|
||||
- Project 4 item status 변경. 현재 token scope 부족으로 보드 상태 확인 불가
|
||||
- Project 4 item status 변경. board field 조작은 이번 Discovery 범위가 아니며 별도 evidence/권한이 필요
|
||||
|
||||
# 6. 리스크/가정 목록
|
||||
|
||||
@@ -171,8 +171,8 @@
|
||||
- 완화: `요약`은 월중 운영 허브, `월정산`은 월말 검토·마감 orchestration으로 책임을 분리한다.
|
||||
- R-2 (High): 월정산 close를 새로 영속화할 경우 기존 asset snapshot close와 이중 마감 상태가 생길 수 있다.
|
||||
- 완화: REQ 단계에서 월정산 close를 read-only checklist로 둘지, 별도 `monthly_settlements` 상태로 둘지 명확히 결정한다.
|
||||
- R-3 (Medium): 최총무가 요청한 Project item 본문에 추가 조건이 있을 수 있으나 현재 Project API scope 부족으로 확인하지 못했다.
|
||||
- 완화: GitHub token `read:project` scope 복구 후 Project item 본문을 재확인하고 Discovery를 보강한다.
|
||||
- R-3 (Low): GitHub Project 4의 board 상태/field metadata는 현재 Project API scope 부족으로 직접 확인하지 못했다.
|
||||
- 완화: 요구사항 본문은 repo issue #3/#4에서 확인했으며, Project field 상태가 필요할 때만 `read:project` scope를 복구한다.
|
||||
- R-4 (Medium): 월정산 summary가 finance agent 입력으로 사용될 경우 privacy/sensitive boundary를 잘못 잡으면 raw evidence 노출 위험이 있다.
|
||||
- 완화: REQ-021 minimal/operator-summary/debug-gated policy를 그대로 적용한다.
|
||||
|
||||
@@ -202,20 +202,20 @@
|
||||
|
||||
- S-1: 월정산 페이지의 섹션 순서와 각 섹션의 표시 지표/CTA가 REQ 작성 가능한 수준으로 확정된다.
|
||||
- S-2: 기존 구현과 중복되는 부분과 새로 필요한 read model/close state가 분리되어 구현 범위가 명확해진다.
|
||||
- S-3: Project 4 item 본문을 확인한 뒤 최총무 요청사항과 Discovery 초안의 gap이 정리된다.
|
||||
- S-3: GitHub issue #3/#4 본문과 Discovery 초안의 gap이 정리된다.
|
||||
- S-4: 승인 후 REQ는 dashboard-only 1차 구현인지, dashboard+MCP+영속 close state 구현인지 결정 가능한 상태가 된다.
|
||||
|
||||
## 측정 방식 및 데이터 출처
|
||||
|
||||
- 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 측정 방식: `read:project` scope 복구 후 Project 4 item title/body 비교 / 데이터 출처: GitHub Project 4
|
||||
- S-3 측정 방식: GitHub issue #3/#4 title/body 비교 / 데이터 출처: `genichin/jarca-ledger-mcp` issue #3/#4
|
||||
- S-4 측정 방식: 사용자 결정 항목 OQ-1/OQ-2 해소 여부 / 데이터 출처: 사용자/최총무 확인
|
||||
|
||||
# 8. REQ로 넘기기 전 확인 체크
|
||||
|
||||
- [ ] Project 4 두 항목의 본문/상태 확인
|
||||
- 기준: GitHub CLI token에 `read:project` scope가 있어야 함
|
||||
- [x] 최총무가 등록한 두 GitHub issue 본문 확인
|
||||
- 기준: repo issue #3/#4를 `gh issue view`로 확인 완료
|
||||
- [ ] 월정산 close 영속화 여부 결정
|
||||
- 기준: read-only page vs persistent monthly settlement state
|
||||
- [ ] MCP/finance-agent-facing summary 포함 여부 결정
|
||||
@@ -246,7 +246,6 @@
|
||||
- `{{DECIDE_MONTHLY_SETTLEMENT_MCP_SCOPE}}`: 최총무/finance agent가 소비할 MCP monthly settlement summary tool을 이번 범위에 포함할지 결정한다.
|
||||
|
||||
## CONFIRM
|
||||
- `{{CONFIRM_PROJECT4_ITEM_BODY}}`: Project 4의 `[Feature]`, `[Design]` 항목 본문/상태를 확인해 본 Discovery 초안과 차이를 검토한다.
|
||||
- `{{CONFIRM_WIREFRAME_SECTION_ORDER}}`: Header, KPI, 현금흐름/지출, 예산, blocker, 자산/마감, evidence, 다음 액션 섹션 순서를 승인한다.
|
||||
|
||||
## DATA
|
||||
@@ -264,7 +263,7 @@ REQ 초안 작성 인계 시점의 확정 플래그와 섹션 참조만 기록
|
||||
|
||||
## Freeze 플래그
|
||||
- Handoff Decision: 보류
|
||||
- Handoff Rationale: 초기 Discovery 초안 생성 완료. Project 4 item 본문 확인과 월정산 close/MCP 범위 결정 후 REQ 초안 작성 가능.
|
||||
- Handoff Rationale: 초기 Discovery 초안 생성 및 GitHub issue #3/#4 본문 확인 완료. 월정산 close/MCP 범위 결정 후 REQ 초안 작성 가능.
|
||||
- Ready for REQ Drafting: false
|
||||
- Confirmed By: 없음
|
||||
- Confirmed At (KST): 없음
|
||||
|
||||
Reference in New Issue
Block a user