📘 체육 사용 가이드

1. 한눈에 보기

EAIM 체육 수업은 마음 열기 → 탐구 → 창작·완성 → 나누기 → 기록으로 흘러가요. 준비 운동과 오늘의 기분·물음으로 마음을 열고, 원리·규칙·동작을 몸으로 탐구하고, 안무·작전·실천 계획을 만들어(창작·완성), 모둠 경기와 발표로 나누고, 수업 QR로 들어온 학생의 결과가 선생님께 모여요(기록).

앱 정보를 불러오는 중…

AI가 들어간 곳: 학생 화면에는 AI가 없어요. 교사 페이지에서 비트 & 볼 소감에 답장할 때 선생님이 누르는 🤖 AI 초안 받기 한 곳뿐이에요.

기기에만 저장되는 앱: 기록 측정·팀 편성(선생님 기기)과 건강체력 자기관리(학생 기기)는 서버에 올리지 않아요. 체력 측정값은 건강 정보에 가까워서예요(8번).

교육과정과 이어 보고 싶으면 📝 지도안 만들기에서 성취기준을 고르면 수업 과정안이 짜여요(7번).

2. 처음 한 번만 하는 설정

구글 로그인

1. 교사 페이지(teacher.html)에서 구글 로그인을 눌러요. 계정 고르는 창이 나와요. 버튼이 "준비 중…"이면 잠깐 기다려요.
2. 브라우저를 닫으면 자동으로 로그아웃돼요(공용 PC 보호).
3. 처음 쓰는 사이트 주소라면 Firebase 콘솔 → Authentication → 승인된 도메인에 이 주소(eaim-physical-play.vercel.app)가 있어야 로그인이 돼요.

AI 키

1. Google AI Studio(또는 구글 클라우드 콘솔)에서 새 API 키를 만들어요. API 제한(Generative Language API만) + 하루 한도만 걸고, 웹사이트 제한은 걸지 않아요 — 서버에서 부를 때 막혀요.
2. 교사 페이지의 🤖 AI 연결 칸 → 내 Gemini 키 넣기를 펼쳐 붙여 넣고 저장 → 30초쯤 뒤 연결 상태가 AI 연결됨으로 바뀌는지 봐요.
3. 키는 선생님 본인과 서버만 읽는 금고에 저장되고 서버에서만 쓰여요. 학생 기기로 내려가지 않고, 교사 페이지에는 "끝 네 자리"만 보여요. 필요 없으면 내 키 지우기로 지워요. 이 키는 같은 구글 계정으로 쓰는 다른 EAIM 교과 교사 화면과 함께 쓰는 설정이에요. 예전에 넣어 둔 키는 로그인할 때 저절로 금고로 옮겨져요.
4. 저장소 관리자는 처음 한 번 저장소에 api/ai.js(v0.7), Vercel 환경변수 FIREBASE_SERVICE_ACCOUNT(꼭 — 서버가 금고를 읽음)·GEMINI_KEY·ALLOWED_TEACHERS·ALLOWED_ORIGINS를 넣고 다시 배포해요.

휴대폰·태블릿 홈 화면에 두기

크롬(안드로이드)은 ⋮ 메뉴 → 홈 화면에 추가, 사파리(아이폰·아이패드)는 공유 버튼 → 홈 화면에 추가. 기록 측정·서킷 타이머처럼 운동장에서 바로 꺼내 쓰는 앱을 홈 화면에 두면 편해요.

3. 수업 방 만들기

1. teacher.html에서 로그인한 뒤 새 체육 수업 방 칸에 수업 이름을 적어요. 예: "2학년 리듬 체육"
2. 반 목록을 쉼표로 적어요. 예: 2-1, 2-3. 적으면 학생이 목록에서 반을 고르고, 비워 두면 학생이 학년·반을 직접 적어요.
3. 수업 방 만들기를 누르면 수업 코드가 생겨요.

