HBHR290_병행운영 대사 리포트
(Hereby) HR 급여 관리 > 시트 워크스페이스 > 병행운영 대사 리포트
| 앱 | HR 급여 관리 (hr-system, 포트 4000) |
| 대상 사용자 | 조건1 [HR_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | /workspace/group/deduction-screens/mockup-deduction-v1.html (병행운영 대사 리포트 장면) |
| 관련 정책 | [[POL_공제_판정]] · [[POL_공제_항목·요율]] · [[POL_공제_산정기초·비과세]] · [[POL_법정공제]] |
| Status | draft |
| Owner | 카나 |
| 부모 | [[HBHR100_시트 워크스페이스 (공통 Shell)]] |
| 관련 | [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] |
개요
- 병행운영 대사 리포트는 이카운트(기존 계산/세무사) 실값 vs Hereby 계산 라인을 직원 × 항목 단위로 대조하는 절체(cutover) 게이트 도구다 (IA 19529769 — ⑥편 매트릭스의 화면화). 차이를 "정상 사유"/"미분류"로 분류하고, 불일치 0 확인 후 절체하는 판단 근거를 제공한다.
- 📋 상태: 신규 제안(미구현 기획). 병행운영 레이어(FIG §3 Layer 5 병행운영, §2-4) 개념은 확인되나, 본 리포트 화면 자체는 미구현 기획이다. 따라서 모든 UI 텍스트는 "(기획 문구 — 목업 기준)"이며 tRPC procedure·엔티티는 TBU/(추정).
- 차이 분류 규칙(무엇이 정상 사유인가)의 정의는 본 사양서가 정하지 않는다 — [[POL_공제_항목·요율]] / [[POL_공제_산정기초·비과세]] 참조.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-08-24 | 카나 | PM | 최초 작성 (IA 19529769 기준, 📋 제안=미구현 기획 — UI 텍스트 기획 문구) |
Data I/O
Server → Client
| 변수 | DB 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
${recon.lines} | 직원 × 항목 대조 라인 (좌: 이카운트 실값 / 우: Hereby 계산) | 0건 시 Empty (-E) | (추정) · ✓ §3 Layer5 병행운영 |
${recon.diff} | 라인별 차이(금액·분류) | 차이 0이면 "일치" 표시 | (추정) |
${recon.category} | 차이 분류 ("정상 사유"/"미분류") | 미분류 = 조사 대상 | ✓ §3 Layer4 정상 사유 근거 |
${recon.cutoverReady} | 절체 가능 여부(미분류 불일치 0) | 미분류 잔존 시 false | (추정) · 절체 게이트 |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 이카운트 실값 업로드 | file (이카운트 export 파일) | TBU (미구현 — 업로드 인터페이스 추정) | payroll:confirm (추정) |
| 대조 실행 | year, month | TBU (미구현) | payroll:confirm (추정) |
| 차이 분류 지정 | lineId, 분류(정상 사유/미분류), 메모 | TBU (미구현) | payroll:write (추정) |
📋 미구현 기획으로 업로드·대조·분류 procedure·엔티티는 TBU. 차이 분류의 "정상 사유"(기준소득월액 차이·정산분·두루누리 등, §3 Layer4)와 "미분류"(조사 대상) 개념은 FIG §3 Layer4·§2-4 근거. 절체는 불일치 0 확인 후, 최소 2-3 급여주기 병행 후 수행하는 설계 추정.
화면 플로우 (Mermaid)
📋 미구현 기획 — 위 업로드·대조·분류·절체 게이트 동작은 기획/목업 기준이며 라이브 확정 아님.
병행운영 대사 리포트 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | 조건1 [HR_ADMIN]/조건2 [SUPER_ADMIN] 인증 후 병행운영 대사 리포트 진입. 미인증 시 [[HBHR100_시트 워크스페이스 (공통 Shell)]] 게이트 차단 | sheet_views (추정) | 📋 미구현 |
| 01 | 초기 상태 | Output | 이카운트 실값 업로드 전 = 업로드 유도 상태. 업로드·대조 후 대조 표 렌더 | $ | 기획 문구 — 목업 기준 |
| 10 | 이카운트 실값 업로드 | Button | • 이카운트(기존 계산) export 파일 업로드 진입 • 클릭 → 파일 선택 → 업로드(추정) - 실패·포맷 오류 동작: TBU (라이브 미확인) | 이카운트 export 파일 | 📋 미구현 · procedure TBU |
| 20 | 대조 실행 | Button | • year/month 기준 이카운트 실값 vs Hereby 계산 대조 실행 • 클릭 → 대조 표 산출(추정) | ${recon.lines} · [[HBHR280_법정공제 시트 (4대보험·소득세 월별)]] | 📋 미구현 |
| 30 | 대조 표 | Grid | • 직원 × 항목 라인 대조. 좌변 이카운트 실값(기존 계산/세무사) / 우변 Hereby 계산 - CASE01 [일치]: "일치" 표시 - CASE02 [불일치]: 차이 금액 + 분류 셀 노출 | ${recon.lines} · $ | ✓ §3 Layer5 |
| ㄴ31 | 대조 라인 아이템 | Cell | • 직원(예: 김간호)·항목(국민연금 등)·이카운트값·Hereby값·차이 표시 | sheet_rows · 이카운트 실값 | dev 페르소나 예시 |
| 40 | 차이 분류 | Badge | • 불일치 라인의 차이 분류 — "정상 사유" | "미분류"(기획 문구 — 목업 기준) - 정상 사유(§3 Layer4): 기준소득월액 차이·정산분·두루누리 등 - 미분류: 조사 대상 | ${recon.category} · [[POL_공제_항목·요율]] | ✓ §3 Layer4 근거 |
| ㄴ41 | 분류 지정 | Dropdown | • 미분류 라인을 "정상 사유"로 재분류(사유 메모) (추정) - 미확인 동작: TBU | $ | 📋 미구현 |
| 50 | 절체 게이트 요약 | Info | • 미분류 불일치 0 확인 시 절체 가능 안내. 최소 2-3 급여주기 병행 권고 - CASE01 [미분류 0]: 절체 가능 - CASE02 [미분류 잔존]: 절체 보류(조사 대상 잔존) | $ | ✓ §2-4·§3 절체 게이트 |
| 60 | 리포트 내보내기 | Button | • 대조 결과 리포트 내보내기 (추정) - 미확인 동작: TBU | TBU | 📋 미구현 · TBU |
| 30-E | Empty (대조 라인 0건) | Text | • 업로드/대조 전 또는 라인 0건 시 안내 (원문 TBU) | ${recon.lines}=0 | 원문 미확인 · TBU |
권한 요청 / 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [업로드] | 이카운트 실값 파일 업로드 | 대조 준비 상태 | payroll:confirm (추정) |
CASE02 [대조 실행] | year/month 대조 실행 | 직원 × 항목 대조 표 렌더 | 📋 미구현 |
CASE03 [일치] | 라인 차이 없음 | "일치" 표시 | 기획 문구 |
CASE04 [정상 사유] | 불일치 + 정상 사유 분류 | "정상 사유" 배지 (기준소득월액/정산분/두루누리) | ✓ §3 Layer4 |
CASE05 [미분류] | 불일치 + 미분류 | "미분류" 배지 (조사 대상) → 절체 보류 | ✓ 절체 게이트 |
CASE06 [절체 가능] | 미분류 불일치 0 | 절체 게이트 요약: 절체 가능(2-3 주기 병행 후) | ✓ §2-4 |
Open Question
- 이카운트 실값 업로드·대조·분류·내보내기 tRPC procedure·엔티티 = TBU (📋 미구현 기획)
- 이카운트 export 파일 포맷·컬럼 매핑(직원×항목 키) = TBU
- "정상 사유" 세부 분류 규칙(기준소득월액 차이/정산분/두루누리 등 경계) = [[POL_공제_항목·요율]]/[[POL_공제_산정기초·비과세]] 정의 대기 (사양 아님)
- 절체 게이트 "불일치 0"의 판정 대상(미분류만 vs 전체) 및 병행 주기 수 확정 = (추정) → TBU
- 대조 표·분류·절체 요약 UI 원문 확정 = TBU (기획 문구 기준, 라이브 실사 전)
- ⑥편 매트릭스(§2-4·§3)의 원 문서 대비 화면 항목 매핑 = TBU