🏫 쌤버스

1. 교사가 교사용 대시보드에서 수업 코드를 만들고, 맵·구역별로 미션을 설정합니다.
2. 대시보드의 "🔗 학생 초대 링크" 버튼으로 맵별 링크와 QR 코드를 학생에게 공유합니다.
3. 학생은 링크 접속 또는 QR 스캔 → 캐릭터를 만들고 닉네임 입력 후 맵에 입장합니다.
4. 캐릭터를 이동하다 구역(zone)에 진입하거나 특정 가구 위치를 밟으면 미션이 자동으로 열립니다.
5. 미션을 완료할수록 우상단 진행률 배지(🎯 미션 진행률 N / 전체)가 올라갑니다.
6. 필수 미션을 모두 마치면 출입구를 통해 다음 맵으로 자동 이동합니다.

1. 접속 코드 입력 → "수업 선택" 화면. 이전 수업 목록(최대 10개)에서 "이 수업 계속하기"로 바로 이어서 관리. "+ 새 수업 만들기"로 새 수업 생성.
2. 각 수업 항목에서 ✏️ 버튼으로 수업 이름(예: "3학년 2반") 추가 가능. ✕ 버튼은 목록에서만 제거(실제 미션 데이터는 유지).
3. 상단 맵 탭(일반교실/도서관/운동장/체육관/현대도시/자연숲)으로 맵 전환.
4. 각 맵의 구역(zone_A~H)별로 미션 추가·수정·삭제. 미션 타입은 8가지 중 선택 (아래 7번 항목 참고).
5. 미션 등록 전에는 데모 미션이 학생에게 표시됩니다.
6. 상단 도구 버튼: 🪑 맵 에디터 · ✨ AI 자동문제 생성 · 🔗 학생 초대 링크 · 💬 채팅 모드 · 🚫 채팅 금지 · 🏆 완료 순위 · 📊 진행현황 다운로드 · 🚪 맵 이동 순서 · 🗺️ 실시간 맵 보기 · 🧑‍🏫 맵 참가하기

1. 대시보드 상단 "🔗 학생 초대 링크" 버튼 → 팝업이 열리면서 시작 맵의 QR 코드가 즉시 표시됩니다.
2. "⛶ 전체화면으로 보기" 버튼으로 빔프로젝터·모니터에 QR을 크게 띄울 수 있습니다. ESC 키로 닫기.
3. "PNG 다운로드"로 QR 이미지 저장 → 원격 수업 시 학습 플랫폼에 첨부 가능.
4. 상단 헤더의 수업코드 옆 "복사" 버튼으로 수업코드를 클립보드에 복사할 수 있습니다.

• QR 스캔 또는 공유된 링크로 접속합니다.
• 처음 접속한 학생은 자동으로 "캐릭터 만들기" 화면으로 이동. 교복/교사/판타지 탭에서 캐릭터를 꾸민 뒤 "이 캐릭터로 입장하기"를 누르면 맵으로 입장.
• 한 번 만든 캐릭터는 같은 기기·브라우저에서는 다시 설정 없이 바로 입장.
• PC/크롬북은 방향키, 모바일/태블릿은 화면 버튼 또는 스와이프로 이동.
• 같은 수업 코드로 입장한 다른 학생 캐릭터가 실시간으로 함께 표시됩니다.

각 맵은 8개 구역(zone_A~H)으로 나뉩니다. 캐릭터가 구역에 진입하거나, 교사가 지정한 특정 타일을 밟으면 미션이 자동으로 열립니다.

• 미완료 미션만 표시됩니다. 이미 완료한 구역은 다시 진입해도 열리지 않습니다.
• 완료 시 우상단 진행률(🎯 N / 전체) 업데이트.
• 맵의 필수 미션 전체 완료 → 색종이 효과 + 완료 팝업. 마지막 맵이면 소감 입력란도 함께 표시됩니다.
• 필수 미션을 모두 마쳐야 출입구를 통해 다음 맵으로 이동할 수 있습니다.

대시보드 상단 "🪑 맵 에디터" 버튼을 누르면 맵별로 가구를 자유롭게 배치할 수 있는 에디터가 열립니다.

• 상단 탭으로 맵 전환 (일반교실/도서관/운동장/체육관/현대도시/자연숲).
• 맵마다 어울리는 가구 팔레트가 자동으로 바뀝니다:

