1. 한눈에 보기

에임 케어는 창의적 체험활동(창체)과 다문화 학생의 한국어를 위한 곳이에요. 마음 트랙에서는 오늘의 감정과 관계를 들여다보고, 뾰족한 말을 동그랗게 바꿔 보고, 친구와 나누고, 성찰로 기록해요. 한국어 트랙에서는 한글 자모부터 문장·글쓰기까지 이어 가요. EAIM의 감성·예술적 환경·상호작용·음악화가 활동 곳곳에 들어 있어요(가족 갈등을 가사로, 런웨이를 음악과 함께).

공개 앱(로그인 없이 누구나 연습): …. 연습한 내용은 어디에도 저장되지 않아요. 선생님께 보내기와 답장은 수업 QR로 들어왔을 때만 돼요.

수업 전용 앱(선생님이 연 수업 방 QR로만 들어옴): …. 감정·가족 이야기를 다루거나 선생님 진행 화면이 필요한 앱이에요.

AI: 학생 화면에는 AI가 없어요. AI는 선생님 답장 화면의 AI 초안 받기와 🔊 AI 목소리도 붙이기 두 곳뿐이고, 선생님이 누를 때만 서버(중계 함수)를 거쳐 불러요.

2. 처음 한 번만 하는 설정

구글 로그인

1. 첫 화면의 선생님 페이지(교사 페이지 teacher.html)를 열고 구글 계정으로 시작하기를 눌러요. 계정 고르는 창이 나와요.
2. 브라우저를 닫으면 자동으로 로그아웃돼요(공용 PC 보호). 팝업이 막혀 있으면 로그인 화면으로 넘어갔다가 돌아와요.
3. 처음 쓰는 사이트 주소라면 Firebase 콘솔 → Authentication → 승인된 도메인에 이 주소(eaim-care.vercel.app)가 있어야 로그인이 돼요.

AI 키 (답장 초안·AI 목소리를 쓸 때만)

1. Google AI Studio(또는 구글 클라우드 콘솔)에서 새 API 키를 만들어요. API 제한(Generative Language API만) + 하루 한도만 걸고, 웹사이트 제한은 걸지 않아요 — 서버에서 부를 때 막혀요.
2. 교사 페이지 🔑 AI 설정 칸에 붙여 넣고 💾 저장을 눌러요. 위에 🔑 저장됨 · ••••끝 네 자리가 보이면 된 거예요. 30초쯤 뒤 🤖 AI 연결 상태로 확인해요. 운영자 명단에 있는 선생님은 키를 넣지 않아도 돼요.
3. 키는 선생님 전용 금고에 들어가요. 선생님 본인과 서버(AI 중계 함수)만 다루고, 학생 기기로 내려가지 않아요. 화면에는 끝 네 자리만 보이고 칸은 늘 빈칸이에요. 바꾸려면 새 키를 저장, 그만 쓰려면 지우기.
4. 예전에 넣어 둔 키는 교사 페이지에 로그인하면 금고로 저절로 옮겨져요. 금고는 같은 구글 계정으로 쓰는 다른 EAIM 교과 교사 화면과 함께 쓰는 한 자리예요.
5. 저장소 관리자는 처음 한 번 저장소에 api/ai.js(v0.6 이상), Vercel 환경변수 FIREBASE_SERVICE_ACCOUNT(키 금고 연결, 꼭 필요)·GEMINI_KEY·ALLOWED_TEACHERS를 넣고 다시 배포해요.

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

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

3. 수업 방 만들기

1. 교사 페이지 🏫 수업 방 만들기에서 앱을 골라요. 수업 전용 표시가 있는 앱은 수업 QR로만 들어올 수 있어요.
2. 수업 이름(예: 2-3 감정 스토리)과 활동 방식(개인별·모둠별·반 전체)을 정하고 수업 방 열기를 눌러요.
3. 📋 내 수업 방에서 QR 보기를 눌러 칠판 화면에 띄우거나, 링크 복사로 학급 게시판·메신저에 붙여요. 반마다 방을 따로 열면 기록이 반별로 모여요.
4. 수업이 끝나면 수업 닫기. 닫히면 학생은 더 보낼 수 없어요. 다음 시간에 다시 열기로 같은 QR을 써요(라이프 액션Q 돌아보기처럼 이어지는 활동).

학생은 학년·반·번호만 적고 들어와요. 성 한 글자는 쓰지 않아도 되고, 쓰면 "김**"처럼 보여요.

공개 앱은 수업 방이 없어도 첫 화면에서 바로 열려요(저장 없음).

4. 수업 중

• 학생 현황 — 교사 페이지 수업 방의 기록 보기에서 들어온 학생 수와 보낸 기록을 봐요.
• 실시간 활동 — 한국어 놀이터·한글 놀이터·마이 바이브 런웨이는 답장 화면(live.html)에 학생 글이 보내는 대로 바로 올라와요.
• 우리 반 마음 맞히기 — 진행 화면(feel-guess-host.html)에서 수업 방을 고르고 새 게임 준비 → 학생 입장 → 1번 문제 시작 → 학생들이 보내면 우리 반 마음 공개 → 다음 문제. 전자 칠판에 띄워 두면 좋아요.