• 수업 방 하나로 여러 앱을 써요. 수업 방 카드의 학생에게 띄울 앱에서 앱을 고르면 그 앱의 QR과 링크가 나와요. 칠판 화면에 QR을 크게 띄우고 학생이 휴대폰·태블릿으로 찍어요.
• 링크 복사 — 학급 게시판·메신저에 붙여 넣을 수 있어요. 공개 화면(기록 없음) 열기 ↗로 학생 화면을 미리 볼 수 있어요.
• 수업 닫기 / 수업 열기 — 닫으면 학생이 더 이상 들어오거나 낼 수 없어요. 다음 시간에 다시 열면 같은 QR을 써요.
• 선생님 자료 — 수업 방마다 녹화·관리 →(스트레칭 시범 동작), 곡 추가·관리 →(비트 & 볼 추천곡), 문제 편집(심판 퀴즈 선생님 문제), 🎬 영상 동작 만들기·관리 →(시범 영상에서 흘러가는 움직임만 뽑아 저장 — 영상은 올라가지 않음). 새 수업 방을 만들면 가장 최근 수업 방의 자료를 이어받아요.

학생은 반, 번호, 성 한 글자(선택)만 적고 들어와요. 선생님 화면에는 "김**"처럼 성 한 글자만 보여요.

4. 수업 중

• 학생 현황 — 이 과목은 들어온 학생 목록 화면이 없어요. 학생 화면 왼쪽 아래에 📚 반 번호 · 수업 중 표시가 있으면 수업 방에 들어온 거예요. 낸 것은 📋 기록 보기에서 봐요.
• 실시간 활동 — 이 과목은 실시간 화면이 없어요. 📋 기록 보기를 다시 누르면 새로 낸 것이 보여요.
• 프로젝터로 쓰는 앱 — 경기 점수판(종목별 시계·점수, 전체 화면), 서킷 트레이닝 타이머(전체 화면), 심판 판정 퀴즈 모둠 대결, 전술 보드 ▶ 작전 재생은 칠판 화면에 띄워 함께 봐요. 기록이 남지 않는 공개 화면으로 열면 돼요.
• 음악 — 서킷 트레이닝 타이머·스트레칭 따라하기·경기 점수판에서 🎵 음악을 고르면 수업 음악이 함께 나와요. 비트 & 볼은 종목(농구·배구·축구·배드민턴)과 기분을 고르고 🎵 EAIM 체육 음악의 박에 맞춰 공을 다뤄요. 곡은 저장소 안에 있어 인터넷 다른 곳을 부르지 않아요.
• 카메라 앱 — 스트레칭 따라하기·리듬 포즈·창작 안무·슬로우 캠은 기기를 1.5~3m 떨어진 곳에 세우고, 주변에 부딪힐 것이 없는지 먼저 살펴요.

막혔을 때

• "수업 방을 찾을 수 없어요" / "수업이 닫혀 있어요" → 수업 방이 열려 있는지 보고 QR을 다시 보여 줘요. 학생은 기록 없이 연습하기로 연습은 계속할 수 있어요.
• "체육 수업 방이 아니에요" → 다른 과목이나 예전 수업 방의 QR이에요. 교사 페이지에서 새 QR을 띄워요.
• 학생 화면 아래가 "🔒 수업이 닫혔어요 · 기록은 보내지지 않아요"로 바뀌었으면 → 수업 열기를 눌러요.
• 카메라가 안 켜지면 → 주소창 옆 자물쇠에서 카메라를 허용하고, 안내 창에서 알겠어요, 켜기를 눌렀는지 봐요(9번).

5. 수업 뒤

• 결과물 보기 — 수업 방 카드의 📋 기록 보기 → 결과물에 반·번호·앱·낸 때와 내용이 나와요. 비트 & 볼 소감, 창작 안무(마디별 동작·빠르기·도전 결과), 전술 보드 작전(종목·인원·장면 수·설명)이 모여요.
• 점수 — 같은 화면의 점수 표에 스트레칭 일치도, 리듬 포즈 점수, 심판 퀴즈(개인 풀이), 가슴압박 적정 빠르기 비율이 모여요. 결과물과 따로 저장돼요.
• 답장 — 결과물마다 답장 칸에 적고 답장 보내기. 비트 & 볼 소감은 🤖 AI 초안 받기로 초안을 받아 고친 뒤 보내요. 학생은 비트 & 볼 첫 화면의 📮 선생님 답장에서 봐요.
• CSV 내려받기 — CSV 내려받기. 결과물과 점수가 한 파일로 엑셀에서 열려요.
• 세특 초안 — 이 과목은 세특 초안 기능이 없어요.
• 기록 측정의 측정값은 서버에 없어요. 기록 측정 앱 📋 기록 탭의 전체 기록 엑셀(CSV)로 내보내기로 학교 컴퓨터에 보관해요.
• 학년말 기록 정리는 EAIM 공통 기능이 생기면 교사 페이지에 들어가요. 그 전에는 수업 방마다 CSV로 내려받아 두세요.

