HBAD270_설정 (조직 설정·내 정보)
(Hereby) 관리자 패널 > 기타 > 설정
| 메타 | 앱: 관리자 패널 (HBAD)대상 사용자: 조건1 [설정 수정] 권한 보유 역할프로토타입: TBU관련 정책: [[POL_근태원천]] · [[POL_권한(RBAC)]]Status: reviewOwner: 카나 |
개요
설정은 관리자 패널 "기타" 그룹의 진입점으로, "조직 설정" / "내 정보" 2개 탭으로 구성된다.조직 설정 탭은 ①기본 정보 ②급여 설정 ③메시지 발신 ④출근 기록 방식 ⑤보안·셀프서비스 ⑥알림 설정 섹션의 사용자 친화 화면이며, 저장 원천은 organization_parameters(백엔드 key-value 저장소)다.메시지 발신 섹션은 연차 통보·촉진 등 업무용 내부 메시지에 표시할 발신자 이름·이메일을 조직 단위로 관리하며(연차 사용촉진 워크플로우 [[HBAD251_연차 현황·결재]]가 이 설정을 가져다 씀), 발송 화면에는 발신자 피커를 두지 않는다.내 정보 탭은 로그인 관리자 본인 프로필을 관리한다. 근태 유형·기준 관리 5종은 근태 현황의 "유형·기준 관리" 모달로 이동했다 ([[HBAD260_근무 설정 (근무 그룹·유형)]] / [[HBAD261_유형 설정 (연장근무·외근·휴가)]] / [[HBAD262_연차 부여 기준]]).
문서 히스토리
- 2026-07-06 최초 작성 - 카나/콸
- 2026-07-10 라이브 기능 검토 반영 (설정 2탭 개편) - 카나/콸
- 2026-07-13 버튼 행동 명세 보강 - 카나/콸
- 2026-07-21 GC700 깊이 재작성 - 카나/콸
- 2026-07-21 가독성 패스 (GUIDE §7) - 카나/PM
- 2026-07-21 셀 스타일 확정판 적용 (콸 승인) - 카나/PM
- 2026-07-22 코드 변경 반영(c1d72a3·d7bd3f4) - 카나/콸
- 2026-07-30 코드 변경 반영(b375f14) - 카나/PM
- 2026-08-05 병원 로고 업로드 필드 반영(609eb73) - 카나/PM
- 2026-08-11 인센티브 자가 등록 토글 반영(e9d745c) - 카나/PM
- 2026-08-14 연차촉진 워크플로우 반영(36989ac) - 카나/PM
- 2026-08-17 라이브 실사 검증 반영(dev v0.1.0+, 유형·기준 모달 최초 실증) - 카나/PM
- 2026-08-26 로고·직인 삭제의 저장 영속 반영(b09c616) - 카나/PM
Data I/O
Server → Client
변수
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 조직 설정 값 변경 | 섹션 값 | sdk.settings.update() (추정) | settings:write (라벨 "설정 수정", 매핑 추정) |
| 출근 기록 방식 변경 | source | sdk.settings.update() (추정) | settings:write (추정) |
| 알림/셀프서비스 토글 | boolean | sdk.settings.update() (추정) | settings:write (추정) |
| 내 정보 수정 | 본인 프로필 | sdk.employee.updateSelf() (추정) | 본인(self scope, 추정) |
외부 통합 (cross-app)
| 외부 시스템 | 데이터 | 동기/비동기 | 비고 |
|---|---|---|---|
| Secom 지문 단말기 | 출근 기록 방식=지문 단말기 시 secom_events punch 수집 활성 | 비동기(polling 주기 TBU) | secom_sync_state.enabled |
| 직원 앱 (HBEA) | 셀프서비스 허용 항목 → 직원 "내 정보" 수정 가능 항목 결정 | 동기 참조 | [[HBEA]] 내 정보 |
| 급여 산정 (HBHR) | 급여 지급일·마감일 → 산정 주기 | 동기 참조 | 마감일→지급일 |
조직 설정 탭 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 진입 조건 | - | • 조건1 [설정 수정] 인증 시 사이드바 "기타" 그룹 > "설정"으로 진입- CASE01 [미인증/미보유]: /admin/signin 리다이렉트 | 인증 세션 · RBAC | |
| 01 | 초기 상태 | Output | • 진입 시 "조직 설정" 탭 기본 랜딩, 각 섹션 read 모드 표시 | - | |
| 10 | 탭 | Tab | • "조직 설정" / "내 정보" 2개 탭 전환 • 클릭 시: CASE01 [조직 설정] → 5섹션 · CASE02 [내 정보] → 본인 프로필(70) | - | |
| 20 | 기본 정보 | Section | • 조직 기본 정보를 표시 — 상호 / 법인명 / 기관코드 / 사업자번호 / 대표자명 / 대표전화 / 이메일 / 팩스 / 웹사이트 / 직인 - CASE01 [빈 항목]: "—" 표기(라이브 이메일·웹사이트="—") · 직인 미등록 시 "미등록" | organizations · organization_parameters | |
| ㄴ21 | 병원 로고 | Upload | • 병원 로고 이미지 업로드·표시 필드 (기본 정보 섹션) - read 모드: dt 라벨 "병원 로고", 값(로고 이미지) 표시 · CASE01 [미등록]: "등록된 로고가 없어요" - edit 모드: 라벨 "병원 로고", "병원 로고 업로드" 버튼(ds-btn--line, label을 파일 인풋으로 사용), 도움말 "업로드하면 좌측 상단에 hereby 로고와 함께 병원 로고가 표시돼요. (500KB 이하 이미지)" • 업로드 시: 로고 등록 → LNB 심볼 슬롯에 병원 로고 표시(416d863로 코브랜딩→슬롯 대체 전환) - 제약: 500KB 이하 이미지 - CASE02 [삭제 후 저장]: 로고·직인 삭제가 조직 저장 시 영속 — 저장 후 재진입 시에도 삭제 유지 (코드 반영: b09c616, 구버전은 삭제가 저장에서 유실되던 버그) | organization_parameters | 신설 (코드 반영: 609eb73) · LNB 표시 [[HBAD100_App Shell·사이드바]] · 삭제 영속(b09c616) |
| ㄴ22 | 수정 | Button | • 기본 정보를 편집 모드로 전환 • 클릭 시: read → 편집 모드 전환 | organization_parameters | 편집 모드 · TBU: 저장 동선 |
| 30 | 급여 설정 | Section | • "지급일·마감일·근무시간" 값 표시 — 급여 지급일(30일) / 마감일(21일) / 회계연도 시작월(1월) / 주당 근무시간 한도(52시간) / 1일 기본 근무시간(8시간) / 통화(KRW) - CASE01 [미설정]: 기본값 표기(추정) | organization_parameters · 급여 산정(HBHR) | 마감일→지급일 산정 주기 |
| ㄴ31 | 주간 한도 알림 (weeklyLimitAlert) | Toggle | • 직원이 주간 근로시간 한도를 초과하면 관리자·인사관리자에게 알림 발송 여부 (급여 설정 섹션, 기본 켜짐) - read 모드 라벨 "주당 초과 알림", 값 "사용" / "사용 안 함" - 편집 모드 라벨 "주당 근무시간 초과 알림", 안내 "주당 근무시간 한도를 초과하면 관리자·인사관리자에게 알림을 보내요." • 토글 시: orgSettingsForm.weeklyLimitAlert 반영 (기본값 on) | organization_parameters(workHours.weeklyLimitAlert) · 주당 근무시간 한도(52시간) | 신설 (코드 반영: b375f14) · 기본 켜짐 |
| ㄴ32 | 인센티브 자기 등록 허용 | Toggle | • 직원이 직원 앱 결재 화면에서 본인 인센티브(프리셋 실적)를 직접 등록할 수 있는지 조직 단위 on/off (급여 설정 부근, 기본 꺼짐 opt-in) - 카드 제목 "인센티브", 안내 "직원 자기 등록", 항목 값 "직원앱 인센티브 자기 등록" - 도움말(원문): "켜면 직원이 직원앱 결재 화면에서 오늘 실적(프리셋 항목·건수)을 직접 등록할 수 있어요. 끄면 등록 메뉴가 숨겨지고 서버에서도 차단돼요. 관리자·시트 경로는 영향받지 않아요." • 토글 시: incentive.self_registration 파라미터 생성/수정 (없으면 create, 있으면 update)- CASE01 [OFF]: 직원 앱 인센티브 등록 진입점 미노출 + 서버 등록 차단 · CASE02 [ON]: 직원 앱 결재 신규 등록 시트에 "인센티브 등록" 노출 | organization_parameters(incentive.self_registration) · [[HBEA400_결재 허브]] | 신설 (코드 반영: e9d745c) · 기본 꺼짐(opt-in) · 관리자·시트 경로 미영향 |
| 35 | 메시지 발신 | Section | • 카드 제목 "메시지 발신" (원문), 설명 "내부 메시지 발송 시 발신자 이름·이메일" (원문). 업무용 내부 메시지(연차 통보·촉진 등)에 표시할 발신 이름·이메일을 조직 단위로 관리 — 발송 화면에는 발신자 피커를 두지 않고 항상 이 설정을 사용 - read 모드: "발신 이름" / "발신 이메일" 값 표시. 값 없으면 "미설정 (플랫폼 메시지 기본)" (원문, muted) - edit 모드 아래 ㄴ36 참조 | organization_parameters(messageSender.name/email) · [[HBAD251_연차 현황·결재]] 촉진 통지 | 신규 · TC20 메시지 발신 설정(코드 반영: 36989ac) · 전자서명 발신 설정과 동일 UX·별도 카드 |
| ㄴ36 | 발신 이름·이메일 입력 | Input | • (edit 모드) 발신 이름·이메일 자유 입력(직원 드롭다운 아님) - "발신 이름" 입력(data-testid=settings-message-sender-name, placeholder "예: 인사팀" 원문) - "발신 이메일" 입력(type=email, data-testid=settings-message-sender-email, placeholder "예: hr@company.com" 원문) - 도움말(원문): "비워두면 플랫폼 기본으로 발송됩니다. 워크스페이스 생성 시 owner 정보로 초기화돼요." • 저장 시: 조직 설정 저장과 동일(orgSettingsForm.messageSenderName/Email) | organization_parameters(messageSender) | 조직 생성 시 owner 정보로 초기화, 이후 SoT는 설정값(owner 계정 변경과 자동 동기화 안 함) · 발송 시점 값은 이력에 스냅샷 보존 |
| 40 | 출근 기록 방식 | Section | • 조직 근태 원천을 선택 — 현재 "지문 단말기 (Secom)" • 선택 시: CASE01 [Secom] → secom_events punch 수집 활성 - 직원별 개별 설정은 직원 모달의 "출근 기록 방식"(조직 기본값 사용 / 앱 (Web/Mobile) / 지문 단말기 (Secom) / 관리자 수동 입력) | secom_sync_state · [[POL_근태원천]] · [[HBAD201_직원 추가·수정 모달]] | 근태 원천 결정 |
| 50 | 보안 · 셀프서비스 | Section | • 로그인 보안·셀프서비스 항목 관리 — "비밀번호 찾기 허용" 토글(+ 비밀번호 규칙 표기) + "직원 본인 수정 허용 항목"(안내 "직원이 내정보에서 직접 수정할 수 있는 항목": 프로필 사진 / 전화번호 / 주소 / 비상연락처 / 계좌정보) | organization_parameters · 직원 앱 내 정보(HBEA) | 라이브: 본인 수정 5항목 일치 + 비밀번호 규칙 표기 추가 관찰(2026-08-17 실사) |
| ㄴ51 | 비밀번호 찾기 허용 | Toggle | • 직원의 비밀번호 찾기 허용 여부 • 세부 비밀번호 규칙 표기(라이브 관찰): 임시 비밀번호 = 숫자만·6자리 / 일반 비밀번호 = 8자 이상·소문자·숫자 • 토글 시: 설정 인라인 반영(추정) | organization_parameters | 라이브 비밀번호 규칙 표기 추가(2026-08-17 실사, 사양 미기재분 반영) |
| ㄴ52 | 본인 수정 허용 항목 | Toggle | • 프로필 사진 / 전화번호 / 주소 / 비상연락처 / 계좌정보 항목별 셀프 수정 허용 • 토글 시: ON 항목이 직원 앱 "내 정보"에서 수정 가능해짐(추정) | 직원 앱 내 정보(HBEA) | |
| 60 | 알림 설정 | Section | • 앱 푸시 알림 정책 관리 — "앱 푸시 알림"("휴가·연장근무·증명서 등 결재·승인 알림을 휴대폰 푸시로 받아요. 꺼도 앱 알림함에는 계속 쌓입니다.") + "전체 알림 받기"("끄면 모든 유형의 알림이 일시중지돼요.") | notifications · 앱 푸시 | |
| ㄴ61 | 앱 푸시 알림 | Toggle | • 결재·승인 알림의 휴대폰 푸시 수신 여부 • 토글 시: OFF여도 앱 알림함에는 계속 적재(원문) | notifications · 앱 푸시 | |
| ㄴ62 | 전체 알림 받기 | Toggle | • 전체 알림 일시중지 스위치 • 토글 시: OFF → 모든 유형 알림 일시중지(원문) | notifications | |
| 70 | 내 정보 탭 | Tab | • 로그인 관리자 본인 프로필 조회·수정 진입 • 클릭 시: 내 정보 탭 전환 (하단 "내 정보 탭 사양표" 참조) | employees(본인) | |
| 80 | 에러·실패 | - | • 저장 실패 시 피드백(토스트/무반응) = TBU (라이브 미검증) | - | TBU |
| 90 | 권한별 차이 | - | • 조건1 [설정 수정] 없으면 진입 자체 차단(/admin/signin)- 섹션별 read-only 분기 여부 = TBU | RBAC | 권한 분기 TBU |
내 정보 탭 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 노출 조건 | - | • "내 정보" 탭 클릭 시 노출 — 대상 = 로그인 관리자 본인 | employees(본인) | |
| 10 | 본인 프로필 | Section | • 로그인 관리자 본인 프로필 조회·수정 - CASE01 [프로필 값 부재]: 표기 = TBU | employees(본인) | TBU: 필드 구성 상세 · Empty 표기 |
| 20 | 서명(signature) | Upload | • 본인 서명 이미지 업로드·표시 기능. 서명 이미지를 업로드하면 등록된 서명이 표시됨 • 업로드 시: 서명 이미지 등록 → 문서 결재 양식(승인 폼)에 서명 자동 삽입 연동 - CASE01 [미등록]: 서명 미표시 (등록 안내) | employees(본인) · Employee.signatureImage · [[HBEA510_내 정보·근무 설정]] | 신설 · 문서 결재 양식 서명 삽입 연동(코드 반영: c1d72a3·d7bd3f4) |
출근 기록 방식 (근태 원천) 매핑
| 방식 | 설명 | 비고 |
|---|---|---|
| 지문 단말기 (Secom) | Secom 지문 단말기 punch → secom_events → attendances 정규화 | 현재 활성 원천 |
| 앱 (Web/Mobile) | 직원 앱 출퇴근 기록 | 4월 원천 |
| 관리자 수동 입력 | 관리자 수동 입력 | 수정 사유 필수 연동(추정) |
| 조직 기본값 사용 | 직원별 설정에서 조직 설정값 상속 | 직원 모달 전용 옵션 |
권한 / 상태 요약
| 시나리오 | 트리거 | 결과 화면 | 비고 |
|---|---|---|---|
CASE01 [권한 보유 진입] | /admin 설정 진입 | 조직 설정 탭 랜딩 | 기본 |
CASE02 [권한 미보유] | 진입 시도 | /admin/signin 리다이렉트 | RBAC gate |
CASE03 [출근 기록 방식 변경] | Secom 선택 | secom_events punch 수집 활성 | [[POL_근태원천]] |
CASE04 [내 정보 탭] | 탭 클릭 | 본인 프로필 조회·수정 | self scope |
Open Question
- organization_parameters namespace/key 전체 카탈로그(백엔드). TBU.
- 출근 기록 방식 변경 시 기존 근태 데이터 처리. TBU.
- 내 정보 탭 필드 구성 상세. TBU.
- 각 섹션 저장 성공/실패 피드백(80 에러 동작). 라이브 미검증. TBU.
- 파라미터 변경 이력 노출 여부(organization_parameters_history 추정). TBU.
- 메시지 발신: 빈 값일 때 실제 플랫폼 기본 발신자 이름·이메일(요구사항 OQ-1). TBU.
- 메시지 발신: 발신 이메일의 Messenger 화면 실노출 여부·이력 저장 범위(요구사항 OQ-2). TBU.
- 보안: 비밀번호 규칙(임시 숫자만·6자리 / 일반 8자 이상·소문자·숫자) 정책 문서화·강제 로직 여부(2026-08-17 실사 표기 관찰). TBU.