1. 한눈에 보기

EAIM 기술·가정 수업은 학생의 생활과 마음에서 출발해요. 나의 하루 식탁, 내 방, 우리 동네의 불편함을 떠올리며 마음을 열고, 앱에서 개념을 탐구하고 적용해 보고, 식단·설계도·한복·제안서 같은 결과물을 창작하고, 친구와 나누고, 선생님께 내어 기록해요. 앱은 기술·가정 ①·② 교과서 순서대로 놓여 있고, 앱마다 2022 개정 교육과정 성취기준이 이어져 있어요. 성취기준 52개 가운데 51개가 앱에 바로 이어지고, 나머지([9기가01-02])는 지도안에서 가까운 앱으로 이어져요.

공개 앱(로그인 없이 누구나): 첫 화면 카드를 누르면 바로 열려요. 쓴 내용은 그 기기에만 잠깐 남고 창을 닫으면 사라져요. 수업 QR로 들어오면 같은 앱에 선생님께 내기 버튼이 생겨 결과가 교사 페이지로 모여요.

수업 전용 앱(선생님이 연 수업 QR로만 들어옴): …. 가족 이야기가 담겨 있어서예요.

AI가 들어간 곳: 학생 화면에는 AI가 없어요. AI는 교사 페이지의 ✍️ 세특 초안에만 있어요(5번).

2. 처음 한 번만 하는 설정

구글 로그인

1. 첫 화면 선생님 줄의 👩‍🏫 교사 페이지(teacher.html)를 열고 구글로 로그인을 눌러요. 계정 고르는 창이 나와요.
2. 기술·가정은 교사 페이지 하나에서 모든 활동의 수업 방을 만들고 결과를 봐요.
3. 브라우저를 닫으면 자동으로 로그아웃돼요(공용 PC 보호). 팝업이 막혀 있으면 로그인 화면으로 넘어갔다가 돌아와요.
4. 처음 쓰는 사이트 주소라면 Firebase 콘솔 → Authentication → 승인된 도메인에 이 주소(eaim-home-tech.vercel.app)가 있어야 로그인이 돼요.

AI 키

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

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

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

3. 수업 방 만들기

교사 페이지에서 활동마다 수업 방을 만들어요. 수업 방마다 QR과 링크가 따로 생겨요.

1. 활동을 골라요. 기술·가정 ①·② 교과서별로 묶여 있어요.
2. 수업 이름을 적어요. 예: 2학년 균형 잡힌 식사 계획.
3. 반 목록 (쉼표로)에 반 이름을 적어요. 예: 2-1, 2-2, 2-3. 학생이 입장할 때 이 목록에서 골라요. 비워 두면 학생이 반을 직접 적어요.
4. 수업 방 만들기를 누르면 아래 목록에 수업 방이 생겨요.
5. QR 크게 보기로 칠판 화면에 QR을 띄워요. 학생이 휴대폰·태블릿으로 찍어요. 링크 복사로 학급 게시판·메신저에 붙여 넣을 수도 있어요.
6. 수업이 끝나면 수업 닫기를 눌러요. 닫으면 학생이 더 이상 낼 수 없어요. 다음 시간에 수업 열기를 누르면 같은 QR을 써요.

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

공개 앱은 수업 방 없이도 쓸 수 있어요. 첫 화면 주소나 앱 주소를 알려 주면 바로 열려요(기록 없음).

4. 수업 중

• 학생 현황 — 수업 방 카드의 학생 결과물 보기를 누르면 지금까지 낸 학생이 반·번호 순으로 나와요.
• 실시간 활동 — 이 과목은 실시간 화면이 없어요. 학생 결과물 보기를 다시 누르면 새로 불러와요.
• 조리 실습 도우미는 모둠 태블릿 한 대로 켜 두고 써요. 타이머가 끝나면 소리와 알림이 나요.
• 마이 바이브 런웨이는 수업 방 카드의 🎵 런웨이 음악으로 선생님 곡을 올려 둘 수 있어요.

막혔을 때

• 학생 화면에 "수업이 닫혀 있어요" → 교사 페이지에서 수업 열기를 눌러요.
• 학생 화면에 선생님께 내기가 없어요 → 첫 화면에서 들어온 연습 모드예요. QR이나 복사한 링크로 다시 들어오게 해요.
• 반 목록이 비어 있어요 → 수업 방을 만들 때 반 목록을 적어요. 목록이 없으면 학생이 반을 직접 적어요.

5. 수업 뒤

• 결과물 보기 — 학생 결과물 보기에서 반·번호·제목·내용·낸 시각을 표로 봐요. 여러 활동에 인쇄하기가 있어 활동지로도 모을 수 있어요.
• 답장 — 답장 칸이 있는 활동(마이 바이브 런웨이 등)은 표에서 바로 써서 답장 보내기를 눌러요. 학생 화면에 보여요.
• CSV 내려받기 — CSV 내려받기로 엑셀에서 여는 파일을 받아요. 답장과 세특 초안 칸도 함께 나와요.
• 세특 초안 — 결과물 표 오른쪽 세특 초안 칸에서 ✍️ 초안을 누르거나 위의 빈 칸 모두 만들기로 차례로 만들어요(■ 멈추기 가능). 꼭 읽고 고친 뒤 저장해요.
• 퀴즈 게임방 수업 방은 같은 버튼이 점수 표(점수·정답 수·틀린 문제)를 보여 줘요. 게임 점수는 세특 자료와 따로 저장돼요.

