HBHR282_계산 진단 패널 드로어
(Hereby) HR 급여 관리 > 시트 워크스페이스 > 법정공제 시트 > 계산 진단 패널 드로어
| 앱 | HR 급여 관리 (hr-system, 포트 4000) |
| 대상 사용자 | 조건1 [HR_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | /workspace/group/deduction-screens/mockup-deduction-v1.html (계산 진단 드로어 장면) |
| 관련 정책 | [[POL_공제_판정]] · [[POL_공제_항목·요율]] · [[POL_법정공제]] |
| Status | draft |
| Owner | 카나 |
| 부모 | [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] |
| 관련 | [[HBHR281_판정 상세·수동 판정 모달]] |
개요
- 계산 진단 패널은 [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] 우측에서 열리는 「계산이 안되는 경우」 드로어로, 미계산·판정불가·요율 부재 행의 사유를 모아 보여준다 (IA 19529769 — 이카운트 계승, 기획서 화면 ⑦).
- 📋 상태: 제안(미구현 기획). 진단이 참조하는 실체(요율 부재 → 커밋 거부 §6-5②, 판정 입력 부재 → 이상값 §6-4①)는 FIG PoC에서 확인되나, 본 드로어 화면 자체는 미구현 기획이다. 따라서 모든 UI 텍스트는 "(기획 문구 — 목업 기준)"이며 tRPC procedure·엔티티는 TBU/(추정).
- 사유 분류의 규칙 정의는 본 사양서가 정하지 않는다 — [[POL_공제_판정]] / [[POL_공제_항목·요율]] 참조.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-08-24 | 카나 | PM | 최초 작성 (IA 19529769 기준, 📋 제안=미구현 기획 — UI 텍스트 기획 문구) |
Data I/O
Server → Client
| 변수 | DB 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
${diag.uncalculated} | ①미계산 행 목록 (수식 미해결/입력 부재) | 0건 시 분류 숨김 | (추정) · ✓ 미계산 = 소득세 표/구간 없음 warn(§6-6) 등 |
${diag.unjudged} | ②판정불가 행 목록 (판정 입력 부재로 이상값·연령 0) | 0건 시 분류 숨김 | (추정) · ✓ §6-4① fail-safe |
${diag.noRate} | ③요율 부재 행 목록 (귀속월 [$statutory.*] 유효값 없음) | 0건 시 분류 숨김 | ✓ §6-5② 커밋 거부 원인 |
${diag.total} | 문제 행 총건수 | 0건 시 Empty (-E) | (추정) |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 진단 드로어 열기 | sheetViewId | TBU (미구현 — 클라이언트 필터/조회 인터페이스 추정) | payroll:write (추정) |
| 행 클릭 → 시트 행 점프 | rowId | 클라이언트 스크롤/포커스 (추정) | — |
📋 미구현 기획으로 진단 집계 procedure·엔티티는 TBU. 각 분류는 §6 실체(요율 부재=§6-5② 커밋 거부, 판정불가=§6-4① 이상값, 미계산=§6-6 표/구간 없음 warn·조용한 0 방지)를 화면화한 것으로 설계 추정.
화면 플로우 (Mermaid)
📋 미구현 기획 — 위 분류 문구·행 점프 동작은 기획/목업 기준이며 라이브 확정 아님.
계산 진단 패널 드로어 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]]에서 계산 진단 진입 버튼 클릭 시 우측 드로어 오픈. 조건1 [HR_ADMIN]/조건2 [SUPER_ADMIN] | HBHR280 계산 진단 진입(80) | 📋 미구현 |
| 01 | 초기 상태 | Output | 드로어 제목 "계산이 안되는 경우"(기획 문구 — 목업 기준) + 사유 3분류 목록 | $ | 기획 문구 — 목업 기준 |
| 10 | 드로어 헤더 | Text | • 제목 "계산이 안되는 경우"(기획 문구 — 목업 기준) + 문제 행 총건수 | $ | 기획 문구 |
| 20 | ①미계산 분류 | List | • "미계산"(기획 문구 — 목업 기준) — 수식 미해결/입력 부재 행 목록 - 예: 소득세 표/구간 없어 셀 비움 warn(§6-6, 조용한 0 방지) • 행 클릭 → 해당 시트 행 점프 (추정) | ${diag.uncalculated} · [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] | ✓ 근거 §6-6 |
| ㄴ21 | 미계산 행 아이템 | ListItem | • 직원·항목·사유 표시(예: 김간호·소득세·"구간 없음") + 클릭 시 시트 행 점프(추정) | sheet_rows | dev 페르소나 예시 |
| 30 | ②판정불가 분류 | List | • "판정불가"(기획 문구 — 목업 기준) — 판정 입력 부재로 이상값·연령 0 행 목록 • 행 클릭 → [[HBHR281_판정 상세·수동 판정 모달]] 또는 시트 행 점프 (추정) | ${diag.unjudged} · [[HBHR281_판정 상세·수동 판정 모달]] | ✓ 근거 §6-4① |
| ㄴ31 | 판정불가 행 아이템 | ListItem | • 직원·항목·사유(예: 이행정·국민연금·"연령 0") + 클릭 시 점프(추정) | sheet_rows | dev 페르소나 예시 |
| 40 | ③요율 부재 분류 | List | • "요율 부재"(기획 문구 — 목업 기준) — 귀속월 [$statutory.*] 유효값 없는 행 목록. 커밋 거부 원인 - 관련: 커밋 거부 원문 "귀속월(2026-08)에 유효한 파라미터가 없어 커밋할 수 없어요"(기획 문구 — 목업 기준) • 행 클릭 → 시트 행 점프(추정) | ${diag.noRate} · [[POL_공제_항목·요율]] | ✓ 근거 §6-5② |
| ㄴ41 | 요율 부재 행 아이템 | ListItem | • 직원·항목·사유(예: 박수술·건강보험·"요율 없음") + 클릭 시 점프(추정) | sheet_rows | dev 페르소나 예시 |
| 50 | 행 점프 | Button | • 진단 목록의 행 클릭 시 해당 법정공제 시트 행으로 스크롤·포커스 (추정) - 미확인 동작: TBU | [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] | 📋 미구현 · 점프 동작 추정 |
| 60 | 닫기 | Button | • 드로어 닫기 (Esc) | 클라이언트 상태 | |
| 00-E | Empty (문제 0건) | Text | • 문제 행 0건 시 "계산이 안 되는 행이 없어요"(기획 문구 — 목업 기준) | ${diag.total}=0 | 기획 문구 — 목업 기준 |
권한 요청 / 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [진단 진입] | 계산 진단 버튼 클릭 | 우측 드로어 오픈 | 📋 미구현 |
CASE02 [미계산 행] | 수식 미해결/입력 부재 | ①미계산 분류에 노출 | ✓ §6-6 warn |
CASE03 [판정불가 행] | 판정 입력 부재(이상값·연령0) | ②판정불가 분류에 노출 | ✓ §6-4① |
CASE04 [요율 부재 행] | 귀속월 [$statutory.*] 유효값 없음 | ③요율 부재 분류에 노출 (커밋 거부 원인) | ✓ §6-5② |
CASE05 [문제 0건] | 미계산·판정불가·요율 부재 모두 0건 | Empty "계산이 안 되는 행이 없어요" | 기획 문구 |
Open Question
- 진단 집계 tRPC procedure·엔티티 = TBU (📋 미구현 기획)
- 행 클릭 시 점프 목적지(시트 행 vs [[HBHR281_판정 상세·수동 판정 모달]]) 구분 = (추정) → 확정 TBU
- 3분류 세부 판정 로직(미계산/판정불가/요율 부재 경계) = [[POL_공제_판정]]/[[POL_공제_항목·요율]] 정의 대기 (사양 아님)
- 드로어 헤더·아이템 표시 UI 원문 확정 = TBU (기획 문구 기준, 라이브 실사 전)
- 이카운트 계승(기획서 화면 ⑦)의 원 화면 대비 항목 매핑 = TBU