시작하기
hereby 플랫폼을 처음 사용하는 분들을 위한 초기 설정 가이드입니다.
접속 정보
공통
| 사이트 | 비고 |
|---|---|
| hereby 메디컬 medical.hereby.me | 서비스 소개 페이지 (로그인 불필요) |
| hereby 문서 docs.hereby.me | 이 문서 사이트 |
| 시스템 관리자 system-admin.dev.hereby.me | 플랫폼 운영자 전용. 개발 환경 주소 — 운영 호스트 미개설, IP 허용 목록 필요 |
OKBest (베스트재활병원) — 운영
| 앱 | 대상 사용자 |
|---|---|
| 관리자 패널 okbest.hereby.me/admin | 시스템 관리자 |
| HR 급여 시트 okbest.hereby.me/hr-system | HR 담당자 |
| 팀 결재 okbest.hereby.me/team-manager | 팀장/관리자 · 간호 스케줄러 포함 |
| 총무 okbest.hereby.me/general-affairs | 총무 담당자 |
| 경영 대시보드 okbest.hereby.me/management-dashboard | 병원장/경영진 |
| 재고 okbest.hereby.me/inventory | 총무 담당자 |
| 모듈 매니저 okbest.hereby.me/module-manager | 시스템 관리자 |
로컬 개발 환경
| 앱 | 대상 사용자 |
|---|---|
HR 급여 시트http://localhost:4000 | HR 담당자 |
관리자 패널http://localhost:4001 | 시스템 관리자 |
hereby Works (직원 앱)http://localhost:4002 | 전체 직원 |
팀 결재 (간호 스케줄러 포함)http://localhost:4004 | 팀장/관리자 · 간호 관리자 |
총무http://localhost:4005 | 총무 담당자 |
경영 대시보드http://localhost:4006 | 병원장/경영진 |
재고http://localhost:4007 | 총무 담당자 |
모듈 매니저http://localhost:4010 | 시스템 관리자 |
시스템 관리자 APIhttp://localhost:4100 | 플랫폼 운영자 |
시스템 관리자 UIhttp://localhost:4101 | 플랫폼 운영자 |
INFO
「OKBest」 표의 주소가 실제 운영 환경입니다. 병원마다 앞부분(okbest)이 달라지고 뒤쪽 경로는 같습니다 — 새 병원이 열리면 그 병원 주소를 받아 쓰세요.
QA 환경 (Staging)
| 사이트 | 비고 |
|---|---|
| OKBest okbest.stg.hereby.me | 병원 워크스페이스 진입점 |
| 관리자 패널 okbest.stg.hereby.me/admin | 시스템 관리자 |
| 시스템 관리자 system-admin.stg.hereby.me | 플랫폼 운영자 |
브랜치 운영 방식
develop PR merge
- 빠른 개발 내용 확인 및 통합 목적
- 동시에 여러 PR이 머지되는 경우, 먼저 머지된 내용 기준으로 이후 PR에 일부 변경사항이 누락될 수 있습니다.
- develop 머지 후에는 최신 develop 브랜치를 다시 pull/rebase 받아 변경사항 누락 여부를 확인하세요.
실제 QA 진행
- staging 브랜치 기준으로 진행합니다.
- dev/develop 환경은 개발 및 기능 확인 용도로 사용하고, QA는 staging 환경에서 진행합니다.
- staging 브랜치는 실제 QA 기준 환경이므로, 머지 전 영향도 및 테스트 확인을 신중하게 진행하세요.
최초 로그인
1단계: 계정 확인
시스템 관리자가 직원 정보를 등록하면 계정이 자동 생성됩니다. 등록된 사번(또는 이메일)과 초기 비밀번호를 확인하세요.
2단계: 로그인
- 브라우저에서 사용할 앱의 URL에 접속합니다
- 「ID」 칸에 사번·이메일·전화번호 중 하나를 입력합니다 (베스트재활병원 운영 환경은 사번 로그인이 기본입니다)
- 비밀번호를 입력합니다
- 로그인 버튼을 클릭합니다
3단계: 비밀번호 변경
보안을 위해 최초 로그인 후 비밀번호를 변경하는 것을 권장합니다.
브라우저 요구사항
| 브라우저 | 최소 버전 |
|---|---|
| Chrome | 90+ |
| Safari | 15+ |
| Firefox | 90+ |
| Edge | 90+ |
WARNING
Internet Explorer는 지원하지 않습니다.
모바일 앱 (직원 앱)
직원 앱은 모바일에서도 사용할 수 있습니다:
- iOS: App Store에서 "Hereby" 검색하여 설치
- Android: Google Play에서 "Hereby" 검색하여 설치
- 웹: 모바일 브라우저에서 직원 앱 URL 접속
도움말
사용 중 문의사항이 있으면:
공통 기능
로그인
- 브라우저에서 앱 URL로 접속
- 「ID」(사번·이메일·전화번호)와 비밀번호 입력
- 로그인 클릭
최초 로그인 시 임시 비밀번호를 변경해야 합니다.
알림 벨 (2026-06 정책)
모든 앱(시스템 관리자 제외) 우측 상단의 알림 벨은 받은 알림 인박스 전용입니다.
- 빨간 배지: 읽지 않은 알림 수
- 목록: 최근 받은 알림. 항목 위에서 "이 사람 알림 끄기"로 바로 음소거할 수 있습니다.
알림 설정은 알림 벨이 아니라 '내 정보' 모달에서 관리합니다:
- 푸시 알림 on/off (iOS·Android FCM / 브라우저 Web Push)
- 이벤트 종류별·채널별(인앱/푸시) on/off, '전체 알림 받기' 통합 토글
- 음소거한 사람/팀 관리 (이메일·SMS 채널은 전역 off)
명령 팔레트 (HR 시스템)
Ctrl + K를 눌러 전역 액션 검색을 엽니다.
키보드 단축키 (HR 시스템)
**?**를 눌러 단축키 도움말 모달:
- Ctrl + C / V / M: 복사 / 붙여넣기 / 메모
- Ctrl + Z: 실행 취소
- Ctrl + F: 검색
- Ctrl + G: 급여 재생성
- 화살표 / Shift+화살표: 이동 / 선택
권한 시스템 (RBAC)
범위 기반 역할 기반 접근 제어 (self / team / all):
- 시스템 관리자: 전체 접근
- HR 관리자: 급여, 인사, 수당/공제
- 팀장: 직속 부하의 휴가/연장/인센티브 승인
- 직원: 본인 데이터 조회 및 제출
일반 UI 요소
- 대시보드: 주요 지표 개요
- 필터 바: 목록 상단 검색 및 필터
- 페이지네이션: 목록 하단
- 상태 배지:
- 파랑: 초안 / 대기
- 초록: 승인 / 완료
- 빨강: 반려
- 노랑: 진행 중
- 회색: 취소됨
- 한국어 로케일: 날짜 (YYYY-MM-DD), 통화 (₩), 전화 (+82)