HBAD295_호봉표
(Hereby) 관리자 패널 > 호봉표
| 메타 | 앱: 관리자 패널 (HBAD)대상 사용자: 조건1 [호봉 관리/조회] 권한 보유 역할프로토타입: TBU관련 정책: [[POL_급여정본경계]]Status: draft (라이브 미검증 — ERD 기반)Owner: 카나 |
개요
호봉표는 직종·적용연도별 호봉 단계별 기본급·호봉액·합계·연봉·시급을 관리하는 급여 마스터 화면이다. salary_grades / salary_grade_categories를 근거로 한다.여기서 정의한 호봉표는 직원 근로계약(employment_contracts.salaryGradeId)의 기본급·호봉가산 산정 원천이며, HR 급여 관리 앱(HBHR) 계약급여내역 시트의 호봉·기본급 입력으로 소비된다.시급은 안내문 원문 인용: "시급은 세금 공제 전 금액으로 계산된 값입니다" (통상임금 환산 기준, 산출식 = TBU).⚠️ 본 문서는 라이브 미검증 — ERD/개요만 확인분. UI 요소·동작 상세는 TBU 유지, 캡처 확보 후 GC700 깊이 확정 필요.
문서 히스토리
- 2026-07-06 최초 작성 (ERD 기반, 라이브 미검증) - 카나/콸
- 2026-07-21 GC700 깊이 재작성 (구조 정비 · TBU 명시 유지) - 카나/콸
- 2026-07-21 가독성 패스 (GUIDE §7) - 카나/PM
- 2026-07-21 셀 스타일 확정판 적용 (콸 승인) - 카나/PM
Data I/O
Server → Client
변수
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 호봉 행 추가/수정 | 직종 · 적용연도 · 기본급 · 호봉액 · 연봉 | salary_grades upsert (매핑 TBU) | 호봉 관리 (라벨 기반, 매핑 TBU) |
외부 통합 (cross-app)
| 외부 시스템 | 데이터 | 동기/비동기 | 비고 |
|---|---|---|---|
| 근로계약 | employment_contracts.salaryGradeId → 기본급(baseSalary)·호봉가산(hobongAmount) 산정 원천 | 동기 참조 | [[HBAD201_직원 추가·수정 모달]] |
| HR 급여 관리 (HBHR) | 계약급여내역 시트 호봉·기본급 입력으로 소비 | 동기 참조 | 급여 원천 |
호봉표 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 진입 조건 | - | • 조건1 [호봉 관리/조회] 보유 시 노출 | 권한 트리(호봉) | |
| 01 | 초기 상태 | Output | • 진입 시 직종·적용연도 미선택 상태 (초기 화면 상세 TBU, 라이브 미검증) | - | TBU |
| 10 | 직종 * | Dropdown | • 호봉표 대상 직종을 선택하는 드롭다운 (필수). 직종 = 호봉 카테고리 • 선택 시: 해당 직종 호봉표 조회 | salary_grade_categories.name | 필수 · TBU: 카테고리 0건 |
| 20 | 적용연도 | Dropdown | • 호봉표 적용 연도를 선택하는 드롭다운. 연도별 버전 관리 • 선택 시: 해당 연도 버전 호봉 행 재조회 | salary_grades.effectiveYear | 연도별 버전 |
| 30 | 호봉 행 그리드 | Grid | • 호봉 단계별 급여 구성 행. 컬럼 = 기본급-월급 / 호봉액 / 합계 / 연봉 / 시급 (하위 ㄴ31~35). grade 오름차순 정렬 - CASE01 [선택 직종·연도 0건]: 빈 상태 (원문 문구 TBU) | salary_grades[] | grade 오름차순 · Empty 원문 TBU |
| ㄴ31 | 기본급-월급(원) | Input/Number | • 호봉 단계별 월 기본급 (원) • 입력 시: 해당 호봉 행 기본급 갱신 | salary_grades.baseSalary | 통화 · TBU: 값 없음(0/공란) |
| ㄴ32 | 호봉액(원) | Input/Number | • 호봉 가산액 (원) • 입력 시: 해당 호봉 행 호봉액 갱신 | salary_grades.hobongAmount | 통화 |
| ㄴ33 | 합계(원) | Output/Number | • 기본급 + 호봉액 합계 (원) | salary_grades.totalSalary | 산출(추정) · 자동/수기 TBU |
| ㄴ34 | 연봉(원) | Input/Number | • 연 환산 급여 (원) • 입력 시: 해당 호봉 행 연봉 갱신 | salary_grades.annualSalary | 통화 |
| ㄴ35 | 시급(원) | Output/Number | • 시간당 임금 (원/h). 안내문 "시급은 세금 공제 전 금액으로 계산된 값입니다" | 합계/월소정시간(monthlyHours 기본 209) 환산(추정) · minimumWage | 세전 · 산출식 TBU |
| 40 | 호봉 행 추가/수정 | Button/Input | • 직종·적용연도·기본급·호봉액·연봉을 입력해 호봉 행을 저장하는 기능 • 클릭 시: salary_grades upsert 실행 | salary_grades | TBU: 저장 실패 피드백·동작 상세 |
| 90 | 권한별 차이 | - | • 조건1 [호봉 관리] = 편집 · 조건2 [호봉 조회] = 읽기전용(추정). 미보유 시 메뉴 미노출 | RBAC | 편집/조회 분기 TBU |
ERD 근거 (salary_grades)
| 컬럼 | 타입 | 호봉표 대응 |
|---|---|---|
| grade | integer | 호봉 단계 (행 식별) |
| baseSalary | numeric(15,2) | 기본급-월급(원) |
| hobongAmount | numeric(15,2) | 호봉액(원) |
| totalSalary | numeric(15,2) | 합계(원) |
| annualSalary | numeric(15,2) | 연봉(원) |
| effectiveYear | integer | 적용연도 |
| monthlyHours | numeric(7,2), 기본 209 | 시급 환산 월 소정근로시간(추정) |
| minimumWage | numeric(15,2) | 최저임금 대비 검증(추정) |
| categoryId | uuid FK | 직종 (salary_grade_categories) |
Open Question
| 구분 | 미확인 항목 |
|---|---|
| 화면 전반 | 라이브 미검증: UI 요소·초기 상태·Empty 원문·저장 동작·편집/조회 권한 분기 전반. 캡처 확보 후 GC700 깊이 확정 필요 |
| 시급 산출식 | 합계/monthlyHours(209)인지 별도 통상임금 환산인지. 안내문만 확인, 식은 미확인 |
| 산출 방식 | 합계(totalSalary)·연봉(annualSalary) 자동 산출 vs 수기 입력 여부 |
| 직종 매핑 | 직종(salary_grade_categories) 목록 = census 직종 15종과의 매핑 관계 |
| 승급 반영 | 호봉 승급 시 계약(employment_contracts) 반영 시점·동선 (grade_promotion 프로세스) |
| 검색·필드 | 직종 카테고리 0건 · 기본급 값 없음 처리 |