이룸병원업무 사용 안내

시작하기

병원에서 받은 주소로 접속해 로그인합니다. 계정은 병원의 시스템 관리자가 만듭니다.

접속 주소

• Cloudflare 배포형: https://his.irumx.app/login
• 원내 설치형: 병원 전산 담당이 알려 준 원내 주소(예: https://his.병원.local). 병원 망(유선·Wi-Fi) 안에서만 열립니다.

로그인

• 아이디·비밀번호: 두 방식 모두 씁니다.
• 메일 로그인 코드(Cloudflare 배포형): 등록된 메일로 6자리 코드를 받아 로그인합니다.
• 옆자리 계정(Cloudflare 배포형): 옆자리에서 확인된 메일이 병원에 등록된 메일과 같으면 로그인됩니다.

임시 비밀번호

관리자가 계정을 만들거나 비밀번호를 초기화하면 임시 비밀번호가 발급됩니다. 임시 비밀번호로 처음 로그인하면 새 비밀번호를 정해야 다른 화면을 쓸 수 있습니다. 임시 비밀번호는 관리자 화면에 한 번만 보이므로 직접 전달받으세요.

잠금과 로그인 유지

• 같은 아이디로 연속 5번 틀리면 15분 동안 잠깁니다(병원 설정으로 바꿀 수 있습니다). 관리자가 바로 풀 수 있습니다.
• 로그인은 기본 12시간 유지됩니다. 여러 사람이 함께 쓰는 PC 에서는 다 쓴 뒤 꼭 로그아웃하세요. 로그아웃하면 그 브라우저에 남은 화면 자료와 고른 병원도 지웁니다.

첫 화면

‘내 업무’에서 내가 맡은 업무, 기한이 지난 업무, 오늘 마감, 확인해 달라는 요청을 먼저 봅니다. 여러 병원에 속해 있으면 왼쪽 위 병원 칸에서 병원을 바꿉니다. 어느 화면에서든 / 를 누르면 업무 검색으로 갑니다.

업무 흐름

모든 업무는 등록 → 배정 → 진행 → 처리 결과 → 완료 확인 순서로 흐르고, 모든 변경이 이력에 남습니다.

1. 등록

머리글의 ‘새 업무’를 누릅니다. 제목, 내용, 분류, 담당 부서·담당자, 우선순위(낮음·보통·높음·긴급), 기한, 공개 범위를 정하고 필요하면 사진·파일을 붙입니다.

• 분류를 고르면 그 분류에 정해 둔 담당 부서·담당자·기한이 미리 채워집니다.
• 기한을 비워 두면 병원이 정한 기본 처리 기한을 씁니다(기본은 기한 없음).
• 공개 범위: 관계자만(요청자·담당자·확인자·공유받은 사람과 담당 부서 관리자), 담당 부서(담당·요청 부서 직원), 병원 전체(모두 볼 수 있고 처리는 관계자만).
• 업무·댓글에는 환자 이름·주민등록번호 같은 식별정보를 넣지 않습니다. 주민등록번호 형태의 숫자는 저장되지 않습니다.

2. 배정

담당자가 정해지면 그 사람에게, 부서까지만 정해지면 부서에 알림이 갑니다. 병원 설정에 따라 일반 직원은 담당 부서까지만 정하고 담당자는 부서 관리자가 정할 수 있습니다. ‘담당 바꾸기’로 다시 배정하면 이전 담당자는 이력에 그대로 남습니다.

3. 진행

담당자가 ‘시작’을 누르면 진행 상태가 됩니다. 부품을 기다리거나 결정이 필요해 멈출 때는 ‘보류’를 누르고 사유를 적습니다. 다시 할 수 있게 되면 ‘재개’합니다. 묻고 답할 것은 댓글로 남깁니다(댓글은 쓴 뒤 30분 안에만 고칠 수 있습니다).

4. 처리 결과

무엇을 했는지 처리 결과를 적고, 필요하면 증빙 사진·파일을 붙입니다. 병원 설정에 따라 처리 결과 없이는 완료할 수 없습니다.

5. 완료 확인

• 확인이 필요 없는 업무는 ‘완료’를 누르면 끝납니다.
• 확인이 필요한 업무(분류에 정해 두었거나 등록 때 고른 업무)는 ‘완료’를 누르면 확인 대기가 됩니다. 지정한 확인자(없으면 요청자)가 결과를 보고 ‘확인’하면 완료, ‘반려’하면 사유와 함께 진행으로 돌아갑니다.
• 끝난 업무를 다시 해야 하면 ‘다시 열기’를 누르고 사유를 적습니다.

화면에는 지금 내가 할 수 있는 동작의 단추만 보입니다. 단추가 없다면 권한이 없거나 지금 상태에서 할 수 없는 동작입니다.

상태 설명

상태는 색만으로 구분하지 않고 점 모양과 글자를 함께 씁니다.

기한은 남은 시간으로 보여 줍니다. 지난 업무는 빨간색과 경고 표시, 오늘·24시간 안 마감은 주황색입니다.

반복 업무·점검표

정기 점검·청소 확인·주간 보고처럼 되풀이되는 일은 반복 업무로 만들어 두면 정한 시각에 업무가 자동으로 생깁니다. 업무 관리자와 부서 관리자가 만듭니다.

반복 업무 만들기

• 주기: 매일, 매주(요일 선택), 매월(날짜 선택)과 만들 시각을 정합니다.
• 만든 뒤 처리 기한, 시작일·종료일, 담당·분류·우선순위·공개 범위·확인 필요 여부를 정합니다.
• 점검 양식을 연결하면 만들어진 업무에 점검표가 붙습니다.
• 잠시 멈출 때는 ‘일시 중지’, 다시 쓸 때는 ‘재개’합니다.

서버가 멈췄던 동안의 회차

정전·점검으로 서버가 멈춘 사이 지난 회차는 템플릿마다 정한 방법으로 처리합니다: 가장 최근 회차만 만들기(기본), 지난 회차 모두 만들기(한 번에 최대 31회), 지난 회차는 건너뛰기.

점검표

점검 양식은 항목마다 입력형을 고릅니다: 확인(체크), 수치(단위·최솟값·최댓값), 메모, 선택(보기 목록). 필수 항목을 정할 수 있고, 누가 언제 입력했는지 남습니다. 양식을 고치면 버전이 올라가고 이미 만든 업무의 점검표는 그대로입니다.

인수인계

교대·휴가·퇴사로 일을 넘길 때 씁니다.

1. 인계자가 ‘인수인계 만들기’에서 받는 사람, 제목, 내용, 주의 사항, 기한을 적고 넘길 업무를 고릅니다.
2. 받는 사람에게 알림이 갑니다. 확인하기 전까지는 인계자가 그 업무의 책임자입니다.
3. 받는 사람이 ‘인수 확인’을 누르는 순간 고른 업무의 담당이 받는 사람으로 바뀝니다. 그사이 다른 사람에게 배정된 업무는 넘기지 않습니다.
4. 받을 수 없으면 사유와 함께 ‘반려’합니다. 인계자는 확인 전까지 취소할 수 있습니다.

공지·지침

• 업무 관리자는 병원 전체나 여러 부서에, 부서 관리자는 자기 부서에 공지를 올립니다.
• 종류는 공지와 업무 지침입니다. 지침은 오래 두고 보는 절차·기준에 씁니다.
• 게시 시작·종료 시각을 정해 미리 올려 둘 수 있고, 중요 공지는 화면 위쪽에 띄우며 고정해 목록 맨 위에 둘 수 있습니다.
• 작성자와 관리자는 대상 인원 중 몇 명이 읽었는지 확인할 수 있습니다.

알림

머리글의 종 단추에 새 알림 수가 나옵니다. 알림을 누르면 해당 업무로 갑니다.

• 받는 경우: 업무 배정, 부서로 들어온 업무, 상태 변경, 완료 확인 요청·확인·반려, 새 댓글, 기한 임박(기본 24시간 전)·지남, 인수인계 요청·확인·반려, 새 공지, 재배정이 필요한 업무, 업무 공유, 내려받을 파일 준비.
• 화면은 기본 30초마다 새 알림을 확인합니다.
• Cloudflare 배포형은 병원 설정으로 메일 알림도 켤 수 있습니다(메일이 없는 아이디 계정은 제외).
• 읽은 알림은 90일이 지나면 지웁니다(병원 설정).

검색·통계·내보내기

업무 목록과 검색

보기(전체·내 담당·내가 요청·확인 요청·우리 부서·담당자 없음)와 필터(상태·부서·담당자·분류·우선순위·기한)로 좁힙니다. 필터는 주소에 남아 새로 고치거나 주소를 공유해도 같은 목록이 열립니다. 부서 관리자와 업무 관리자는 여러 건을 골라 한 번에 처리할 수 있고, 부서 보드에서 상태별로 볼 수 있습니다.

통계

기간·부서·상태별 건수, 미완료·지연 업무, 처리에 걸린 시간을 실제 업무 기록으로 셉니다. 각자 볼 수 있는 업무만 집계됩니다.

엑셀·CSV 내보내기

1. 업무 목록에서 조건을 고른 뒤 ‘엑셀로 내보내기’를 누릅니다.
2. 서버가 파일을 만들면 알림이 오고, ‘내보내기’ 화면에서 내려받습니다.
3. 파일은 요청한 사람만 내려받을 수 있고 기본 24시간 뒤 지워집니다. 한 번에 최대 2만 행이며, 요청과 내려받기는 감사 기록에 남습니다.

관리자 설정

역할

한 사람에게 여러 역할을 줄 수 있습니다.

시스템 관리자의 업무 열람은 별도입니다. 계정과 설정을 관리한다고 해서 업무 내용을 볼 수 있는 것은 아닙니다. 직원·계정 화면에서 ‘업무 내용 열람’을 허용한 경우에만 읽을 수 있고, 처리는 할 수 없습니다. 제품 운영자(이룸엑스)는 병원 업무 자료를 보지 않습니다.

관리 화면

• 직원·계정: 계정 만들기(임시 비밀번호 한 번 표시), 역할·부서·직책, 비밀번호 초기화, 잠금 해제, 정지·퇴사. 정지·퇴사하면 그 사람의 진행 중 업무를 담당 부서로 돌리고 부서 관리자에게 재배정을 요청합니다(설정).
• 부서와 업무 분류: 분류마다 기본 담당 부서·담당자·처리 기한·완료 확인 필요 여부를 정합니다.
• 설정: 아래 표의 항목을 바꾸고, 바꾼 이력을 봅니다.
• 감사 기록: 로그인 실패·잠금, 계정·권한 변경, 비밀번호 초기화, 설정 변경, 내보내기·파일 내려받기 같은 작업을 찾아봅니다.
• 시스템·백업과 자료 이관: 예약 작업과 메일·알림 작업 상태, 백업, 기존 자료 가져오기.

주요 설정과 기본값

원내 설치형 운영

병원 서버 한 대에 Docker 로 설치합니다. 외부 인터넷 없이 원내망에서 동작하고, 자료는 서버의 데이터 폴더에만 있습니다.

준비

• Docker 와 Docker Compose 를 쓸 수 있는 원내 서버(리눅스 권장)
• 데이터 폴더와 백업을 둘 디스크 공간, 백업을 복사해 둘 별도 장치(NAS·외장 디스크 등)
• 직원 PC·휴대폰이 접속할 원내 주소(예: his.병원.local)와 서버 IP

설치

1. 이룸엑스가 안내한 곳에서 배포물(이미지 파일과 .sha256 파일)을 받고 해시를 확인합니다.
2. 이미지를 불러옵니다.
3. 함께 받은 his.env.example 을 his.env 로 복사해 병원 이름(HIS_HOSPITAL_NAME), 병원 코드(HIS_HOSPITAL_CODE), 접속 주소(HIS_ORIGIN)를 적습니다. compose.yml 은 컨테이너 포트 8443(HIS_PORT)을 서버의 443 으로 엽니다.
4. 원내 HTTPS 인증서를 만들고(his cert) 서비스를 시작합니다. 원내 CA 인증서(data/certs/ca.crt)를 직원 PC 에 배포합니다.
5. 처음 시작하면 병원과 첫 시스템 관리자(기본 아이디 admin)를 만들고, 임시 비밀번호를 서버 기록과 데이터 폴더의 initial-admin.txt 에 한 번 남깁니다. 로그인해 비밀번호를 바꾼 뒤 이 파일을 지우세요.

# 1~2. 해시 확인 후 이미지 불러오기
sha256sum -c his-v<버전>.tar.gz.sha256
gunzip -c his-v<버전>.tar.gz | docker load

# 3. 설정·폴더
cp his.env.example his.env
mkdir -p data backups && sudo chown 10001:10001 data backups

# 4. 인증서 → 시작 → 상태 보기
docker compose run --rm his his cert --host his.hospital.local --ip 192.168.0.10
docker compose up -d
docker compose exec his his status

# 화면 파일에 외부 주소(CDN·글꼴)가 없는지 확인
docker compose exec his his check-offline

운영 명령

서버에서 docker compose exec his his <명령> 으로 실행합니다.

백업

• 매일 정한 시각(기본 새벽 2시, 병원 시간대)에 DB·첨부 목록·설정을 백업 폴더에 남기고, 14회가 넘은 자동 백업은 지웁니다. 시각과 보관 회차는 관리자 설정의 운영 묶음에서 바꿉니다.
• 백업 폴더는 기본으로 데이터 폴더 아래 backups 이며 HIS_BACKUP_DIR 로 바꿀 수 있습니다.
• 백업 실패나 디스크 사용률 85% 초과는 시스템 관리자에게 알립니다.

백업은 별도 장치에도 두세요. 같은 서버 디스크에만 있으면 디스크가 고장 날 때 백업도 함께 잃습니다. 백업 폴더를 매일 NAS·외장 디스크 같은 다른 장치로 복사하고, 한 달에 한 번은 verify-backup 으로 실제로 쓸 수 있는지 확인하세요.

복원

1. his backups 로 되돌릴 백업을 고르고 his verify-backup <이름> 으로 검증합니다.
2. 서비스를 멈춥니다(docker compose stop his).
3. 멈춘 상태에서 복원 명령을 실행합니다(예: docker compose run --rm his his restore <이름> --yes). 복원 직전 자료는 data/pre-restore-<시각>/ 에 남습니다.
4. 서비스를 다시 시작하고(docker compose start his) 로그인해 확인합니다.

HTTPS 인증서 배포

1. his cert --host his.병원.local --ip <서버 IP> 로 원내 인증 기관(ca.crt)과 서버 인증서를 데이터 폴더의 certs 에 만듭니다.
2. ca.crt 를 직원 PC 의 ‘신뢰할 수 있는 루트 인증 기관’에 배포합니다(Windows 는 그룹 정책으로 한꺼번에 배포할 수 있습니다). 휴대폰도 같은 인증서를 설치해야 경고 없이 열립니다.
3. HIS_ORIGIN 을 https://his.병원.local 로 바꾸고 서비스를 다시 시작합니다.
4. 서버 인증서는 825일 동안 유효합니다. 만료 전에 같은 명령으로 다시 만들면 원내 인증 기관은 그대로 씁니다.

기존 자료 이관

직원·부서·업무 분류·업무 기록(첨부 포함)을 정해진 JSON 형식으로 준비합니다. his import <파일.json> 은 먼저 검사 결과만 보여 주고 아무것도 바꾸지 않습니다. 결과를 확인한 뒤 --apply 를 붙여 반영합니다. 첨부파일은 --dir <첨부 폴더> 로 함께 넘깁니다. 관리자 화면의 ‘자료 이관’도 같은 순서(검사 → 반영)입니다.

라이선스와 업데이트

• 이룸엑스가 발급한 라이선스 파일(his-license-….json)을 서버에 두고 his license <파일> 로 설치합니다. 라이선스가 없거나 만료돼도 업무는 멈추지 않고 관리자 화면에 안내만 나옵니다.
• 업데이트는 새 배포물을 받아 해시를 확인하고 이미지를 불러온 뒤 서비스를 다시 시작합니다. DB 구조가 바뀌는 버전은 적용 전에 자동으로 백업합니다. 업데이트 전에 his backup 으로 한 번 더 백업해 두기를 권합니다.

문제 해결

로그인이 안 됩니다

아이디와 비밀번호를 확인하세요. 연속으로 틀리면 잠시 잠깁니다. 잠금 해제와 비밀번호 초기화는 시스템 관리자가 직원·계정 화면에서 합니다(원내 서버에서는 his unlock·his reset-password).

화면 위에 빨간 띠가 나옵니다

서버와 연결이 끊긴 상태입니다. 원내 LAN·Wi-Fi 나 인터넷 연결을 확인하세요. 띠가 떠 있는 동안 누른 저장은 반영되지 않았으니, 연결이 돌아오면 다시 저장합니다.

“다른 사람이 바꿨습니다”라고 나옵니다

같은 업무를 다른 사람이 먼저 고쳤습니다. 화면이 최신 내용으로 바뀌었으니 확인한 뒤 다시 고치세요.

파일이 올라가지 않습니다

병원이 허용한 형식과 크기인지 확인하세요. 서버는 확장자가 아니라 실제 파일 내용으로 형식을 확인하므로, 확장자만 바꾼 파일과 매크로가 든 문서·실행 파일은 받지 않습니다.

저장하려는데 주민등록번호 때문에 막힙니다

업무·댓글·공지에 주민등록번호 형태의 숫자가 있으면 저장하지 않습니다. 해당 숫자를 지우세요. 진료 외 업무에는 환자 식별정보가 필요하지 않습니다.

반복 업무가 만들어지지 않습니다

템플릿이 일시 중지되지 않았는지, 시작일·종료일 안인지 확인하세요. 원내 설치형은 his status 에서 예약 작업이 최근에 돌았는지 봅니다. 서버가 멈췄던 동안의 회차는 템플릿의 누락 회차 정책을 따릅니다.

브라우저가 인증서 경고를 띄웁니다

그 PC·휴대폰에 원내 인증 기관(ca.crt)이 설치됐는지, 접속 주소가 인증서를 만들 때 넣은 --host·--ip 와 같은지 확인하세요.

그래도 해결되지 않으면

help@irumx.app 으로 병원 이름, 쓰던 화면, 시각, 화면에 나온 오류 문구를 보내 주세요. 환자 정보나 업무 내용 원문은 보내지 마세요.