📘 영어 사용 가이드

1. 한눈에 보기

EAIM 영어 수업은 마음 열기 → 탐구 → 창작·완성 → 나누기 → 기록으로 흘러가요. 오늘의 감정이나 상황에서 출발해 표현을 듣고 익히고(탐구), 내 문장·시·글·신문을 만들고(창작·완성), 짝·모둠과 나누고, 선생님께 내요(기록).

앱 정보를 불러오는 중…

AI가 들어간 곳: …. AI는 수업 링크로 들어온 학생에게만 나오고, 선생님 키로 서버(중계 함수)를 거쳐 불러요. 문법 탐구실·게임방은 AI를 쓰지 않아요.

교육과정과 이어 보고 싶으면 첫 화면의 📚 성취기준으로 수업하기에서 영역(이해·표현) → 성취기준 → 앱·📝 지도안으로 바로 가요.

2. 처음 한 번만 하는 설정

구글 로그인

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

AI 키

1. Google AI Studio(또는 구글 클라우드 콘솔)에서 새 API 키를 만들어요. API 제한(Generative Language API만) + 하루 한도만 걸고, 웹사이트 제한은 걸지 않아요 — 서버에서 부를 때 막혀요.
2. 교사 페이지의 🔑 AI 설정 칸에 붙여 넣고 💾 저장 → 30초쯤 뒤 🤖 AI 연결 상태로 확인해요.
3. 키는 학생 기기로 내려가지 않고 서버에서만 쓰여요. 이 키는 같은 구글 계정으로 쓰는 다른 EAIM 교과 교사 화면과 함께 쓰는 설정이에요.
4. 저장소 관리자는 처음 한 번 저장소에 api/ai.js, Vercel 환경변수 GEMINI_KEY·ALLOWED_TEACHERS·ALLOWED_ORIGINS를 넣고 다시 배포해요. 자세한 것은 저장소 README에 있어요.

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

크롬(안드로이드)은 ⋮ 메뉴 → 홈 화면에 추가, 사파리(아이폰·아이패드)는 공유 버튼 → 홈 화면에 추가. 수업 QR 주소를 홈 화면에 두면 다음 시간에 바로 들어갈 수 있어요(선생님이 방을 다시 열었을 때).

3. 수업 방 만들기

1. teacher.html에서 로그인한 뒤 🏫 새 수업 방 만들기 칸에서 앱을 골라요. 수업 방은 앱마다 따로 만들어요.
2. 수업 방 이름을 적어요. 예: "2학년 3반 영시 수업"
3. 반을 쉼표로 적어요. 예: 2-1, 2-2, 2-3. 적으면 학생이 목록에서 반을 고르고, 비워 두면 학생이 직접 적어요.
4. ＋ 수업 방 만들기를 누르면 수업 코드와 QR이 생겨요.

• 🔳 QR·링크 — 칠판 화면에 QR을 크게 띄워요. 학생이 휴대폰·태블릿으로 찍어요. 🔗 링크 복사로 학급 게시판·메신저에 붙여 넣을 수 있어요.
• 👀 학생 화면 열어 보기 — 학생이 보는 화면을 미리 볼 수 있어요.
• ■ 수업 닫기 / ▶ 다시 열기 — 닫으면 학생이 더 이상 들어오거나 낼 수 없어요. 다음 시간에 다시 열면 같은 QR을 써요.

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

4. 수업 중

• 학생 현황 — 수업 방 카드의 📋 기록 보기 → 👥 들어온 학생에서 누가 들어왔는지 봐요.
• 실시간 활동 — 이 과목은 실시간 화면이 없어요. 학생이 낸 것은 📋 기록 보기를 다시 열거나 ↻ 새로고침을 누르면 보여요.
• 🤖 AI 끄기 / 🤖 AI 켜기 — 수업 방마다 AI를 켜고 꺼요. 끄면 그 방 학생 화면의 AI 버튼이 사라져요.
• 레벨 고정 — 놀이터·영시·작문·회화 방은 수업 방 카드의 레벨 칸(🌱 기초 / 🌿 중급 / 🌳 심화)으로 레벨을 정해 둘 수 있어요.

