카드 합계 vs 상세 내역 차이 원인 추적 도구(배분/숨김 반영) 추가 #18

New Issue

Hyein · 2026-04-22T17:32:53+09:00

Hyein commented

2026-04-22 17:32:53 +09:00

대상 브랜치: manage

배경

사용자 피드백 기준으로, 카드에는 입출금이 보이는데 상세 테이블에는 0으로 보이는 케이스가 반복되었습니다.
현재는 숨김 계정 정책/배분 비율 때문에 차이가 발생할 수 있으나, 화면에서 원인 설명이 부족합니다.

문제 정의

"카드 숫자"와 "상세 숫자"가 다르면 사용자는 데이터 오류로 인식함
실제로는 아래 요인이 반영되었을 수 있음
- 배분 비율(해당/총 프로젝트) 적용
- 프로젝트 화면 숨김 계정 제외
- 화면별 집계 기준 차이

제안 작업

카드/상세 차이에 대한 계산 근거(브리지) UI 추가
상세 팝업에 “제외된 계정 합계”와 “배분 적용 전/후 금액” 표시
필요 시 전용 디버그 API 추가
- 예: /api/project-reconcile-detail
운영자가 원인을 30초 내 설명할 수 있는 수준으로 표준화

완료 기준 (Acceptance Criteria)

카드-상세 차이가 발생할 때, 사용자 화면에서 원인을 확인할 수 있다.
배분/숨김/필터 조건이 어떤 금액에 어떻게 반영됐는지 수치로 표시된다.
동일 프로젝트를 새로고침해도 설명값이 일관되다.

산출물

UI: 차이 원인 설명 패널(또는 팝업)
API: 필요 시 근거 상세 응답
문서: 운영자용 설명 가이드 1페이지

참조

관련 파일: PTC/management_dashboard_preview.html, server/ptc_api_server.py
연관 커밋: bc611c3

대상 브랜치: manage ## 배경 사용자 피드백 기준으로, 카드에는 입출금이 보이는데 상세 테이블에는 0으로 보이는 케이스가 반복되었습니다. 현재는 숨김 계정 정책/배분 비율 때문에 차이가 발생할 수 있으나, 화면에서 원인 설명이 부족합니다. ## 문제 정의 - "카드 숫자"와 "상세 숫자"가 다르면 사용자는 데이터 오류로 인식함 - 실제로는 아래 요인이 반영되었을 수 있음 - 배분 비율(`해당/총 프로젝트`) 적용 - 프로젝트 화면 숨김 계정 제외 - 화면별 집계 기준 차이 ## 제안 작업 1. 카드/상세 차이에 대한 `계산 근거(브리지)` UI 추가 2. 상세 팝업에 “제외된 계정 합계”와 “배분 적용 전/후 금액” 표시 3. 필요 시 전용 디버그 API 추가 - 예: `/api/project-reconcile-detail` 4. 운영자가 원인을 30초 내 설명할 수 있는 수준으로 표준화 ## 완료 기준 (Acceptance Criteria) - 카드-상세 차이가 발생할 때, 사용자 화면에서 원인을 확인할 수 있다. - 배분/숨김/필터 조건이 어떤 금액에 어떻게 반영됐는지 수치로 표시된다. - 동일 프로젝트를 새로고침해도 설명값이 일관되다. ## 산출물 - UI: 차이 원인 설명 패널(또는 팝업) - API: 필요 시 근거 상세 응답 - 문서: 운영자용 설명 가이드 1페이지 ## 참조 - 관련 파일: `PTC/management_dashboard_preview.html`, `server/ptc_api_server.py` - 연관 커밋: `bc611c3`

Hyein referenced this issue

2026-04-22 17:32:53 +09:00

[Master] PTC 전용 차세대 실행 분석 및 자금 관리 통합 플랫폼 구축 #1

Hyein changed title from ~~[manage] 카드 합계 vs 상세 내역 차이 원인 추적 도구(배분/숨김 반영) 추가~~ to 카드 합계 vs 상세 내역 차이 원인 추적 도구(배분/숨김 반영) 추가

2026-04-22 17:34:04 +09:00

Hyein added reference manage

2026-04-22 17:35:50 +09:00

Hyein closed this issue

2026-04-22 17:52:10 +09:00

Hyein added the ptc 실행분석 label 2026-05-04 09:28:30 +09:00

Sign in to join this conversation.