HBHR203_재계산 diff 뷰

(Hereby) HR 급여 관리 > 시트 워크스페이스 > 급여대장 시트 > 재계산 diff 뷰


앱	HR 급여 관리 (hr-system, 포트 4000)
대상 사용자	`조건1 [HR_ADMIN]` / `조건2 [SUPER_ADMIN]`
프로토타입	TBU
관련 정책	[[POL_급여정본경계]]
Status	draft
Owner	카나
부모	[[HBHR200_급여대장 시트]]

개요

재계산 diff 뷰는 급여 시트의 전 시트 공통 우측 컬럼군으로, 재계산 전/후 지급·공제·실수령 변화와 차액, 그리고 eCount export용 코드군을 함께 노출한다.
변경 전/후 지급·공제·실수령·차액을 나란히 보여줘 재계산 영향을 검토할 수 있게 하며, AI recalcExplain이 "왜 변동됐는지"를 자연어로 설명해 부착한다(읽기 전용, P1).
이 뷰가 compute preview(확정 전 재계산 미리보기)인지 commit audit(확정 후 감사 비교)인지의 구분 = TBU. 확정 전 계산은 sheet_cells.computedValue, 확정 후 정본은 allowance_records/deduction_records 및 inputSnapshot 기반 (추정).
본 컬럼군은 전 급여 시트([[HBHR210_계약급여내역 시트]]~[[HBHR270_전자서명 발송·eCount 연동 시트 (2섹션)]])에서 1회 정의로 공유되며 각 시트 문서는 이 뷰를 참조한다(중복 정의 금지).

문서 히스토리

날짜	작성자	팀	변경 내용
2026-07-06	카나	PM	최초 작성
2026-07-21	카나	PM	GC700 깊이 재작성
2026-07-21	카나	PM	가독성 패스 + 액션 표기 (GUIDE §7·§8)
2026-07-21	카나	PM	셀 스타일 확정판 적용 (콸 승인)
2026-07-21	카나	PM	TC 크로스체크 확정분 반영 (🟡)

Data I/O

Server → Client

변수	DB 엔티티.컬럼	값 없을 때	비고
`${before}`	기확정 allowance/deduction_records 또는 이전 computedValue (추정)	없으면 "변화 없음" 표시	변경 전 값
`${after}`	재계산 `sheet_cells.computedValue`	없으면 미계산	변경 후 값
`${diff}`	after − before (클라이언트 산출, 추정)	0이면 "-"	차액
`${input_snapshot}`	`sheet_cells.inputSnapshot` / `allowance_records.inputSnapshot`	없으면 recalcExplain 비활성	recalcExplain 근거
`${ecount}`	eCount export 필드 (코드/부서코드/사원명/금액 매핑)	미매핑 시 공란	export군
`${excludedRecords}`	`payroll.exportEcount` 반환 `excludedRecords.{allowance, deduction}` (급여대장 aggregate 컬럼 미앵커 record 수)	0이면 전량 export	(TC 확정: 10:10.6 excludedRecords)

공통 우측 컬럼군 (순서)

순서	컬럼군	컬럼
1	eCount export군	코드 / 부서코드 / 사원명 / 금액
2	식별	사번 / 성명 (employee 참조)
3	지급 diff	변경 전 지급 / 변경 후 지급
4	공제 diff	변경 전 공제 / 변경 후 공제
5	실수령 diff	변경 전 실수령 / 변경 후 실수령
6	차액	after − before

화면 플로우 (재계산 diff)

diff/explain은 읽기 전용 검토 단계. 확정(record 생성)은 사람이 [[HBHR201_전체 확정 (commit)]]에서 실행.

재계산 diff 뷰 사양표

번호	항목/기능명	타입	사양 및 기능 설명	연관/영향 범위	비고
00	노출 조건	-	• 급여 시트 우측 공통 컬럼군으로 노출 (재계산 diff + eCount)	전 시트 공통	TBU: 진입 경로 (상시 vs 뷰 전환)
01	초기 상태	Output	• 재계산 미발생 시 변경 전=변경 후, 차액 "-" 표시
10	eCount export군	Column	• 코드 / 부서코드 / 사원명 / 금액 — 이카운트 연동 매핑. 미매핑 시 공란 　- CASE01 [aggregate 컬럼 미앵커 record]: `payroll.exportEcount` 시 export 제외 → `excludedRecords.{allowance,deduction}` 카운트로 보고	eCount export	(TC 확정: 10:10.6)
20	식별 컬럼	Column	• 사번 / 성명 — employee 참조. read-only	sheet_rows.employeeId	read-only
30	지급 diff	Column	• 변경 전 지급 / 변경 후 지급	allowance_records / computedValue
40	공제 diff	Column	• 변경 전 공제 / 변경 후 공제	deduction_records / computedValue
50	실수령 diff	Column	• 변경 전 실수령 / 변경 후 실수령	payroll_records.netPay
60	차액	Column	• after − before 차액 표시		TBU: 산출 기준 (월 대비/재계산 대비)
70	AI recalcExplain	Info	• 차액에 "왜 변동됐는지" 자연어 설명을 부착하는 기능 (읽기 전용). output key 역추적(tracePayrollKey) • 클릭 시: 차액 hover/선택 → 자연어 변동 설명 부착 　- 값 없음: inputSnapshot 없으면 recalcExplain 비활성	inputSnapshot / calculator	읽기 전용, P1
60-E	Empty (변화 없음)	Text	• 재계산 없거나 before=after 시 차액 "-", explain 비활성

AI 접점 (recalcExplain)

재계산 diff 뷰는 AI recalcExplain의 트리거 위치다. 차액에 대해 어느 calculator·source table·input·parameter에서 변동이 왔는지 inputSnapshot과 output key를 역추적해 설명한다. Module Manager의 calc.tracePayrollKey와 연결된다. 안전 경계: 읽기 전용 — AI는 설명·추적만 하고 재계산 실행·commit은 하지 않는다 ([[POL_급여정본경계]]).

권한·상태 분기 요약

시나리오	트리거	결과	비고
`CASE01 [재계산]`	요율/파라미터/셀 변경	변경 후 값 + 차액 산출	preview 단계
`CASE02 [recalcExplain]`	차액 셀 hover/선택	자연어 변동 설명 부착	읽기 전용
`CASE03 [eCount]`	export (`payroll.exportEcount`)	코드/부서코드/사원명/금액 매핑 출력, 미앵커 record는 excludedRecords로 제외 보고	이카운트 · (TC 확정: 10:10.6)

Open Question

compute preview vs commit audit 구분 = TBU ("변경 전" baseline이 이전 record인지 이전 computedValue인지)
diff 뷰 진입 경로 (상시 우측 컬럼 vs 별도 뷰 전환) = TBU
recalcExplain의 ai_generated enum 매핑 및 P1 범위 = TBU
eCount 코드군 ↔ allowance_item_codes / deduction_item_codes(code varchar(4)) 매핑 상세 = TBU
차액 산출 기준(월 대비 / 재계산 대비)과 audit 저장 위치 = TBU

HBHR203_재계산 diff 뷰 ​

개요 ​

문서 히스토리 ​

Data I/O ​

Server → Client ​

공통 우측 컬럼군 (순서) ​

화면 플로우 (재계산 diff) ​

재계산 diff 뷰 사양표 ​

AI 접점 (recalcExplain) ​

권한·상태 분기 요약 ​

Open Question ​