궁궐 사람들 — 경복궁 현장체험학습 1인 1역 미션 앱 (우리 학교로 설치해 쓰는 템플릿)

궁궐 사람들은 경복궁·국립고궁박물관 현장체험학습에서 쓰는 1인 1역 미션 웹앱이에요. 서울 선유고등학교에서 2026년 10월 1학년 7개 반과 실제로 운영했어요. 학생 190여 명이 들어와 160명이 미션 세 개를 모두 마쳤고, 미션 일기가 499건 남았어요. 그 경험을 바탕으로 다른 학교에서도 쓸 수 있게 다시 만들었어요.

🔎 먼저 둘러보기

(교사 인증 후 열 수 있어요) 설치 없이 학생 · 담임 · 관리자 화면을 모두 둘러볼 수 있어요. 위쪽 막대에서 시각을 행사 전 · 현장 · 엔딩 열림으로 바꿔 보세요. 둘러보기판은 서버 없이 그 기기 안에서만 돌고, 담임 화면의 학생은 모두 예시예요.

🎒 학생은 이렇게 써요

1. 휴대폰으로 주소를 열고 입장 코드 + 반·번호·이름 + 숫자 4자리로 들어와요. 다른 휴대폰에서도 같은 값으로 이어 써요. (학교 구글 계정 로그인도 고를 수 있어요.)
2. 처음 들어오면 사용법 카드가 넘겨지며 하루 흐름을 알려 줘요.
3. 역할 14개의 편지와 미션을 읽어 보고 하나를 골라요. 반마다 역할별 정원이 있어서 먼저 정한 사람이 자리를 가져요.
4. 현장에서는 실제 경복궁 지도(오픈스트리트맵) 위 동선을 따라 궁 미션 두 개를 하고, 박물관에서 미션 하나를 해요. 사진은 고르자마자 올라가고, 일기는 쓰는 대로 저절로 저장돼요. 화면을 닫거나 다른 앱으로 넘어가도 한 번 더 저장해요. (실제 운영 때 "쓰다가 날아갔다"는 학생이 있어서 넣은 기능이에요.)
5. 엔딩 시각이 되면 엔딩을 보고, 인물에게 한마디와 오늘의 소감을 남겨요.
6. 같은 반 친구 3명까지 코드로 모이면 모두의 미션 장소를 가장 짧게 잇는 동선을 알려 주는 "함께 다니기"도 있어요.

🧑‍🏫 선생님은 이렇게 써요

• 담임: 맡은 반의 등록·역할·출석·미션·소감 현황(현장 시간에는 30초마다 새로 고침), 출석·종례 확인을 안 한 학생 명단, 학생별 사진·일기·소감, 응답 CSV(학생이 답할 때의 질문 문구가 함께 들어가 생기부 근거 정리에 바로 써요), 비밀번호 지우기, 학생으로 체험하기
• 관리자: 행사 날짜·시각, 반 수, 역할 정원, 입장 코드, 현장 수칙·개인정보 안내, 역할·편지·미션·엔딩 고치기(역할 끄기·새로 만들기), 담임 계정, 학년도 말 기록 지우기

기본 미션 42개는 실제 학생 응답 499건을 검수해서 한 번 더 고친 판이에요. "답이 한쪽으로 몰리는 질문", "현장에서 할 수 없던 미션"(예: 근정전 문이 닫혀 병풍을 못 본 경우)을 고쳤어요.

🛠️ 우리 학교에서 쓰려면

학교마다 따로 설치해요. 학생 사진과 글은 그 학교 계정에만 저장되고, 저나 다른 학교는 볼 수 없어요. 무료 요금제로 충분해요(200명 × 사진 3장 기준).

1. GitHub에서 저장소를 Use this template로 복사
2. Supabase(무료)에 프로젝트를 만들고 supabase/install.sql을 SQL Editor에 붙여 넣어 실행
3. Supabase에서 익명 로그인 켜기, 익명 로그인 한도 올리기
4. Vercel(무료)에 저장소를 연결하고 환경변수 두 개(주소·공개 키) 넣기
5. 앱 첫 화면에서 설치 코드로 관리자 만들기 → 날짜·반·역할 정하기

처음 한 번 30분~1시간쯤 걸려요. 단계마다 화면 문구까지 적은 설치 안내서(INSTALL.md)가 있고, Claude Code에서 "INSTALL.md대로 설치를 도와줘"라고 하면 함께 진행해요. 📦 저장소·설치 안내서(템플릿): https://github.com/bokduklee99-max/gunggwol-people-kit

🔒 개인정보와 보안

• 수집: 반·번호·이름, 고른 역할, 미션 사진과 글, 출석 시각. 이메일·전화번호는 받지 않아요(구글 로그인을 고르면 학교 계정 이메일).
• 기록은 본인·담임(맡은 반)·관리자만 봐요. 표는 직접 읽을 수 없게 막고, 모든 읽기·쓰기를 권한을 다시 확인하는 DB 함수로만 해요. 사진 보관함도 비공개예요.
• 비밀번호는 암호화해 저장하고, 학생은 5번 틀리면 15분 잠겨요. 선생님 로그인은 12시간 뒤 저절로 끊겨요(교무실 공용 PC·전자칠판 대비).
• 학년도가 끝나면 관리자 화면에서 학생 기록과 사진을 한 번에 지워요.
• 도름스체크 기본 보안 점검: 위험 0건(둘러보기판 기준).

⚠️ 알아 두실 것

• 엔딩의 역사 내용(헐린 해, 복원된 해 등)은 확인해서 썼지만, 학교에서 쓰기 전에 한 번 검토해 주세요. 관리자 화면에서 고칠 수 있어요.
• 박물관 전시는 바뀔 수 있어요. 박물관 미션은 행사 전에 전시실을 한 번 확인해 주세요.
• 경회루·향원정 내부는 특별관람 예약제라 미션은 바깥에서 하게 되어 있어요. 수문장 교대식처럼 시간이 정해진 행사는 넣지 않았어요.
• 역할 인물 그림과 오프닝 그림은 AI(Notion AI)로 만든 뒤 교사가 검수한 상상화예요.
• 사진은 장소·사물만 찍도록 안내해요(다른 사람 얼굴 금지).

📚 출처·라이선스

• 지도 © OpenStreetMap contributors (ODbL), 글꼴 Noto Serif KR (OFL), 엔딩 옛 사진은 위키미디어 공용 퍼블릭 도메인 자료
• CC BY-NC 4.0(저작자표시-비영리): 코드, 미션·편지·엔딩 글, 인물 그림, 문서 모두. 학교·교육청·연수에서 무료로 설치하고 고쳐 쓰고 다시 나누셔도 돼요. 출처("궁궐 사람들 키트, 선유고 이재영(이복덕쌤)")를 밝혀 주시고, 판매·유료 서비스 같은 상업적 이용은 먼저 말씀해 주세요. 자세한 내용은 저장소의 LICENSE와 NOTICE.md에 있어요.

👨‍🏫 만든 사람

선유고 한국사 교사 이재영(이복덕쌤)이 만들었어요. 써 보시다가 막힌 곳이나 역사 내용 오류는 이 게시물 후기나 저장소 이슈로 알려 주세요.