6. 앱별 사용법

저장소의 활동 정보(activities.json)를 읽어 보여 줘요. 누구나 로그인 없이 연습 · 수업 QR 기록 수업 방으로 들어오면 기록 · 카메라 · 선생님 도구

7. 선생님 도구

📝 지도안

성취기준을 고르면 본시 교수·학습 과정안 표를 짜 줘요. 첫 화면이나 교사 페이지 위의 📝 지도안 만들기로 열어요(eaim-pe-lessonplan.html). AI·로그인·저장이 없어요.

1. 왼쪽 위에서 학교급·과목을 고르고, 그 아래에서 성취기준을 골라요. 중학교 1~3학년 51개(운동·스포츠·표현)와 고등학교 20과목 139개 — 일반 선택(체육1·체육2), 진로 선택(운동과 건강·스포츠 문화·스포츠 과학), 융합 선택(스포츠 생활1·2), 체육 계열 선택 과목 13개(체육고) — 모두 190개예요.
2. 활동 앱에서 수업에 쓸 EAIM 체육 앱을 골라요. 활동 칸에 그 앱의 실제 단계가 들어가요. 이어 둔 앱이 없는 성취기준은 앱 없이 짜기로 기본 틀이 짜여요.
3. 일시, 장소, 대상, 차시, 수업 시간(분)을 적어요. 시간을 바꾸면 단계별 분이 다시 나뉘어요. 도입에는 준비 운동·안전 점검, 정리에는 정리 운동이 들어가요.
4. 표 안의 글은 눌러서 바로 고쳐요. 다 고친 뒤 🖨️ 인쇄·PDF ⬇️ Word 파일(.doc) 📋 표째 복사로 가져가요. 색상은 초록·파랑·분홍·흑백.

지도안은 도구라서 앱 수에는 세지 않아요. 교사 페이지 자체(수업 방·선생님 자료·기록)는 3·5번을 보세요.

8. 안전과 개인정보

반·번호만

• 학생은 가입·비밀번호 없이 반·번호(와 성 한 글자)만 적어요. 기록에도 그것만 남아요.
• 이름 쓰지 않기 — 소감·작전 설명·안무 이름 칸에 "이름은 쓰지 않아요" 안내가 있어요. 작전 설명은 친구 이름 대신 "1번·2번 선수"로 적어요.

카메라 (스트레칭 따라하기 · 영상 동작 따라하기 · 리듬 포즈 · 창작 안무 · 동작 분석 슬로우 캠)

• 영상은 이 기기 안에서만 자세(관절 위치)를 읽는 데 쓰고, 저장하지 않아요. 서버나 AI로 보내지도 않아요.
• 처음 켤 때 안내 창이 떠요: "영상은 이 기기 안에서만 자세를 읽는 데 쓰고, 저장하지 않아요 … 친구가 화면에 나올 때는 먼저 친구에게 물어봐요" → 알겠어요, 켜기 / 안 켜기.
• 자세를 읽는 프로그램은 처음 한 번 인터넷에서 받아 와요. 프로그램을 받아 오는 것이지, 영상을 보내는 것은 아니에요.
• 스트레칭의 선생님 시범 녹화도 영상이 아니라 관절 위치 숫자만 수업 방에 저장돼요.
• 🎬 영상 동작 만들기는 선생님 기기에 있는 시범 영상을 그 기기 안에서만 읽어 관절 숫자만 뽑아요. 영상 파일은 어디에도 올라가지 않아요. 학생이 나오는 영상은 쓰지 않아요.
• 슬로우 캠의 녹화와 캡처는 화면 안에만 있고, 새로고침하면 사라져요. 내려받기 단추도 없어요.
• 학생 얼굴이 나온 화면을 캡처해 쓰지 않아요 — 수업 자료, 학급 게시판, 연수 자료, 이 가이드 모두. 친구를 찍을 때는 먼저 묻고, 찍히기 싫은 학생은 카메라 없이 기록 도우미·안전 도우미로 참여해요.

