HBHR109_행 정보 패널·검색
(Hereby) HR 급여 관리 > [[HBHR100_시트 워크스페이스 (공통 Shell)]] > 시트 그리드 > 셀 상세 패널·검색
| 앱 | HR 급여 관리 (HBHR) |
| 대상 사용자 | 조건1 [HR_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | review |
| Owner | 카나 (PM) |
개요
- 시트 로드 상태에서 상시 사용 가능한 셀 상세 패널(진입 i / "셀 상세 패널 표시" 버튼)과 시트 헤더 검색(/ 키), 댓글(💬) 접점, 하단 상태바를 정의한다.
- 셀 상세 패널은 제목 "셀 상세" 아래 급여명세서 카드(월/성명/사번/실수령액 + "직원에게 발송") + 행·열·참조 값 + 행 정보(전 컬럼 값) + 안내로 구성된다.
- 급여명세서 "직원에게 발송"은 실수령액 0원 행에서 클릭 시 무반응(성공/실패 피드백 부재)인 버그 후보 BL-002가 관찰됐다. 실수령액 >0 행 발송 검증은 실데이터 대기(TBU).
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-12 | 카나 | 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
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| $ | sheet_cells (행=직원, 열=컬럼 좌표) (추정) | 패널 닫힘 | 선택 셀 값·참조 |
| $ | PayrollRecord (추정) | hide | 행 정보(전 컬럼 값) 원천 |
| $ | 월·성명·사번·실수령액 (추정) | 실수령액 0원 → "직원에게 발송" 무반응(BL-002) | 급여명세서 카드 |
| $ | 클라이언트 필터 입력 (추정) | 전체 행 표시 | 대상: 사번/성명/사유/항목 |
| $ | 합계 "{n}명 {금액}" (추정) | 0명 / 0원 | 하단 상태바 |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 셀 상세 패널 열기(i / "셀 상세 패널 표시") | rowId, columnKey | 클라이언트 상태 (추정) | - |
| 패널 닫기(Esc) | - | 클라이언트 상태 (추정) | - |
| 급여명세서 "직원에게 발송" | rowId | TBU (실수령액 0원 무반응, BL-002) | payroll:send (추정) |
| 시트 검색(/) | query (사번/성명/사유/항목) | 클라이언트 필터 (추정) | - |
| 댓글(💬) | TBU | TBU | TBU |
| {n}개씩 행 추가하기 | count | sdk.payrollSheet.addRows() (추정) | payroll:write (추정) |
화면 플로우
셀 상세 패널·검색 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | 시트 로드 상태에서 상시 사용 가능 | [[HBHR100_시트 워크스페이스 (공통 Shell)]] 시트 헤더(50) | 시트 로드 전제 |
| 10 | 셀 상세 패널 | Panel | • 선택 셀·행의 상세를 보여주는 "셀 상세" 패널. 하위 구성 = 급여명세서 카드(11) + 행·열·참조 값(12) + 행 정보(13) + 안내(14) • 클릭 시: i 키 / "셀 상세 패널 표시" → 패널 열기 - CASE01 [열기]: 선택 셀 기준 상세 패널 노출 - CASE02 [Esc]: 패널 닫기 - 값 없음: 선택 셀 없으면 패널 닫힘 | 데이터 그리드 선택 셀·행 / [[HBHR100_시트 워크스페이스 (공통 Shell)]] "셀 상세 패널 표시" / [[HBHR103_편집 메뉴·단축키]] 단축키 i | i / Esc |
| ㄴ11 | 급여명세서 카드 | Card | • 선택 행(직원)의 급여명세서 요약(월 / 성명 / 사번 / 실수령액) + "직원에게 발송" 카드 • "직원에게 발송" 클릭 시: 발송 실행 - CASE01 [실수령액 0원]: 🔴 무반응(성공/실패 피드백 부재) = 버그 후보 - CASE02 [실수령액 >0]: 발송 동작 = 실데이터 대기(TBU) | 선택 행 PayrollRecord / [[HBHR270_전자서명 발송·eCount 연동 시트 (2섹션)]] 발송 연계(추정) | 🔴 버그 후보 (BL-002, 노션 등록) · 0원 발송 무반응 · TBU: 카드 표시 필드 세부 |
| ㄴ12 | 행·열·참조 값 | - | • 선택 셀의 행(직원) / 열(컬럼) / 참조 값 표시. 셀 좌표(행=직원, 열=컬럼)와 셀 값·참조 노출 - 값 없음: 셀 값 부재 시 빈 텍스트(추정) | 선택 셀 sheet_cells / 컬럼 fieldKey | 셀 좌표·값 |
| ㄴ13 | 행 정보 | - | • 선택 행(직원)의 전 컬럼 값을 나열(행 정보) - 값 없음: 컬럼 값 부재 시 빈 텍스트(추정) | 선택 행 sheet_rows 전 컬럼 | 전 컬럼 나열 |
| ㄴ14 | 단축키 안내 | Text | • 패널 하단 안내 "단축키: i (행 정보), Esc (닫기)" | [[HBHR103_편집 메뉴·단축키]] 단축키 | |
| 20 | 검색 | Search | • 사번/성명/사유/항목을 대상으로 행을 거르는 클라이언트 필터. placeholder "사번 / 성명 / 사유 / 항목 검색 ( / )" • 클릭 시: / 키 → 검색창 포커스 → 입력 시 일치 행 필터 - Empty: 검색 결과 없음 상태 - 값 없음: 검색어 미입력 시 전체 행 표시 | [[HBHR100_시트 워크스페이스 (공통 Shell)]] 시트 헤더(51) / [[HBHR103_편집 메뉴·단축키]] 단축키 | TBU: 하이라이트·카운트 / Empty 문구 |
| 30 | 댓글(💬) | Button | • 시트 헤더 댓글 버튼 "💬" • 클릭 → TBU (스레드·셀 앵커 여부 미확인) | [[HBHR100_시트 워크스페이스 (공통 Shell)]] 시트 헤더(52) | TBU: 스레드·셀 앵커 여부 |
| 40 | 시트 하단 상태바 | - | • 상태바 표시 = "합계 {n}명 {금액}" + "{n}개씩 행 추가하기" 버튼 • "{n}개씩 행 추가하기" 클릭 시: 지정 개수만큼 시트 하단에 행 추가 실행 - 값 없음: 대상 0명이면 "합계 0명" 표시(추정) - 에러: 행 추가 실패 피드백(TBU) | [[HBHR200_급여대장 시트]] 합계행 / [[HBHR105_삽입 메뉴]] 행 여러 개 추가 | 합계·행 추가 · TBU: 행 추가 실패 피드백 |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [패널 열기] | i 키 / "셀 상세 패널 표시" | "셀 상세" 패널 노출 | Esc로 닫기 |
CASE02 [0원 발송] | 실수령액 0원 행 "직원에게 발송" 클릭 | 무반응, 피드백 없음 | 버그 후보 (BL-002) |
CASE03 [>0원 발송] | 실수령액 >0 행 발송 | 미검증 | 실데이터 대기 (TBU) |
조건1 [HR_ADMIN] | 발송·행 추가 | 권한 요건 TBU | 세부 권한 미확인 |
Open Question
- 급여명세서 카드 "직원에게 발송" — 실수령액 0원 행 무반응(피드백 부재) = 버그 후보 (BL-002, 노션 등록). 실수령액 >0 행 발송 동선·API·권한 = TBU (실데이터 대기)
- 급여명세서 카드 표시 필드 세부(공제·지급 내역 등) = TBU
- 검색 결과 하이라이트 / 카운트 / Empty 문구 = TBU
- 댓글(💬) 스레드 / 셀 앵커 여부 · API · 권한 = TBU
- 시트 하단 상태바 "{n}개씩 행 추가하기" 실패 피드백 = TBU