HBMD250_병동별 인력 현황
(Hereby) 경영 대시보드 > [[HBMD100_Shell·사이드바]] > 운영현황 > 병동별 인력 현황
| 앱 | 경영 대시보드 (HBMD) |
| 대상 사용자 | 조건1 [경영 대시보드 조회 권한] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_급여정본경계]] |
| Status | review |
| Owner | 카나 (PM) |
개요
- 선택 월 기준 병동별 인력 현황을 8컬럼 테이블로 보여주는 섹션이다. 상단 상태 배지("등급 유지") + 설명 + 기준일 + 병동 row(내과/외과/중환자실/신생아실) + 합계로 구성된다.
- 원천은 Nurse Scheduler(스케줄러)와 병동 관리의 병동·환자 수·간호 인력 수다 — [[HBNS230_환자수 관리]] · [[HBHR240_병동 일별 환자수 시트]].
- 테이블의 **배치비율(주/석/야)**은 NS "병동 관리 및 설정 > 인력 설정"에서 정의한 근무별 간호사:환자 비율을 소비한 값이다(예 "1:5 / 1:7 / 1:10") — [[HBNS240_병동 관리·설정]].
- 인원/비율은 **예시값(월 선택 종속)**이며, 병동 관리의 환자 수/필요 인원 원천은 일부 TBU.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 + 확정 스타일 |
Data I/O
Server → Client
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| $ | 병동별 인력 현황 (NursingStaffingSnapshot[], 추정) | empty | 8컬럼 row |
| ${patientCount} / $ | 환자 수 / 간호 인력수 | 0 | |
| ${requiredByShift}(주/석/야) / ${peakRequired} / $ | 근무별 필요 / 피크 필요 / 과부족 | 0 | |
| $ | 근무별(주/석/야) 배치비율 | hide | NS 인력 설정 소비 |
| $ | 기준일 (예 "2026-06-30") | current | |
| $ | 간호등급 준수 상태 (예 "등급 유지") | hide | 상태 배지 |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| (조회 전용) | - | read-only 스냅샷 조회 | - |
외부 통합 (cross-app)
| 원천 앱 | 데이터 | 동기/비동기 | 소비 |
|---|---|---|---|
| Nurse Scheduler / 병동 관리 | 병동·환자 수·간호 인력 수 | 스냅샷 | 환자/간호 인력 컬럼 — [[HBNS230_환자수 관리]] · [[HBHR240_병동 일별 환자수 시트]] |
| Nurse Scheduler 인력 설정 | 근무별(주/석/야) 배치비율 | ratioByShift 소비 | 배치비율 컬럼 — [[HBNS240_병동 관리·설정]] |
화면 플로우
병동별 인력 현황 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | • 병동/환자/간호 인력 데이터가 있을 때 노출 | NursingStaffingSnapshot | |
| 10 | 제목 | Text | • 섹션 제목 "병동별 인력 현황" | ||
| 20 | 상태 배지 | Badge | • 간호등급 준수 상태 표기 "등급 유지" | nursing grade compliance | |
| 30 | 설명 | Text | • 섹션 설명 원문 "병동별 간호 인력이 평가기준에 맞게 배치되었는지 확인해요. 스케줄러와 병동 관리의 병동·환자 수·간호 인력 수로 계산해요." | HBNS/Admin | census 원문 |
| 40 | 기준일 | Text | • 스냅샷 기준일 표기. 예시 "2026-06-30 기준" | snapshotDate | 예시값(월 선택 종속) |
| 50 | 테이블 | Table | • 병동별 인력 8컬럼 테이블 "병동 / 환자 수 / 간호 인력수 / 배치비율(주/석/야) / 현재 / 필요 (주/석/야) / 피크 필요 / 과부족" • 배치비율은 NS 인력 설정(HBNS240)에서 소비한 근무별 간호사:환자 비율(예 "1:5 / 1:7 / 1:10" = 주/석/야) | NursingStaffingSnapshot · ratioByShift(HBNS240) | |
| ㄴ51 | 내과병동 | ListItem | • 병동 인력 행. 예시 "병동 내과병동 / 환자 38명 / 간호 14명 / 배치비율 1:5 / 1:7 / 1:10(주/석/야) / 현재·필요(주/석/야) 12·9·6 / 피크 필요 12명 / 과부족 +2명". 배치비율은 HBNS240 인력 설정 소비 | Ward · ratioByShift | 예시값(월 선택 종속) |
| ㄴ52 | 외과병동 | ListItem | • 병동 인력 행. 예시 "환자 32명 / 간호 11명 / 현재·필요 10·8·5 / 피크 필요 10명 / 과부족 +1명 / 배치비율 1:4 / 1:4 / 1:7" | Ward | 예시값(월 선택 종속) |
| ㄴ53 | 중환자실 | ListItem | • 병동 인력 행. 예시 "환자 8명 / 간호 12명 / 현재·필요 4·4·4 / 피크 필요 4명 / 과부족 +8명 / 배치비율 1:2 / 1:2 / 1:2" | Ward | 예시값(월 선택 종속) |
| ㄴ54 | 신생아실 | ListItem | • 병동 인력 행. 예시 "환자 6명 / 간호 7명 / 현재·필요 3·2·2 / 피크 필요 3명 / 과부족 +4명 / 배치비율 1:2 / 1:3 / 1:3" | Ward | 예시값(월 선택 종속) |
| 60 | 합계 | Output | • 전 병동 인력 합계 행. 예시 "84명 / 44명 / 29명 / +15명" (환자 수 / 간호 인력수 / 피크 필요 / 과부족) | sum | 예시값(월 선택 종속) |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [현황 조회] | 선택 월 | 병동별 8컬럼 + 합계 노출 | read-only |
CASE02 [등급 판정] | 간호 인력 vs 피크 필요 | "등급 유지" 배지 | 준수율 계산 |
Open Question
- 병동 관리의 환자 수/필요 인원 원천(NursingStaffingSnapshot 정본 필드) = TBU. 배치비율(주/석/야)은 NS 인력 설정(HBNS240) 소비로 확인
- "등급 유지" 배지 판정 임계값 및 준수율 산식 = TBU