건강 정보 (건강체력 자기관리 · 기록 측정)

• 건강체력 자기관리는 학생 기기에만 저장되고 서버·AI로 가지 않아요. 이름 칸이 없어요. 메모 칸에 아픈 곳이나 병명은 적지 않고, 통증은 보건 선생님이나 코치 선생님께 바로 말하도록 안내해요. 공용 기기라면 설정의 이 기기의 건강 기록 모두 지우기로 지워요.
• 기록 측정은 반·번호(와 성 한 글자)만 받아요. 이름까지 붙여 넣으면 성 한 글자만 남겨요. 측정값은 선생님 기기에만 있고, 학기가 끝나면 엑셀로 내보낸 뒤 지워요.
• 키·몸무게·부상·장애·병명·수면·컨디션을 적는 칸은 만들지 않았어요. 수업 중에도 이런 정보를 앱이나 활동지에 적게 하지 말아 주세요. 몸이 불편한 학생은 모두 앞에서 묻지 말고 따로 이야기해요.
• 예전 기록 측정 앱에 실명 명단이 남아 있으면 앱 위에 안내가 떠요: ① CSV 내려받기 → ② 예전 기록 지우기.

그 밖의 안전

• 가슴압박 박자 연습은 빠르기와 일정함만 확인해요. 누르는 깊이는 측정하지 못해요. 사람에게 누르지 않고 쿠션·마네킹으로 연습해요.
• 교사 페이지의 AI 답장 초안에는 소감 글과 고른 기분·템포만 보내요. 반·번호·이름은 보내지 않아요. 초안은 꼭 읽고 고친 뒤 보내요.
• 연습 모드(QR 없이)는 기록이 선생님께 가지 않아요. 예전 체육 앱이 기기에 남긴 Gemini 키·이름·수면·컨디션 칸은 새 앱을 처음 열 때 지워져요.

9. 이럴 땐 이렇게 · 자주 묻는 질문

교사 페이지 로그인이 안 돼요.

Firebase 콘솔 → Authentication → 승인된 도메인에 이 사이트 주소(eaim-physical-play.vercel.app)가 있는지 확인해요. 버튼이 "준비 중…"이면 잠시 기다려요.

AI 연결 상태가 "AI 안 됨"이에요.

상태 위에 마우스를 올리면 까닭이 보여요. "웹사이트 제한"이면 제한 없는 키로 바꾸고, "키가 없어요"면 내 Gemini 키 넣기에 키를 넣어요. "허용되지 않은 주소"면 Vercel 환경변수 ALLOWED_ORIGINS에 이 주소가 있는지 봐요. AI가 없어도 모든 앱은 그대로 써요.

카메라가 안 켜져요.

주소창 옆 🔒에서 카메라를 허용해요. 안내 창에서 "안 켜기"를 눌렀다면 다시 시작 단추를 눌러요. 그래도 "인식 프로그램을 켜지 못했어요"가 뜨면 학교 인터넷이 인식 프로그램 주소(cdn.jsdelivr.net, storage.googleapis.com)를 막고 있을 수 있어요 — 정보 담당 선생님께 알려 주세요.

학생 화면에 "선생님께 보내기" 버튼이 없어요.

수업 QR이 아니라 첫 화면에서 들어온 연습 모드예요. QR이나 복사한 링크로 다시 들어오게 해요.

선생님이 녹화한 시범 동작·추천곡이 학생 화면에 안 나와요.

수업 방 QR로 들어와야 그 수업 방의 자료가 나와요. 공개 화면에서는 기본 동작 14개(스트레칭)와 그 기기에 있는 곡만 나와요.

새로고침했더니 다시 반·번호를 물어요.

