에듀게이트 시스템 소개
군산제일고등학교 에듀게이트는 출입 통제, 전자 출석, 시설물 관리, 디지털 사이니지를 하나의 플랫폼으로 통합한 스마트 스쿨 솔루션입니다.
본 시스템은 다크모드 및 모바일을 지원하지만 일부 브라우저에서 시인성이 떨어질 수 있으니 라이트모드 및 PC를 권장합니다.
본 매뉴얼의 내용은 소프트웨어 업데이트에 따라 실제 화면 및 기능과 상이할 수 있습니다. 기능 관련 문의 사항은 개발사로 연락 부탁드립니다.
시스템 아키텍처
시스템 관리자
메인 / 백업
(이중화 구성)
교사, 학생 이용
사용자별 역할
관리자 (Admin)
- 학기/과목/학생 기초 정보 관리
- 도어락 전체/비상 제어
- 시스템 설정 및 로그 확인
교사 (Teacher)
- 내 수업 출석부 관리
- 출석 상태 수동 정정
학생 (Student)
- 키오스크에서 시간표 확인
- 학생증 태깅으로 출석 체크
주요 기능 요약
스마트 출석
RFID 학생증 태깅으로 빠르게 출석 처리. 출석부는 웹에서 실시간으로 확인하고 엑셀로 다운로드할 수 있습니다.
도어락 자동 제어
수업 시간표에 맞춰 문이 자동으로 열리고 잠깁니다. 화재 등 전체 개방 및 비상 제어 기능을 지원합니다.
시스템 로그
누가 언제 문을 열었는지(출입 로그), 관리자가 어떤 설정을 변경했는지(조작 로그) 모두 기록되어 투명하게 관리됩니다.
키오스크 사용
수업이 없는 경우 학교 공지사항 및 주요 행사 송출, 수업 중에는 수업 안내와 출석 현황판으로 사용됩니다.
로그인
관리자 시스템은 보안을 위해 허가된 계정으로만 접속이 가능합니다.
접속 정보
- URL: 전용 도메인
- ID: 행정실에서 발급한 아이디
- PW: 초기 설정 비밀번호 (첫 로그인 후 변경 권장)
시스템 설치 시 기본 관리자 계정이 제공됩니다. 최초 로그인 후 사용자 관리 메뉴에서 실제 사용할 계정을 생성하고, 기본 계정의 비밀번호를 반드시 변경하세요.
사용자가 직접 찾을 수 없습니다. 학교 시스템 관리자에게 초기화를 요청하세요.
초기 설정 가이드
에듀게이트를 처음 도입한 후 시스템을 운영하기 위해 필요한 설정을 순서대로 안내합니다. 아래 순서를 따라 진행하면 출석, 도어락, 키오스크가 정상 동작합니다.
용어 안내
- RFID — 학생증/슈퍼카드에 내장된 무선 인식 칩
- UID — 카드마다 부여된 고유 번호 (카드 뒷면이나 포장에 표기)
- 릴레이 — 컨트롤 박스에서 도어락을 제어하는 스위치 번호 (1~5번)
- 슈퍼카드 — 교사용 마스터 카드, 키오스크에 태깅하면 출석부 수정 화면 진입
교시 시스템 이해
에듀게이트의 모든 수업 일정은 교시 단위로 운영됩니다. 교시는 시스템에 미리 등록되어 있으며, 과목의 시간표를 등록할 때 교시를 선택하는 방식입니다.
| 교시 | 시간 |
|---|---|
| 1교시 | 08:40 ~ 09:30 |
| 2교시 | 09:40 ~ 10:30 |
| 3교시 | 10:40 ~ 11:30 |
| 4교시 | 11:40 ~ 12:30 |
| 5교시 | 13:35 ~ 14:25 |
| 6교시 | 14:35 ~ 15:25 |
| 7교시 | 15:35 ~ 16:25 |
| 방과후 1교시 | 16:40 ~ 17:30 |
| 방과후 2교시 | 17:40 ~ 18:30 |
| 야자 1교시 | 19:20 ~ 20:50 |
| 야자 2교시 | 21:00 ~ 22:00 |
초기 설정 절차
최초 1회 등록
한 번 등록하면 이후 변경이 없는 한 다시 설정할 필요가 없습니다.
수업이 진행될 교실을 등록하고, 각 교실에 도어락/키오스크/RFID 리더기를 연결합니다.
- 교실 필수: 이름 (위치 정보는 선택)
- 도어락 연결: 컨트롤러 IP, 릴레이 번호, 위치(정문/후문) 설정
- 키오스크/RFID 리더기: 도어락 등록 후 연결 가능
과목 담당 교사 및 관리자 계정을 등록합니다. 과목에 담당 교사를 배정하려면 먼저 계정이 있어야 합니다.
- 필수: 로그인 ID, 이름, 비밀번호, 역할(교사/교무실/행정실)
- 역할은 복수 선택 가능합니다.
교사용 마스터 카드를 등록합니다. 키오스크에서 슈퍼카드를 태깅하면 출석부 수정 화면에 진입할 수 있습니다.
학기마다 등록
새 학기가 시작될 때마다 아래 항목을 등록합니다.
모든 데이터(과목, 학생, 시간표)의 기준이 되는 학기를 등록합니다.
- 필수: 연도, 학기 구분(1학기/2학기/여름방학/겨울방학), 시작일, 종료일
- 상태(진행중/예정/종료)는 오늘 날짜 기준으로 자동 계산됩니다.
해당 학기의 학생 정보를 등록합니다. 엑셀 일괄 등록을 지원합니다.
- 필수: 학기, 학번, 이름, 학년, 반, 번호
- 선택: RFID 카드 UID (나중에 등록 가능)
과목을 생성하면서 요일/교시/교실로 시간표를 설정하고, 수강 학생을 매칭합니다.
- 필수: 교과, 과목명, 학년, 학기, 담당 교사
- 시간표: 요일 + 교시 + 교실 조합으로 등록하면 학기 기간 동안 자동 생성
- 학생 매칭을 해야 출석부에 학생이 표시됩니다.
수시 변경 가능
운영 중 필요에 따라 언제든 변경할 수 있습니다.
수업 시간 외에 문이 열리거나 잠기는 시간을 설정합니다.
- 전체 교실 공통 스케줄과 교실별 개별 스케줄을 설정할 수 있습니다.
- 반복 옵션: 매일 / 평일만 / 주말만 / 특정 요일
수업이 없을 때 키오스크에 표시할 슬라이드 이미지를 등록합니다.
설정 완료 후 확인 사항
- 학기 상태가 진행중인지 확인 (시작일 ~ 종료일 사이여야 함)
- 과목 > 시간표가 정상 생성되었는지 확인
- 키오스크에서 오늘 시간표가 표시되는지 확인
- 도어락이 스케줄에 따라 잠금/해제되는지 확인
- 학생 RFID 카드로 출석 태깅이 정상 동작하는지 확인
과목 관리
학기별 개설 과목, 담당 교사, 시간표, 수강생을 관리하는 메뉴입니다.
- 학기 — 과목이 소속될 학기
- 교사 계정 — 담당 교사로 배정할 사용자
- 교실 — 시간표에서 수업 교실을 선택하기 위해 필요
- 학생 — 수강생 매칭을 위해 필요 (과목 생성 후 나중에 매칭 가능)
과목 목록 화면
- 상단 버튼에서 [다운로드], [과목 일괄 등록], [신규 과목 등록]을 사용할 수 있습니다.
- 검색/필터: 학기, 키워드(교과/과목명/교사/비고)
- 목록 컬럼: 교과, 과목명, 학생 수, 담당 교사, 비고, 학생 매칭/수정/삭제
과목 등록 절차
신규 등록 시작
우측 상단의 [신규 과목 등록] 버튼을 클릭합니다.
기본 정보 입력
- 교과: 국어/수학 등 교과 분류
- 과목명: 실제 과목명 (예: 1학년 문학)
- 학년: 대상 학년 선택
- 학기: 과목이 속한 학기 선택
- 담당 교사: 출석부 관리 권한이 부여됩니다.
- 비고: 선택 입력(특이사항/설명)
수업 일정 선택
요일, 교시, 교실을 선택하면 해당 학기 일정에 맞춰 전체 스케줄이 자동으로 등록됩니다. 만약 휴강 등 예외 사항이 있다면 해당 날짜의 스케줄을 별도로 추가하거나 삭제할 수 있습니다.
학생 매칭
주의: 학생을 매칭하지 않으면 출석부에도 이름이 뜨지 않습니다.
목록에서 [학생 매칭] 버튼을 눌러 수강생을 등록합니다. 학생 매칭 팝업에서 엑셀 일괄 등록을 지원하여 편리하게 배정할 수 있습니다.
마지막으로 [과목 등록] 버튼을 눌러 등록합니다.
학생 매칭 화면 안내
좌측에는 전체 학생 목록, 우측에는 현재 과목 수강생 목록이 표시됩니다.
- 추가: 좌측 목록에서 학생을 선택 후 [>] 버튼을 클릭하거나, 더블 클릭하여 우측으로 이동시킵니다.
- 제거: 우측 목록에서 학생을 선택 후 [<] 버튼을 클릭하여 수강생 명단에서 제외합니다.
- 엑셀 업로드: [엑셀 업로드] 버튼을 클릭 후 엑셀 파일을 선택해서 업로드하거나, 샘플 양식을 다운로드 받아 작성 후 업로드할 수 있습니다.
엑셀 일괄 등록
다수의 과목을 한 번에 등록할 때는 일괄 등록 기능을 사용할 수 있습니다.
- 등록 팝업에서 샘플 양식을 다운로드하여 작성해야 합니다.
- 정해진 양식에 맞춰 과목 정보를 입력하고 업로드하면 자동으로 등록됩니다.
학생 관리
학기별 학생 정보를 등록하고 관리합니다. 학번은 동일 학기 내에서 중복될 수 없으며, 학년/반/번호도 중복 등록되지 않습니다. 학생 정보는 출석 및 과목 매칭의 기준이 됩니다.
학생 목록 화면
- 상단 버튼에서 [다운로드], [학생 일괄 등록], [신규 학생 등록]을 사용할 수 있습니다.
- 검색 필터: 학기, 키워드(학번/비고/RFID는 부분 검색, 이름은 완전 일치), 학년, 반, RFID 상태
- 목록 컬럼: 학번, 학년/반/번호, 이름, RFID 상태/UID, 비고, 등록일, 수정/삭제
학생 등록 절차
학생 등록은 개별 등록과 엑셀 일괄 등록 두 가지가 있습니다.
1. 개별 등록 절차
신규 등록 시작
학생 목록 화면에서 [신규 학생 등록] 버튼을 클릭합니다.
학생 정보
- 학기: 학생이 속한 학기를 선택합니다.
- 학번: 동일 학기 내 중복 불가
- 이름: 학생 성명
- 학년/반/번호: 동일 학기 내 중복 불가
- 비고: 선택 입력 (전학, 특이사항 등)
RFID 카드 등록 (선택)
RFID 카드 UID를 입력하여 학생증을 등록합니다. 학생당 1장만 등록 가능하며, 이미 다른 학생에게 등록된 카드는 사용할 수 없습니다. 카드 UID를 변경하면 기존 카드가 자동 해제됩니다.
저장 완료
마지막으로 [학생 등록] 버튼을 눌러 등록합니다. 등록이 완료되면 학생 목록으로 돌아가며, 즉시 검색 및 과목 매칭에 사용됩니다.
2. 엑셀 일괄 등록
학생 수가 많을 경우 엑셀 일괄 등록을 사용합니다. 양식을 내려받아 작성 후 업로드하거나, 화면에서 직접 여러 줄을 입력해 등록할 수 있습니다.
- 양식 다운로드 후 작성 (필수: 학번/이름/학년/반/번호, 선택: RFID 카드/비고)
- 업로드 지원: .xlsx / .xls / .csv
- 중복 학번, 중복 학년/반/번호, 중복 RFID 카드 UID는 등록 실패로 처리됩니다. 기존 학생 정보가 자동 업데이트되지 않습니다.
- 저장 후 성공/실패 건수와 오류 목록이 표시됩니다.
학생 정보 관리
RFID 카드 변경/해제
학생 수정 화면에서 UID를 입력해 카드 등록/변경이 가능합니다. 카드 UID를 비워두면 등록이 해제되며, 변경 시 기존 카드는 자동 해제됩니다.
수정/삭제
목록에서 수정 버튼으로 정보를 변경할 수 있습니다. 삭제 시 해당 학생의 수강 매핑과 출석 기록이 함께 삭제되므로 신중히 처리하세요.
과목 매칭
학생에게 과목을 배정하려면 과목 관리 > 학생 매칭을 사용합니다. 매칭되지 않은 학생은 출석부에 표시되지 않습니다.
출석부
담당 교사가 수업별 학생 출석 현황을 확인하고 정정하는 메뉴입니다. 해당 수업의 담당 교사만 출석 상태를 수정할 수 있습니다.
- 해당 교사가 담당 교사로 배정된 과목이 있어야 합니다.
- 과목에 학생이 매칭되어 있어야 출석 명단이 표시됩니다.
- 과목에 시간표(수업 일정)가 등록되어 있어야 합니다.
화면 구성
수업 카드 형태로 목록이 표시됩니다. 각 카드에는 수업명, 교실, 교시, 수강 인원 및 출석/지각/결석 요약이 표시되며 [엑셀 다운로드] 버튼으로 해당 수업 출석 데이터를 내려받을 수 있습니다.
출석부 컬럼
- 학년/반/번호
- 이름
- 태깅시간: 실제 RFID 태깅 기록 시각
- 출석상태: 미결정 / 출석 / 지각 / 결석
- 수정정보: 수동 정정 시 정정자 표시
출석 상태 구분
-
미결정
수업 시작 전
-
출석
정상 태깅 완료
-
지각
수업 시작 후 태깅
-
결석
태깅 기록 없음
수동 정정 방법
학생이 카드를 잃어버렸거나 기기 오류로 태깅하지 못한 경우 담당 교사가 수동으로 출석 상태를 정정할 수 있습니다.
- 학생 행의 출석상태 버튼을 클릭합니다.
- 변경할 상태(출석 / 지각 / 결석)를 선택합니다.
- 변경 사항이 생기면 하단 [저장 (n건)] 버튼이 활성화됩니다. 클릭하여 일괄 저장합니다.
전체 출석부
학교 전체 수업의 출석부를 한 곳에서 조회하는 메뉴입니다. 출석부는 담당 교사 본인의 수업만 표시되지만, 전체 출석부는 모든 수업을 날짜·교시·교실·수업 조건으로 조회할 수 있습니다.
검색 필터
- 날짜: 조회할 날짜 선택 (하루 단위, 기간 조회 불가)
- 교시: 전체 또는 특정 교시 선택
- 교실명: 교실 이름으로 검색
- 수업명: 과목명으로 검색
필터를 설정한 후 [검색] 버튼을 클릭하면 조건에 맞는 수업 카드 목록이 표시됩니다. 수업이 있는 날에 대한 출석부만 조회됩니다.
출석부 카드
검색 결과는 수업 카드 형태로 표시됩니다. 각 카드는 출석부 메뉴와 동일한 구성입니다.
- 수업명, 교실, 담당 교사, 교시 표시
- 출석/지각/결석 인원 요약
- 학생별 학년/반/번호, 이름, 태깅시간, 출석상태, 수정정보
도어락 제어
전체 교실의 문 상태를 모니터링하고 스케줄 및 수동 제어를 관리하는 메뉴입니다.
전체 스케줄 설정
모든 도어락에 공통으로 적용되는 기본 스케줄을 관리합니다. 등록된 스케줄은 목록으로 표시되며 수정·삭제할 수 있습니다.
스케줄 추가/수정 시 입력 항목:
- 반복 주기: 매일, 평일, 주말, 특정 요일
- 시간: 동작 실행 시각
- 동작: 열기 / 잠금
- 활성화: 스케줄 활성화 여부 토글
- 메모: (선택) 스케줄 구분용 설명 (예: 등교, 방과후)
예외 기간 설정
버튼 클릭 시 [스케줄링 예외 일정] 메뉴로 이동합니다. 예외 기간 동안은 전체 스케줄이 적용되지 않습니다.
날짜별 스케줄 미리보기
날짜 선택기에서 특정 날짜를 선택하면, 해당 날짜에 적용될 스케줄 타임라인(열기/잠금 동작 순서)을 미리 확인할 수 있습니다. 예외 기간 설정이 제대로 반영되었는지 검증하는 데 사용합니다.
도어락 상태 통계
현재 도어락 상태를 5개 카드로 요약해 표시합니다.
- 전체
- 열림
- 잠김
- 상태이상
- 오프라인
도어락 목록
교실명 검색 및 건물 필터로 원하는 도어락을 찾을 수 있으며, 그리드 / 테이블 뷰를 전환할 수 있습니다.
각 도어락 항목에서 사용 가능한 기능:
- 열기: 해당 도어락을 즉시 개방합니다.
- 닫기: 해당 도어락을 즉시 잠급니다.
- 개별 스케줄 설정: 전체 스케줄과 다른 운영 시간이 필요한 경우(예: 방과후 수업실) 해당 도어락 전용 스케줄을 설정합니다. 전체 스케줄보다 우선 적용됩니다.
비상 제어
화재, 지진 등 긴급 상황 발생 시 모든 도어락을 즉시 개방하는 기능입니다. 헤더의 비상 버튼을 통해 접근합니다.
긴급 상황 발생
헤더의 [긴급 발생] 버튼을 클릭합니다.
확인 알림이 표시됩니다: "정말 긴급 상황을 발생시키겠습니까? 모든 도어락이 열립니다."
[확인]을 누르면 모든 도어락이 즉시 개방되고, 화면에 "긴급 상황 진행 중" 표시가 나타납니다.
긴급 상황 해제
[긴급 해제] 버튼을 클릭합니다.
확인 알림이 표시됩니다: "긴급 상황을 해제하시겠습니까? 도어락이 정상 스케줄로 복귀합니다."
[확인]을 누르면 긴급 상황이 해제되고, 도어락이 평소 스케줄대로 동작합니다.
스케줄링 예외 일정
공휴일, 개교기념일, 수능일 등 도어락 전체 스케줄을 적용하지 않을 기간을 등록합니다. 예외 기간 동안에는 전체 스케줄 및 개별 스케줄이 동작하지 않습니다.
예외 일정 등록
우측 상단의 [예외 일정 등록] 버튼을 클릭하여 등록합니다.
- 시작일: 예외 기간 시작 날짜
- 종료일: 예외 기간 종료 날짜
- 설명: (선택) 예외 사유 메모 (예: 수능일, 개교기념일)
목록 컬럼
- 기간: 시작일 ~ 종료일
- 일수: 해당 예외 기간의 총 일수
- 설명: 등록 시 입력한 메모
- 등록일: 예외 기간이 등록된 날짜
- 삭제: 예외 기간 삭제 버튼
학기 관리
시스템 운영의 기준이 되는 학기를 등록하고 관리합니다. 과목과 시간표는 반드시 특정 학기에 소속되어야 합니다.
검색 필터
- 연도: 연도 선택
- 학기: 1학기 / 2학기 / 여름방학 / 겨울방학
- 메모: 메모 키워드 검색
목록 컬럼
- 연도
- 학기: 1학기 / 2학기 / 여름방학 / 겨울방학
- 기간: 학기 시작일 ~ 종료일
- 상태: 진행중 / 예정 / 종료
- 메모: 부가 설명
- 관리: 수정 / 삭제
학기 등록 절차
우측 상단의 [학기 등록] 버튼을 클릭하여 새 학기를 등록합니다.
- 연도: 해당 연도 (예: 2026)
- 학기: 1학기 / 2학기 / 여름방학 / 겨울방학 중 선택
- 시작일: 학기 시작 날짜
- 종료일: 학기 종료 날짜
- 메모: 부가 설명 (선택)
교실 관리
학교 내 모든 교실을 등록하고, 각 교실에 연결된 도어락·키오스크·RFID 리더기 장치를 확인하고 관리합니다.
상단 통계 카드
- 전체 교실
- 도어락
연결된 도어락 수
- 키오스크
연결된 키오스크 수
- RFID 리더기
연결된 리더기 수
- 건물
등록된 건물 수
교실 목록
그리드 / 테이블 뷰 전환이 가능합니다. 각 교실 항목에서 연결된 장치 목록(도어락, 키오스크, RFID 리더기) 및 각 장치의 상태를 확인할 수 있습니다.
- 교실명 및 건물
- 연결된 도어락 장치 ID 및 상태
- 연결된 키오스크 장치 ID 및 상태
- 연결된 RFID 리더기 장치 ID 및 상태
교실 등록 절차
교실을 등록한 뒤, 해당 교실에 도어락/키오스크/RFID 리더기를 순서대로 연결합니다.
교실 생성
[교실 등록] 버튼으로 교실을 추가합니다.
- 교실명: 필수 (예: 101호, 음악실)
- 위치 메모: 선택 (예: 본관 2층)
- 설명: 선택 (교실 용도 등 부가 설명)
도어락 연결
교실 상세에서 [도어락 추가]로 물리 장치를 연결합니다.
- 이름: 도어락 식별 이름 (예: 101호 정문)
- 컨트롤러 IP: Kincony 컨트롤 박스의 IP 주소
- 릴레이 번호: 해당 도어락이 연결된 릴레이 (1~5)
- 위치: 정문(FRONT) / 후문(BACK)
- 비상구 여부: 비상 상황 시 자동 개방 대상 여부
키오스크 / RFID 리더기 연결
도어락이 등록된 후 해당 도어락에 키오스크와 RFID 리더기를 연결할 수 있습니다.
- 키오스크: 이름, IP 주소, 연결할 도어락 선택
- RFID 리더기: 이름, IP 주소, 연결할 도어락 선택 (하나의 도어락에 복수 연결 가능)
IP 주소, 릴레이 번호 등 장치 설정값은 설치 환경, 기기 버전 및 소프트웨어 버전에 따라 다를 수 있습니다.
사용자 관리
관리자 웹에 접속할 수 있는 교직원 계정을 관리합니다. 계정 생성·수정·비밀번호 변경·삭제가 가능합니다.
검색 및 필터
- 로그인 ID로 검색
- 역할로 필터링: 교사 / 교무실 / 행정실
역할(권한)
| 역할 | 접근 가능 메뉴 |
|---|---|
| 교사 | 출석부, 전체 출석부, 카드태깅 이력 |
| 교무실 | 교사 메뉴 + 과목 관리, 학생 관리 |
| 행정실 | 모든 메뉴 접근 가능 (도어락 제어, 스케줄 관리, 사용자 관리 등) |
계정 등록 절차
우측 상단의 [사용자 등록] 버튼을 클릭하여 새 계정을 등록합니다.
- 로그인 ID: 영문/숫자 조합 (중복 불가)
- 이름: 사용자 표시 이름
- 비밀번호: 초기 비밀번호 설정
- 역할: 교사 / 교무실 / 행정실 (복수 선택 가능)
계정 관리 기능
- 수정: 이름, 역할 등 계정 정보 변경
- 비밀번호 변경: 관리자가 타 계정의 비밀번호를 초기화
- 삭제: 계정 삭제
슈퍼카드 관리
슈퍼카드는 교사용 마스터 카드입니다. 키오스크에서 슈퍼카드를 태깅하면 출석부 수정 화면에 진입하여 수업별 출석 상태를 직접 관리할 수 있습니다.
슈퍼카드 용도
키오스크에서 슈퍼카드를 태깅하면 해당 교실의 수업 목록이 표시되고, 수업을 선택하여 학생별 출석/지각/결석을 수정할 수 있습니다.
슈퍼카드 등록 절차
우측 상단의 [슈퍼카드 등록] 버튼을 클릭하여 새 슈퍼카드를 등록합니다.
- 이름: 카드 소지자 이름 (예: 김OO 선생님). 슈퍼카드에 등록된 이름으로 키오스크에서 출석부를 변경한 사람을 식별할 수 있으므로 정확하게 입력합니다.
- 카드 UID: RFID 카드 고유 번호 입력
검색
이름 또는 카드 UID로 검색할 수 있습니다.
목록 컬럼
- 이름: 카드 소지자 이름
- UID: RFID 카드의 고유 번호
- 등록일: 슈퍼카드 등록 날짜
- 관리: 삭제
화면보호기 관리
수업이 없고 일정 시간 동안 키오스크 사용이 없을 때 표시할 슬라이드 이미지를 관리합니다.
설정 항목
- 슬라이드 전환 시간: 이미지가 넘어가는 간격(초)을 설정합니다. (1~99초)
- 활성화: 화면보호기 기능을 켜거나 끄는 토글
- 이미지 등록: 최대 10장까지 JPG, PNG 파일을 업로드할 수 있습니다.
- 파일당 최대 크기: 2MB
- 권장 해상도: 1920×1200
- 순서 변경: 각 이미지의 위(↑) / 아래(↓) 버튼으로 슬라이드 순서를 조정합니다. 목록에서 가장 위에 있는 이미지가 가장 먼저 표시됩니다.
키오스크 메인 화면
교실 입구 태블릿의 기본 화면입니다. 현재 수업 정보, 미출석 학생 목록, 다음 수업 예고를 보여줍니다.
상단 바
현재 날짜와 시각이 표시됩니다. (형식: yyyy년 M월 d일 HH시 mm분)
화면 구성
좌측 패널 — 수업 정보
현재 진행 중인 수업 정보를 파란색 배경으로 표시합니다.
- 교시 (크게 표시)
- 과목명
- 담당교사 (미지정 시 "담당자 미정")
- 정원: 전체 수강 인원
- 출석: 1명 이상일 때만 표시
- 지각: 1명 이상일 때 노란색으로 표시
- 결석: 1명 이상일 때 빨간색으로 표시
수업 없을 때: "진행 중인 수업이 없습니다" (회색 배경)
우측 패널 — 미출석 학생 목록
아직 태깅하지 않은 학생을 3열 카드 그리드로 표시합니다.
- 각 카드: 학년/반/번호 + 이름
- 학년 → 반 → 번호 순 정렬
- 학생 없을 때: "학생 정보가 없습니다"
하단 — 다음 수업 예고
현재 수업 종료 후 이 교실에서 진행될 다음 수업 정보를 표시합니다.
- 교시, 과목명, 담당교사, 시작 시각
- 다음 수업 없을 때: "다음 수업이 없습니다"
화면 보호기 전환 조건
아래 조건이 모두 충족되면 화면 보호기(슬라이드)가 자동 실행됩니다.
- 현재 진행 중인 수업 없음
- 다음 예정 수업도 없음
- 일정 시간 동안 조작 없음
화면을 터치하면 메인 화면으로 돌아옵니다.
시간표 확인
오늘 이 교실에서 진행되는 수업 일정을 확인하는 방법을 안내합니다.
메인 화면에서 확인
메인 화면 하단의 다음 수업 예고 영역에서 교시, 과목명, 담당교사, 시작 시각을 바로 확인할 수 있습니다.
출석부를 통한 전체 일정 확인
슈퍼카드를 태깅하면 출석부 화면이 열리고, 오늘 이 교실의 전체 수업 목록이 표시됩니다.
- 수업별 카드: 교시(숫자), 과목명, 수업 시간 (HH:mm ~ HH:mm)
- 수업이 없을 때: "오늘 예정된 수업이 없습니다"
카드를 선택하면 해당 수업의 출석부로 이동합니다.
출석 태깅
학생증을 키오스크 하단 리더기에 태깅하여 출석을 체크합니다.
출석 성공
화면에 "출입 허용" 메시지와 함께 학생 이름, 카드 번호가 표시됩니다.
출석 실패
화면에 "출입 거부" 또는 "오류 발생" 제목과 함께 사유 메시지가 표시됩니다.
상태 메시지 안내
타이틀(출입 허용 / 출입 거부 / 오류 발생)과 그 아래 사유 메시지로 구성됩니다.
| 타이틀 | 사유 메시지 | 설명 및 조치 |
|---|---|---|
| 출입 허용 | (없음) | 정상적으로 출석이 인정되었습니다. 학생 이름과 카드 번호가 함께 표시됩니다. |
| 출입 거부 | 카드를 찾을 수 없습니다 | 시스템에 등록되지 않은 카드입니다. 행정실에 문의하세요. |
| 카드가 비활성화되었습니다 | 비활성화된 카드입니다. 행정실에 문의하세요. | |
| 카드가 만료되었습니다 | 유효기간이 지난 카드입니다. 행정실에 문의하세요. | |
| 카드가 학생과 연결되어 있지 않습니다. | 카드에 학생 정보가 연결되어 있지 않습니다. 행정실에 문의하세요. | |
| 현재 진행 중인 수업이 없습니다. | 이 교실에 현재 진행 중인 수업이 없습니다. | |
| 현재 진행 중인 수업에 등록되어 있지 않습니다. | 현재 수업의 수강생 명단에 없습니다. 담당 선생님께 문의하세요. | |
| 오류 발생 | 서버 연결 시간이 초과되었습니다 | 네트워크 상태가 불안정합니다. 잠시 후 다시 시도해주세요. |
| 서버에 연결할 수 없습니다 | 인터넷 연결이나 서버 상태를 확인해주세요. | |
| 오류가 발생했습니다 | 알 수 없는 오류가 발생했습니다. 관리자에게 문의하세요. |
화면 보호기
수업이 없고 일정 시간 동안 화면 조작이 없으면 화면 보호기(이미지 슬라이드)가 자동으로 실행됩니다.
동작 방식
- 검은 배경에 이미지가 자동 슬라이드됩니다.
- 슬라이드 전환 시간은 관리자 웹 [화면보호기 관리]에서 설정합니다.
- 등록된 이미지가 없을 때: "화면 보호기 이미지가 없습니다" 메시지가 표시됩니다.
- 화면을 터치하면 메인 화면으로 돌아옵니다.
이미지 관리
화면 보호기에 표시할 이미지는 관리자 웹 [화면보호기 관리] 메뉴에서 등록·순서 변경·삭제합니다.
- 최대 10장, JPG/PNG, 파일당 최대 2MB
- 권장 해상도: 1920×1200
관리 콘솔
키오스크의 네트워크 설정, 기기 연결 상태, NFC 상태 등을 확인하고 조정하는 엔지니어용 메뉴입니다.
비밀번호 입력창(관리자 인증)이 나타나면 관리자 암호를 입력합니다.
비밀번호가 틀리면 "비밀번호가 올바르지 않습니다" 메시지가 표시됩니다.
GraphQL
서버와 통신하는 GraphQL 엔드포인트 URL을 설정합니다.
- 현재 설정된 URL 확인 및 변경 가능
- [초기화] 버튼으로 기본값으로 되돌릴 수 있습니다.
- 예시:
http://10.0.2.2:10301/graphql
Restart refresh subscription: 서버와의 실시간 구독 연결을 끊고 1초 후 재연결합니다. 데이터 동기화 문제가 발생할 때 사용합니다.
Features
- Fullscreen mode: 키오스크 전체화면 모드 토글
- Demo mode: 활성화 시 카드 태깅 시뮬레이션 버튼이 메인 화면에 노출됩니다.
- Refresh kiosk self: 서버에서 현재 키오스크 정보를 다시 불러옵니다.
- 조회 성공 시: [키오스크명] | [도어명] / [교실명] 형식으로 표시. 교실에 위치 메모가 있으면 그 아래에 추가 표시됩니다.
- 도어 미배정 시: [키오스크명] | door not assigned
- 도어 이름 없을 시: [키오스크명] | 도어 미등록
- IP로 등록된 키오스크 없을 때: "현재 IP로 등록된 키오스크가 없습니다. IP 또는 DB 등록을 확인하세요."
NFC
키오스크 내장 NFC 리더기 상태를 실시간으로 확인합니다.
| 상태 | 설명 |
|---|---|
| 초기화 중 | NFC 리더기 초기화 진행 중 |
| 지원하지 않음 | 기기가 NFC를 지원하지 않음 |
| 비활성화됨 | NFC가 비활성화 상태 |
| 카드 대기 중 | 정상 동작 중, 카드 태깅 대기 |
| 카드 인식됨 | 카드 태깅 감지됨 |
| 오류 | NFC 리더기 오류 발생 |
마지막 스캔 카드: 가장 최근 태깅된 카드 UID를 확인할 수 있습니다.
LED
키오스크 LED 색상을 테스트합니다. 색상 항목을 선택하면 해당 색상으로 LED가 점등됩니다.
기타
- 화면 크기: 현재 화면 해상도(px) 표시. 탭하면 해상도, 기기 픽셀 비율, 전체화면/일반 모드 전환 버튼이 있는 진단 화면으로 이동합니다.
출석 관리 (교사)
슈퍼카드를 태깅하면 교사가 키오스크에서 직접 출석 현황을 조회하고 학생별 출결을 수정할 수 있습니다.
진입 절차
키오스크 하단 리더기에 슈퍼카드를 태깅합니다.
화면에 "관리자 카드" 다이얼로그(보라색)가 나타납니다. (슈퍼카드 태깅 시 표시)
[출석부] 버튼을 탭하면 출석 관리 화면으로 이동합니다.
수업 선택 화면
헤더에 "출석부 - 수업 선택"이 표시되고, 오늘 이 교실에서 예정된 수업 목록이 나열됩니다. 각 카드에는 교시, 과목명, 수업 시간(HH:mm ~ HH:mm)이 표시됩니다. 카드를 탭하면 해당 수업의 출석부로 이동합니다.
출석부 화면
수업을 선택하면 헤더 제목이 "출석부 - {교시} {과목명}"으로 바뀌고 학생 목록이 3열 그리드로 표시됩니다.
학생 카드 구성
- 학년/반/번호 (예: 1학년 1반 3번)
- 이름
- 출결 버튼 3개: 출석 / 지각 / 결석
현재 상태의 버튼이 색상으로 채워져 표시됩니다. 미결정(미태깅) 상태는 버튼이 모두 비어 있습니다.
학생 정렬 순서: 학년 → 반 → 번호
출결 변경 절차
원하는 버튼(출석 / 지각 / 결석)을 직접 탭하면 즉시 변경됩니다. 저장 전에는 다시 탭하여 언제든 수정할 수 있습니다. 변경 사항이 생기면 헤더에 [저장] 버튼이 활성화됩니다.
저장
- 저장 중에는 버튼 텍스트가 "저장 중..."으로 바뀌고 비활성화됩니다.
- 저장 완료: "{n}건 저장 완료" (녹색 알림)
- 일부 실패: "일부 저장 실패: {n}건 (...)"
- 전체 실패: "저장 실패: {오류 내용}" — 변경 사항이 유지되어 재시도 가능
- 데이터 로드 실패: "데이터 로드 실패: {오류 내용}" — 학생 목록을 불러오지 못한 경우
뒤로 가기 / 화면 닫기
- [←] 뒤로: 저장되지 않은 변경 사항을 모두 취소하고 수업 선택 화면으로 돌아갑니다.
- [✕] 닫기: 출석 관리 화면을 완전히 닫고 메인 화면으로 돌아갑니다.
카드태깅 이력
RFID 카드 태깅 기록을 조회합니다. 태깅마다 허용(GRANTED) 또는 거부(DENIED) 결과가 기록됩니다.
검색 필터
- 카드 UID: 특정 카드로 검색
- 도어락: 특정 도어락(교실)으로 필터링
- 결정: GRANTED / DENIED 필터
- 날짜 범위: 시작일 ~ 종료일로 기간 조회
목록 컬럼
- 번호: 이력 순번
- 발생시간: 카드가 태깅된 날짜 및 시각
- 카드 UID: 태깅된 RFID 카드의 고유 번호
- 도어락: 태깅이 발생한 도어락(교실)
- 결정: GRANTED(허용) / DENIED(거부)
- 사유: 결정에 대한 상세 사유
결정별 사유 목록
| 결정 | 사유 | 설명 |
|---|---|---|
| GRANTED | Access granted | 학생이 현재 수업에 정상 등록되어 출석 처리됨 |
| GRANTED | Super card access | 슈퍼카드 태깅 (출석부 수정 화면 진입) |
| GRANTED | 비상상황: 열림 유지 | 긴급 상황 진행 중에 태깅됨 |
| DENIED | 카드를 찾을 수 없습니다 | 시스템에 등록되지 않은 카드 |
| DENIED | 카드가 비활성화되었습니다 | 카드가 비활성 상태로 전환됨 |
| DENIED | 카드가 만료되었습니다 | 카드 유효기간이 지남 |
| DENIED | 카드가 학생과 연결되어 있지 않습니다. | 카드는 존재하나 학생이 배정되지 않음 |
| DENIED | 현재 진행 중인 수업이 없습니다. | 해당 교실에 지금 수업이 없음 |
| DENIED | 현재 진행 중인 수업에 등록되어 있지 않습니다. | 학생이 현재 수업의 수강생이 아님 |
카드태깅 이력
RFID 카드 태깅 기록을 조회합니다. 태깅마다 허용(GRANTED) 또는 거부(DENIED) 결과가 기록됩니다.
검색 필터
- 카드 UID: 특정 카드로 검색
- 도어락: 특정 도어락(교실)으로 필터링
- 결정: GRANTED / DENIED 필터
- 날짜 범위: 시작일 ~ 종료일로 기간 조회
목록 컬럼
- 번호: 이력 순번
- 발생시간: 카드가 태깅된 날짜 및 시각
- 카드 UID: 태깅된 RFID 카드의 고유 번호
- 도어락: 태깅이 발생한 도어락(교실)
- 결정: GRANTED(허용) / DENIED(거부)
- 사유: 결정에 대한 상세 사유
결정별 사유 목록
| 결정 | 사유 | 설명 |
|---|---|---|
| GRANTED | Access granted | 학생이 현재 수업에 정상 등록되어 출석 처리됨 |
| GRANTED | Super card access | 슈퍼카드 태깅 (출석부 수정 화면 진입) |
| GRANTED | 비상상황: 열림 유지 | 긴급 상황 진행 중에 태깅됨 |
| DENIED | 카드를 찾을 수 없습니다 | 시스템에 등록되지 않은 카드 |
| DENIED | 카드가 비활성화되었습니다 | 카드가 비활성 상태로 전환됨 |
| DENIED | 카드가 만료되었습니다 | 카드 유효기간이 지남 |
| DENIED | 카드가 학생과 연결되어 있지 않습니다. | 카드는 존재하나 학생이 배정되지 않음 |
| DENIED | 현재 진행 중인 수업이 없습니다. | 해당 교실에 지금 수업이 없음 |
| DENIED | 현재 진행 중인 수업에 등록되어 있지 않습니다. | 학생이 현재 수업의 수강생이 아님 |
조작 이력
관리자 웹에서 수행된 모든 작업 기록입니다. 누가 언제 어떤 작업을 했는지 추적할 수 있습니다.
목록 컬럼
- 번호: 이력 순번
- 발생시간: 작업이 실행된 날짜 및 시각
- 사용자: 작업을 수행한 계정
- 작업: 수행한 작업 종류 (아래 작업 목록 참고)
- 대상: 작업이 적용된 대상 유형 (아래 대상 목록 참고)
- 입력값: 작업 시 전달된 입력 데이터 (JSON 형식)
- 결과: 성공 / 실패
작업 종류
| 분류 | 작업명 | 설명 |
|---|---|---|
| 사용자 | CreateManager | 계정 생성 |
| UpdateManager | 계정 정보 수정 | |
| DeleteManager | 계정 삭제 | |
| ResetManagerPassword | 비밀번호 초기화 | |
| ChangePassword | 본인 비밀번호 변경 | |
| 학생 | CreateStudent | 학생 개별 등록 |
| BulkCreateStudents | 학생 일괄 등록 | |
| UpdateStudent | 학생 정보 수정 | |
| DeleteStudent | 학생 삭제 | |
| 과목 | CreateCourse | 과목 생성 |
| UpdateCourse | 과목 정보 수정 | |
| DeleteCourse | 과목 삭제 | |
| BulkCreateCourses | 과목 일괄 등록 | |
| EnrollStudents | 수강생 매칭 | |
| UnenrollStudents | 수강생 매칭 해제 | |
| 수업 일정 | BatchCourseSchedule | 수업 일정 일괄 처리 (추가/수정/삭제) |
| CreateCourseSchedule | 수업 일정 등록 | |
| UpdateCourseSchedule | 수업 일정 수정 | |
| DeleteCourseSchedule | 수업 일정 삭제 | |
| 학기 | CreateSemester | 학기 등록 |
| UpdateSemester | 학기 수정 | |
| DeleteSemester | 학기 삭제 | |
| 교실 | CreateClassroom | 교실 등록 |
| UpdateClassroom | 교실 수정 | |
| DeleteClassroom | 교실 삭제 | |
| 도어락 | CreateDoorLock | 도어락 등록 |
| UpdateDoorLock | 도어락 수정 | |
| DeleteDoorLock | 도어락 삭제 | |
| AssignDoorLock | 도어락 교실 배정 | |
| OpenDoorLock | 도어락 열기 (관리자 웹) | |
| CloseDoorLock | 도어락 닫기 (관리자 웹) | |
| 도어락 스케줄 | CreateGlobalDoorSchedule | 전체 스케줄 등록 |
| UpdateGlobalDoorSchedule | 전체 스케줄 수정 | |
| DeleteGlobalDoorSchedule | 전체 스케줄 삭제 | |
| CreateDoorSchedule | 개별 스케줄 등록 | |
| UpdateDoorSchedule | 개별 스케줄 수정 | |
| DeleteDoorSchedule | 개별 스케줄 삭제 | |
| 스케줄 예외 | CreateDoorScheduleException | 예외 기간 등록 |
| UpdateDoorScheduleException | 예외 기간 수정 | |
| DeleteDoorScheduleException | 예외 기간 삭제 | |
| 키오스크 | CreateKiosk | 키오스크 등록 |
| UpdateKiosk | 키오스크 수정 | |
| DeleteKiosk | 키오스크 삭제 | |
| AssignKiosk | 키오스크 도어락 배정 | |
| RFID 리더기 | CreateRfidReader | RFID 리더기 등록 |
| UpdateRfidReader | RFID 리더기 수정 | |
| DeleteRfidReader | RFID 리더기 삭제 | |
| AssignRfidReader | RFID 리더기 도어락 배정 | |
| 비상 제어 | ActivateEmergency | 긴급 상황 발생 (전체 개방) |
| DeactivateEmergency | 긴급 상황 해제 | |
| 출석 | ModifyAttendance | 출석 상태 수정 (관리자 웹) |
| BulkModifyAttendance | 출석 상태 일괄 수정 (관리자 웹) | |
| ModifyAttendanceFromKiosk | 출석 상태 수정 (키오스크) | |
| BulkModifyAttendanceFromKiosk | 출석 상태 일괄 수정 (키오스크) | |
| 카드 | CreateCard | RFID 카드 등록 |
| UpdateCard | 카드 정보 수정 | |
| DeleteCard | 카드 삭제 | |
| TapCardFromReader | 외부 RFID 리더기 카드 태깅 | |
| 화면보호기 | UpdateScreensaverSetting | 화면보호기 설정 변경 |
| DeleteScreensaverImage | 화면보호기 이미지 삭제 | |
| MoveScreensaverImageUp | 화면보호기 이미지 순서 올리기 | |
| MoveScreensaverImageDown | 화면보호기 이미지 순서 내리기 |
대상 유형
작업명에 따라 자동으로 결정되며, 어떤 종류의 데이터에 대한 작업인지를 나타냅니다.
| 대상 | 설명 |
|---|---|
| manager | 사용자(교사/관리자) 계정 |
| student | 학생 |
| course | 과목 |
| course_student_map | 과목-학생 매칭 |
| course_schedule | 수업 일정 |
| semester | 학기 |
| classroom | 교실 |
| door_lock | 도어락 |
| global_door_schedule | 전체 도어락 스케줄 |
| door_schedule | 개별 도어락 스케줄 |
| door_schedule_exception | 스케줄 예외 기간 |
| kiosk | 키오스크 |
| rfid_reader | RFID 리더기 |
| emergency | 비상 상황 |
| attendance | 출석 기록 |
| card | RFID 카드 |
| screensaver | 화면보호기 |
기기 초기화 (엔지니어 전용)
키오스크 태블릿을 처음 설치하거나 공장 초기화 후 재설정할 때 필요한 ADB 명령어 가이드입니다.
adb shell settings put global auto_time_zone 0
adb shell settings put global ntp_server 192.168.1.10
adb shell getprop persist.sys.timezone
설정 항목 설명
- persist.adb.tcp.port 5555: 네트워크를 통한 원격 디버깅 및 업데이트를 위해 5555 포트를 개방합니다.
- auto_time_zone 0: 네트워크(통신사) 시간 자동 동기화를 끕니다. (폐쇄망 환경)
- ntp_server: 로컬 NTP 서버를 지정하여 시간을 동기화합니다. 서버 시간과 키오스크 시간이 다르면 출석 태깅 시 오류가 발생할 수 있습니다.
이 페이지의 매뉴얼은 작성 중입니다.