Beginner Guide

교실 QR 자리선택 초보자 설명서

이 버전은 복잡한 별점, 성적, 청소 기능 없이 학생 이름 넣기 -> 순번 정하기 -> 세션 JSON 저장 -> QR 세션 만들기 만 하는 가장 쉬운 흐름입니다.

간단 메인 화면 열기 qr-setup 열기 학생 QR 카드 만들기 기존 자세한 설명서

0. 먼저 이해하기

이 앱에서 하는 일은 4개뿐입니다

1. 학생 명단 넣기

CSV 파일을 열거나 엑셀 표를 복사해서 붙여넣습니다.

2. 학생 순번 정하기

학생이 자리를 고를 순서를 1번부터 연속으로 정합니다.

3. 세션 JSON 저장

실시간 QR 세션을 만들 재료 파일을 저장합니다.

4. QR 세션 만들기

qr-setup.html에서 교사용 링크와 학생 링크를 만듭니다.

1. 준비

작업 기준 경로

앞으로 작업 경로는 /Users/hangbokee/classroom-planner 입니다. 입력 파일은 /Users/hangbokee/classroom-planner/workspace/input, 세션 JSON은 /Users/hangbokee/classroom-planner/workspace/sessions를 쓰면 정리하기 편합니다.

2. 명단 넣기

가장 쉬운 방법

방법 A. CSV/엑셀 파일 열기 메인 화면에서 CSV/엑셀 파일 열기를 누르면 .csv, .xlsx, .xls 파일을 바로 읽을 수 있습니다.

방법 B. 엑셀 표 그대로 붙여넣기 엑셀에서 이름과 순번 표를 드래그해서 복사한 뒤, 메인 화면 입력칸에 그대로 붙여넣고 명단 반영을 누릅니다.

방법 C. 샘플 양식부터 시작 샘플 양식 다운로드를 눌러 CSV를 받은 뒤, 그 양식을 수정해서 다시 불러옵니다. 프로젝트 안의 샘플 파일은 /Users/hangbokee/classroom-planner/samples/simple-roster-template.csv 입니다.

이름,선택순번
김민지,1
박준호,2
이서연,3

3. 순번

순번 규칙은 이것만 기억하면 됩니다

좋은 예 1, 2, 3, 4

안 되는 예 1, 2, 4

안 되는 예 1, 2, 2, 3

순번이 비거나 겹치면 세션 JSON 저장 단계에서 경고가 뜹니다.

4. 좌석

좌석은 쓰지 않을 자리만 끄면 됩니다

기본으로 36석이 켜져 있습니다. 학생 수보다 적지만 않으면 됩니다. 사용하지 않을 자리만 클릭해서 꺼 두세요.

5. 세션 만들기

메인 화면 다음 단계

1단계 메인 화면에서 세션 JSON 저장 클릭

2단계 qr-setup.html 열기

3단계 세션 이름 입력

4단계 방금 저장한 JSON 내용 붙여넣기

5단계 실시간 세션 만들기 클릭

6. 수업 시간

실제 운영 순서

선생님 교사용 링크 열기 -> 열기 / 재개

학생 자기 QR 찍기 -> 자기 차례일 때 자리 선택

문제 생기면 교사용 화면에서 선택 취소 가능

7. 마지막

정말 최소한으로 기억할 것

1. CSV 또는 엑셀 표로 학생 명단 넣기
2. 순번을 1번부터 연속으로 정하기
3. 세션 JSON 저장
4. qr-setup에서 실시간 세션 만들기
5. 학생 링크 CSV 저장 후 QR 카드 만들기