HBHR231_근태 내역 시트 (근무시간 유형 집계)
(Hereby) HR 급여 관리 > 시트 워크스페이스 > 근태 내역 시트
| 앱 | HR 급여 관리 (hr-system, 포트 4000) |
| 대상 사용자 | 조건1 [HR_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | review |
| Owner | 카나 |
| 부모 | [[HBHR100_시트 워크스페이스 (공통 Shell)]] |
개요
- 근태 내역 시트는 직원별 근무시간 유형별 집계값을 한 행으로 표현하는, 출퇴근 내역([[HBHR230_출퇴근 내역 시트]])의 롤업 시트다.
- 좌→우 11컬럼: # / 사번 / 이름 / 일반 / 연장 / 야간 / 야간연장 + 휴일 4종(휴일일반근무 / 휴일연장 / 휴일야간 / 휴일야간연장).
- 출퇴근 내역의 일자별 분해값이 직원 단위·월 단위로 유형별 집계되어, 각 유형이 급여 가산수당(연장/야간/휴일 배수) 입력이 된다.
- 시트는 급여 작업공간이며, 이 유형 집계값이 급여대장([[HBHR200_급여대장 시트]]) 제수당 컬럼(ƒ)에 입력되어 확정 시에만 정본화된다 ([[POL_급여정본경계]] — 시트=작업공간 vs 정본=commit 경계).
- 공통 우측 컬럼군(재계산 diff + eCount)은 **[[HBHR203_재계산 diff 뷰]]**을 참조한다.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-13 | 카나 | PM | 버튼 행동 명세 보강 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 |
| 2026-07-21 | 카나 | PM | 가독성 패스 + 액션 표기 (GUIDE §7·§8) |
| 2026-07-21 | 카나 | PM | 셀 스타일 확정판 적용 (콸 승인) |
Data I/O
Server → Client
| 변수 | DB 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
${sheet.rows} | 직원별 근태 집계 (attendances 월 롤업, employeeId 단위 1행) | 0건 시 빈 그리드 | employeeId 단위 1행 |
${row.regular} | Σ attendances.regularHours | 미집계 시 0 | 일반 근무시간 |
${row.night} | Σ attendances.nightHours | 미집계 시 0 | 야간 근무시간 |
${row.holiday*} | Σ attendances.holidayHours / holidayRegularHours / holidayNightHours | 미집계 시 0 | 휴일 세부 |
Calculator 연동
- 근태 → 급여 입력 관계: 각 유형 집계 시간 × 통상시급([[HBHR210_계약급여내역 시트]]) × 유형별 배수 = 해당 가산수당.
- 배수는 근로기준법/
organization_parameters기준(실값 = TBU). - 이 집계값이 급여대장([[HBHR200_급여대장 시트]]) 제수당 컬럼(ƒ)의 입력 원천이 되어 확정 시
allowance_records로 정본화.
원천 흐름
- 원천 = [[HBHR230_출퇴근 내역 시트]] 일자별 분해값 → 본 시트에서 직원 단위·월 단위 유형 집계 → 급여대장 가산수당 입력.
화면 플로우 (Mermaid)
컬럼 사양표 (11컬럼, 좌→우 — 기본 템플릿 기준)
컬럼 순서·명칭은 기본 템플릿 기준이며, 시트별 실데이터는 사용자 컬럼 편집으로 변형될 수 있다. 내부 fieldKey 10종: employeeNumber / employeeName / regular / overtime / night / nightOvertime / holidayRegular / holidayOvertime / holidayNight / holidayNightOvertime.
| # | 컬럼 | 타입 | 설명 (용도·형식) | 연관 (ERD/calculator/타 앱) | 비고 |
|---|---|---|---|---|---|
| 1 | # | Index | • 행 순번을 표시하는 시스템 컬럼 (read-only) | sheet_rows.sortOrder | read-only |
| 2 | 사번 | Text (system) | • 직원 사번을 표시하는 시스템 컬럼 (read-only) | employees.employeeNumber / fieldKey=employeeNumber | 시스템 컬럼 |
| 3 | 이름 | Text (system) | • 직원 성명을 표시하는 시스템 컬럼 (read-only) | employees.name / fieldKey=employeeName | 시스템 컬럼 (라벨 "이름") |
| 4 | 일반 | Output/Number | • 일반(정규) 근무시간 집계(h)를 표시하는 Output 컬럼 | Σ attendances.regularHours / fieldKey=regular | 기본 근무 |
| 5 | 연장 | Output/Number | • 평일 연장 근무시간 집계(h)를 표시하는 Output 컬럼 | Σ attendances.overtimeHours / fieldKey=overtime · [[HBHR220_연장근무 내역 시트]] 정합 | ×1.5 가산(추정) |
| 6 | 야간 | Output/Number | • 야간(22-06시) 근무시간 집계(h)를 표시하는 Output 컬럼 | Σ attendances.nightHours / fieldKey=night | ×0.5 가산(추정) |
| 7 | 야간연장 | Output/Number | • 야간+연장 중복 근무시간 집계(h)를 표시하는 Output 컬럼 | attendances 파생(야간∩연장) / fieldKey=nightOvertime | 중복 가산 산정 |
| 8 | 휴일일반근무 | Output/Number | • 휴일 정규 근무시간 집계(h)를 표시하는 Output 컬럼 | Σ attendances.holidayRegularHours / fieldKey=holidayRegular | 휴일근로 가산 |
| 9 | 휴일연장 | Output/Number | • 휴일 연장 근무시간 집계(h)를 표시하는 Output 컬럼 | attendances.holidayHours 파생 / fieldKey=holidayOvertime | 휴일+연장 가산 |
| 10 | 휴일야간 | Output/Number | • 휴일 야간 근무시간 집계(h)를 표시하는 Output 컬럼 | Σ attendances.holidayNightHours / fieldKey=holidayNight | 휴일+야간 가산 |
| 11 | 휴일야간연장 | Output/Number | • 휴일+야간+연장 중복 근무시간 집계(h)를 표시하는 Output 컬럼 | attendances 파생(3중 중복) / fieldKey=holidayNightOvertime | 최고 배수 산정 |
근무시간 유형 = 4종(일반/연장/야간/야간연장) + 휴일 4종(휴일일반근무/휴일연장/휴일야간/휴일야간연장). 공통 우측 컬럼군(재계산 diff + eCount)은 [[HBHR203_재계산 diff 뷰]] 참조.
연동·플로우
- 롤업 관계: [[HBHR230_출퇴근 내역 시트]] 출퇴근 내역(일자별 분해) → HBHR231 근태 내역(직원별·월별 유형 집계) → 급여대장([[HBHR200_급여대장 시트]]) 가산수당 입력.
- 급여 입력 관계: 각 유형 집계 × 통상시급 × 배수. 배수는 근로기준법 기준(연장 1.5, 야간 0.5 가산, 휴일 0.5 가산, 8시간 초과 휴일연장 등), 실값 = organization_parameters(TBU).
- 정합: 이 시트 연장 집계와 HBTM 승인 overtime_records([[HBHR220_연장근무 내역 시트]])의 관계 = 근태 실측 vs 승인 신청 이원화, 급여 산입 기준 = [POL_근태원천].
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [자동 집계 표시] | 출퇴근 내역 롤업 완료 | 유형별 집계값 표시 (attendances Σ) | read-only(추정) |
CASE02 [급여 입력 소비] | 급여대장 ƒ 컬럼 바인딩 | 유형 집계 × 통상시급 × 배수 = 가산수당 | 배수 실값 TBU |
CASE03 [수기 보정] | 집계값 직접 편집 | 편집 가능 여부 TBU | 자동 집계 vs 수기 = OQ |
Open Question
- 야간연장·휴일연장·휴일야간연장 등 중복 유형 산출 로직 및 우선순위(attendances 파생 규칙). TBU.
- 유형별 가산 배수 실값 및 organization_parameters key(namespace/key) 매핑. TBU.
- 집계 대상 status(승인/실측 기준) 및 [[HBHR220_연장근무 내역 시트]] 승인 연장과의 정합. TBU.
- 자동 집계 read-only 여부 vs 수기 보정 가능 여부. TBU.
- 휴일 정의(주휴일/법정공휴일/약정휴일) 및 판정 원천. TBU.