HBHR107_컬럼 헤더 컨트롤
(Hereby) HR 급여 관리 > [[HBHR100_시트 워크스페이스 (공통 Shell)]] > 시트 그리드 > 컬럼 헤더 컨트롤
| 앱 | HR 급여 관리 (HBHR) |
| 대상 사용자 | 조건1 [HR_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | review |
| Owner | 카나 (PM) |
개요
- 급여대장 시트의 프로그래머블 컬럼 헤더 한 칸을 구성하는 개별 컨트롤(라벨 · ƒ 수식 · ⚙ 설정 · ∑ 집계 · fieldKey · ⇅ 정렬 · 필터 · ⌄ 메뉴 · ⚠ 배지)을 요소 단위로 정의한다.
- 컬럼 ƒ(수식) = 컬럼 값을 산출하는 표면이자 Module Manager Calculator Registry 연동 진입점(HBMM01: 근로계약 11키·초과근무 16키·4대보험 5키 등 9 calculator)이다.
- 시스템 컬럼 employeeNumber / employeeName / team / position 4종은 read-only 바인딩으로 재바인딩 불가하며, AI(formulaFromNL)는 제안까지만 관여하고 commit은 항상 사람이 한다 ([[POL_급여정본경계]]).
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 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 | 셀 스타일 확정판 적용 (콸 승인) |
| 2026-10-01 | 카나 | PM | ⚙ 열 설정 패널 실측 확정(ㄴ13 — 열 이름·컬럼 그룹·종류 3종·고급 종류·표시 형식·취소/저장, 스샷 live-1001-hbhr107-colsettings.png) + 「다음 달로 값 이월」 carryValues 체크박스(52eaa202, #967)·식별 「표시할 식별값」 select 저장값 표시 수정(5540152f, #966) 반영 |
| 2026-10-02 | 카나 | PM | 수식바 초안 → 수식 편집 팝오버 넘김(ㄴ12-H)·열 폭 조절 바 더블클릭 자동 맞춤(ㄴ1A)(99a24b42, #979) · 열 북마크 메뉴·「북마크한 열」 칩(30·ㄴ12-B)(8284d800, #982) · 열 설정 저장 안 된 변경 「저장하고 이동」(ㄴ13-L)(4870139b, #981) · 「다음 달로 값 이월」 다시 열 때 체크 유지(ㄴ13)(79af84ac, #991) — 커밋 근거, 라이브 실사 이월(TBU) |
| 2026-10-03 | 카나 | PM | 급여 반영 「+ 새 집계 컬럼」 사용 중 급여대장 확인 다이얼로그 「열고 적용」(재설정→저장→설정 완료)·예외 안내(ㄴ13-R·ㄴㄴ13-R1)(dd46ec65, #1020) — 커밋 근거, 라이브 실사 이월(TBU) |
| 2026-10-07 | 카나 | PM | PR #1039 반영(5cd3483, MED-886): 열 설정에 폼 전용 종류 「단일 선택」 추가(ㄴ13 비고) — 저장 = 값 열 + format:select + selectOptions. 커밋 근거, 라이브 실사 이월(TBU) |
| 2026-10-16 | 카나 | PM | PR #1249 반영(85e65fe·272aeb8): 「표시할 식별값」에 근로형태(workPatternName) 추가 + 카탈로그 그룹별 optgroup 묶음(기본/프로필/근로계약/급여 산정 구간 — ㄴ13) · 역할(roleName)·급여 가산일(payStartDate)·급여 마감일(payEndDate) 카탈로그 등재(272aeb8)도 UI 노출 확인 — 2026-10-16 라이브 실측(스샷 live-1016-hbhr107-identity-select.png), 열 헤더 우클릭 「열 설정」 진입 실측 |
| 2026-10-17 | 카나 | PM | 주간 정합 스윕 — 헤더 ⚙ 병행 노출 TBU 해소(ㄴ13): ic-setting은 계산 수식 열 전용 표시(title 「계산: {수식}」)로 열 설정 진입점 아님, 일반 열에선 숨김. 열 설정 진입 = 우클릭 메뉴 단독 (라이브 실측, /hr-system/sheets 직접 URL 확인) |
Data I/O
Server → Client
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| $ | 컬럼 표시명 (사용자 지정 라벨) | fieldKey로 fallback (추정) | 예 "사번" |
| $ | 컬럼 바인딩 필드 키 | 빈 텍스트 | 예 "(employeeNumber)" |
| $ | 컬럼 ƒ ↔ Calculator output key (추정) | 자유 수식 or 미바인딩 → 라벨 hide | 저장 단위 TBU |
| $ | 바인딩 원천 "← {시트명}: {항목명}" | 자유 수식·시스템 컬럼이면 hide | 예 "← 치료일 인센티브: 청구금액" |
| $ | ∑ 집계 결과 (합계·평균 등) | 빈 텍스트 | 시트 하단 합계행 반영 |
| $ | 바인딩/수식 미검증 여부 (추정) | 검증 완료 시 hide | "⚠ 설정 확인 필요" 배지 |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| ƒ 수식 편집/바인딩 | columnKey, formula | calculatorKey | sdk.payrollSheet.setColumnFormula() (추정) | payroll:write (추정) |
| ⚙ 컬럼 설정 | columnKey, fieldBinding, type, carryValues(literal 한정), refField(식별) | TBU | payroll:write (추정) |
| ⇅ 정렬 추가 | columnKey, direction | TBU | payroll:read (추정) |
| 필터 추가 | columnKey, condition | TBU | payroll:read (추정) |
| 열 북마크 목록·추가·해제 | sheetSlug, columnKey / bookmarkId | sheetTemplate.listColumnBookmarks / createColumnBookmark / deleteColumnBookmark | 목록 payroll:read · 추가/삭제 payroll:manage |
| AI formulaFromNL 제안 | naturalLanguage → formula 제안 | sdk.formulaFromNL() (추정) | 제안까지만, commit은 사람 ([[POL_급여정본경계]]) |
화면 플로우
컬럼 헤더 컨트롤 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | 급여대장 등 시트 그리드의 컬럼 헤더 행에 상시 노출. 헤더 hover/클릭 시 하위 컨트롤(ƒ/⚙/∑/⇅/⌄) 활성 | [[HBHR200_급여대장 시트]] 급여대장 시트 | |
| 01 | 초기 상태 | - | 라벨 + fieldKey 표기 기본 노출. ⚠ 배지는 컬럼 바인딩/수식 검증 상태에 따라 조건부 노출(검증 완료 시 hide) | ||
| 10 | 헤더 구성(컨테이너) | - | 한 컬럼 헤더 = 라벨 + "ƒ + ⚙ + ∑ + (fieldKey) + ⇅ + ⌄" 컨트롤 + "⚠ 설정 확인 필요" 배지(조건부) 조합. 하위 요소를 개별 해부(11~19) | 프로그래머블 컬럼 | |
| ㄴ11 | 라벨 (컬럼명) | Text | • 컬럼 표시명(예: 사번)을 나타내는 사용자 지정 라벨. 시스템 컬럼은 고정 라벨과 결합 - 값 없음: 라벨 미지정 시 fieldKey 표기로 대체(추정) | ||
| ㄴ12 | ƒ 수식 | Control | • 컬럼 값을 산출하는 ★표면 — 수식 또는 Calculator output key 바인딩 진입점. Module Manager(HBMM01) Calculator Registry 연동: 컬럼 ƒ ↔ output keys(근로계약 11키·초과근무 16키·4대보험 5키 등 9 calculator) • 클릭 시: 수식/바인딩 편집 진입. 바인딩 시 헤더에 "← {시트명}: {항목명}" 라벨 노출(예 "← 치료일 인센티브: 청구금액") - CASE01 [바인딩됨]: calculator key 소비 - CASE02 [자유 수식]: formula string - 권한: 시스템 컬럼(50)은 ƒ 편집 불가(read-only) - 에러: 미검증 바인딩 시 ⚠ 배지(80) 노출 | HBMM01 Calculator Registry · [[HBHR105_삽입 메뉴]] 삽입(ƒ) · [[HBHR106_데이터 메뉴]] 새로고침(재계산) · 80 ⚠ 배지 | ★AI(formulaFromNL) 표면 · 제안까지만 · TBU: formula string vs calculator key 저장단위 |
| ㄴ12-H | 수식바 초안 → 수식 편집 팝오버 넘김 (시트 전환) | - | • 수식바에서 고친 수식 초안이 있는 채로 다른 시트를 열면, 초안이 사라지지 않고 헤더 수식 편집 팝오버로 넘어감. 그 시트 머리글 클릭 → [시트!열] 참조 삽입 → 저장 시 원본 시트로 돌아와 저장• 팝오버 상단 안내: "「{원본 시트}」 시트의 수식을 편집하는 중이에요. 이 시트의 열 머리글을 클릭하면 [시트!열] 참조가 들어가고, 저장하면 원본 시트로 돌아가요." - CASE01 [셀에서 시작한 수식(값 열)]: 제목 「열: {열 이름} · 이 셀만」, Enter = 이 셀만 저장(순환 검사·사용 중 수정 사유 적용) - CASE02 [손대지 않은 초안·값 편집]: 넘기지 않고 버림 | ㄴ12 ƒ 수식 · [[HBHR100_시트 워크스페이스 (공통 Shell)]] 60 수식바 · 72 수식 적용 범위 바 | 신규 (99a24b42 #979, MED-844) · 종전: 시트 전환 시 수식바 비워지고 초안 유실 · 저장 셀 못 찾음 오류 "수식을 저장할 셀을 찾을 수 없어요. 원본 시트에서 다시 시도해 주세요." · TBU: 라이브 실사 |
| ㄴ12-B | 북마크한 열 (칩) | Chip | • 헤더 수식 편집 팝오버(간단히 상태 포함)와 수식바 fx 팝오버에 「북마크한 열」 칩 목록. 칩 = "{시트 이름} › {열 이름}" • 칩 클릭 → 커서 자리에 [시트!열] 참조 삽입(같은 시트면 [열]), 연달아 누르면 마지막 피연산자 치환 · × 클릭 → 북마크 해제(title "북마크 해제 (병원 공통)")- -E [북마크 0개]: "열 머리글을 우클릭해 열 북마크를 누르면 여기 모여요 — 다른 시트의 단가·기본급처럼 자주 참조하는 열을 클릭 한 번으로 넣을 수 있어요." - CASE01 [이번 기간에 없는 시트]: 칩 흐리게 표시 | 30 열 북마크 · [[HBHR100_시트 워크스페이스 (공통 Shell)]] 60 수식바 · sheet_column_bookmarks(병원 공통) | 신규 (8284d800 #982, MED-845) · 헤더 팝오버 참조 삽입도 수식바와 같은 엑셀 포인트 규칙으로 통일 · TBU: 라이브 실사 |
| ㄴ13 | ⚙ 설정 | Control | • 컬럼 설정을 여는 컨트롤. 시스템 컬럼은 필드 바인딩 read-only • 클릭 시: 오른쪽 레일 「열 설정」 패널 진입(실측 구성): 패널 제목 "열 설정" + 열 이름 부제 / 열 이름 입력 / 컬럼 그룹 입력(placeholder "예: 지급, 공제", ? 도움말) / 종류 라디오 3종 — ✎ 값 "직접 입력 — 예: 금액, 메모" · ƒ 수식 "계산식 — 예: =[단가]*[수량]" · 👤 식별 "직원 정보 — 예: 사번, 성명" + 고급 종류 접힘(▶) / 표시 형식 select(예 "텍스트") + 안내 "서식 도구바의 "123 ▮" 메뉴로 셀별 형식을 개별 지정할 수 있어요." / ☐ 「다음 달로 값 이월」 체크박스 / 하단 "취소" · "저장" - 「다음 달로 값 이월」( carryValues): 값(literal) 종류에서만 체크박스 노출. 체크된 열은 「이전 월에서 가져오기」가 값·행을 사본 시트로 옮김([[HBHR108_폴더·휴지통 사이드바]] 값 이월). 다른 종류로 바꾸면 저장 시 플래그 삭제. 다시 열면 저장된 체크 상태 그대로 표시, 다른 설정만 바꿔 저장해도 플래그 유지(종전 결함: 다시 열면 해제로 보이고 다른 설정 저장 시 플래그가 지워짐)- 식별 종류의 「표시할 식별값」 select: 저장된 값(refField)을 그대로 표시(종전 결함: 항상 첫 항목 "사번"으로 보여 현재 식별값을 알 수 없고, 사번으로 바꾸는 변경이 변경으로 안 잡혀 저장 불가 — MED-837) - 「표시할 식별값」 select는 카탈로그 그룹별 optgroup으로 묶임(2026-10-16 실측): 기본(사번·성명·소속 경로·팀·역할(roleName)·병동·이메일·휴대폰) / 프로필(생년월일·입사일·최종 근무일(퇴사일)·재직 상태·직무·근로형태(workPatternName)) / 근로계약 (시트 년월 기준)(계약 형태·임금 형태·기본급·호봉 금액·근속 수당·시급·소정근로시간(주)·호봉명·계약 시작일) / 급여 산정 구간 (시트 년월 기준)(급여 가산일(payStartDate)·급여 마감일(payEndDate)) — 근로형태는 employees.workPatternId → work_patterns.name을 비춤(85e65fe), 역할·급여 가산일·급여 마감일은 서버에만 있던 식별값의 카탈로그 등재(272aeb8) | fieldKey 바인딩(50) · sheetColumnLayoutEntrySchema.carryValues · [[HBHR108_폴더·휴지통 사이드바]] | 열 설정 패널 실측 2026-10-01(스샷 live-1001-hbhr107-colsettings.png) · 값 이월 플래그(52eaa202, #967, MED-829) · 식별값 select 저장값 표시(5540152f, #966, MED-837) · 값 이월 체크 로드 누락 수정(79af84ac, #991, MED-829) · 고급(폼 전용) 종류 「단일 선택」 추가(10/7, 5cd3483 #1039) — 저장은 값 열 + format:select + selectOptions, 칸 편집은 기존 드롭다운 · 식별 「근로형태」 추가+optgroup 그룹핑(10/15 머지, 85e65fe·272aeb8 #1249) — 2026-10-16 라이브 실측(스샷 live-1016-hbhr107-identity-select.png). 진입 경로: 열 헤더 우클릭 메뉴 「열 설정 — 열 이름과 종류, 표시 형식을 설정합니다」 실측 · 헤더 ⚙ 병행 노출 해소(2026-10-17 실측): 헤더 안 ic-setting 아이콘은 열 설정 진입이 아니라 계산 수식 열 전용 표시(title 「계산: {수식}」, 수식 없는 열은 display:none — QA 시트 전 열 숨김 확인). 열 설정 진입은 우클릭 컨텍스트 메뉴 단독 · TBU: 고급 종류 목록·컬럼 그룹 동작 |
| ㄴ13-L | 저장 안 된 변경 이탈 확인 | Dialog | • 열 설정 패널에 저장하지 않은 변경이 있는 채로 다른 열로 옮기거나(셀 클릭) · 열 설정/급여 반영 열기 · 패널 닫기 시 선택형 다이얼로그 • 문구: "「{열 이름}」 열 설정에 저장하지 않은 변경이 있어요.\n저장하지 않으면 변경한 내용이 사라져요." / 버튼 「저장하고 {이동·열기·닫기}」 · 「변경 취소하고 {이동·열기·닫기}」 - CASE01 [저장하고 …]: 저장 뒤 진행. 저장이 안 끝나면(열 이름 비움·오류) 원래 열에 머묾 - CASE02 [Esc]: 머무르기(선택도 원래 열로) | ㄴ13 ⚙ 설정 · 급여 반영 드로어 | 신규 (4870139b #981, MED-847) · 종전: 확인 = 변경 취소뿐(저장하고 나갈 길 없음) · 저장 실패 "열 설정 저장 실패: {사유}" · TBU: 라이브 실사 |
| ㄴ13-R | 급여 반영 「+ 새 집계 컬럼」 — 사용 중 급여대장 열고 적용 | Dialog | • 열 설정 › 급여 반영에서 「+ 새 집계 컬럼」 클릭 시 대상 급여대장이 「사용 중」이라 구조 변경이 막히면, 실패 안내 대신 확인 다이얼로그 • 문구: "급여대장 '{대장 이름}'이(가) 사용 중이라 구조를 바꿀 수 없어요.\n설정을 잠시 열어 집계 컬럼을 만들고 바로 다시 설정 완료할까요?" / 확인 버튼 「열고 적용」 • 클릭 시: 즉시 실행 — STEP1 급여대장 재설정 → STEP2 집계 컬럼 저장 → STEP3 설정 완료, 성공 토스트 "'{대장 이름}' 설정을 잠시 열어 집계 컬럼을 만들고 다시 설정 완료했어요." (재설정·설정 완료 이력은 그대로 남음) | ㄴ13 ⚙ 설정 · 급여 반영 드로어 · [[HBHR200_급여대장 시트]] 수명주기(설정 중/사용 중) · [[HBHR100_시트 워크스페이스 (공통 Shell)]] ㄴ64E 히스토리 | 신규 (dd46ec65, #1020 — MED-870) · 종전: "급여대장 집계 컬럼 생성 실패: …파일 → 시트 재설정에서 설정을 다시 연 뒤 변경해 주세요." 안내만 · TBU: 다이얼로그 취소 버튼 라벨·라이브 실사 |
| ㄴㄴ13-R1 | 열고 적용 — 예외·실패 | - | • CASE01 [작업 완료·보호 급여대장]: 다이얼로그 없이 종전 안내 "급여대장 집계 컬럼 생성 실패: {사유}" • CASE02 [재설정 실패]: "급여대장 재설정 실패: {사유}" • CASE03 [재설정 뒤 저장 실패]: "급여대장 집계 컬럼 생성 실패: {사유}\n'{대장 이름}'은(는) 「설정 중」으로 남아 있어요." • CASE04 [설정 완료 재전이 실패]: 토스트 "집계 컬럼은 만들었지만 '{대장 이름}' 설정 완료에 실패했어요 — 급여대장에서 「설정 완료」를 눌러 주세요. ({사유})" | ㄴ13-R | 커밋 근거 (dd46ec65, #1020) · CASE01은 dev 미검증(PR test plan 미체크) |
| ㄴ14 | ∑ 집계 | Control | • 컬럼 하단 합계/통계(합계·평균 등)를 산출해 시트 하단 합계행에 반영하는 컨트롤 • 클릭 시: 집계 방식 선택 UI 노출(TBU) → 집계 결과 합계행 반영 - 값 없음: 집계 대상 0건이면 빈 텍스트(추정) | [[HBHR100_시트 워크스페이스 (공통 Shell)]] 합계행("{n}명"+∑) | TBU: 집계 선택 UI |
| ㄴ15 | (fieldKey) | Text | • 필드 바인딩 키 표기 — 예 "(employeeNumber)" / "(employeeName)" / "(team)" / "(position)". 시스템 컬럼 4종은 read-only 바인딩(50에서 별도 강조) | 엔티티 필드(추정) | 바인딩 키 표기 |
| ㄴ16 | ⇅ 정렬 | Control | • 컬럼 기준 정렬 컨트롤. 헤더 버튼 "정렬 추가"(20)로 정렬 기준 등록 • 클릭 시: 해당 컬럼 기준 정렬 | [[HBHR106_데이터 메뉴]] "↕ 시트 정렬" | "정렬 추가" |
| ㄴ17 | 필터 | Control | • 컬럼 필터 컨트롤. 헤더 버튼 "필터 추가"(21)로 조건 등록 • 클릭 시: 해당 컬럼 필터 진입 | [[HBHR106_데이터 메뉴]] "🔽 필터 만들기" | "필터 추가" |
| ㄴ18 | ⌄ 컬럼 메뉴 | Dropdown | • 컬럼 단위 드롭다운 메뉴 • 클릭 시: 컬럼 메뉴 노출(세부 항목 TBU) | ㄴ 세부 항목 취합 → OQ | TBU: 드롭다운 항목 |
| ㄴ19 | ← 바인딩 라벨 | Text | • 수식 열이 다른 시트 항목에 바인딩된 경우 "← {시트명}: {항목명}" 형태로 원천을 노출(예 "← 치료일 인센티브: 청구금액") - CASE01 [바인딩됨]: 라벨 노출 - CASE02 [자유 수식·시스템 컬럼]: 라벨 없음(hide) | ㄴ12 ƒ 수식 · [[HBHR251_치료실 인센티브 시트]] 관찰 | 바인딩 원천 표기 |
| ㄴ1A | 열 폭 조절 바 | Control | • 머리글 오른쪽 가장자리 크기 조절 바. title "끌어서 폭 조절 · 더블클릭하면 내용에 맞춤" • 드래그 → 열 폭 조절 · 더블클릭 → 열 폭을 내용(머리글 라벨 + 보이는 칸 중 가장 넓은 값)에 자동 맞춤, 새로고침 뒤 유지 | ㄴ11 라벨(이름 바꾸기) · 열 크기 조절… 메뉴 | 더블클릭 자동 맞춤 신규 (99a24b42 #979, MED-846) · 종전: 더블클릭이 머리글 더블클릭(이름 바꾸기·수식 편집)으로 올라감 · TBU: 라이브 실사 |
| 20 | 헤더 버튼 "정렬 추가" | Button | • 해당 컬럼을 정렬 기준으로 추가하는 버튼 • 클릭 시: 해당 컬럼 정렬 기준 추가 | ㄴ16 ⇅ · [[HBHR106_데이터 메뉴]] 시트 정렬 | TBU: 실패 피드백 |
| 21 | 헤더 버튼 "필터 추가" | Button | • 해당 컬럼에 필터 조건을 추가하는 버튼 • 클릭 시: 해당 컬럼 필터 조건 추가 - Empty: 조건 불일치 시 표시 행 0건 | ㄴ17 필터 · [[HBHR106_데이터 메뉴]] 필터 만들기 | |
| 30 | 열 북마크 (머리글 우클릭) | MenuItem | • 머리글 우클릭 메뉴 「열 북마크」(북마크된 열이면 「북마크 해제」). title "자주 참조하는 열을 북마크하면 수식 편집기의 「북마크한 열」에서 클릭 한 번으로 참조할 수 있어요 — 병원 공통" • 클릭 → 즉시 실행, 성공 토스트 "「{열}」 열을 북마크했어요. 수식 편집기의 북마크한 열에서 바로 참조할 수 있어요." - CASE01 [비공개 시트]: 거절 토스트 "비공개 시트의 열은 북마크할 수 없어요. 북마크는 병원 공통이라 시트 이름과 열 이름이 모두에게 보여요." - 에러: "열 북마크에 실패했어요. 잠시 후 다시 시도해 주세요." / "북마크 해제에 실패했어요. 잠시 후 다시 시도해 주세요." | ㄴ12-B 북마크한 열 칩 · [[HBHR100_시트 워크스페이스 (공통 Shell)]] ㄴ71 열 헤더 메뉴 | 신규 (8284d800 #982, MED-845) · 행 번호(#) 열에는 미노출 · 잠금 가드 밖(사용 중 시트에서도 가능) · 권한: 목록 payroll:read · 추가/삭제 payroll:manage · TBU: 라이브 실사 |
| 50 | fieldKey 바인딩 (read-only 강조) | - | • 필드 바인딩 키를 컬럼에 매핑. 시스템 컬럼 4종 = read-only: employeeNumber / employeeName / team / position — 수식/필드 재바인딩 불가. 조건1 [HR_ADMIN] 이어도 시스템 컬럼 재바인딩 불가. 그 외 급여 항목 컬럼은 ƒ/⚙로 바인딩 편집 가능 | ㄴ13 ⚙ 설정 · ㄴ15 fieldKey | ★시스템 컬럼 read-only |
| 80 | ⚠ "설정 확인 필요" 배지 | Badge | • 컬럼 바인딩/수식 미검증 경고 배지 — Calculator 바인딩 미검증 시 "⚠ 설정 확인 필요" 노출 - CASE01 [검증 완료]: 배지 hide - CASE02 [미검증]: "⚠ 설정 확인 필요" 노출 | ㄴ12 ƒ 수식 · HBMM 바인딩 · commit preflight([[HBHR201_전체 확정 (commit)]]) | 조건부 노출 · TBU: 검증 트리거 시점 |
시스템 컬럼 (read-only 바인딩) 강조
| fieldKey | 표기 | 의미 | 편집 |
|---|---|---|---|
| employeeNumber | (employeeNumber) | 사번 | read-only (재바인딩 불가) |
| employeeName | (employeeName) | 성명 | read-only |
| team | (team) | 팀 | read-only |
| position | (position) | 직급 | read-only |
위 4종 시스템 컬럼은 엔티티 필드에 직결된 고정 바인딩이므로 ƒ 수식/필드 재바인딩이 불가하다. 나머지 급여 항목 컬럼만 ƒ(수식)·⚙(설정)로 Calculator output key에 바인딩·편집한다.
AI 접점 참조
컬럼 ƒ(수식) 표면에서 formulaFromNL 스킬이 자연어 → 컬럼 수식/계산기 바인딩을 제안한다(자동 삽입 X, 사용자 확인 후 적용). 안전 경계 = Sheet 단계 preview/preflight까지만이며, commit·PayrollLedger 변경은 항상 사람이 실행한다 ([[POL_급여정본경계]], [[HBHR201_전체 확정 (commit)]]). ⚠ 설정 확인 필요(80) 배지 및 commit preflight가 미검증 바인딩을 확정 직전에 경고한다.
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [바인딩됨] | ƒ ↔ calculator key 결합 | "← {시트명}: {항목명}" 라벨 노출 | 재계산 시 값 소비 |
CASE02 [미검증] | 바인딩 검증 실패 | "⚠ 설정 확인 필요" 배지 | commit preflight 경고 |
조건1 [HR_ADMIN]/조건2 [SUPER_ADMIN] | 급여 항목 컬럼 ƒ 편집 | 편집 가능 | 시스템 컬럼 4종은 read-only |
Open Question
- 컬럼 ƒ 저장 단위(formula string vs calculator key 참조 vs 혼합) = TBU
- ⚙ 열 설정 패널 기본 구성은 실측 확정(2026-10-01, ㄴ13) — 「고급 종류」 펼침 목록·컬럼 그룹 저장 동작 = TBU
- ⌄ 컬럼 메뉴 드롭다운 세부 항목 = TBU
- ⚠ 배지 검증 트리거(저장 시 vs 재계산 시 vs commit preflight) 정확 시점 = TBU
- 정렬 추가 / 필터 추가와 [[HBHR106_데이터 메뉴]] 정렬·필터의 상태 공유 여부(동일 store) = TBU