같은 탭에서는 다시 묻지 않아요. 탭이나 창을 닫으면 공용 기기 보호를 위해 처음부터 들어와요.

기록 측정·건강체력 기록이 교사 페이지에 안 보여요.

두 앱은 건강 정보 보호를 위해 서버에 올리지 않아요. 기록 측정은 그 기기에서 엑셀로 내보내요.

음악이 안 나와요.

기기 소리와 🎵 칸의 소리 크기를 확인하고, ▶ 단추를 한 번 눌러 보세요(브라우저는 화면을 누르기 전에는 소리를 막아요). 처음 틀 때는 곡을 받아 오느라 1~2초 걸려요.

비트 & 볼에서 박이 음악과 조금 어긋나요.

"바로 시작" 곡은 곡 전체를 분석해 박을 맞췄어요. 다른 곡은 박자를 두드려 맞추는데, 어긋나면 훈련 화면의 다시 두드리기나 마디 맞추기로 고쳐요.

문제·안내 내용(규칙 해설, 가슴압박 기준, 운동 조언)이 이상해요.

저장소 밖의 검토표(pe-review.md)에 번호가 붙어 있어요. 번호로 알려 주시면 고쳐요.

10. 수업 예시

📝 지도안에서 성취기준을 고르면 이런 흐름이 표로 짜여요.

1. 들어가기

1. 선생님이 보여 주는 QR을 휴대폰이나 태블릿으로 찍어요.
2. 반을 고르고(또는 학년과 반을 적고) 번호를 적어요. 성 한 글자는 적지 않아도 돼요. 이름은 적지 않아요.
3. 들어가기를 눌러요. 화면 왼쪽 아래에 📚 내 반·번호 · 수업 중이 보여요.

집에서 연습할 때는 체육 첫 화면에서 앱을 바로 눌러요. 로그인은 필요 없어요. 이때는 기록이 선생님께 가지 않아요.

2. 활동하기

• 활동 전에 몸을 풀고, 주변에 부딪힐 것이 없는지 살펴요.
• 📷 카메라를 쓰는 앱은 처음에 안내 창이 떠요. 읽고 알겠어요, 켜기를 눌러요. 영상은 내 기기 안에서만 쓰이고 저장되지 않아요.
• 친구가 화면에 나올 때는 먼저 친구에게 물어봐요.
• 화면의 순서대로 차근차근 해요. 점수는 연습을 돕는 숫자예요 — 친구와 비교하기보다 지난번의 나와 비교해요.
• 숨이 너무 차거나 아픈 곳이 생기면 바로 멈추고 선생님께 말해요.

3. 선생님께 내기

1. 비트 & 볼은 훈련 일지를 쓰고 선생님께 일지 보내기 📮, 창작 안무는 📤 선생님께 안무 보내기, 전술 보드는 작전 설명을 쓰고 📤 선생님께 작전 보내기를 눌러요.
2. 스트레칭 따라하기·리듬 포즈 게임·심판 판정 퀴즈·가슴압박 박자 연습은 끝나면 점수가 저절로 선생님께 가요.
3. "선생님께 보냈어요 ✓"가 뜨면 끝이에요. 고친 뒤 다시 보내도 돼요.
4. "🔒 수업이 닫혔어요"가 뜨면 선생님께 말씀드려요.
5. 선생님 답장은 비트 & 볼 첫 화면의 📮 선생님 답장에서 봐요.

4. 우리의 약속

• 🔒 내 이름, 친구 이름, 학교 이름은 쓰지 않아요. 작전 설명은 "1번·2번 선수"로 적어요.
• 📷 친구 얼굴이 나온 화면을 찍거나 캡처해서 올리지 않아요. 찍기 전에 먼저 물어봐요.
• 🩹 아픈 곳이나 병 이름은 앱에 적지 않고, 선생님이나 보건 선생님께 말로 이야기해요.
• 🤝 친구의 움직임과 생각을 존중해요. 서툰 동작도 응원해요.
• 💬 힘들거나 걱정되는 일이 있으면 선생님이나 믿을 만한 어른께 이야기해요. 청소년 상담은 1388이에요.