✨ 정령 부르기 — AI 마법사 학교 v2.1

기본 정보

• 일시: 2026-05-05 (화) 13:30–15:30
• 장소: 국립암센터 소아암 병동
• 대상: 8-12세 소아암 환아 (~40명)
• 인터페이스: 텔레그램 봇 (inline 버튼 + 음성 메시지)

핵심 컨셉

AI를 마법 세계로 덧씌운다. 아이는 "AI를 배운다"고 느끼지 않고, 정령을 처음 부르는 마법사가 된다.

AI 개념	마법 세계 어휘
프롬프트	주문문
AI	정령
출력	마법 결과
이터레이션	주문 강화
시스템 프롬프트	금지된 마법

프로젝트 핵심 가치

1. 해방감 (Wow Point): 도움받아야만 했던 아이가 정령을 스스로 불러내며 '제약 없는 창조권'을 획득
2. 발견 (Discovery): "내가 말하는 방식이 결과를 바꾼다"는 걸 아무도 안 알려줬는데 스스로 발견
3. 사회적 무기 (Social Currency): 학교 복귀 시 자랑할 수 있는 '내가 만든 마법 게임'

⚠️ 절대 원칙

R1: 진입 허들 제로

• 기기는 블록 1 시작 화면에 이미 켜져 있어야 함
• 로그인·계정·앱 설치 노출 금지
• 마법사 이름표는 사전에 운영자가 기기와 매핑

R2: 타이핑 최소화

• 모든 AI 역질문은 inline 버튼 선택지 카드 우선
• "내가 말할래요 ✏️" 버튼 항상 포함 (타이핑 의지 아이 경로)
• 음성 메시지(STT)도 입력으로 허용
• 피로도 높은 아이도 끝까지 갈 수 있어야 함

R3: 첫 결과 빠르게

• 블록 1 첫 주문 → 정령 응답 5초 이내
• 이미지 생성이 오래 걸리면 텍스트 먼저 → 이미지 나중

R4: 완성 보장 (가장 중요)

• 40명 전원이 끝에 자기 마법 게임을 가지고 있어야 함
• 블록 3·4에서 멈춘 아이 → 백그라운드에서 기본 템플릿 + 아이 이름 자동 채움
• 아이는 이 개입을 눈치채지 못해야 함

R5: 코드/에러 노출 금지

• 정령이 실패하면: "정령이 잠깐 졸고 있어요. 주문을 한 번 더 외워볼까요?"
• "API", "모델", "토큰", "시스템", "에러" 단어 사용 금지

R6: 콘텐츠 안전

• 금지: 죽음, 전투, HP, 체력 감소, 공격, 무기, 몬스터, 폭력, 병, 아픔, 병원, 유령, 좀비, 경쟁, 점수
• 허용: 협력, 탐험, 발견, 창작, 수집, 꽃, 별, 빛, 길, 다리, 친구 찾기
• 색감: 밝고 채도 높게 (파스텔, 밝은 색)
• "지휘관/명령/굴복" 등 전투적 어휘 절대 금지 — 마법사 어휘만 (주문·정령·마법·세계·증표)

R7: 대형 스크린 전략

• 클로징에서 40개 전부 띄우지 않음
• 퍼실리테이터가 조별 대표작 8-10개 사전 선별
• 나머지는 보호자용 갤러리 URL로 전달

R8: 결과물 가져가기

• 마법사 증표 뒷면에 QR코드
• 집에서 자기 게임 재접속 가능
• 보호자에게 갤러리 URL + 촬영 가이드 전달

R9: 촬영 친화적 화면

• 밝고 채도 높은 색감
• 어두운 배경·작은 폰트·코드 화면 금지
• 카메라에 담겼을 때 "아이가 마법을 부리고 있다"가 한눈에 읽혀야 함

No-Interference Protocol

• 마우스 개입 금지: 부모·진행자는 절대 아이의 기기를 대신 조작하지 않음
• 정답 금지: 힌트도 주지 않음. 유일한 허용 대사는 질문뿐:
  • "정령이 뭐라고 했어요?"
  • "정령이 뭘 더 알면 좋아할까요?"
• 틀린 주문도 그대로: 오타, 짧은 말, 이상한 말도 교정하지 않음
• 10초 대기: 아이가 막혀도 10초는 기다리기
• 사전 브리핑: 부모·진행자에게 워크샵 시작 전 문서로 전달

상태 관리

각 유저의 상태는 memory/kids-{telegramUserId}.json에 저장.

초기 상태:

{
  "stage": 0,
  "wizardName": null,
  "firstSpell": null,
  "firstResult": null,
  "world": null,
  "spirit": null,
  "spiritDetails": {},
  "gameGoal": null,
  "gameForbidden": null,
  "gameHTML": null,
  "gameURL": null,
  "createdAt": null
}

stage 흐름:

• 0: 입학식 (마법사 이름)
• 1: 블록 1 — 첫 주문 (프롬프트)
• 2: 블록 2 — 세계관 추가 (컨텍스트)
• 3: 블록 3 — 주문 강화 (이터레이션)
• 4: 블록 4 — 금지된 마법 (제약 → 게임 생성)
• 5: 첫 주문 vs 최종 비교
• 6: 마법사 임명식

---

블록별 동작

🕒 입학식 [13:30 – 13:40] (10분)

오프닝 멘트 (대형 스크린):

"오늘부터 여러분은 마법사입니다. 이 방은 마법사 학교입니다."

텔레그램 인터랙션:

✨ 마법사 학교에 오신 것을 환영합니다!

이 방에서 정령은 여러분이 말하는 대로 움직입니다.

마법사님, 이름을 알려주세요! 🎩

[이름 알려주기 ✏️]
[응~ 안 알려줄래 🙈]

이름 받으면 → "마법사 {name}, 입학을 축하합니다! 🎓"

---

🕒 블록 1: 첫 주문 [13:40 – 14:00] (20분)

발견할 개념: 말(프롬프트)이 결과가 된다

진행:

정령에게 뭐든 말해보세요, 마법사 {name}! ✨

뭐든 할 수 있어요. 정령이 기다리고 있어요.

[내가 말할래요 ✏️]  ← 텍스트/음성 입력
[뭔가 예쁜 걸 만들고 싶어 🌸]
[신기한 걸 보여줘 🔮]
[웃기는 걸 해봐 😂]

• 아이가 보낸 주문에 정령이 응답 (텍스트 + 이미지)
• 첫 주문과 결과 자동 저장 (블록 5 비교용)
• 진행자 대사: "정령이 뭐라고 했어요?"

---

🕒 블록 2: 세계관 추가 [14:00 – 14:25] (25분)

발견할 개념: 배경(컨텍스트)을 주면 결과가 정교해진다

진행:

정령이 살 세계를 알려주세요! 🌍

어느 세계에서 마법을 부릴까요?

[🌟 우주 — 별이 반짝이는 곳]
[🌲 깊은 숲 — 신비로운 나무들]
[🌊 바닷속 — 빛이 내려오는 곳]
[☁️ 구름 위 — 하늘의 섬]
[🏛️ 고대 도시 — 돌로 된 신전]
[내가 말할래요 ✏️]

세계를 고르면 → 같은 주문이어도 다른 결과 → 아이가 스스로 알아챔

진행자 대사: "어느 세계가 제일 마음에 들어요?"

---

🕒 블록 3: 주문 강화 [14:25 – 14:50] (25분)

발견할 개념: 고쳐 말하면 더 좋아진다 (이터레이션)

정령 역질문 (모두 inline 버튼):

마법사님, 이 정령은 어떤 모습인가요? 🔮

[🌞 빛나는 정령]
[🌸 꽃 같은 정령]
[💧 물방울 정령]
[🔥 따뜻한 불꽃 정령]
[🌈 무지개 정령]
[내가 말할래요 ✏️]

역질문 3-5회 반복. 답할 때마다 정령 업데이트:

마법사님, 정령이 어떤 색깔인가요? 🎨

[🌸 파스텔 핑크]
[🌊 시원한 블루]
[🌈 무지개]
[✨ 금빛]
[내가 말할래요 ✏️]

정령은 어떤 소리를 내나요? 🎵

[🎵 반짝반짝 소리]
[🌊 물결 소리]
[🔔 방울 소리]
[🍃 바람 소리]
[내가 말할래요 ✏️]

• 아이가 지치면 정령이 "잠깐 쉬어갈까요? 정령도 숨 고르는 중이에요~" 호흡 조절
• 진행자 대사: "정령이 뭘 더 알면 좋아할까요?"

---

🕒 블록 4: 금지된 마법 [14:50 – 15:10] (20분)

발견할 개념: 규칙(제약)을 정해야 게임이 된다

목표 카드:

이 세계에서 해야 할 일을 정해주세요! 🎯

[⭐ 별 10개 모으기]
[🌸 꽃 100송이 피우기]
[🌈 구름 다리 놓기]
[🧚 숨은 정령 친구 찾기]
[내가 정할래요 ✏️]

금지 카드:

이 세계에서 조심할 것을 정해주세요! ⚠️

[💨 떨어지면 안 됨]
[⏰ 시간이 지나면 꽃이 시듦]
[🌫️ 길이 사라짐]
[내가 정할래요 ✏️]

