HBMD220_월별 현황·월 상세
(Hereby) 경영 대시보드 > [[HBMD100_Shell·사이드바]] > 운영현황 > 월별 현황·월 상세
| 앱 | 경영 대시보드 (HBMD) |
| 대상 사용자 | 조건1 [경영 대시보드 조회 권한] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | review |
| Owner | 카나 (PM) |
개요
- 운영현황의 "월별 현황" selector와 그 아래 "선택 월 상세 내역"을 묶은 섹션이다. selector에서 월 버튼을 고르면 하단에 해당 월 4카드(청구금액 · 인건비(인센티브 포함) · 차액(영업손익) · 인력 충원도)가 노출된다.
- selector 월 버튼에 표기되는 차액(예 "1월 +808만")과 상세 차액 카드의 정의가 다르다: selector 월 차액은 기본 월별 ClaimAmount − grossPay 계열로 보이고, 상세 차액 카드는 인센티브를 포함한 ClaimAmount − grossPay − incentiveTotalAmount 계열로 계산되는 정황이다(HBMD000 margin 3종 참조). 상세 차액 카드의 상태 배지 원문은 "흑자"다.
- 모든 금액/인원은 **예시값(월 선택 종속)**이다. selectedMonth default = current month(예 7/1 재진입 시 7월).
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 + 확정 스타일 |
Data I/O
Server → Client
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| ${selectedYear} / $ | 연도·월 | current | 월 선택 종속 |
| $ | selector 월 버튼 차액 표기 (예 "6월 -602만") | disabled | 기본 월별 계열 |
| $ | 선택월 상세 4카드 (청구금액/인건비+인센티브/차액/인력 충원도) | hide | 월 버튼 선택 후 |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 월 버튼 선택 | year·month | 해당 월 상세 재조회 | - |
| 이전 해 / 다음 해 | year∓1 | selectedYear 변경 | - |
미래 월·데이터 없는 월 = disabled.
화면 플로우
월별 현황 selector 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | • selectedYear의 월별 차액 데이터가 있을 때 노출 | MonthlyKpi | |
| 10 | 이전 해 | Button | • 조회 연도를 한 해 이전으로 이동하는 기능 "‹", title "이전 해" • 클릭 시: year-- 후 해당 연도 월별 현황 재조회 | selectedYear | |
| 20 | 제목 | Text | • selector 제목 "2026년 월별 현황" | ||
| 30 | 다음 해 | Button | • 조회 연도를 한 해 다음으로 이동하는 기능 "›", title "다음 해" • 클릭 시: 현재 disabled (future) | selectedYear | future disabled |
| 40 | 이번 달 | Button | • 현재 월로 selector를 이동하는 기능 "이번 달" • 클릭 시: 현재 disabled | selectedMonth | |
| 50 | 월 버튼 | Button group | • 월별 차액을 표기하고 선택 시 상세를 여는 기능. 예시 "1월 +808만" / "2월 -923만" / "3월 +3,619만" / "4월 +1,526만" / "5월 +2,151만" / "6월 -602만". 차액 = 기본 월별 계열(ClaimAmount − grossPay 정황) • 클릭 시: 해당 월 상세 4카드 노출 | selectedMonth | 예시값(월 선택 종속) |
| 60 | 미래 월 | Button disabled | • 데이터 없는 미래 월 표기 "7월 —"에서 "12월 —" • 클릭 시: disabled (선택 불가) | future disabled |
선택 월 상세 내역 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | • 월 버튼 선택 후 해당 월 데이터 노출 | MonthlyDetail | |
| 10 | 제목 | Text | • 선택월 상세 제목 "6월 상세 내역" (7/1 default는 7월) | selectedMonth | |
| 20 | 설명 | Text | • 섹션 설명 원문 "위에서 선택한 월의 데이터예요" | ||
| 30 | 청구금액 | Card | • 선택월 청구액을 보여주는 카드 "청구금액", 배지 "정상", value 예시 "1.9억"(월 선택 종속) | ClaimAmount | 배지 원문 "정상" |
| 40 | 인건비 (인센티브 포함) | Card | • 선택월 인센티브 포함 인건비 카드 "인건비 (인센티브 포함)", value 예시 "2.1억"(월 선택 종속), detail 원문 "인센티브 1,096만 · 62건"(인센티브 금액 · 건수) | Payroll + Incentive | 예시값(월 선택 종속) |
| 50 | 차액 (영업손익) | Card | • 선택월 영업손익 차액 카드 "차액 (영업손익)", 배지 "흑자". 산식 = ClaimAmount − grossPay − incentiveTotalAmount(인센티브 포함) 정황 — selector 월 차액(ClaimAmount − grossPay 정황)과 정의 다름 | ClaimAmount − grossPay − Incentive | 배지 원문 "흑자" · selector 차액과 정의 차이 |
| 60 | 인력 충원도 | Card | • 선택월 병동 인력 충원도 카드 "인력 충원도", 배지 "전 병동 충족", value 예시 "+15명", detail 원문 "현재 44명 · 피크 필요 29명" | NursingStaffingSnapshot | 배지 원문 "전 병동 충족" |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [월 선택] | selector 월 버튼 | 해당 월 상세 4카드 노출 | read-only |
CASE02 [미래 월] | 7월~12월 버튼 | disabled | 데이터 없음 |
Open Question
- ★ selector 월 차액(ClaimAmount − grossPay 정황) vs 상세 차액 카드(− incentive 포함) 정본 산식 통일 = TBU
- 상세 4카드 상태 배지("정상" · "흑자" · "전 병동 충족") 판정 임계값 정의 = TBU
- 청구금액 관련 입력/수정 모달(HBMD260 연동) 풀페이지 전환 가능성 — 7/14-16 코드 변경 반영 대기 — 라이브 확인 필요