• 배치: 팔레트에서 가구 선택 후 캔버스에서 좌클릭·드래그로 배치 (보행 가능 타일에만 허용).
• 삭제: 지우개 선택 또는 우클릭으로 제거.
• 배치된 가구는 학생이 지나갈 수 없는 장애물로 자동 처리됩니다.
• 💾 저장 버튼 클릭 시 현재 수업에 저장. 학생 맵에 픽셀 아트 스타일로 표시됩니다.
• 📂 이전 수업 불러오기: 이전에 만든 다른 수업의 가구 배치를 현재 수업에 그대로 가져올 수 있습니다. 불러온 후 💾 저장 버튼을 눌러야 반영됩니다.

수업 자료 PDF를 업로드하면 AI(Groq · Qwen3-32B)가 자동으로 미션을 생성해줍니다.

1. 대시보드 상단 "📄 PDF로 미션 생성" 버튼 클릭.
2. PDF 파일 선택, 추출 페이지 범위와 생성할 미션 수(5~10개) 설정.
3. 미션 타입(객관식 퀴즈 / 주관식 단답 / 토론 등)을 선택하고 "미션 생성" 클릭.
4. AI가 수초~수십초 내에 미션 초안을 카드 형태로 표시합니다. 각 카드의 ✕ 버튼으로 맘에 들지 않는 문제를 제외할 수 있습니다.
5. 남은 카드를 검토한 뒤 구역을 선택하고 "저장"을 누르면 현재 맵·구역에 등록됩니다.

대시보드 상단 채팅 모드 버튼을 클릭할 때마다 모드가 순환 전환되며, 변경 즉시 모든 학생에게 실시간 반영됩니다.

대시보드 상단 "🚪 맵 이동 순서" 버튼 → 6개 맵의 진행 순서를 ▲▼로 정렬해 저장할 수 있습니다. 각 맵 옆에 "✅ 미션 있음 / ⚪ 미션 없음"이 표시됩니다.

1. 학생이 현재 맵의 필수 미션을 모두 완료하고 출입구(문/게이트) 칸으로 이동하면 → 설정 순서상 다음 미션이 있는 맵으로 자동 이동합니다.
2. 미션이 없는 맵(데모 미션만)은 자동 이동 대상에서 제외됩니다.
3. 필수 미션이 남아있는 상태에서 출입구를 통과하려 하면 "🔒 미션을 모두 완료해야 출입구를 통과할 수 있어요!" 안내가 표시됩니다.

대시보드 상단 "🗺️ 실시간 맵 보기" 버튼 → 선택한 맵 전체를 한 화면에서 볼 수 있는 관전 창이 열립니다.

• 상단 탭으로 보고 싶은 맵 전환.
• 입장한 학생들의 캐릭터가 실시간으로 이동하는 모습이 표시됩니다. (직접 조작 불가, 관전 전용)
• 우상단에 현재 맵 접속 인원("접속 인원: N명") 표시.
• 학생들의 말풍선 채팅도 이 창에서 실시간으로 확인할 수 있습니다.

대시보드 상단 "🧑‍🏫 맵 참가하기" 버튼 → 맵 선택 → 새 탭에서 해당 맵 열림.

• 처음 입장 시 캐릭터 선택 화면에서 "교사" 탭으로 교사용 캐릭터 선택.
• 학생들과 동일하게 이동·채팅하며 함께 활동 가능.
• "🗺️ 실시간 맵 보기"(관전)와 달리 직접 조작 가능한 참가자 모드입니다.

대시보드 상단 "📊 진행현황 다운로드" 버튼 → 학생별·미션별 완료 여부를 정리한 엑셀 파일(.xlsx)이 다운로드됩니다.

다운로드 파일에는 최대 4개 시트가 포함됩니다:

캐릭터 만들기 페이지에서 3종류의 캐릭터를 꾸밀 수 있습니다.

• PC / 크롬북: 키보드 방향키(↑↓←→)
• 모바일 / 태블릿: 화면 하단 방향 버튼 또는 화면 스와이프(상/하/좌/우)
• 캐릭터는 한 타일씩 부드럽게 슬라이드로 이동합니다. (맵 카메라도 함께 따라옴)
• 다른 학생이 점유한 타일로는 이동할 수 없습니다. (충돌 방지)
• 가구가 배치된 타일도 이동 불가 장애물로 처리됩니다.