HBGA000_총무 (앱 개요)
(Hereby) 총무 > 앱 개요
| 앱 | 총무 (HBGA) |
| 대상 사용자 | 조건1 [GA_ADMIN] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_법정의무교육]] (교육 축) · 반복 업무/공지 축 정책 TBU |
| Status | review |
| Owner | 카나 (PM) |
개요
- (Hereby) 총무는 총무 전체 ERP가 아니라, 법정교육·반복 점검업무·공지 발행/확인을 관리하는 컴플라이언스 운영 보드다.
- 세 축 = 교육(mandatory_trainings / training_completions) · 반복 업무(recurring_tasks / recurring_task_executions / task_checklist_items / checklist_completions) · 공지(general_affairs_notices / notice_acknowledgments). 각 축은 "정의 record" + "이력 record" 쌍으로 구성된다.
- 자산·계약·비품청구·구매요청은 라이브에서 확인되지 않았으며 **확장 영역(Donue P1 후보)**이다.
- 좌측 메뉴 구성 = 대시보드 / 총무(=교육 관리) / 관리(=반복 업무 관리) / 공지, 계정 메뉴 = 내 정보 / 로그아웃.
- 설정 화면(HBGA240)은 사이드바·계정 메뉴 어디에도 진입점이 없다(현재 미노출).
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 + 확정 스타일 |
| 2026-07-21 | 카나 | PM | TC 크로스체크 확정분 반영 (🟡) |
Data I/O
Server → Client
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| $ | 인증 세션 (조건1 [GA_ADMIN] / 조건2 [SUPER_ADMIN]) | 없으면 signin 리다이렉트 | 세션 미존재 시 진입 차단 |
| $ | training_completions.expiryDate 임박 집계 (추정) | 0 | 대시보드 KPI |
| $ | recurring_task_executions.status overdue 집계 (추정) | 0 | 대시보드 KPI |
| $ | recurring_task_executions.status pending 집계 (추정) | 0 | 대시보드 KPI |
| $ | general_affairs_notices.isPublished=true 집계 (추정) | 0 | 대시보드 KPI |
| $ | general_affairs_notices[] | empty | 최근 공지 리스트 |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 교육/업무/공지 생성·수정·삭제 | 각 화면 폼 값 | 개별 화면 참조 (추정) | GA_ADMIN (추정) |
| 이수기록/실행내역 저장 | completion/execution 값 | 개별 화면 참조 (추정) | GA_ADMIN (추정) |
| 공지 게시 | noticeId, isPublished | sdk.generalAffairs.notice.*() (추정) | GA_ADMIN (추정) |
| 알림 설정 저장 | 설정 값 | TBU (진입점 없음) | TBU |
전 mutation은 사람 확정이며, 상세 파라미터는 개별 화면(HBGA210/220/230)을 참조한다. token 내부 key 미확정 (OQ).
외부 통합 (cross-app)
| 외부 시스템 | 데이터 | 방향 | 비고 |
|---|---|---|---|
| Admin Employee | 교육 이수 대상 직원 / 공지 확인 대상 employeeId | 원천 → 총무 | 직원 마스터 참조 |
| Employee App (HBEA300_메신저) | 공지/알림 수신 | 총무 → 직원 | 게시 공지 수신, "확인했어요" 읽음 검증됨 |
| Inventory | 점검 대상 장비 | 원천 → 총무 | 라이브 미확인 (추정) |
| 문서 저장소 | 이수증/점검사진/계약서 증빙 | 양방향 | 라이브 미확인 (추정) |
| Management Dashboard | 컴플라이언스 리스크 KPI | 총무 → 대시보드 | 라이브 미확인 (추정) |
화면 플로우
공지 게시·이수 확정·점검 완료·삭제는 사람이 실행한다. AI는 read/suggest/preflight/export draft까지만 관여하며, 설정(HBGA240)은 어느 경로에도 진입점이 없다.
앱 개요 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 화면 진입 조건 | - | • 조건1 [GA_ADMIN] 또는 조건2 [SUPER_ADMIN] 인증 세션이 있어야 진입• 진입 시: 미인증이면 signin 리다이렉트, 인증이면 대시보드 노출 | 인증 세션 | token 내부 key TBU |
| 01 | 초기 상태 | - | • /general-affairs/ 진입 시 대시보드가 기본 화면으로 노출 | HBGA200_대시보드 | |
| 10 | 정체성 | - | • 법정교육·반복 점검업무·공지 3축의 컴플라이언스 운영 보드. 각 축이 "정의 record" + "이력 record" 쌍으로 구성됨 • 자산/계약/비품/구매요청은 미구현(확장 영역) | HBGA210 / HBGA220 / HBGA230 | |
| 20 | 도메인 — 교육 | - | • 법정의무교육 정의(주기/필수시간/대상/과태료) + 직원별 이수기록을 관리하는 축. 과태료를 정량화해 노출 | HBGA210 / HBGA211 · mandatory_trainings / training_completions | [[POL_법정의무교육]] |
| 21 | 도메인 — 반복 업무 | - | • 시설/안전/소방 등 반복 점검업무 정의 + 체크리스트 + 실행내역을 관리하는 축 | HBGA220 · recurring_tasks / recurring_task_executions / task_checklist_items | |
| 22 | 도메인 — 공지 | - | • 카테고리/우선순위/게시 상태 공지 + 대상자별 확인 내역을 관리하는 축. 게시 공지는 직원 메신저로 수신됨 | HBGA230 / HBEA300_메신저 · general_affairs_notices / notice_acknowledgments | |
| 30 | 확장 영역 (미구현) | - | • 자산·계약·비품청구·구매요청은 라이브 미확인. Donue P1 확장 후보로 별도 범위화 필요 | Inventory / 문서 저장소 | TBU: P1 범위 확정 |
| 40 | 화면 목록 (I.A.) | - | • HBGA100 Shell / HBGA200 대시보드 / HBGA210 교육 / HBGA211 이수현황 / HBGA220 반복 업무 / HBGA230 공지 • HBGA240 설정 = 현재 미노출(진입점 없음) | 앱 하위 화면 | |
| 50 | cross-app 연결 | - | • Admin Employee(직원) · HBEA300_메신저(공지 수신) · HBAD296_자격증·면허 관리(교육 이수 연계 후보) · Inventory(점검 장비) · Management Dashboard(리스크 KPI) | Data I/O 외부 통합 참조 | 일부 라이브 미확인 |
AI 접점 요약
General Affairs의 AI는 컴플라이언스 리스크를 읽고, 누락을 알려주고, 증빙 초안을 만드는 보조자다. 현재 라이브 AI 표면은 없으므로 아래 7종은 greenfield 후보다. 핵심 룰: AI 자동 게시/자동 저장/자동 완료/자동 삭제 금지, read/suggest/preflight/export draft까지만. 법령/과태료 금액은 AI가 확정하지 않고 검수된 정책 테이블을 참조한다.
| AI Skill | 트리거 위치 | 동작 | 안전 경계 | 우선도 |
|---|---|---|---|---|
| complianceExposureBrief | 대시보드 / 교육 (HBGA200/210) | 미이수 교육·지연 점검·만료 공지 근거로 잠재 과태료/위험 노출을 위험순 환산. 예: "이번달 만료 3건, 미이수 시 과태료 총 158만원" | 읽기 전용, 법무/노무 검수 필요 | ★★★★★ |
| ga.complianceBrief | 대시보드 (HBGA200) | 오늘 봐야 할 교육만료/지연업무/대기업무/게시공지와 담당자를 요약 | 읽기 전용 | ★★★★☆ |
| ga.trainingExpiryAlert | 교육 (HBGA210) | 신규 입사/직무 변경자 또는 만료 임박자를 찾아 교육 등록 초안 제안 | suggest, 사람 등록 | ★★★★☆ |
| ga.completionOcrDraft | 이수기록 추가 (HBGA211) | 이수증 이미지/PDF에서 교육기관·수료번호·이수일·이수시간 추출해 폼 채움 | suggest, 사람 저장 | ★★★☆☆ |
| ga.taskOverdueSummary | 반복 업무 (HBGA220) | 지연/대기 점검업무를 담당자·카테고리·위험도별로 요약 | 읽기 전용 | ★★★☆☆ |
| ga.noticeDraft | 공지 (HBGA230) | 교육마감/시설/안전/정책 공지 초안 작성 | suggest, 사람 게시 | ★★★☆☆ |
| ga.auditPackExportDraft | 교육/공지/반복 업무 전반 | 기간별 이수기록·이수율·실행내역·확인내역·첨부를 묶어 감사 PDF/컴플라이언스 리포트 초안 생성 | export draft, 사람 확정 | ★★★★☆ |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [미인증 진입] | /general-affairs 직접 | signin 리다이렉트 | |
CASE02 [총무 담당자 진입] | 인증 세션 (조건1 [GA_ADMIN]) | 대시보드 노출 | |
CASE03 [공지 게시] | 공지 게시 → 사람 확인 | isPublished=true, 게시 중 전환 | 사람 실행 |
Open Question
- GA 3축(교육·반복 업무·공지) 밖에서 라이브 동작 확인된 기능 — 화면 범위/사양서 신규 여부 검토 필요 (TC 확정: 05:5.5~5.7):
- 스포츠 인센티브
fixedIncentive.*(05:5.5) - 교육지원금
educationSubsidy.*— status PENDING→approve 흐름 (05:5.6) - 문서 저장소
document.upload/document.list/document.get(05:5.7)
- 스포츠 인센티브
- 자산/계약/비품청구/구매요청 모듈 부재 재확인 및 Donue P1 범위화 = TBU
- 이수증/점검사진/공지첨부/계약서 파일 첨부 지원 여부 = TBU
- audit trail(생성자/수정자/삭제자/게시자/확인자/저장 시각) UI 존재 여부 = TBU
- 법령/과태료 영업자료화 전 법무·노무 검수 = TBU
- 데이터 cleanup 필요(555555, cgxfgnfgn 등 더미) = TBU
- 대상 사용자 권한 토큰 내부 key(GA_ADMIN / SUPER_ADMIN) = TBU