HBTM200_대시보드
(Hereby) 내부 결재 > 대시보드
| 앱 | 내부 결재 (HBTM) |
| 대상 사용자 | 조건1 [TEAM_LEADER] / 조건2 [SUPER_ADMIN] |
| 프로토타입 | TBU |
| 관련 정책 | [[POL_결재워크플로우]] · [[POL_권한(RBAC)]] |
| Status | review |
| Owner | 카나 (PM) |
개요
- 대시보드는 /team-manager/ 진입 시 노출되는 운영 현황판이며 4위젯 통합 뷰다: 출퇴근현황 / 외근 결재 / 연장 근무 결재 / 연차·휴가.
- 각 위젯은 최근 8건 preview + "더 보기 (8/n)" 카운트 + "전체 보기 →" 링크로 구성되며, 링크는 해당 탭([[HBTM210_연차·휴가 승인 큐]] · [[HBTM220_근무 관리 (연장·휴일/외근)]] · [[HBAD250_근태 현황 (근무)]])으로 이동한다.
- 출퇴근현황은 Secom 근태 원천의 실데이터(census 14,358건)를 소비한다 ([[POL_근태원천]]).
- 대시보드는 read-only preview다. 승인·반려는 대시보드가 아니라 각 탭에서 처리한다.
문서 히스토리
| 날짜 | 작성자 | 팀 | 변경 내용 |
|---|---|---|---|
| 2026-07-06 | 카나 | PM | 최초 작성 |
| 2026-07-10 | 카나 | PM | 라이브 기능 검토 반영 |
| 2026-07-13 | 카나 | PM | 버튼 행동 명세 보강 |
| 2026-07-21 | 카나 | PM | GC700 깊이 재작성 + 확정 스타일 |
Data I/O
Server → Client
| 변수 | 엔티티.컬럼 | 값 없을 때 | 비고 |
|---|---|---|---|
| $ | attendances[] (추정) | 위젯 empty | 최근 8건 + "더 보기 (8/n)" (census 14,358건) |
| $ | offsite_work_records[] | 위젯 empty | 상태 필터 8종 |
| $ | overtime_records[] | 위젯 empty | "더 보기 (8/319)" |
| $ | leave_requests[] | 위젯 empty | "더 보기 (8/31)" |
Client → Server
| 액션 | 전달 값 | tRPC procedure | 권한 토큰 |
|---|---|---|---|
| 소속/상태/기간 필터 | orgId·status·period | preview 재조회 (read-only, 추정) | approval:read (추정) |
| 상세 보기 | requestId | sdk.teamManager.work.detail() (추정, read-only) | approval:read (추정) |
외부 통합 (cross-app)
| 외부 시스템 | 데이터 | 방향 | 비고 |
|---|---|---|---|
| Secom 근태 원천 | 출퇴근현황 census (14,358건) | Secom → TM | [[POL_근태원천]] |
| 각 승인 탭 (HBTM210/220) | "전체 보기 →" 진입 | TM 내부 | 결재는 탭에서 |
화면 플로우
대시보드 위젯은 preview·읽기 전용이며 결재(승인/반려/취소)는 각 탭에서 실행된다.
대시보드 사양표
| 번호 | 항목/기능명 | 타입 | 사양 및 기능 설명 | 연관/영향 범위 | 비고 |
|---|---|---|---|---|---|
| 00 | 화면 진입 조건 | - | 조건1 [TEAM_LEADER] 이상 인증 · /team-manager/. 4위젯 통합 뷰(출퇴근현황 / 외근 결재 / 연장 근무 결재 / 연차·휴가) | 인증 세션 | token 내부 key TBU |
| 01 | 초기 상태 | - | 각 위젯 최근 8건 preview + "더 보기 (8/n)" + "전체 보기 →". read-only | 하위 위젯 | 랜딩은 출퇴근현황 탭(HBTM100) |
| 10 | 출퇴근현황 위젯 | Table | • Secom census 근태를 preview하는 위젯. 필터 "소속 전체" + 기간. 6컬럼: 사번 / 이름 / 소속 / 근무일 / 출근 시간 / 퇴근 시간. 최근 8건 | attendances (Secom 원천) · [[HBAD250_근태 현황 (근무)]] | "더 보기 (8/n)" |
| ㄴ11 | 더 보기 (출퇴근) | Button | • 출퇴근현황 화면으로 이동하는 링크. 라벨 "더 보기 (8/n)" / "전체 보기 →" • 클릭 시: 출퇴근현황 화면 전환 | [[HBAD250_근태 현황 (근무)]] | census 실데이터 |
| 20 | 외근 결재 위젯 | Table | • 외근 신청을 preview하는 위젯. 필터 "소속 전체" + 상태 필터 + 기간. 컬럼: 사번 / 이름 / 근무일 / 외근 시간 / 장소 / 유형 / 상태 / 관리. 최근 8건 | offsite_work_records | "전체 보기 →" |
| ㄴ21 | 외근 상태 필터 | Dropdown | • 외근 위젯을 상태로 거르는 필터 • 선택 시: 해당 상태 목록 재조회 - 8종 원문: "전체" / "대기" / "승인" / "반려" / "취소" / "보고서 대기" / "보고서 승인" / "보고서 반려" | offsite_work_records.status | 보고서 단계 포함 |
| ㄴ22 | 외근 row | ListItem | • 외근 건 1행. action "보기". 상태 예: "보고서 승인" / "보고서 반려" / "취소" / "반려" • "보기" 클릭 시: 상세(read-only) 표시, 결재는 HBTM220 탭에서 | [[HBTM220_근무 관리 (연장·휴일/외근)]] | preview |
| 30 | 연장 근무 결재 위젯 | Table | • 연장근무 신청을 preview하는 위젯. 필터 소속 / 상태 / 기간. 컬럼: 사번 / 이름 / 근무일 / 연장 시간 / 유형 / 상태 / 관리. 최근 8건 | overtime_records | "더 보기 (8/319)" |
| ㄴ31 | 연장 row | ListItem | • 연장근무 건 1행. action "보기". 유형 "평일" / "야간" / "토요일", 상태 "취소" / "반려" / "승인" / "보고서 승인" • "보기" 클릭 시: 상세(read-only) 표시, 결재는 HBTM220 탭에서 | overtime_records.category | 유형=category enum(weekday/night/weekend) |
| 40 | 연차·휴가 위젯 | Table | • 휴가 신청을 preview하는 위젯. 필터 소속 / 상태 / 기간. 컬럼: 사번 / 이름 / 유형 / 적용기간 / 차감 일수 / 사유 / 상태 / 관리. 최근 8건 | leave_requests | "더 보기 (8/31)" |
| ㄴ41 | 휴가 row | ListItem | • 휴가 건 1행. action "보기". 상태 "대기" / "승인" / "반려" / "취소" • "보기" 클릭 시: 상세(read-only) 표시, 결재는 HBTM210 탭에서 | [[HBTM210_연차·휴가 승인 큐]] | preview |
| 50 | 큐 이동 | Link | • 각 위젯 하단의 큐 이동 링크. 라벨 "더 보기 (8/n)" / "전체 보기 →" • 클릭 시: 해당 승인 탭 전환. 대시보드는 preview·읽기 전용, 결재는 각 탭에서 | HBTM210 / HBTM220 |
권한·상태 분기 요약
| 시나리오 | 트리거 | 결과 | 비고 |
|---|---|---|---|
CASE01 [preview 조회] | 대시보드 진입 | 출퇴근 + 3큐 상위 8건 노출 | read-only |
CASE02 [상세 보기] | row "보기" | 상세 modal/drawer | read-only |
CASE03 [큐 이동] | "더 보기" / "전체 보기" | 해당 승인 탭 진입 (결재는 탭에서) |
Open Question
- 출퇴근현황 필터 조합(소속·기간) 및 배정근무 vs 실제 출퇴근 비교 노출 여부 = TBU ([[POL_근태원천]])
- 대시보드에서 직접 승인/반려 action 노출 여부 (현재는 각 탭 경유로 관찰) = TBU