막혔을 때

• "수업 방을 찾지 못했어요" → QR·링크가 맞는지, "아직 수업이 열리지 않았어요" → 다시 열기를 눌렀는지 봐요.
• "선생님이 수업을 닫았어요" → 수업 중에 닫혔어요. 다시 열면 학생이 새로고침하고 보내면 돼요.
• 🔊 소리가 안 나요 → 카카오톡 같은 앱 안에서 열면 소리가 안 날 수 있어요. 크롬·사파리로 열게 해 주세요.

5. 수업 뒤

• 결과물 보기 — 기록 보기에서 학생별로 읽어요(반·번호·표시 이름·종류·내용).
• 답장 — 답장 화면에서 수업 방을 고르고 학생 글마다 답장을 써서 답장 보내기. AI 초안 받기는 초안일 뿐이라 꼭 읽고 고쳐 보내요. 🔊 AI 목소리도 붙이기를 켜면 답장을 AI 목소리로도 만들어 저장해 두고, 학생은 몇 번이고 다시 들어요(한국어 트랙은 기본 켜짐). 감정·가족 글(마음 트랙 성찰 기록)에는 답장 칸이 없어요.
• CSV 내려받기 — 수업 방마다 CSV 내려받기(반·번호·표시 이름·앱·종류·제목·내용·선생님 답장·시간). 엑셀에서 열어요.
• 세특 초안 — 이 과목은 세특 초안 기능이 없어요. 창체 특기사항·행동특성 기록은 CSV와 지도안의 기록 관점을 참고해 선생님이 써요.

6. 앱별 사용법

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

🌳 진로로 이어 가기 (한국어 트랙 다음 걸음)

첫 화면 한국어 트랙 아래에 진로 「다문화 성장 프로젝트」로 가는 카드 네 개가 있어요 — 🌱 강점 보물지도(뿌리) · 🧭 강점과 이어지는 직업(줄기) · 💡 성장 창업 아이디어(가지) · 🍎 진로 경로와 성장나무(열매). 진로 앱이 쉬운 말과 🔊 읽어 주기로 그 차시를 바로 열어요.

• 케어의 학생 정보(이름·나라·가족·한국어 수준)는 넘어가지 않아요. 링크만 이어요. 진로 쪽도 나라·가족·사는 곳을 묻지 않고 AI가 없어요.
• 기록은 진로 앱 쪽에 남아요(로그인 없이 하면 그 기기에만, 수업이면 진로 선생님께 내기).
• 수업으로 할 때는 진로 선생님 페이지에서 만든 수업 QR 주소 뒤에 &easy=1 을 붙이면 쉬운 말로 열려요(예: …/multi-growth.html?code=ABCD&easy=1).
• 창체로는 진로 활동 · 진로 탐색 활동(자아탐색·정보탐색)이에요.

7. 선생님 도구

📝 지도안 만들기

첫 화면이나 교사 페이지의 📝 지도안 만들기에서 열어요.

1. 왼쪽에서 활동(앱)을 골라요. 창체 영역·활동별로 묶여 있어요. 일시·장소·대상·지도교사·차시를 적어요(여러 차시 앱은 차시 번호에 따라 흐름이 바뀌어요).
2. 오른쪽에 본시 교수·학습 과정안이 채워져요 — 핵심역량 · 영역·활동 · 활동 목표 · 중학교 운영 중점 · (한국어 성취 기준·연계 성취기준) · 학습 목표 · 탐구 질문 · 교수·학습 방법 · 수업 자료 · 수업 설계 의도 · 도입/전개/정리 · 평가 방법 · 기록 관점 · 배려할 점.
3. 핵심역량·운영 중점·한국어 성취 기준은 체크로 바꾸고, 표 안의 글은 눌러서 바로 고쳐요. 색상(초록·파랑·분홍·흑백)도 골라요.
4. 🖨️ 인쇄·PDF, ⬇️ Word 파일(.doc), 📋 표째 복사(한글·워드에 붙여 넣기)로 가져가요.

답장 화면 · 진행 화면

답장 화면은 5번, 진행 화면은 4번을 봐요. 교사 페이지 수업 방 카드에서 열려요.

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

8. 안전과 개인정보

