HBAD296_자격증·면허 관리
(Hereby) 관리자 패널 > 자격증·면허 관리
| 메타 | 앱: 관리자 패널 (HBAD)대상 사용자: 조건1 [자격증 조회/수정] 권한 보유 역할프로토타입: TBU관련 정책: TBUStatus: draft (라이브 미검증 — ERD 기반)Owner: 카나 |
개요
자격증·면허 관리는 직원별 자격증/면허 보유 현황을 등록·추적하는 화면이다. employee_certifications / certificate_issuances를 근거로 한다.직원 추가([[HBAD201_직원 추가·수정 모달]])에서 자격증/면허 요구 선택 시 이 화면에 "파일 미제출" 상태로 등록되며, 이후 파일 제출·확인으로 상태가 갱신된다.자격유형 taxonomy는 문서 양식([[HBAD241_문서 양식]])의 "자격증·면허" 탭(certification_type_configs)에서 정의한 직종·자격유형을 원천으로 한다.⚠️ 본 문서는 라이브 미검증 — 서브 화면 부분 노출·ERD만 확인분. 그리드 컬럼·필터·상태 enum·필드 구성은 TBU 유지, 캡처 확보 후 GC700 깊이 확정 필요.
문서 히스토리
- 2026-07-06 최초 작성 (ERD 기반, 라이브 미검증) - 카나/콸
- 2026-07-21 GC700 깊이 재작성 (구조 정비 · TBU 명시 유지) - 카나/콸
- 2026-07-21 가독성 패스 (GUIDE §7) - 카나/PM
- 2026-07-21 셀 스타일 확정판 적용 (콸 승인) - 카나/PM
Data I/O
Server → Client
변수
| 메타 | $ |
| 메타 | $ |
| 메타 | $ |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 자격증 등록/수정 | 직원 · 자격유형 · 면허번호 · 발급기관 · 발급일 · 파일 | employee_certifications upsert (매핑 TBU) | 자격증 (라벨 기반, 매핑 TBU) |
| 파일 제출 | storagePath 등록 | (매핑 TBU) | 자격증 (추정) |
외부 통합
| 외부 시스템 | 데이터 | 동기/비동기 | 비고 |
|---|---|---|---|
| 직원 추가 모달 (HBAD201) | 자격증/면허 요구 → "파일 미제출" 상태 등록 | 동기 | 생성물 ④ |
| 문서 양식 (HBAD241) | certification_type_configs → 자격유형 taxonomy | 동기 참조 | 자격유형 원천 |
| 문서 결재 (HBAD240) | certificate_issuances → 증명서 발급 결재 | 비동기 | 발급 이력 |
자격증·면허 관리 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 진입 조건 | - | • 조건1 [자격증 조회/수정] 보유 시 노출 | 권한 트리(자격증) | |
| 01 | 초기 상태 | Output | • 진입 시 직원별 자격증 목록 그리드 표시 (초기 화면 상세 TBU, 라이브 미검증) | employee_certifications[] | TBU |
| 10 | 자격증 목록 | Grid | • 직원별 자격증/면허 목록을 표시하는 그리드. 상태 배지 포함 (컬럼·필터 구성 TBU — 서브 화면 부분 노출) - CASE01 [목록 0건]: 빈 상태 (원문 문구 TBU) | employee_certifications[] | 컬럼 상세 TBU · Empty 원문 TBU |
| 20 | 직원 * | Dropdown/Search | • 자격증 등록 대상 직원을 검색·선택하는 드롭다운 (필수) • 선택 시: 등록 대상 직원 확정 | employees (employeeId) | 필수 · TBU: 검색 0건 |
| 30 | 자격유형 * | Dropdown | • 자격증/면허 유형을 선택하는 드롭다운 (필수). [[HBAD241_문서 양식]] 자격유형 원천 • 선택 시: 등록 자격유형 확정 | certification_type_configs · employee_certifications.type | 필수 |
| 40 | 상태 | Badge | • 자격증 제출 상태를 표시하는 배지 ("파일 미제출" 등). storagePath 부재 = "파일 미제출" - CASE01 [직원 추가 시 요구]: "파일 미제출" 등록 - CASE02 [파일 제출]: 미제출 해제 | employee_certifications.storagePath · isActive · [[HBAD201_직원 추가·수정 모달]] | 상태 enum TBU |
| 50 | 세부 필드 | Input | • 면허번호 / 발급기관 / 발급일 / 파일 등 자격증 상세를 입력하는 필드 (필드 구성 TBU, 라이브 미검증) • 입력 시: 해당 자격증 레코드에 반영 | licenseNumber · issuingAuthority · issueDate · storagePath | TBU: 필드 구성 |
| 90 | 권한별 차이 | - | • 조건1 [자격증 수정] = 등록/편집 · 조건2 [자격증 조회] = 읽기전용(추정). 미보유 시 메뉴 미노출 | RBAC | 편집/조회 분기 TBU |
ERD 근거
| 엔티티 | 핵심 컬럼 | 용도 |
|---|---|---|
| employee_certifications | employeeId · type(64) · name · licenseNumber · issuingAuthority · issueDate · isActive · storagePath · lastReportedDate · nextReportingDeadline · sourceDocumentId | 직원 보유 자격증/면허. storagePath 미존재 = "파일 미제출". nextReportingDeadline=면허 신고 기한 추적 |
| certificate_issuances | employeeId · templateId · purpose · status(기본 pending) · approvedBy/approvedAt · rejectedReason · certificateHtml | 증명서 발급 요청·이력. 자격증 보유 기반 증명서 발급(발급 결재는 [[HBAD240_문서 결재]]) |
| certification_type_configs | code(64) · name · isActive · isSystem · fields(jsonb) | 자격유형 마스터 (직종별). employee_certifications.type의 원천 |
권한 / 상태 요약
| 시나리오 | 트리거 | 결과 화면 | 비고 |
|---|---|---|---|
CASE01 [직원 추가 시 요구] | HBAD201 자격증/면허 요구 | "파일 미제출" 상태로 등록 | 생성물 ④ |
CASE02 [파일 제출] | storagePath 등록 | "파일 미제출" 해제 | sourceDocumentId 연계(추정) |
CASE03 [권한 미보유] | 메뉴 접근 | 미노출 | RBAC gate |
Open Question
- 라이브 미검증: 그리드 컬럼·필터·초기 상태·Empty 원문·세부 필드·저장 동작 전반. 캡처 확보 후 GC700 깊이 확정 필요. TBU.
- 제출 상태 enum — "파일 미제출" 외 상태(제출완료/확인/만료 등) 및 storagePath 유무 판정 규칙. TBU.
- 면허 신고 기한(nextReportingDeadline/lastReportedDate) 알림·리마인드 동선. TBU.
- employee_certifications ↔ certificate_issuances(증명서 발급) 연결 관계 및 sourceDocumentId 의미. TBU.