6. 앱별 사용법

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

7. 선생님 도구

📝 지도안 만들기

첫 화면 선생님 줄이나 교사 페이지 머리의 📝 지도안 만들기로 열어요.

1. 왼쪽에서 성취기준을 골라요. ①·② 교과서, 가정·기술 영역으로 묶여 있어요.
2. 이어진 활동이 여러 개면 수업에 쓸 앱을 골라요. 전개 활동 칸에 그 앱의 실제 화면 단계가 들어가요.
3. 일시·장소·대상·지도교사·차시·수업 시간(분)을 적어요. 오른쪽에 본시 교수·학습 과정안이 채워져요(핵심 아이디어·성취기준·해설·학습 목표·탐구 질문·교수·학습 방법·수업 자료·수업 설계 의도·도입/전개/정리와 평가·피드백·맞춤형 전략). 성·폭력·중독·가족 주제는 유의 사항, 실습 주제는 실습 안전 칸이 저절로 들어가요.
4. 핵심 아이디어는 체크로 바꾸고, 표 안의 글은 눌러서 바로 고쳐요. 색상(초록·파랑·분홍·흑백)도 골라요.
5. 🖨️ 인쇄·PDF, ⬇️ Word 파일(.doc), 📋 표째 복사(한글·워드에 붙여 넣기)로 가져가요.

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

8. 안전과 개인정보

• 학생은 반·번호로 들어와요. 이름은 적지 않아도 되고, 성 한 글자만 적을 수 있어요. 이름 원문은 저장하지 않아요.
• 글쓰기 칸마다 "이름이나 다른 사람을 알아볼 수 있는 이야기는 쓰지 않아요"가 붙어 있어요. 수업 시작 때 한 번 함께 읽어 주세요.
• 공개 앱은 아무것도 저장하지 않아요. 퀴즈 게임방 최고 점수만 그 기기에 남아요.
• 카메라·마이크를 쓰는 앱은 없어요. 음악과 타이머 소리는 기기 스피커로만 나요.
• 학생 자신의 경험을 묻지 않아요. 성·폭력·중독·관계 단원은 지어낸 장면과 보기 고르기로 배워요. 마음 이야기(힘든 까닭, 하루 시간 저울, 소비 모습 등)는 그 기기에만 남고 선생님께 가지 않아요.
• 🐾 도움받는 곳(1388·1366·117·112·1372 등)을 늘 볼 수 있고, 위험한 낱말을 쓰면 도움 안내가 떠요. 키·몸무게를 묻지 않고, 성별을 비교하지 않고, 비밀 보장을 단정하지 않아요.

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

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

Firebase 콘솔 → Authentication → 승인된 도메인에 eaim-home-tech.vercel.app 가 있는지 확인해요.

세특 초안을 누르면 "api/ai.js …"라고 나와요

AI 중계 함수가 아직 없어요. 에임 케어 저장소의 api/ai.js 를 그대로 복사해 올리고, Vercel 환경변수를 넣은 뒤 다시 배포해요. "이 주소에서는 AI를 쓸 수 없어요"는 ALLOWED_ORIGINS 를 확인해요.

학생이 창을 닫았더니 쓴 게 사라졌어요

개인정보를 남기지 않으려고 창을 닫으면 지워지게 했어요. 낼 활동은 선생님께 내기를 먼저 누르도록 안내해 주세요.

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

첫 화면 ①·② 탭이 교과서 순서예요. 단원마다 카드에 성취기준이 적혀 있어요. 지도안 만들기에서도 성취기준으로 찾아요.

내용이 교과서와 달라요

저장소의 검토표(home-tech-review.md)에 활동마다 숫자·문장이 정리되어 있어요. 고칠 곳을 알려 주세요.

10. 수업 예시

한 차시 — 균형 식탁 (45분)

1. 도입(5분): 어제 먹은 음식을 떠올리고, 탐구 질문 "균형 잡힌 식사는 어떻게 계획할까?"를 칠판에 적어요.
2. 전개 1(11분): 수업 QR로 들어가 누구의 하루 식탁인지 고르고, 6가지 식품군 카드로 하루 식탁을 차려요.
3. 전개 2(12분): 식품 바퀴로 모자란 식품군을 찾아 바꾸고, 짝과 까닭을 설명해요.
4. 전개 3(12분): 지속가능한 식탁 점검을 하고 식탁을 완성해 선생님께 내기.
5. 정리(5분): 🎮 퀴즈 게임방 「가정 ②」 5문제로 점검하고 탐구 질문에 한 문장으로 답해요.

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

여러 차시 — 한 끼를 계획하고 만들기 (5차시)

1. 1차시: 균형 식탁 — 식품군과 식사 구성으로 하루 식탁 계획.
2. 2차시: 식품 표시 탐정 — 영양 정보·원재료·소비기한 읽기.
3. 3차시: 우리 가족 한 끼 — 지어낸 가족의 요구에 맞춘 저녁 계획.
4. 4차시: 조리 실습 도우미 — 모둠 태블릿으로 역할·재료 계산·타이머·위생 점검.
5. 5차시: 초록 식탁 융합 프로젝트 — 과학·사회·도덕·국어로 넓혀 "초록 한 끼" 제안서.

여러 차시 — 기술적 문제 해결 (4차시)

1. 문제 해결 설계 노트(2차시) → 발명 기법 놀이터 → 지식 재산 지킴이, 이어서 제작 공방으로 실제 제작.