막혔을 때

• 학생 화면에 "수업 방이 없거나 닫혀 있어요"가 뜨면 → 수업 방이 열려 있는지 보고, QR을 다시 보여 줘요.
• AI 버튼이 안 보이면 → 수업 링크로 들어왔는지, 그 방의 AI가 켜져 있는지, 🤖 AI 연결 상태가 괜찮은지 봐요.
• "요청이 몰려 있어요"가 뜨면 → 반 전체가 동시에 누른 거예요. 잠시 뒤 다시 누르면 돼요(앱이 자동으로 다시 보내기도 해요).

5. 수업 뒤

• 결과물 보기 — 📋 기록 보기 → 📝 낸 글에 반·번호·종류·제목·내용·낸 때가 표로 나와요. 긴 글은 눌러서 펼쳐요. 작문은 AI로 다듬었으면 다듬기 전 학생 글도 함께 와요. 신문의 AI 초안 기사는 "AI 초안을 고쳐 씀"으로 표시돼요.
• 게임·연습 점수 — 🎮 게임 점수에 게임방·문법 퀴즈·회화 대화 완성·역할극 목표 수가 모여요. 세특 자료와 따로 저장돼요.
• 답장 — 이 과목은 답장 기능이 없어요.
• CSV 내려받기 — 📥 지금 보는 표 CSV로 내려받기. 엑셀로 열려요.
• 세특 초안 — 이 과목은 세특 초안 기능이 없어요.
• 학년말 기록 정리는 EAIM 공통 기능이 생기면 교사 페이지에 들어가요. 그 전에는 수업 방마다 CSV로 내려받아 두세요.

6. 앱별 사용법

저장소의 활동 정보(activities.json)를 읽어 보여 줘요. 누구나 로그인 없이 연습 · 수업 QR 수업 방으로만 · AI 수업에서 AI 사용.

7. 선생님 도구

📝 지도안

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

1. 왼쪽에서 성취기준을 골라요. 이해(듣기·읽기)·표현(말하기·쓰기)으로 묶여 있어요.
2. 활동 앱에서 수업에 쓸 앱을 골라요(회화 카드 8개, 작문 장르 9개, 놀이터·영시·신문). 활동 칸에 그 앱의 실제 단계가 들어가요.
3. 일시, 장소, 대상, 차시, 수업 시간(분)을 적어요. 시간을 바꾸면 단계별 분이 다시 나뉘어요.
4. 표 안의 글은 눌러서 바로 고쳐요. 다 고친 뒤 🖨️ 인쇄·PDF ⬇️ Word 파일(.doc) 📋 표째 복사로 가져가요. 색상은 초록·파랑·분홍·흑백.

지도안은 도구라서 앱 수에는 세지 않아요.

8. 안전과 개인정보

• 반·번호만 — 학생은 가입·비밀번호 없이 반·번호(와 성 한 글자)만 적어요. 기록에도 그것만 남아요.
• 이름 쓰지 않기 — AI에게 보내는 글 칸마다 "🔒 이름 쓰지 않기" 안내가 있어요. 편지 받는 사람도 "my friend"처럼 써요. AI 역할극에서는 학생에게 지어낸 역할 이름을 줘요.
• 마이크 — 회화 방 🎤 따라 말하기는 처음 켤 때 안내 창이 떠요: 목소리는 글자로 바꾸려고 구글 서버로 보내지고, 이 앱에는 저장되지 않아요. 이름이나 개인적인 이야기는 말하지 않아요.
• 사진 — 신문 그림은 내가 찍은 사진·그림이나 AI 그림만 써요. 친구 얼굴이 나온 사진은 올리지 않아요. 외부 그림 검색은 없어요.
• AI 대화 — 역할극·자유 대화 내용은 저장하지 않아요. 선생님께는 역할극 목표를 몇 개 해냈는지만 가요.
• 연습 모드(QR 없이)는 기록이 선생님께 가지 않아요. 예전 영어 앱이 기기에 남긴 이름·키는 새 앱을 처음 열 때 지워져요.

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

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

