AI 자료는 ‘미확인’으로 들어온다
이미지 모델은 한글은 정확히 썼지만 크기 비율을 틀렸고, 영상 모델은 자전 방향을 틀렸습니다. 수업 계획서의 ‘오류를 고치고 확인 근거 적기’를 제품의 기본 상태로 삼아, 근거 없이는 서버가 확인 상태를 받지 않게 했습니다.
LIVE / 체험 모드 · 수업용 AI 노트
초등 과학 수업에서 학생이 AI에게 받은 설명·그림·만화·영상을 자기 보드에 모으고, 자료가 맞는지 확인한 근거와 자기 말로 쓴 설명을 남기는 수업용 웹앱입니다. 학번과 이름만으로 들어오고, 교사는 학생·노트·하루 비용을 한 화면에서 관리합니다.

GPT Image 2 medium · 검증 이미지 5장
Kling 3.0 · 프롬프트 2종 · ‘미확인’ 설계의 근거
설명 5 + 그림 3 + 영상 1 · 글 비용은 추정
01 / PRODUCT
4·5·6학년 과학 ‘태양계’ 단원을 위한 도구입니다. 수업 계획서의 흐름은 질문 만들기, 개인 AI로 자료 받기, AI 자료의 오류를 고치고 확인 근거 적기, 내 질문·자료·확인 근거·내 설명을 보드에 남기기, 내 설명을 가리고 정리 답 쓰기입니다. 이 흐름을 그대로 화면의 기능으로 옮겼습니다.
요구사항은 열 개 항목이었습니다. 가입 없이 학번과 이름으로 들어오기, 교사의 삭제와 복원, 노트 모음, 무한 캔버스 보드, 왼쪽 대화·오른쪽 보드로 나뉜 AI 화면과 아이가 눌러 고르는 도움말 단어, 결과가 보드로 들어가는 움직임, 보드를 메일·이미지로 가져가기, 글·그림·영상 세 모델, 아이가 쓰고 싶어 하는 화면, 그리고 화면에 필요한 그림을 생성 모델로 만드는 것입니다.
학번 + 이름 · 가입 없음
수업을 고르면 학습 문제가 붙은 보드
형식 · 도움말 단어 · 질문 틀
미확인 → 확인 근거 → 내 설명
02 / LESSON DESIGN
수업 계획서의 단계마다 화면 장치와 서버 규칙을 하나씩 두었습니다. 학습 문제, 질문 틀, 낱말 칩, 주의할 점, 정리 문제는 학년마다 다르며 4·5·6학년 세 가지를 넣었습니다.
| 수업 단계 | 화면 장치 | 서버 규칙 |
|---|---|---|
| 질문 틀로 내 질문 만들기 | 학년별 질문 틀 5개와 낱말 칩 · 조사 자동 맞춤 | 학년별 사실 자료를 Claude 시스템 프롬프트에 추가 |
| 형식 고르기 | 설명·그림·만화·영상 4종과 도움말 단어(최대 4개) | 학생별 하루 한도와 하루 전체 예산 확인 |
| 오류를 고치고 확인 근거 적기 | AI 카드는 ‘미확인’ 도장 · 근거를 적으면 ‘확인함’ | 근거가 비어 있으면 확인 상태를 저장하지 않음 |
| 내 질문·자료·확인 근거·내 설명 남기기 | 보드 위 네 칸 체크 | 같은 규칙을 서버와 브라우저가 각각 계산 |
| 내 설명을 가리고 정리 답 쓰기 | ‘정리 문제’가 내 설명을 가리고 답 메모를 엶 | 가림은 내 설명·정리 답 메모에만 허용 |
03 / SYSTEM
영상 한 편을 만드는 데 2–3분이 걸리지만 서버리스 함수는 응답을 보내면 멈춥니다. 별도 워커 없이, 브라우저가 몇 초마다 상태를 물을 때마다 서버가 한 걸음씩 나아가는 상태 기계로 만들었습니다. 생각 중 → 대기 → 만드는 중 → 옮기는 중 → 완료 순서입니다.
Claude가 쓴 프롬프트를 먼저 기록하고 외부 작업 ID는 받는 즉시 저장합니다. 함수가 다시 시작되거나 화면을 닫았다 열어도 같은 작업을 이어 받습니다. 결과를 저장소로 옮기다 실패하면 생성은 다시 하지 않고 옮기기만 다시 시도합니다.
같은 작업을 두 곳에서 동시에 진행하지 않도록 DB에 90초 잠금을 두었습니다. 힉스필드에는 동시에 3건까지만 걸고 나머지는 ‘앞에 n명’으로 기다립니다. 학생 한 명은 한 번에 하나만 만들 수 있습니다.
저장소는 두 가지입니다. 내 컴퓨터에서는 SQLite와 파일, Vercel에서는 Neon Postgres와 Vercel Blob을 같은 코드로 씁니다. AI 화면과 보드 화면이 같은 보드를 고칠 수 있어, 저장은 판 번호가 같을 때만 덮어쓰고 다르면 최신 보드를 돌려줍니다.
하루 한도·예산 확인 후 기록
Claude가 장면 계획을 JSON으로 작성
GPT Image 2 · Kling 3.0 → 저장소
보드에 넣기 · 다시 만들기
04 / MODELS
글은 Claude Sonnet이 초등학교 선생님 말투로 씁니다. 해요체, 한 문장에 한 가지 내용, 어려운 낱말은 괄호로 풀이, 3–5문장, 끝에는 스스로 해 볼 질문이 규칙입니다. 답은 JSON 스키마로 받아 제목·본문·이어서 물을 말 세 개로 나눕니다.
그림·만화·영상은 Claude가 먼저 장면 계획을 쓰고, 서버가 고정된 형식의 프롬프트로 조립합니다. 그림 속 한글을 위해 장면은 영어로 쓰고, 한글은 큰따옴표 안에 위치와 함께 적으며, 제목 하나와 이름표 8개까지만 넣고, 끝에 같은 규칙 문장을 붙입니다. 글자가 필요 없는 그림에는 글자 금지 문장을 붙입니다.
이 규칙으로 GPT Image 2의 medium 품질에서 만든 검증 이미지 5장의 한글 문구 28개가 모두 정확했습니다. 그래서 기본 품질을 high(3.5크레딧) 대신 medium(1크레딧)으로 정했습니다.
내용의 정확성은 달랐습니다. 목성과 지구 그림은 지름 비율이 약 3배로 그려졌고(실제 약 11배), 지구 자전 영상은 프롬프트를 바꿔 만든 2개 모두 방향이 반대였습니다. 모델을 바꾸는 대신 AI 카드를 ‘미확인’으로 들이고 아이가 확인 근거와 고친 곳을 적게 했습니다.
| 확인한 것 | 결과 | 조건 |
|---|---|---|
| 그림 속 한글 문구 | 28 / 28 정확 | GPT Image 2 medium · 5장 · 제목·이름표·말풍선 |
| 글자 없는 그림 | 글자 없음 | 글자 금지 문장 · 1장 |
| 영상 생성 시간 | 약 2–3분 | Kling 3.0 · 5초 · 소리 포함 |
| 지구 자전 방향 | 0 / 2 정확 | 프롬프트 2종 · 체험용 견본은 역재생으로 바로잡음 |
| 목성·지구 크기 비율 | 약 3배로 그려짐 | 실제 지름 비율은 약 11배 |
05 / COST
교사가 예산을 가늠할 수 있게 크레딧과 토큰을 원화로 바꿔 한 번당 가격으로 보여 줍니다. 기준은 1달러 1,360원, 힉스필드 1크레딧 0.048달러입니다.
학생별 하루 한도(설명 40 · 그림 10 · 만화 5 · 영상 2)와 하루 전체 예산(기본 30,000원)을 요청을 받기 전에 확인합니다. 넘으면 그날은 만들기가 멈추고, 교사는 영상 만들기만 따로 끌 수 있습니다.
| 만드는 것 | 한 번 | 근거 |
|---|---|---|
| 설명 | 약 13원 | Claude Sonnet · 토큰 수 추정, 실제 호출로 재지 않음 |
| 그림 | 약 79원 | GPT Image 2 medium 1크레딧 + 계획용 Claude 호출 |
| 네 컷 만화 | 약 79원 | GPT Image 2 medium 1크레딧 + 계획용 Claude 호출 |
| 영상 5초 | 약 583원 | Kling 3.0 8.75크레딧 + 계획용 Claude 호출 |
| 학생 1명 · 수업 1시간 | 약 885원 | 설명 5 + 그림 3 + 영상 1 |
| 한 반 25명 | 약 22,000원 | 같은 사용량 가정 |
06 / CLASSROOM SAFETY
학급에서 쓸 도구라 무엇을 저장하고 어디까지 되돌릴 수 있는지를 먼저 정했습니다.
07 / EVIDENCE
로그인부터 내보내기까지 29개 항목의 API 검사를 로컬 SQLite, 로컬 Postgres+Blob, 운영 배포 세 환경에서 통과했습니다. 다른 사이트에서 온 요청 거절, 옛 판으로 저장할 때의 409, 밖의 주소 그림 제거, 만드는 중의 새 요청 거절, 경로 탈출 차단, 내보낸 HTML의 스크립트 주입 검사가 들어 있습니다.
화면은 헤드리스 Chrome으로 로그인, 노트 모음, 카드 확대·축소, AI 흐름, 확인 근거 입력, 정리 문제, PNG·HTML 내보내기, 메일 발송(로컬 수신기)을 확인했고 태블릿·휴대폰 폭도 점검했습니다. 내보낸 HTML은 파일로 열어 서버 없이 동작하는지 확인했습니다.
보드 이미지는 DOM을 캡처하지 않고 캔버스에 직접 그립니다. 한글 웹폰트가 부분 집합으로 내려와 DOM 캡처에서는 글자가 빠졌기 때문입니다.
ENGINEERING DECISIONS
이미지 모델은 한글은 정확히 썼지만 크기 비율을 틀렸고, 영상 모델은 자전 방향을 틀렸습니다. 수업 계획서의 ‘오류를 고치고 확인 근거 적기’를 제품의 기본 상태로 삼아, 근거 없이는 서버가 확인 상태를 받지 않게 했습니다.
한 학급 규모에서는 워커와 큐를 따로 운영할 이유가 작았습니다. 브라우저의 상태 확인을 진행 신호로 쓰고, 프롬프트와 작업 ID를 DB에 남겨 재시작 뒤에도 이어지게 했습니다. 화면을 닫은 동안에는 진행하지 않고 다시 열면 이어 갑니다. 제출 직후 ID를 저장하기 전에 중단되는 경우는 막지 못합니다.
교사에게 필요한 숫자는 크레딧이 아니라 한 반이 한 시간에 쓰는 금액입니다. 단가를 원화로 환산해 관리자 화면과 학생의 남은 횟수에 연결하고, 하루 예산을 넘는 요청은 서버가 거절합니다. medium 품질에서도 한글이 정확했던 결과를 근거로 그림 단가를 3.5크레딧에서 1크레딧으로 낮췄습니다.
교사 PC에서 바로 띄우는 실행과 Vercel 배포를 같은 코드로 지원합니다. SQL 문장은 같게 두고 자리표시자만 바꾸며, 트랜잭션 대신 판 번호 비교로 동시 수정을 처리해 SQLite와 Postgres에서 같은 동작을 얻었습니다.
SCOPE & LIMITS