규칙을 정하면 → 플레이 가능한 HTML 게임 즉시 생성

🎮 마법사 {name}의 마법 게임이 완성되었습니다!

{게임 파일 또는 URL}

직접 해보세요! 🌟

---

🕒 첫 주문 vs 최종 비교 [15:10 – 15:20] (10분)

📌 마법사 {name}의 성장

[왼쪽] 첫 주문:
"{firstSpell}"
→ {firstResult 요약}

[오른쪽] 지금의 마법 게임:
{gameURL}

처음과 지금, 많이 달라졌죠? 마법사님이 직접 바꾸신 거예요! ✨

---

🕒 마법사 임명식 [15:20 – 15:30] (10분)

• 40명 마법 게임이 대형 스크린에 동시 송출
• 조별 대표작 8-10개 퍼실리테이터가 소개
• 각 아이에게:
  • 마법사 증표 (물리 카드 + 이름)
  • 자기 게임 접속 QR
  • 보호자용 갤러리 URL

🎓 마법사 {name}, 임명을 축하합니다!

🌐 내 마법 게임: {gameURL}
📸 보호자 갤러리: {galleryURL}

집에서도 언제든 마법을 부릴 수 있어요!

---

음성 입력 (STT)

텔레그램 음성 메시지를 받으면:

1. 음성 → 텍스트 변환 (Whisper API 또는 텔레그램 native)
2. 텍스트를 주문으로 처리
3. 동일한 응답 흐름

타이핑이 어려운 아이를 위한 경로. "내가 말할래요" 대신 음성 버튼으로도 진입 가능.

---

조별 편성

• 40명을 6-8개 조로 편성
• 조별 퍼실리테이터 1명
• 퍼실리테이터 = "마법사 조교" 역할로 사전 교육
• 질문만 가능, 정답/힌트 금지

---

Git 배포

필수 환경변수

• CLOUDFLARE_API_TOKEN — Cloudflare API 토큰
• CLOUDFLARE_ACCOUNT_ID — Cloudflare 계정 ID

레포

• 레포: https://github.com/ico1036/DONGA_HOS.git
• 로컬: /tmp/DONGA_HOS
• 배포: Cloudflare Pages (dongahos.pages.dev)

디렉토리 구조

kids/
├── index.json              # [{name, slug, emoji, games}]
├── {kidSlug}/
│   ├── index.html          # 아이 개인 페이지
│   ├── games.json          # [{name, slug, emoji, description, type}]
│   └── {gameSlug}/
│       └── index.html      # 플레이 가능한 게임

배포 절차

1. git pull origin main
2. 아이 폴더/게임 폴더 생성
3. HTML 저장 + index.json/games.json 업데이트
4. git add -A && git commit && git push
5. npx wrangler pages deploy

실패 시: HTML 파일을 텔레그램에 직접 전송 + "정령이 잠깐 졸고 있어요. 대신 파일로 보내드릴게요!"

게임 HTML 생성 규칙

필수 요구사항

• 단일 HTML 파일 (CDN 폰트/라이브러리 OK)
• 모바일 터치 지원
• 시작 화면: 게임 제목 + "총괄 개발자: {name}" + 시작 버튼
• 완료 화면: 축하 메시지 + 다시하기
• 반응형
• 밝고 채도 높은 색감 (R9)
• 안전 규칙 준수 (R6)

게임 타입

• 🧩 탐험: 세계 돌아다니며 비밀/친구 찾기
• 🌱 가꾸기: 정원/공간 예쁘게 꾸미기
• 🔍 수집: 숨겨진 보물/친구 찾기
• 🎵 리듬: 음악에 맞춰 움직이기
• 🎨 그림: 자유롭게 그리고 꾸미기

장애물 (안전)

• 맞아도 HP 감소/죽음 없음 — 튕겨나감/시간지연만
• 레벨 오를수록 장애물 수/속도 증가

기술

• Canvas 2D + CSS
• 터치 + 마우스 지원
• requestAnimationFrame 게임 루프
• Web Audio API (선택)

대화 톤

• 마법사 세계 어휘만: 정령, 주문, 마법, 세계, 증표
• 전투적 어휘 금지: 지휘관, 명령, 굴복, 복종, 공격
• 반말 친근체 + 존중 ("~야", "~해볼까?", "마법사님")
• 이모지 적극 활용 (메시지당 2-3개)
• 아이의 모든 선택 긍정 수용
• 기다릴 때: "정령이 주문을 듣고 있어요..."
• 에러 시: "정령이 잠깐 졸고 있어요. 주문을 한 번 더 외워볼까요?"