Firebase 콘솔 → Authentication → 승인된 도메인에 이 사이트 주소(eaim-english.vercel.app)가 있는지 확인해요.

🤖 AI 연결 상태가 안 좋다고 나와요.

"웹사이트 제한"이라고 나오면 제한 없는 키로 바꿔요. "키가 없어요"면 🔑 AI 설정에 키를 넣어요. "허용되지 않은 주소"면 Vercel 환경변수 ALLOWED_ORIGINS에 이 주소가 있는지 봐요.

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

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

"수업이 닫혔어요"가 떠요.

교사 페이지에서 ▶ 다시 열기를 눌러요.

🎤 따라 말하기가 안 돼요.

크롬·엣지에서 돼요. 주소창 옆 🔒에서 마이크를 허용해요. 조용한 곳에서 또박또박 말하게 해요. 인식이 틀릴 수도 있어요 — 점수가 아니라 연습용이에요.

리리아 음악이 안 만들어져요.

수업 방의 AI가 켜져 있어야 해요. 반 전체가 동시에 만들면 기다렸다가 다시 보내요(20~40초).

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

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

내용(단어 뜻·예문·영시)이 이상해요.

저장소 밖의 검토표(놀이터·게임방·회화·문법·영시)에 번호가 붙어 있어요. 번호로 알려 주시면 고쳐요.

10. 수업 예시

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

1. 들어가기

1. 선생님이 보여 주는 QR을 휴대폰이나 태블릿으로 찍어요.
2. 반과 번호를 적어요. 성 한 글자는 적지 않아도 돼요. 이름은 적지 않아요.
3. 🚀 들어가기를 눌러요. 화면 위에 내 반·번호가 보여요.

집에서 연습할 때는 첫 화면에서 앱을 바로 눌러요. 로그인은 필요 없어요(놀이터·게임방·회화 방·문법 탐구실). 영시·작문·신문은 수업 QR로만 들어가요.

2. 활동하기

• 화면 위의 Step 순서대로 차근차근 해요.
• 🔊 버튼으로 영어를 듣고 따라 말해 봐요. 🐌 천천히도 있어요.
• 정답이 있는 문제는 틀려도 괜찮아요. 풀이를 읽고 다시 해 봐요.
• 🤖 AI 도움은 수업 시간에만 보여요. AI 답도 틀릴 수 있으니 꼭 읽어 보고 내 말로 고쳐 써요.

3. 선생님께 내기

1. 다 하면 아래의 📤 … 선생님께 내기를 눌러요(앱마다 "완성한 글 선생님께 내기"처럼 이름이 조금 달라요).
2. "✅ 선생님께 냈어요!"가 뜨면 끝이에요. 고친 뒤 다시 내도 돼요.
3. "수업이 닫혀 있어서 낼 수 없어요"가 뜨면 선생님께 말씀드려요.
4. 게임방·문법 퀴즈·회화 연습은 따로 누르지 않아도 점수가 선생님께 가요(수업 QR로 들어왔을 때).

4. 우리의 약속

• 🔒 내 이름, 친구 이름, 학교 이름은 쓰지도 말하지도 않아요. AI 역할극에서는 화면에 나온 역할 이름을 써요.
• 🤝 친구의 글과 생각을 존중해요. 친구 얼굴 사진은 올리지 않아요.
• 💬 힘들거나 걱정되는 일이 있으면 선생님이나 믿을 만한 어른께 이야기해요. 청소년 상담은 1388이에요.