출결 관리
학생들의 입실·퇴실 및 출결 현황을 관리하는 방법을 안내합니다.
이 페이지에서 배울 내용
- 9가지 출결 상태의 의미와 발생 조건
- 일별/월별 출결 현황 조회
- 수동 출결 처리 + 정정 워크플로우
- 외출/조퇴/결석 신청 승인 처리
- 비정규 방문(자율학습) / 퇴실기록 누락 처리
기본 개념
출결 엔진은 학생의 등록 정보(Enrollment) + 휴원 이력(LeavePeriod) + 요일 스케줄을 토대로 매일 자동 판정합니다. 관리자는 판정 결과를 확인하고, 필요 시 정정·승인 처리만 하면 됩니다.
판정 결과는 외부 공개용 9가지 상태로 제공되며, self/parent/admin 모든 화면에서 동일한 라벨과 색을 사용합니다.
9가지 출결 상태
하루에 여러 세션(오전/오후 등)이 있으면 가장 나쁜 상태(worst-first)로 단일 표시됩니다. 예: 오전 지각 + 오후 정시 출석 → 지각으로 표기.
| 상태 | 색 | 발생 조건 |
|---|---|---|
| 출석 | green | 정시 입실 + 정시 퇴실. 의무 있는 날의 가장 좋은 상태. |
| 지각 | yellow | 계획 입실 시각 + 면책시간(기본 5분) 이후 입실. 지각 + 조퇴 동시 발생 시에도 단일 라벨은 지각. |
| 조퇴 | orange | 계획 퇴실 시각 이전 퇴실. 입실은 정시이며 일찍 퇴실한 케이스. |
| 결석 | red | 의무 있는 날 입실 자체가 없음. 운영일이 지나야 확정됨. |
| 출석중 | blue | 현재 운영일 안에서 학원에 있는 상태(입실 + 퇴실 미기록 / 외출 중 등). 운영일이 끝나면 출석/지각/조퇴/누락 중 하나로 확정. |
| 예정 | neutral | 의무 있는 날인데 입실 시각이 아직 안 됨. 결석 아님. |
| 퇴실기록 누락 | orange | 운영일이 끝났는데 퇴실 기록이 없음. 결석 아님 — 입실은 했음. 관리자 정정이 필요한 신호. |
| 자율학습 | blue | 스케줄 없는 날에 학생이 자발적으로 입실. 의무 외 출입. |
| 휴무 | neutral | 의무가 없는 날. 휴원 / 휴일 / 등록 전후 / 미래 날짜. |
출결 현황 확인하기
출결 관리 페이지 접속
좌측 사이드바에서 “출결 관리” 메뉴를 클릭합니다.
날짜 및 필터 설정
상단의 날짜 선택기로 조회 기간을 설정하고, 필요 시 특정 학생이나 상태로 필터링합니다.
현황 확인
테이블에서 각 학생의 입실/퇴실 시간과 출결 상태를 확인할 수 있습니다.
수동 출결 처리 (정정 워크플로우)
해당 학생의 출결 기록 선택
출결 목록에서 수정하려는 학생의 행을 찾고, 일별 타임라인으로 진입합니다.
이벤트 정정
입실/퇴실 시각을 수정하거나 누락된 이벤트를 추가합니다. 원래 시각은 정정 이력으로 자동 보존됩니다.
자동 재판정 + 저장
저장 시 출결 엔진이 같은 날을 자동으로 다시 판정합니다. 결과 상태가 즉시 반영됩니다.
외출 / 조퇴 / 결석 신청 승인
학생 또는 학부모가 신청한 4가지 요청 — 스케줄 변경, 조퇴, 외출, 결석 — 은 학부모 승인을 거쳐 관리자에게 전달됩니다.
승인 페이지 접속
좌측 사이드바 “승인 관리” 메뉴 또는 헤더의 알림 뱃지를 클릭합니다.
요청 내용 확인
요청 타입, 사유, 카테고리, 외출 시간(외출만)을 확인하고 승인 / 거절을 결정합니다.
승인 결정
승인 시 해당 학생의 그날 출결 의무가 자동 갱신됩니다. 거절 시 거절 사유를 입력하면 학생/학부모에게 즉시 노출됩니다.
비정규 방문 / 자율학습 처리
스케줄 없는 날에 학생이 입실하면 자율학습으로 자동 분류됩니다. 의무가 없는 날의 출입이라 결석 / 지각 등 의무 기반 라벨이 붙지 않습니다.
- 출결 통계의 irregularDays 카운트에 반영
- 총 학습 시간(totalStudyMinutes)에는 합산 — 학생의 노력은 인정
- 학습 시간 추적이 필요하면 별도 보고서 다운로드 가능
퇴실기록 누락 운영 시나리오
학생이 퇴실 카드를 안 찍고 갔거나, 단말 오류로 기록이 안 들어온 경우입니다. 엔진은 운영일 종료 시점에 자동으로 퇴실기록 누락 상태로 표시합니다 — 결석 아님.
알림 / 대시보드에서 발견
일별 출결 페이지 / 알림 채널에서 “퇴실기록 누락” 학생 명단을 확인합니다.
실제 퇴실 시각 확인
좌석 / CCTV / 학부모 문의 등으로 실제 퇴실 시각을 파악합니다.
정정 처리
일별 타임라인에서 “퇴실 이벤트 추가” → 시각 입력 → 저장. 자동 재판정 후 정상 라벨로 전환됩니다.