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