• 학생은 학년·반·번호로 들어와요. 이름은 적지 않아도 되고, 적으면 성 한 글자만 남아요("김**"). 이름으로 기록을 찾지 않아요.
• 글쓰기 칸마다 "✋ 친구·가족 이름처럼 나를 알 수 있는 말은 쓰지 않아요"가 붙어 있어요. 수업 시작 때 한 번 함께 읽어 주세요.
• 감정·가족 글은 선생님만 봐요. 반 친구에게 공유되지 않아요. 우리 반 마음 맞히기 답에는 반·번호·이름이 남지 않아 누가 무엇을 골랐는지 드러나지 않아요.
• 힘든 마음 안내 — 감정 스토리에서 많이 가라앉은 마음을 고르면 "선생님이나 주변의 믿을 만한 어른에게 이야기해 보세요" 창이 떠요(막지 않음).
• 위험한 말은 저장하지 않아요 — 폭력·학대·학교폭력·자해로 보이는 말이 든 글은 선생님께 보내지지 않고, 담임·상담 선생님께 직접 이야기하도록, 청소년 상담전화 1388도 함께 안내해요. 학생이 "이런 창이 떴다"고 말하면 학교의 상담·보호 절차를 따라 주세요.
• 카메라·마이크를 쓰는 앱은 없어요. 🔊 읽어 주기는 기기의 브라우저 목소리로 소리를 내요(학생 문장을 다른 곳으로 보내지 않아요).
• 한국어 트랙은 출신 국가·체류 정보를 묻거나 적지 않아요.
• 학생 화면에는 AI가 없어요. 선생님이 AI 초안을 받을 때도 학생 이름은 보내지 않고 글 내용만 보내요.

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

성취기준이 왜 없어요?

창의적 체험활동 교육과정에는 성취기준이 없어요. 대신 학교가 영역·활동을 골라 설계해요. 케어 앱마다 창체 영역·활동·예시 활동과 중학교 운영 중점을 달아 두었고, 지도안에도 그대로 들어가요. 보건·진로와 직업과 이어 쓰고 싶을 때는 6번의 연계 성취기준을 보세요.

학생이 "이 글은 선생님께 보내지 않았어요"라는 창을 봤대요

글에 위험해 보이는 말이 들어 있을 때 뜨는 안내예요. 다른 뜻으로 쓴 말이면 그 말을 바꿔 다시 보내면 돼요. 걱정되는 경우라면 학생과 직접 이야기해 주세요.

학생이 답장을 못 받았대요

답장은 보낸 그 화면(같은 브라우저 창)에 나타나요. 창을 닫았다면 다음 시간에 새로 보낸 글부터 답장이 보여요. 선생님 쪽 기록 보기에서 답장이 붙었는지 확인할 수 있어요.

🤖에 "키 금고에 연결되지 않았어요"가 나와요

서버가 선생님 키 금고를 못 읽는 상태예요. 저장소 관리자가 Vercel 케어 프로젝트에 FIREBASE_SERVICE_ACCOUNT 환경변수를 넣고 다시 배포하면 돼요. 그 전에는 금고로 옮겨진 키를 못 찾아 "키가 없어요"라고 나올 수 있어요.

AI 목소리가 "준비 중"이래요

AI 목소리는 서버의 중계 함수가 음성을 지원하도록 업데이트된 뒤에 켜져요. 그 전에는 글 답장만 가고, 학생은 🔊 읽어 주기(브라우저 목소리)로 들어요.

공개 앱으로 한 연습도 기록이 남나요?

아니요. 공개로 연 앱은 아무것도 저장하지 않아요. 라이프 액션Q 티켓은 🖨️ 인쇄나 💾 이미지 저장으로 가져가요.

휴대폰에서 글씨가 작아요

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

10. 수업 예시

한 차시 — 동그란 말 연습 + 우리 반 마음 맞히기 (45분)

1. 도입(5분): 같은 뜻인데 듣기 좋은 말·싫은 말의 예를 나누고, 탐구 질문 "마음은 그대로 두고 말의 모양만 바꾸면 무엇이 달라질까?"를 칠판에 적어요.
2. 전개 1(15분): 동그란 말 연습에서 문제를 바꿔 쓰고 바꾼 말 확인하기로 점검해요.
3. 전개 2(15분): 우리 반 마음 맞히기 진행 화면으로 같은 상황에서 서로 다르게 느끼는 마음을 확인해요.
4. 전개 3(5분): 가장 의견이 갈린 상황을 두고 "왜 그렇게 느꼈을까" 이야기해요(원하는 사람만).
5. 정리(5분): 이번 주에 써 볼 동그란 말 한 문장을 정해요.

각 앱의 흐름은 📝 지도안 만들기에서 앱을 고르면 과정안으로 바로 나와요.

여러 차시 — 가족 프로젝트 (4차시)

1. 1~2차시: 패밀리 하모니 — 갈등 조각을 모아 동그란 말 가사로 바꾸고(1차시), 성찰 에세이를 완성해요(2차시).
2. 3차시: 라이프 액션Q — 가치(효·책임 등)를 골라 집에서 할 실천 티켓을 만들어요.
3. 4차시: 같은 수업 방을 다시 열기 → 학생이 "지난번 약속, 했나요?"에 답하고 나눠요.