HBEA500_더보기
(Hereby) 직원 앱 > 더보기
| 앱 | 직원 앱 (Employee App, 포트 4002) |
| 대상 사용자 | 조건1 [EMPLOYEE] (self scope 인증 세션) |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_더보기개편]] (FIG 정책 more.md) · [[POL_RBAC권한모델]] |
| Status | review |
| Owner | 카나 |
개요
- 직원 앱 하단 탭바 "더보기" 탭. 프로필 카드 + 메뉴 8종("내 정보" / "서명/도장" / "근무 시간 설정" / "근무 형태 변경" / "급여명세서" / "불편·기능 신고" / "휴대폰 알림 설정" / "화면 설정" / "로그아웃")을 담는다. ⚠ 2026-08-18 재검증에서 4종→7종 확장(서명/도장·휴대폰 알림 설정·화면 설정 신설), 2026-09-04 재검증에서 "불편·기능 신고" 추가로 8종(CS 리포트 진입점, #608·609 — 클릭 시 공용 CS 모달 "불편·오류 신고" 오픈, 상세는 [[HBAD100_App Shell·사이드바]] ㄴ10-1과 동일 모달).
- 프로필 카드는 아바타 + "최콸" / "FIRMA005" / "관리자"(이름 / 사번 / 직위·역할)로 구성되고, 하단에 "hereby Works v1.0.0" 버전 표기가 있다. (사번 노출은 정책 예정→라이브 반영됨. 버전 표기 워딩은 소문자 "hereby".)
- 내 정보·근무 설정·급여명세서는 모두 모달로 열린다(중첩 관찰). 상세는 [[HBEA510_내 정보·근무 설정]] · [[HBEA530_급여명세서 모달]] 참조.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 (더보기 4종·버전 표기) |
| 2026-07-13 | 카나 | PM | 버튼 행동 명세 보강 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 |
| 2026-07-21 | 카나 | PM | 셀 스타일 확정판 적용 (콸 승인) |
| 2026-08-18 | 카나 | 라이브 재검증 정정 | 더보기 개편(POL_더보기개편) 라이브 반영: 메뉴 4→7종(서명/도장·휴대폰 알림 설정·화면 설정 신설, 근무 설정→근무 시간 설정 분리), 프로필 카드에 사번(FIRMA005) 노출, 버전 표기 "hereby Works v1.0.0"(소문자) |
| 2026-09-04 | 카나 | PM | 메뉴 "불편·기능 신고" 추가로 8종(#608·609 머지, 라이브 실증) — CS 리포트 진입점 |
Data I/O
Server → Client
| 변수 | DB 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
${profile_name} | Employee.name (self) | 빈 텍스트 | 프로필 카드 이름 "최콸" |
${profile_role} | Employee.role / 직위 (self) | 빈 텍스트 | 프로필 카드 "관리자" |
${profile_avatar} | Employee.avatarUrl (self) | 이니셜 아바타 fallback | "최" 이니셜 관찰 |
${payslip_count} | Payslip.count (self) | 0 → 급여명세서 모달 Empty | 모달 진입 시 로드 (HBEA530) |
${app_version} | 클라이언트 빌드 상수 | (고정) | "Hereby Works v1.0.0" |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 내 정보 열기 | — | (모달 오픈, 조회) sdk.employee.getSelf() (추정) | employee:read.self |
| 근무 설정 열기 | — | (모달 오픈) sdk.employee.getSelf() (추정) | employee:read.self |
| 급여명세서 열기 | — | sdk.payslip.listSelf() (추정) | payslip:read.self |
| 로그아웃 | — | 세션 종료 → /employee-app/signin 이동 | (인증 세션) |
외부 통합 (cross-app)
| 외부 시스템 | 데이터 | 동기/비동기 | 비고 |
|---|---|---|---|
| Admin 설정 ([[HBAD270_설정 (조직 설정·내 정보)]]) | "직원 본인 수정 허용 항목" | 동기 (내 정보 모달 로드 시) | 수정 허용 범위 원천 |
| HR 급여 ([[HBHR270_전자서명 발송·eCount 연동 시트 (2섹션)]]) | 급여명세서 발송·서명 상태 | 비동기 | 급여명세서 모달 원천 |
화면 플로우 (더보기 메뉴 4종 → 모달 흐름)
더보기 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 화면 진입 조건 | - | 조건1 [EMPLOYEE] 인증 세션 시 노출. 하단 탭바 "더보기" 선택 진입 | 인증 세션 (self) | |
| 01 | 초기 상태 | Output | 프로필 카드 + 메뉴 7종 즉시 렌더. ${payslip_count}는 급여명세서 모달 진입 시 지연 로드 | self | 2026-08-18: 4종→7종 |
| 10 | 프로필 카드 | Card | 아바타 + "최콸" / "FIRMA005" / "관리자" (이름 / 사번 / 직위·역할) | ${profile_name} · ${profile_role} | 2026-08-18: 사번 노출 반영 |
| ㄴ | 값 없음 | Output | ${profile_name} 부재 시 빈 텍스트, ${profile_avatar} 부재 시 이니셜("최") fallback | ||
| 20 | 내 정보 | Link | • 본인 프로필 조회·수정 표면 진입. 수정 허용 범위 = Admin 설정 종속 • 클릭 → "내 정보" 모달 오픈(중첩 가능) → [[HBEA510_내 정보·근무 설정]] | [[HBEA510_내 정보·근무 설정]] | → Modal 1 |
| 25 | 서명/도장 | Link | • 결재문서(휴가·시간외·외근 신청서 등) 서명란 이미지 등록 표면. 안내 "결재문서(휴가·시간외·외근 신청서 등)의 서명란에 들어가는 이미지예요." + "등록하면 결재문서 서명란에 사용돼요." + [등록] • 2026-08-18 신설(구 HBEA510 모달1 내부 서명 업로드가 독립 메뉴로 분리) | [[HBEA510_내 정보·근무 설정]] | 2026-08-18 신설 |
| 30 | 근무 시간 설정 | Link | • 본인 근무시간 지정 표면 진입. 라벨 하단에 현재 근무시간 표기(예 "3교대 주간") • 클릭 → "근무 시간 설정" 독립 모달 오픈 → [[HBEA510_내 정보·근무 설정]] Modal 2 | [[HBEA510_내 정보·근무 설정]] | 2026-08-18: "근무 설정"→"근무 시간 설정" |
| 35 | 근무 형태 변경 | Link | • 근무 형태(교대/데이전담 등) 변경 진입 • 2026-08-18 신설 항목 | 2026-08-18 신설 | |
| 45 | 휴대폰 알림 설정 | Link | • 푸시/알림 수신 설정 진입 (구 내 정보 모달 내 푸시 토글이 독립 메뉴로 분리) • 2026-08-18 신설 | 2026-08-18 신설 | |
| 55 | 화면 설정 | Link | • 화면/테마 설정 진입. 라벨 하단 현재값 표기(예 "기본") • 2026-08-18 신설 | 2026-08-18 신설 | |
| 40 | 급여명세서 | Link | • 본인 급여명세서 열람·전자서명 모달 진입 • 클릭 → [[HBEA530_급여명세서 모달]] 진입 | [[HBEA530_급여명세서 모달]] | → Modal 3 |
| ㄴ | Empty | Text | 명세서 0건 시 모달 내 "급여명세서가 없어요." | HBEA530 | Empty 원문 |
| 50 | 로그아웃 | Button | • 세션 종료 후 로그인 화면 이동 • 클릭 → 세션 종료, /employee-app/signin 이동 | 인증 세션 | TBU: 컨펌 다이얼로그 유무 |
| 60 | 하단 탭바 | Tab | • 근무 / 메신저 / 결재 / 더보기 4탭 (Shell 공통) • 클릭 → 해당 탭 전환 (상세 [[HBEA110_Shell·탭바·알림]]) | [[HBEA110_Shell·탭바·알림]] | |
| 70 | 버전 표기 | Text | 하단 "hereby Works v1.0.0" (소문자 hereby) | ${app_version} | 2026-08-18: 워딩 소문자 정정 |
| 80 | 알림 (더보기 내) | - | 라이브(7/10)에는 더보기 내 별도 알림 항목 없음. 정책 more.md는 "더보기의 알림 삭제" 방향 명시(이미 부재로 정합) | [[POL_더보기개편]] | 정책 vs 라이브 |
| 90 | 에러·실패 | - | 각 메뉴 클릭 시 모달 로드 실패 동작(토스트/무반응) | TBU: 실패 UI (버그 후보 판단 보류) |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 화면 | 비고 |
|---|---|---|---|
CASE01 [정상 진입] | 더보기 탭 (EMPLOYEE 인증) | 프로필 카드 + 메뉴 7종 | 2026-08-18 |
CASE02 [미인증] | 세션 만료 상태 진입 | /employee-app/signin | |
CASE03 [명세서 0건] | 급여명세서 선택 | 모달 "급여명세서가 없어요." | HBEA530 |
조건1 [EMPLOYEE] | self scope | 본인 정보만 조회/수정 (허용 필드) | Admin 설정 종속 |
Open Question
| # | 항목 | 상태 |
|---|---|---|
| 1 | 로그아웃 컨펌 다이얼로그 유무 | TBU (라이브 미확인) |
| 2 | 각 메뉴 모달 로드 실패 시 UI 동작 | TBU |
| 3 | 프로필 카드 부가 정보(부서·사번) 노출 | ✅ 해소(2026-08-18) — 사번(FIRMA005) 라이브 노출 확인 |
| 4 | 더보기 메뉴 개편 적용 시점 | ✅ 해소(2026-08-18) — 메뉴 7종으로 개편 라이브 반영 확인(서명/도장·휴대폰 알림 설정·화면 설정 신설) |