AI HISTORY AR
운영 주소와 배포
- 정식 수업 사이트: https://ai-history-ar.vercel.app
- 통합 AR 만들기: https://ai-history-ar.vercel.app/three-kingdoms/ar-maker
- GitHub
themonsteredu/ai-history-ar의 main 변경이 기존 Vercel 프로젝트로 자동 배포됩니다. 별도 Sites 주소의 배포 성공만으로 정식 사이트 반영을 완료했다고 판단하지 않습니다.
- 유물 6종의 준비된 학습용 3D 모형을 골라 점·해설·녹음을 붙이고 내 작품을 체험할 수 있습니다. 통합 제작 화면에서 도형 조립은 필요하지 않습니다. 기존에 만든 모형과 설명·녹음은 이어서 사용할 수 있습니다.
- 현재 모둠 공동 저장·전시 API는 Sites D1/R2 및 교사 인증을 사용하므로, Vercel에서는 서버 연결이 별도로 필요합니다. 기기 임시 저장과 작업 파일 보관을 공동 저장으로 안내하지 않습니다.
고려 유물 수업 샘플
상단 ‘고려유물수업’ 또는 /goryeo에서 이용합니다. 관촉사 석조미륵보살입상은 교사 시범, 금속활자·팔만대장경·청자 매병·청자 투각칠보문뚜껑 향로는 학생 탐구, 나전 경전함은 아직 배우지 않은 선택 탐구입니다. 각 유물에 OX 2개와 인쇄 가능한 근거 요약 및 출처를 제공합니다. 교사 안내에 40분 흐름과 정답·오류 위치가 있습니다. 요약 자료는 원문 발췌가 아닙니다.
카드는 인쇄해 카메라로 인식합니다. 청자 매병·향로·나전경함은 국립중앙박물관 실물 3D 데이터를 사용하고, 관촉사·금속활자·팔만대장경은 사진을 참고해 만든 학습용 재현 모형입니다. 후자의 보이지 않는 부분은 추정이며 실물 3D 스캔이 아닙니다. 경판 판면은 Steve46814의 해인사 체험용 복제 경판 사진(CC BY-SA 3.0)을 잘라 원근 보정했으며 반대 면은 같은 사진을 사용한 추정 표현입니다. 박물관이 공공누리 제1유형으로 제공하는 3D OBJ와 사진 텍스처를 웹용 GLB로 변환하고 텍스처 크기를 줄였습니다. 출처와 원본은 해당 유물의 사진 링크에서 확인합니다. 사진은 크기를 조정하고 카드로 편집했으며 사진별 저작자와 출처, 이용 허락은 src/features/goryeo/photos.ts와 카드 인쇄물에 표시합니다. 관촉사 카드의 사진 편집물은 CC BY-SA 4.0을 따릅니다. node scripts/generate-goryeo-targets.mjs로 카드와 인식 데이터를 재생성합니다. HTTPS 또는 localhost와 카메라 권한이 필요합니다.
로봇은 실시간 AI가 아니라 정해진 OX 문장에 답하는 학습용 시뮬레이션입니다. 학생 유물 10개 답변 중 팔만대장경 2번 하나에 의도적으로 오류가 있습니다. 이 비율은 준비된 답변에만 적용됩니다. 수업 후 시뮬레이션임을 설명하고 실제 AI도 자료와 비교해 검증하도록 지도합니다. 기록은 기기별 브라우저에만 저장됩니다.
조선시대 공개수업
세종 때 과학 유물 6종(측우기·자격루·간의·앙부일구·혼천의·농사직설)의 AR 카드를 사전에 제작합니다. 당일에는 AR 카드 발표 → 우리 모둠이 AI에게 받은 OX 2문항을 교과서·참고 자료로 검증 → 퀴즈와 근거 발표 → 배움 정리로 진행합니다. 학생 /joseon/open-class, 선생님 /teacher/joseon/open-class. 운영 기준
현재 수업 흐름
5class와 별도로 운영합니다. 삼국시대와 조선시대 모두 근거 확인 → 표 정제 → 그래프 해석 → AR 전시의 6차시 흐름입니다. 조선시대 새 과정은 /joseon/course/1부터, 교사는 /teacher/joseon/course/1부터 시작합니다. 공개수업은 홈과 상단 메뉴에서 바로 들어갑니다.
2·3차시에는 내장 표·그래프 탐구실을 사용합니다. 확인한 문장과 출처를 입력하면 네 이야기종류별 막대그래프가 만들어집니다. 빈칸·미확인·같은 유산의 동일 문장은 집계에서 제외합니다. 유사한 표현의 중복 사실은 학생이 직접 정제합니다. 표 CSV와 그래프 PNG를 저장할 수 있습니다.
기기별 임시 저장은 공유 저장이 아닙니다. 모둠별 작업 JSON 파일을 선생님 기기에 모아 여러 파일을 선택하면 학급 그래프로 합쳐집니다. 같은 파일을 반복해서 넣어도 행이 늘어나지 않으며, 동일 행의 서로 다른 수정본은 충돌을 안내합니다.
조선 6차시 PPT와 활동지는 public/downloads/joseon/course/, 삼국 데이터 수업 자료는 public/downloads/three-kingdoms/data-inquiry/에 있습니다. 활동지는 원본 AI-L.E.A.P. 로고를 고정하고 한 활동지의 이어지는 페이지에는 머리말과 학습목표를 반복하지 않습니다. 과거 10차시 경로와 자료는 기존 수업 기록을 위해 접어 둔 이전 자료로 유지합니다.
이전 10차시 설계 기록
아래 내용과 과거 운영 문서는 이전 차시 구성의 기록입니다. 현재 수업은 위의 6차시 흐름과 내장 표·그래프를 우선합니다.
프로젝트 원칙
- 삼국시대와 조선시대는 각각 독립된 10차시 과정으로 운영한다.
- 두 과정은 인공지능과 역사 공통 AR Engine을 사용하되, 시대별 콘텐츠와 활동지는 분리한다.
- 삼국시대 학생은
질문 -> AI 검증 -> 근거 수집 -> 정제 -> 시각화 -> 해석 -> 유추 -> AR 전시 과정을 수행한다.
- 조선시대 학생은
질문 -> AI 판단 -> 자료 확인 -> 표 정리 -> 그래프 -> 해석·유추 -> 녹음 AR 전시 과정을 수행한다.
- 교사는 모든 차시에서 수업 내용과 준비물을 확인하고 해당 차시 활동지를 다운로드할 수 있어야 한다.
- 20개 차시 활동지는 A4 인쇄용 PDF로 제공하고, 시대별 전체 묶음 다운로드를 지원한다.
- 조선시대 9·10차시 AR 인식 카드는 실제 유산 사진과 이용 조건을 담은 A4 PDF 6종으로 제공한다.
- 조선시대 10차시에는 역할 나누기·다른 전시 세 곳 보기·달라진 생각 말하기를 A4 한 장으로 기록한다.
- 웹 UI와 출력 활동지의 모든 한글 글꼴은 S-Core Dream을 사용한다.
- 한글 문맥을 끊는 강제 줄바꿈을 금지하고
word-break: keep-all과 안정적인 행간을 유지한다.
- 카드 인식 실패에 대비하여 모든 AR 콘텐츠에 QR 직접 접속 경로를 제공한다.
과정
삼국시대 10차시
핵심 질문: 삼국시대 유산의 데이터를 모으면 과거를 어떻게 이해하고 미래를 어떻게 준비할 수 있을까?
모둠 유산:
- 무령왕릉
- 백제 금동대향로
- 첨성대
- 신라 금관
- 고구려 고분벽화
- 가야 고분군
조선시대 10차시
조선시대도 A4 한 장·세 활동을 기준으로 표 → CODAP 그래프 → 해석 → 녹음 AR 전시로 이어집니다. 2차시 판단과 3차시 자료 확인은 각각 운영합니다. 조선시대 현재 운영 기준을 따릅니다.
핵심 질문: 우리가 아는 조선, 정말 그랬을까?
모둠 유산:
- 훈민정음 해례본
- 조선왕조실록
- 수원 화성
- 자격루·앙부일구
- 종묘와 종묘제례악
- 난중일기
구현 영역
- 학생용 시대 선택 및 10차시 학습 흐름
- 시대별 모둠 작업 파일과 CSV·PNG 연결, CODAP 그래프 제작 및 선택 Google Sheets 실습
- PIN 3035 내부의 차시별 외부 도구 URL·실행 방식·결과 제출 설정
- 교사용 과정 대시보드
- 차시별 교수·학습 활동, 준비물, 평가 기준, 사전 준비 안내
- 차시별 활동지 PDF 다운로드
- 시대별 활동지 전체 ZIP 다운로드
- 헤리티지 검증 공방 문항 30개씩
- AR 카드 이미지 추적, 3D/영상/음성/자막, 상호작용 미션
- AR 실전 테스트 기록 및 QR 폴백
- 10차시 교실 박물관 운영 자료
상세 사양은 docs/CURRICULUM_IMPLEMENTATION_SPEC.md와 docs/WORKSHEET_CATALOG.md에서 관리합니다.
삼국시대 4~10차시의 현재 활동과 외부 도구 연결 사양은 docs/THREE_KINGDOMS_CONTINUITY.md에서 관리합니다. docs/EXTERNAL_TOOL_HUB_IMPLEMENTATION_PLAN.md는 이전 설계 기록입니다.
현재 구현 상태
삼국시대와 조선시대의 표·그래프·녹음 AR 수업 흐름이 각각 연결되어 있습니다.
- Vite + React + TypeScript 앱 기반
- 삼국시대 10차시, 조선시대 10차시 전체 구조화 데이터
- 두 시대 전 차시의 내장 수업 PPT, CODAP 실제 도움말 화면과 시대별 탐구 자료
- 교사용 외부 도구 설정 저장·검증·JSON 내보내기·불러오기
- 외부 도구 연결 실패에 대비한 CSV 예비 데이터
- 시대 선택 홈과 시대별 10차시 과정 화면
- 교사용 대시보드, 차시 검색, 차시별 40분 운영안
- 학생용·교사용 활동지 구성과 시대별 다운로드 센터
- 데스크톱·태블릿·모바일 반응형 화면과 A4 운영안 인쇄 스타일
- S-Core Dream 4~8 굵기 원본 글꼴 포함 및 실제 로딩 자동검사
- 20차시 수·차시별 40분·시대별 검증 단계·활동지 존재 여부 자동검사
- 주요 화면 브라우저 오류·가로 넘침·글꼴·경로 자동검사
학생 화면에는 수업 PPT와 웹앱 활동만 노출됩니다. 지도안·학생활동지·활동카드·답안·외부 도구 원본 주소는 PIN으로 잠긴 교사 화면에서 관리합니다.
실행과 검증
pnpm install
pnpm dev
pnpm test
pnpm build
Windows의 Microsoft Edge가 설치된 환경에서는 개발 서버 실행 후 다음 명령으로 데스크톱·모바일 주요 경로를 확인할 수 있습니다.
pnpm verify:ui
글꼴
웹 화면과 인쇄 스타일에는 에스코어 공식 배포처의 S-Core Dream을 사용합니다. 원본 OTF 파일은 수정하지 않았으며, 상세 이용 조건은 public/fonts/README.md에 기록했습니다.
