HBMD260_청구 금액 내역
(Hereby) 경영 대시보드 > [[HBMD100_Shell·사이드바]] > 운영현황 > 청구 금액 내역
| 앱 | 경영 대시보드 (HBMD) |
| 대상 사용자 | 조건1 [경영 대시보드 조회 권한] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | review |
| Owner | 카나 (PM) |
개요
- 선택 연도의 청구 금액 내역을 월별 테이블로 보여주고, "+ 청구 금액 추가" 모달로 수동 등록하는 섹션이다. 과거/현재 월(등록됨) + 미래/미지정 월("미지정", 수정 disabled)로 나뉜다.
- 청구 금액은 수동 입력이며 원천은 front 기준 localStorage.hereby_revenue_entries(ClaimAmount)다. 외부 청구/보험 시스템 연동은 없다(live 미확인). 저장은 사람 확정 + audit 필요.
- 금액은 예시값(연도·월 종속).
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-13 | 카나 | PM | 버튼 행동 명세 보강 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 + 확정 스타일 |
Data I/O
Server → Client
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| $ | 연도 (예 "2026년") | current year | |
| $ | 월별 청구 금액 (hereby_revenue_entries/ClaimAmount) | "미지정" | 미등록 월 = "미지정" |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 청구 금액 추가 | yearMonth·amount | sdk.managementDashboard.claimAmount.create() (추정) | claim:create (추정) |
| 청구 금액 수정 | claimAmountId·amount | sdk.managementDashboard.claimAmount.update() (추정) | claim:update (추정) |
사람 저장, audit 필요.
화면 플로우
청구 금액 내역 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | • 선택 연도 청구 금액 데이터가 있을 때 노출 | ClaimAmount | |
| 10 | 제목 | Text | • 섹션 제목 "청구 금액 내역 · 2026년" | selectedYear | |
| 20 | 청구 금액 추가 | Button | • 청구 금액을 수동 등록하는 모달을 여는 기능 "+ 청구 금액 추가" • 클릭 시: "청구 금액 추가" 모달 open (년월·청구 금액 행 입력) | create modal open | mutation |
| 30 | 과거/현재 월 table | Table | • 등록된 월별 청구 금액 표. 예시 "2026-01 142,763,736" / "2026-02 144,568,975" / "2026-03 237,276,016" / "2026-04 206,017,645" / "2026-05 200,776,163" / "2026-06 194,575,986" • 클릭 시: row별 수정 버튼 → 수정 (UI 상세 TBU) | ClaimAmount | 예시값(월 선택 종속) |
| 40 | 미래/미지정 월 table | Table | • 미등록 월 표. "2026-07"에서 "2026-12" = "미지정" • 클릭 시: 수정 disabled | ClaimAmount null | 미래월 미지정 |
| ㄴ41 | disabled tooltip | Tooltip | • 미지정 row hover 시 안내 원문 "청구 금액은 상단 '+ 청구 금액 추가' 버튼으로 등록하세요" | census 원문 |
청구 금액 추가 Modal 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | • "+ 청구 금액 추가" 클릭 시 모달 open | ClaimAmount create | 저장 미실행 |
| 10 | 제목 | Text | • 모달 제목 "청구 금액 추가" | ||
| 20 | 년월 | Input | • 청구 대상 년월 입력 "년월", value 예시 "2026-06" (month input) • 입력 시: yearMonth 지정 | ClaimAmount.yearMonth | |
| 30 | 청구 금액 (원) | Input Box | • 청구 금액 입력 "청구 금액 (원)", placeholder "0" • 입력 시: amount 지정 | ClaimAmount.amount | |
| 40 | 취소 | Button | • 저장 없이 모달을 닫는 기능 "취소" • 클릭 시: 모달 close | close | |
| 50 | 저장 | Button | • 입력값을 ClaimAmount로 생성하는 기능 "저장" • 클릭 시: ClaimAmount create (hereby_revenue_entries). 사람 저장, audit 필요 | ClaimAmount create | 사람 확정 |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [청구 금액 추가] | "+ 청구 금액 추가" → 년월·금액 → "저장" | ClaimAmount 생성 | 사람 저장, audit 필요 |
CASE02 [미래월 수정 시도] | 미지정 row hover | 수정 disabled + tooltip | 상단 버튼으로 등록 유도 |
Open Question
- 청구 금액 수정 모달 UI(row별 수정) 상세 = TBU
- 외부 청구/보험 시스템 연동 여부(현재 수동 입력 = hereby_revenue_entries, 외부 연동 없음) = TBU
- audit trail(누가·언제 청구 금액 입력/수정) UI = TBU
- 청구 금액 추가/수정 모달 풀페이지 전환 가능성 — 7/14-16 코드 변경 반영 대기 — 라이브 확인 필요