HBHR240_병동 일별 환자수 시트
(Hereby) HR 급여 관리 > 시트 워크스페이스 > 병동 일별 환자수 시트
| 앱 | HR 급여 관리 (hr-system, 포트 4000) |
| 대상 사용자 | 조건1 [HR_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | draft |
| Owner | 카나 |
| 부모 | [[HBHR100_시트 워크스페이스 (공통 Shell)]] |
개요
- 병동 일별 환자수 시트는 병동별·일자별 재원 환자수를 한 행으로 기록하는, 간호인력 지표 산출 입력 시트다.
- 좌→우 5컬럼: # / 일자 / 병동 / 환자수 / 메모. 근거 테이블 ward_daily_records(추정).
- 이 환자수는 간호등급·준수율(간호관리료 차등제) 계산의 입력이며, HBNS(간호 스케줄러)·HBMD(병동/진료)와 연동된다.
- 본 시트는 급여 확정 원천이 아닌 지표 입력 성격이므로, 시트=작업공간 vs 정본=commit 경계([[POL_급여정본경계]])는 참조하되 확정 대상이 아닌 지표 산출로 연결된다.
- 공통 우측 컬럼군(재계산 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} | 병동·일자별 환자수 행 (ward_daily_records[], ERD 미노출 추정 엔티티) | 0건 시 빈 그리드 | 추정 엔티티 |
${row.ward} | ward_daily_records.ward / 병동 마스터 | 미지정 시 공란 | 병동 구분 |
${row.patientCount} | ward_daily_records.patientCount | 미입력 시 공란 | 재원 환자수 |
Calculator 연동
- 간호등급·준수율 계산 입력: 일별 환자수 + 간호사 배치(HBNS ShiftAssignment)로 간호사 대 환자 비(간호등급) 및 준수율 산출.
- HBTM01 스케쥴러 embed 지표(간호등급 / 준수율 % / 간호사 명 / 환자 명)에서 환자수가 준수율 분모 입력.
원천 흐름
- 원천 = 수간호사 수기 입력 또는 HBMD 병동 자동 연동(주체 = TBU) → 본 시트 환자수 → HBNS 배치 결합 → 간호등급·준수율 지표 → HBTM01 스케쥴러 노출.
화면 플로우 (Mermaid)
컬럼 사양표 (5컬럼, 좌→우 — 기본 템플릿 기준)
컬럼 순서·명칭은 기본 템플릿 기준이며, 시트별 실데이터는 사용자 컬럼 편집으로 변형될 수 있다. 내부 fieldKey 4종: date / wardName / patientCount / notes.
| # | 컬럼 | 타입 | 설명 (용도·형식) | 연관 (ERD/calculator/타 앱) | 비고 |
|---|---|---|---|---|---|
| 1 | # | Index | • 행 순번 (read-only) | sheet_rows.sortOrder | read-only |
| 2 | 일자 | DatePicker | • 환자수 기록 일자 (YYYY-MM-DD) • 입력 시: ward_daily_records.date 갱신(추정) | ward_daily_records.date(추정) / fieldKey=date | — |
| 3 | 병동 | Text/Dropdown | • 병동 구분 (예: 병동1). 드롭다운 값(enum/마스터) = TBU • 선택 시: ward_daily_records.ward 갱신(추정) | ward_daily_records.ward(추정) / fieldKey=wardName · HBMD 병동 마스터 | TBU: 드롭다운 값(enum/마스터) |
| 4 | 환자수 | Number | • 해당 병동·일자 재원 환자수 (명) • 입력 시: ward_daily_records.patientCount 갱신(추정), 준수율 분모 반영 | ward_daily_records.patientCount(추정) / fieldKey=patientCount → 간호등급·준수율 입력(HBNS) | 준수율 분모 |
| 5 | 메모 | Text | • 비고 • 입력 시: notes 갱신. 셀 메모(💬) 클릭 시 payroll_cell_memos 별도 저장 | payroll_cell_memos(columnKey) / fieldKey=notes | — |
공통 우측 컬럼군(재계산 diff + eCount)은 [[HBHR203_재계산 diff 뷰]] 참조 (본 시트는 지표 입력 성격상 적용 제한적).
연동·플로우
- 지표 입력 흐름: 병동 일별 환자수 입력 → HBNS 간호사 배치(ShiftAssignment/D·E·N)와 결합 → 간호등급·준수율 산출 → HBTM01 스케쥴러 지표 노출.
- HBMD 연동: 병동 마스터/진료 데이터(HBMD)와 병동 구분 정합.
- 병동 폴더는 환자수 외 수당 계산 워크시트 다수를 포함 — 병동 시트를 수당 계산 워크시트로 확장 활용([[HBHR250_인센티브 세션 시트]]/251 연계).
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [환자수 입력] | 병동·일자별 재원 환자수 기입 | ward_daily_records 행 저장(추정) | 입력 주체 TBU |
CASE02 [지표 산출] | HBNS 배치 결합 | 간호등급·준수율 산출 입력(분모) | 산출 모듈 TBU |
CASE03 [HBMD 정합] | 병동 구분 선택 | HBMD 병동 마스터와 정합 | enum/마스터 TBU |
Open Question
- ward_daily_records 엔티티/컬럼 확정 (02·03 ERD 미노출, 별도 도메인 ERD 필요). TBU.
- 병동 구분 값(마스터/enum) 및 HBMD 병동 마스터 정합. TBU.
- 간호등급·준수율 산출식 및 계산 담당 모듈(HBNS calculator vs HR). TBU.
- 환자수가 급여(간호 수당·차등 인센티브)에 반영되는 경로 및 시기. TBU.
- 셀 입력 주체(수간호사 수기 vs HBMD 자동 연동). TBU.