1. 한눈에 보기

EAIM 국어 수업은 학생의 감정과 경험에서 출발해요. 시를 고를 때도, 글감을 찾을 때도 "오늘의 마음"을 먼저 묻고, 그 마음을 탐구하고(개념·연습), 나만의 글·시·신문으로 창작하고, 친구와 나누고, 성찰로 기록해요. 앱은 교과서 차례가 아니라 2022 개정 국어과 교육과정의 성취기준 순서로 짜여 있어서, 어느 출판사 교과서를 쓰시든 진도에 맞는 단원을 찾을 수 있어요.

공개 앱(로그인 없이 누구나): …. 기록이 남지 않아요. 계획지·점검표는 학생이 📋 복사나 ⬇️ 내려받기로 가져가요.

수업 전용 앱(선생님이 수업을 열어야 들어옴): …. 학생 기록이 선생님 화면에 모여요. 어휘 게임방은 둘 다 돼요 — 수업 링크 없이 열면 🎮 로그인 없이 게임하기로 기록 없이 놀 수 있어요.

AI가 들어간 곳: …. AI는 선생님이 연 수업 링크로 들어온 학생에게만 나오고, 서버(중계 함수)를 거쳐 불러요. 공개 연습실·문법 탐구실·속담 카드·낱말 창고는 AI를 쓰지 않아요.

교육과정과 이어 보려면 첫 화면의 영역별로 찾기에서 영역(듣기·말하기·읽기·쓰기·문법·문학·매체) → 성취기준 → 앱 단원·📝 지도안으로 바로 가요.

2. 처음 한 번만 하는 설정

구글 로그인

1. 수업 전용 앱(시 감상 & 창작·글쓰기 창작·국어 신문)을 열면 선생님 로그인 창이 나와요. 구글 계정으로 로그인을 눌러요. 계정 고르는 창이 나와요. 어휘 게임방은 게임 화면 위 👩‍🏫 선생님 버튼으로 로그인해요.
2. 국어는 따로 된 교사 페이지 없이, 이 네 앱 안에 교사 대시보드가 있어요. 로그인하면 그 앱의 교사 대시보드가 열려요.
3. 브라우저를 닫으면 자동으로 로그아웃돼요(공용 PC 보호). 팝업이 막혀 있으면 로그인 화면으로 넘어갔다가 돌아와요.
4. 처음 쓰는 사이트 주소라면 Firebase 콘솔 → Authentication → 승인된 도메인에 이 주소(eaim-korean-play.vercel.app)가 있어야 로그인이 돼요.

AI 키

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

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

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

3. 수업 방 만들기

국어는 아직 앱마다 교사 대시보드에서 수업을 여는 방식이에요(수업 방을 따로 만들지 않아요). 순서는 네 앱 모두 같아요 — 대시보드 아래 💡 사용 순서에도 적혀 있어요.

1. 교사 대시보드 ⚙️ 설정에서 🤖 AI 연결 상태가 "사용 가능"인지 확인해요.
2. 🏷️ 반/모둠 이름 관리 칸에 반이나 모둠 이름을 적고 추가를 눌러요. 예: 2-3, 3반 시창작반. 학생이 입장할 때 이 목록에서 골라요.
3. 🎓 수업 상태의 스위치를 켜서 수업 진행 중으로 바꿔요. 꺼져 있으면 학생 화면에 "🔒 선생님이 아직 수업을 열지 않았어요"가 떠요.
4. 학생 초대 링크의 QR을 칠판 화면에 띄워요. 학생이 휴대폰·태블릿으로 찍어요. 🔗 링크 복사로 학급 게시판·메신저에 붙여 넣을 수도 있어요.
5. 수업이 끝나면 스위치를 꺼서 수업 종료로 바꿔요. 다음 시간에 다시 켜면 같은 QR을 써요.

학생은 반(예: 1-3), 번호, 이름(선택)만 적고 들어와요. 이름은 첫 글자만 보여요("김**").

