시작하기 전에
2026-10-07 화면 변경
아래 스크린샷은 이전 화면입니다. 지금은 첫 화면 카드 제목이 한국어(「출석 체크」·「출석 기록 조회」·「좌석 배치도」·「관리자」)로 바뀌었고,
출석 화면에서
QR을 누르면 크게 보입니다. QR은
30분 동안 열려 있고 연장은 없습니다.
시간표와 다른 프로그램으로 시작하면 한 번 확인 창이 뜹니다.
이 시스템은 유봉여자고등학교의 코스모스 독서시간 출석을 QR 코드로 관리하는 웹 애플리케이션입니다. 교사가 QR 코드를 생성해 학생에게 보여주면, 학생이 본인 휴대폰으로 스캔해 학번을 입력하는 방식으로 출석이 처리됩니다.
접속 주소
모든 사용자는 아래 주소로 접속합니다. 별도의 앱 설치나 로그인은 필요하지 않습니다.
https://cosmos.yubong.app
[이미지 01-a] 접속 직후 뜨는 메인 화면. 교사용 「출석 체크」와 「출석 기록 조회」, 관리자용 「관리자」 세 카드가 보입니다.
[이미지 01-b] 교사가 「출석 체크」 카드를 누르면 나오는 장소 선택 화면. 아우름 · 교과1실 · 해오름 · 리케이온 네 카드 중 본인 담당 장소를 선택합니다.
역할별 진입 방법
- 학생 — 교사가 보여주는 QR 코드를 휴대폰 카메라로 스캔하면 바로 출석 화면으로 이동합니다. 직접 주소를 입력할 필요는 없습니다.
- 교사 · 출석 받기 — 메인 화면에서 「출석 체크」 카드를 누르고, 이어서 나오는 장소 선택 화면에서 본인이 담당하는 장소(아우름 · 교과1실 · 해오름 · 리케이온)를 선택합니다.
- 교사 · 기록 조회 및 사후 출석 — 메인 화면에서 「출석 기록 조회」 카드를 누릅니다. 비밀번호 없이 바로 진입되며, 지난 출석 기록을 확인하고 늦게 온 학생을 사후 출석으로 추가할 수 있습니다.
- 관리자 — 메인 화면에서 「관리자」 카드를 눌러 관리자 페이지로 이동합니다. (비밀번호 필요)
운영 중인 프로그램
- 방과후 독서시간 — 평일 16:30 ~ 18:20 · 아우름 / 교과1실 / 해오름
- 야간 독서시간 — 평일 19:10 ~ 21:30 · 아우름 / 교과1실 / 해오름
- 심야 독서시간 — 평일 21:30 ~ 23:00 · 리케이온
- 토요일 독서시간 — 오전 08:30 ~ 12:30 / 오후 13:30 ~ 17:30 · 리케이온
- 일요일 독서시간 — 오후 13:30 ~ 17:30 · 리케이온
💡 쌍둥이 장소 운영
아우름과 교과1실은 실질적으로 같은 공간으로 통합 운영됩니다. 교사 한 분이 양쪽을 동시에 관리하며, 학생은 어느 쪽 QR 코드를 스캔해도 같은 출석 시간에 기록됩니다.
교사·관리자용 — 출석 진행 및 확인
교사 화면에서는 QR 코드를 생성해 학생 출석을 받고, 실시간으로 출석 현황을 확인하며, 필요 시 직접 학번을 입력해 출석을 추가할 수 있습니다.
출석 시간 시작하기
1
메인 화면에서 본인이 담당하는 장소 카드를 선택합니다. 2026-10-07부터 카드가 두 장입니다: 「아우름 · 교과1실」(방과후·야간), 「해오름 · 리케이온」(방과후·야간·심야·토·일). 두 방은 한 출석으로 함께 받습니다.
[이미지 02] 장소 진입 직후의 출석 시작 화면. 프로그램은 지금 시각·요일에 맞게 미리 골라져 있습니다. 프로그램 드롭다운과 담당 교사 이름 입력란, 아래에 QR 띄우고 출석 시작 버튼이 있습니다.
2
프로그램을 선택합니다. (심야 · 야간 · 방과후 · 토요일 · 일요일 독서시간) 리케이온이 아닌 장소에서는 심야/토요일/일요일 옵션이 보이지 않습니다.
3
담당 교사 이름을 입력합니다. 아우름 + 교과1실 통합 운영일 때는 생략할 수 있습니다.
4
"QR 띄우고 출석 시작" 버튼을 누릅니다.
[이미지 03] 출석 시간 시작 직후의 교사 화면. 좌측에 큰 QR 코드와 남은 시간, 우측에 출석 현황 요약(출석·미출석·출석률·자율)과 학생 명단이 실시간으로 표시됩니다.
감독 교사 자동 채움
장소에 들어가 프로그램을 고르면 그날 그 프로그램·장소(토·일은 오전/오후)의 감독 교사 이름이 자동으로 입력됩니다. 이 정보는 감독표 엑셀(「26년 ○월」 시트)에서 하루 두 번(06:00·15:30) 자동으로 가져옵니다. 직접 고친 이름은 덮어쓰지 않습니다.
[이미지 04] 리케이온에서 심야 독서시간을 선택하면 담당 교사 칸에 감독표 기준 이름이 자동으로 들어가고, 아래에 "오늘의 심야 감독으로 자동 입력됨 — 다르면 직접 수정하세요" 안내가 보입니다.
⚠ 반드시 확인하세요
자동 채움은 감독표 기준이라 실제 감독자와 다를 수 있습니다. 시작 버튼을 누르기 전 반드시 본인 이름이 맞는지 확인하고, 다르면 직접 지우고 올바른 이름을 입력하세요.
자동 채움이 틀린 채로 출석 시간을 시작해버렸다면, 나중에 관리자 페이지의 출석 기록 탭에서 수정할 수 있습니다. (해당 세션 선택 후 교사 이름 옆 연필 아이콘 클릭)
학생 출석 현황 보기
QR 코드가 표시된 화면에서 학생이 출석할 때마다 실시간으로 명단이 갱신됩니다. 전체 / 출석 / 미출석 탭으로 구분해 볼 수 있습니다.
[이미지 05] 교사 화면 우측의 출석 현황. 상단 요약 카드(출석·미출석·출석률·자율)와 학생 명단이 있고, 이미 출석한 학생은 체크 표시(√)와 시각이, 아직 미출석인 학생은 회색 점과 출석 버튼이 표시됩니다. 전체 / 출석 / 미출석 탭으로 필터할 수 있습니다.
💡 실시간 갱신
학생이 QR을 스캔해 학번을 입력하면 교사 화면에 즉시 반영됩니다. 네트워크 문제로 반영이 늦어도 최대 3초 이내에 자동으로 새로고침됩니다. 수동 새로고침은 불필요합니다.
학번으로 수동 출석 추가
학생의 휴대폰이 없거나 QR 스캔이 안 되는 경우, 교사가 직접 학번을 입력해 출석을 추가할 수 있습니다.
1
교사 화면 우측 상단의 "√ 수동 출석" 버튼을 누릅니다.
2
숫자 키패드가 뜨면 학번 5자리를 입력합니다.
3
입력이 완료되면 출석 버튼을 눌러 확정합니다. 해당 학생이 명단에 추가됩니다.
[이미지 06] 수동 출석 버튼을 누르면 뜨는 학번 입력 키패드. 5자리 학번 입력란과 숫자 버튼, 삭제 버튼, 출석 확정 버튼이 있습니다.
QR 시간이 끝났을 때 — 자동 마감
QR 코드는 30분 동안 열려 있고, 시간이 다 되면 자동으로 마감되어 같은 장소의 시작 화면으로 돌아갑니다. 연장은 없습니다(2026-10-08 변경 — 전에는 20분 + 10분 연장 1회). 자리를 비웠거나 창을 닫아도 다음에 화면을 열 때 정리됩니다.
💡 늦게 온 학생
마감 뒤에 온 학생은 화면 위쪽 「오늘 마감된 세션」 카드에서 사후 출석으로 넣습니다.
출석 시간 마감하기
수업이 끝났거나 모든 학생이 출석을 마쳤으면 직접 출석 시간을 마감할 수 있습니다. 굳이 30분을 다 기다릴 필요는 없습니다.
1
QR 코드 화면에서 "출석 마감" 버튼을 누릅니다.
2
확인 창에서 "마감"을 한 번 더 누릅니다.
3
화면 아래에 출석 인원이 잠깐 표시되고, 같은 장소의 시작 화면으로 돌아갑니다. 인터넷 문제로 마감이 저장되지 않으면 안내가 뜨고 출석 화면에 그대로 남으니 「출석 마감」을 다시 누르면 됩니다.
[이미지 08] 출석 마감 버튼을 누르면 뜨는 출석 마감 확인 창. "마감 후에는 학생이 더 이상 QR을 스캔할 수 없어요" 안내가 표시되고, 취소 / 마감 두 버튼 중 선택합니다.
출석 기록 조회 · 사후 출석 (출석 기록 조회)
지난 출석 기록을 확인하거나, 수업이 끝난 뒤 뒤늦게 온 학생·QR 스캔 실패로 누락된 학생을 추가하려면 메인 화면의 「출석 기록 조회」 카드를 사용합니다. 비밀번호 없이 바로 진입되며, 담당 교사가 아니어도 다른 선생님의 세션에 사후 출석을 추가할 수 있습니다. 수업이 끝난 뒤 추가하는 출석을 사후 출석이라고 합니다.
[이미지 09] View 페이지의 출석 기록 탭. 좌측에 날짜별 세션 카드 목록(필터 가능), 우측에 선택된 세션의 상세(프로그램·시간·교사, 출석/미출석/출석률, 장소별 학생 명단)가 보입니다. 페이지 제목 옆 READ ONLY 배지로 조회 모드임을 표시합니다. 사이드바에는 출석 기록(H)과 실시간(L) 두 탭만 있습니다.
사후 출석 추가하기
1
메인 화면에서 「출석 기록 조회」 카드를 누릅니다.
2
좌측 세션 카드 목록에서 사후 출석을 추가할 세션을 클릭합니다. 필요하면 상단 필터(기간·프로그램·장소)로 범위를 좁힙니다.
3
우측 상세 영역에 뜨는 "+ 사후 출석 추가" 버튼을 누릅니다.
4
숫자 키패드에 해당 학생의 학번 5자리를 입력해 확정합니다. 해당 세션에 사후 출석으로 추가됩니다.
✓ 사후 출석은 기록에 구분 표시됩니다
사후로 추가된 학생은 출석 기록에서
"사후" 라벨로 구분되므로 정상 출석과 혼동되지 않습니다.
💡 담당 교사라면 「출석 체크」 경로도 가능
본인이 담당한 세션에 사후 출석을 추가하는 경우라면,
출석 체크 → 본인 장소로 들어가 설정 화면 위쪽의 "오늘 마감된 세션 · 사후 출석" 영역에서도 같은 작업을 할 수 있습니다. 어느 경로로 추가해도 결과는 동일합니다.
관리자 페이지
관리자 페이지는 명단·기록·분석·요청 등 전반적인 운영을 처리하는 곳입니다. 메인 화면의 「관리자」 카튼으로 이동할 수 있습니다. 왼쪽 사이드바에서 탭을 전환하며 사용합니다.
명단 관리
학생 명단을 추가·수정·삭제하고, 엑셀 파일로 일괄 업로드할 수 있습니다.
[이미지 12] 관리자 페이지 전체 레이아웃 + 명단 관리 탭. 좌측 사이드바에 Cosmos 로고와 메뉴(명단 관리 / 출석 기록 / 분석 / 요청 관리 / 실시간 / 진단 / 좌석 관리 / 코스모스), 하단에 ← 메인으로·로그아웃 버튼이 있습니다. 대기 중인 요청이 있으면 「요청 관리」 옆에 빨간 숫자가 붙습니다. 우측은 상단 필터(검색·프로그램·장소·학년·활성 상태)와 학생 목록 테이블(학번·이름·프로그램·장소·출석 요일·상태), 우측 상단에 엑셀 업로드 / 양식 다운로드 / + 학생 추가 버튼이 있습니다.
학생 개별 추가 · 수정
- 우측 상단 "+ 학생 추가" 버튼으로 한 명씩 추가할 수 있습니다.
- 학생 행을 누르면 수정 모달이 떠서 이름·프로그램·장소·출석 요일 등을 변경할 수 있습니다.
엑셀로 일괄 업로드
1
"양식 다운로드" 버튼으로 템플릿 엑셀 파일을 받습니다.
2
엑셀에서 학생 정보(학번·이름·프로그램·장소·출석 요일)를 입력·수정합니다.
3
"엑셀 업로드" 버튼으로 파일을 올립니다. 바로 저장되지 않고 미리보기가 먼저 뜹니다.
4
미리보기에서 등록 인원과 제외되는 행(학번 형식·프로그램/장소 이름 오타·출석 요일 없음)을 확인하고 「등록」을 누릅니다. 같은 학번이 다른 프로그램에 계속 활성으로 남는 경우도 여기서 알려 줍니다.
✓ 비파괴 업로드
엑셀에 있는 학생은 추가되거나 정보가 갱신됩니다. 엑셀에 없는 기존 학생은
그대로 유지됩니다. 부분 업데이트할 때 다른 학생이 사라질 걱정은 없습니다.
출석 기록
지난 출석 시간의 기록을 날짜별로 조회하고, 학생별 출석 상태를 확인할 수 있습니다.
[이미지 13] 출석 기록 탭. 좌측은 날짜별 출석 시간 카드 목록(상단에 기간·프로그램·장소 필터), 우측은 선택된 출석 시간의 상세(담당 교사·시간, 출석·미출석·출석률·자율 요약, + 사후 출석 추가 / 세션 삭제 버튼, 장소별 학생 명단과 개별 삭제 버튼)가 있는 2열 레이아웃입니다.
- 좌측 목록에서 필터로 기간·프로그램·장소를 좁힐 수 있습니다.
- 카드를 누르면 우측에 해당 출석 시간의 상세 명단이 보입니다. 쌍둥이 장소는 아우름/교과1실 섹션으로 구분되어 표시됩니다.
- 출석 시간 제목 옆의 연필 아이콘을 누르면 담당 교사 이름을 수정할 수 있습니다. (감독 자동 채움이 틀린 경우 등)
- "+ 사후 출석 추가" 버튼으로 해당 출석 시간에 학생을 추가할 수 있습니다.
- 개별 학생 행의 "삭제" 버튼으로 잘못된 출석 기록을 제거할 수 있습니다.
분석
기간·프로그램·장소·학년으로 거른 출석률, 결석이 잦은 학생, 날짜별 출석 매트릭스를 볼 수 있고 출석부를 엑셀로 받을 수 있습니다. 출석률 계산 기준은 화면 위쪽 요약 아래에 적혀 있습니다.
[이미지 14] 분석 탭. 상단 필터(기간·프로그램·장소·학년·학번 검색) 아래에 총 출석·총 미출석·평균 출석률·세션 수 요약 카드, 그 아래에 결석이 잦은 학생 상위 5명 카드, 맨 아래에 학생별·날짜별 체크 표시가 격자로 배치된 출석 매트릭스와 우측 출석률 열이 있습니다. 우측 상단에 출석부 다운로드 버튼이 있습니다.
실시간
지금 이 순간 운영 중인 네 장소의 출석 현황을 한 화면에서 볼 수 있습니다. 학생 문의가 왔을 때 ("저 출석이 안 됐어요") 빠르게 확인할 때 쓰세요.
[이미지 15] 실시간 탭. 상단에 학번으로 출석 여부 확인 검색 박스가 있고, 그 아래에 아우름·교과1실·해오름·리케이온 네 장소의 카드가 2×2로 배치됩니다. 각 카드는 현재 출석 시간이 진행 중이면 프로그램명·인원·명단을 표시하고, 없으면 진행 중인 세션이 없어요와 대기 배지를 표시합니다.
- 각 장소 카드는 현재 활성화된 출석 시간이 있을 때만 정보를 표시합니다.
- 상단의 학번 검색에 5자리를 입력하면 해당 학생이 오늘 어디에 출석했는지 바로 확인할 수 있습니다.
진단
오늘 예정된 출석 시간이 모두 정상적으로 생성됐는지 확인하고, 교사 기기에서 발생한 이벤트 로그를 조회할 수 있습니다. 이 탭은 운영 중 문제가 생겼는지 조기에 발견하는 데 가장 중요합니다.
[이미지 16] 진단 탭. 상단 오늘의 세션 현황에는 오늘 예정된 출석 시간 카드가 프로그램별로 나열되고 상태에 따라 색이 달라집니다. 아래 최근 교사 기기 로그에는 시각·장소·이벤트 이름·세부 정보가 최신순으로 표시되며, 상단에서 장소별·이벤트 유형별로 필터링할 수 있습니다.
오늘의 세션 현황
각 프로그램별로 예정된 출석 시간이 실제로 생성됐는지를 색상으로 한눈에 보여줍니다.
- 녹색 — 정상 진행 중 / 운영 완료. 출석 시간이 잘 만들어져 동작 중이거나 이미 잘 마무리됐습니다.
- amber — 마감됨. 운영 시간 안에 출석 시간이 만들어졌다가 정상적으로 마감됐습니다.
- 빨강 — 세션 미생성. 예정 시각이 지났는데 해당 출석 시간이 아직 만들어지지 않았습니다. 즉시 담당 교사에게 확인하세요.
- 회색 — 예정. 아직 시작 시각 전입니다.
최근 교사 기기 로그
교사 기기에서 발생한 주요 이벤트(페이지 진입·프로그램 선택·세션 생성·만료·연장·종료 등)를 시각 순으로 볼 수 있습니다. 장소별·이벤트 유형별로 필터링할 수 있습니다.
- 에러만 필터 — 실패 이벤트(
*_fail)만 표시
- 세션 관련 필터 — 세션 시작·생성·만료·연장·종료 이벤트만 표시
- 감독 자동 채움 필터 — 심야 감독 자동 채움 관련 이벤트만 표시