공개 앱은 수업을 열 필요가 없어요. 첫 화면 주소나, 영역별로 찾기의 단원 단추 주소(예: eaim-korean-speaking.html#u5 — 말하기·듣기실 ⑤ 면담)를 알려 주면 그 단원이 바로 열려요.

4. 수업 중

• 학생 현황 — 시·글쓰기는 교사 대시보드 📋 학생현황 탭에서 누가 들어왔는지, 몇 번째 단계(Step)인지, 감정·글자 수를 봐요.
• 실시간 활동 — 따로 된 실시간 화면은 없지만, 📋 학생현황은 학생이 단계를 옮길 때마다 저절로 바뀌어요. 탭 옆 숫자는 들어온 학생 수예요.
• 게임방 — 교사 대시보드 🎮 게임 화면으로를 누르면 선생님도 같이 게임하며 볼 수 있어요. 돌아올 때는 게임 화면의 👩‍🏫 대시보드.
• 신문 모둠 — 학생이 시·글쓰기에서 📰 신문으로 보내기를 누른 글은 신문 앱 Step 2의 📥 가져오기로 불러와요(반·번호로 찾음).

막혔을 때

• 학생 화면에 "🔒 선생님이 아직 수업을 열지 않았어요" → 🎓 수업 상태 스위치를 켜요.
• AI 버튼이 동작하지 않아요 → 🤖 AI 연결 상태를 봐요. 학생이 QR(수업 링크)이 아닌 첫 화면 주소로 들어오면 AI가 켜지지 않아요.
• 반 목록이 비어 있어요 → 🏷️ 반/모둠 이름 관리에서 추가해요. 목록이 없으면 학생이 반을 직접 적어요.

5. 수업 뒤

• 결과물 보기 — 학생은 마지막 단계에서 🖨️ 인쇄·💾 저장(파일 이름은 반-번호, 예: 1-3-7_시감상일지.txt)으로 가져가요. 공개 연습실의 계획지·점검표는 📋 복사·⬇️ 내려받기로 학급 게시판이나 활동지에 붙여요.
• 답장 — 이 과목은 학생 글에 답장하는 칸이 없어요.
• CSV 내려받기 — 시·글쓰기 교사 대시보드 📋 학생현황 → 📊 CSV 내보내기(반·번호·단계·감정·제목·글자 수). 🗑️ 초기화는 그 앱의 국어 기록만 지워요.
• 세특 초안 — 선택 기능이에요. 📊 구글시트 연동 (선택)에 선생님 구글 시트 주소를 넣으면 학생 활동이 시트로도 모이고, 시트 메뉴 📋 EAIM 도구 → 🤖 AI 생기부 참고 문구 생성으로 학생별 참고 문구 초안을 만들어요. 시트에는 이름 대신 "1-3 7번 김**" 같은 이름표만 가요.

구글시트 연동 준비 (선택)

1. 새 구글 시트를 만들고 확장 프로그램 → Apps Script를 열어요.
2. 저장소의 apps-script-code-v3.gs 내용을 붙여 넣고 저장해요.
3. 배포 → 새 배포 → 유형: 웹 앱, 액세스 권한을 모든 사용자로 하고 배포해요. 나온 웹 앱 주소를 복사해요.
4. 교사 대시보드 📊 구글시트 연동 (선택) 칸에 붙여 넣어요.
5. 시트를 다시 열면 메뉴에 📋 EAIM 도구가 생겨요. 🔑 Gemini API 키 설정에서 키를 한 번 넣고, 필요할 때 🤖 AI 생기부 참고 문구 생성을 눌러요. 초안은 선생님이 꼭 읽고 고쳐 써요.

6. 앱별 사용법

앱마다 같은 칸으로 적었어요: 무엇을 하나 · 수업 규모 · 순서 · 공개/수업 전용 · AI · 성취기준. 목록은 활동 목록(activities.json)에서 읽어서, 앱이 늘면 여기에도 저절로 나와요.

7. 선생님 도구

📝 지도안 만들기

첫 화면 선생님 줄의 📝 지도안 만들기, 또는 영역별로 찾기의 성취기준마다 있는 📝 지도안에서 열어요.

1. 왼쪽에서 성취기준을 고르고 일시·장소·대상·지도교사·차시를 적어요.
2. 오른쪽에 본시 교수·학습 과정안이 채워져요(핵심 아이디어·내용 요소·성취기준·학습 목표·탐구 질문·교수·학습 방법·수업 자료·수업 설계 의도·도입/전개/정리와 평가·피드백·맞춤형 전략). 활동은 그 성취기준의 EAIM 앱 단원에서 짜여요.
3. 핵심 아이디어·내용 요소는 체크로 바꾸고, 표 안의 글은 눌러서 바로 고쳐요. 색상(초록·파랑·분홍·흑백)도 골라요.
4. 🖨️ 인쇄·PDF, ⬇️ Word 파일(.doc), 📋 표째 복사(한글·워드에 붙여 넣기)로 가져가요.

🤖 AI 문제 세트 만들기 (어휘 게임방)

게임방 교사 대시보드에서 분류·문제 수·모양을 고르면 AI가 문제 글을 쓰고, 정답·보기는 앱의 어휘 목록에서 골라요. 선생님이 읽고 고친 뒤 🎯 수업에 내기(수업 학생 로비에 "📝 선생님 문제") 또는 🔗 링크·QR(누구나 그 세트만, 기록 없음)로 내요.

선생님 도구는 앱 수에 세지 않아요.

8. 안전과 개인정보

• 학생은 반·번호로 들어와요. 이름은 적지 않아도 되고, 적으면 첫 글자만 보여요. 이름 원문은 저장하지 않아요.
• AI에게 보내는 글쓰기 칸에는 "🔒 AI에게 보내는 글이에요. 내 이름이나 친구 이름은 쓰지 않아요"가 붙어 있어요. 수업 시작 때 한 번 함께 읽어 주세요.
• 공개 앱은 아무것도 저장하지 않아요. 퀴즈 최고 기록만 그 기기에 남아요.
• 카메라·마이크를 쓰는 앱은 없어요. 🔊 읽어 주기·낭독은 기기 스피커로만 소리를 내요.
• 정서 표현 글(쓰기 연습실 ⑤, 창작 노트)에는 "드러내고 싶지 않은 일은 쓰지 않아도 돼요"라고 안내해요. 언어폭력 단원(말하기·듣기실 ⑩)에는 선생님께 알리기와 117 신고 안내가 있어요.

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

교과서 단원과 어떻게 맞춰요?

앱은 성취기준 순서예요. 교과서 단원의 성취기준 코드를 보고 첫 화면 영역별로 찾기에서 같은 코드를 누르면 돼요. 교과서 작품은 수업에서 책으로 읽고, 앱의 도구(갈등 지도·해석 비교표·요약 도해 조직자 등)에 적용해요.

앱 안의 작품·지문은 어디서 왔어요?

연습 글은 모두 새로 쓴 글이에요. 문학 감상실의 시 원문은 1929년 이전에 발표된 작품만 싣고, 소설은 줄거리를 새로 써서 요약했어요. 설문 수치는 연습용으로 지어낸 것이라고 화면에 밝혀 두었어요.

학생이 쓴 계획지가 사라졌어요

공개 앱은 저장하지 않아요. 창을 닫기 전에 📋 복사나 ⬇️ 내려받기를 하도록 안내해 주세요.

AI를 끄고 수업하고 싶어요

공개 연습실만으로도 한 차시가 돼요. 시·글쓰기는 AI 추천이 첫 단계라 AI 없이는 진행이 어려워요 — AI 없이 글쓰기를 하려면 쓰기 연습실의 계획지와 공책을 함께 써요.

휴대폰에서 글씨가 작아요

브라우저의 글자 크기를 키우거나, 태블릿·크롬북을 권해요. 모든 화면은 휴대폰에서도 보이게 만들었어요.

10. 수업 예시

한 차시 — 말하기·듣기실 ⑤ 면담 (45분)

1. 도입(5분): 꿈꾸는 직업의 전문가를 만나면 무엇을 묻고 싶은지 나누고, 탐구 질문 "궁금한 사람에게서 원하는 이야기를 들으려면 어떻게 물어야 할까?"를 칠판에 적어요.
2. 전개 1(10분): 개념 탭으로 면담의 목적·유형·흐름·예절을 함께 읽어요.
3. 전개 2(12분): 짝과 "좋은 질문 고르기"·"추가 질문"·"어떤 면담일까?" 연습을 풀고 풀이로 까닭을 확인해요.
4. 전개 3(13분): 모둠별로 면담 계획서를 쓰고 📋 복사로 학급 게시판에 올려 서로 한 줄씩 의견을 남겨요.
5. 정리(5분): 퀴즈로 점검하고 탐구 질문에 한 문장으로 답해요.

이 흐름은 📝 지도안 만들기에서 [9국01-05]를 고르면 과정안으로 바로 나와요.

여러 차시 — 시에서 신문까지 (5차시)

1. 1~2차시: 시 감상 & 창작 — 오늘의 감정으로 시를 만나고 나만의 시를 써요. 마지막에 📰 신문으로 보내기.
2. 3차시: 문학 감상실 ① 운율·비유·상징과 ⑥ 개성적 발상으로 내 시의 표현을 다시 살펴요.
3. 4~5차시: 국어 신문 — 모둠이 📥 가져오기로 친구들의 시를 모아 신문을 엮고, 감상문과 낭독으로 나눠요.