아이들에게 꼭 맞는 연습문제를! — 기초학력 연산 진단 & 맞춤형 문제 자동 생성기
🔢 초등 3~6학년 수학(연산), 기초학력 다중 지원 — 학생들이 연산 진단 퀴즈를 풀면 약점(뺄셈, 곱셈, 분수, 소수점 등)을 자동 분석하고, 약점에 맞춰 난이도와 유형이 자동 조절된 맞춤 문제를 무한 생성하는 기초학력 도움말 교구입니다.
📖 한 줄 정의
심기 모드(데이터 임베딩): API 데이터를 미리 받아 HTML 파일 안 상수로 박아두는 방식(앱 실행 중 외부 통신 0).
학내망 원칙: 학생 개인정보(실명·의견·성적·상담 기록)의 외부 수집·저장·전송 금지(쿼리에 학생 데이터가 담기는 외부 API 호출 포함) — 일반 공개 쿼리의 외부 호출은 허용하며, 학생 배포본은 심기 폴백(EMBED 상수)을 항상 내장한다.
1. 3대 핵심 분석 비교표
| 무엇이 바뀌었나요? / 영역 | 초보자를 위한 쉬운 설명 | 이렇게 한번 써보세요! |
|---|---|---|
| 획일적 문제지 ➔ 개인 맞춤 문제 | 전교생이 똑같은 문제지를 푸는 대신, 개별 진단 결과에 따라 약점 유형과 난이도가 자동 조절됩니다. | 뺄셈 오답률 60%인 학생은 뺄셈 문제 비중이 높아지고, 곱셈 만점 학생은 곱셈이 줄어듭니다. |
| 교사 출제 ➔ 알고리즘 자동 출제 | 정답률을 추적하여 약점을 찾아내고, Math.random()으로 같은 유형의 문제를 무한히 새로 생성합니다. |
"뺄셈 2자리 × 난이도 보통" 옵션 클릭만으로 10문항 즉시 생성. |
| 손 계산 채점 ➔ 실시간 판정 & 리포트 | 입력 즉시 판정하고, 진단 종료 후 4대 영역별 정답률 레이더 차트로 약점을 한눈에 보여줍니다. | A4 1장 인쇄용 개인별 학습 리포트 서식(@media print) 지원. |
2. 초보자를 위한 바이브 코딩 실전 사용 예시
제미나이(Gemini)에 아래 프롬프트를 붙여넣으면 단일 HTML 파일로 즉시 완성됩니다.
- 프롬프트 복사 — 아래 '제미나이 전용 에러 제로 프롬프트' 전체를 복사합니다.
- 역질문 답변 — 제미나이가 묻는 학년, 연산 유형, 난이도에 답합니다.
- HTML 파일 실행 — 메모장에 붙여넣고
연산진단.html로 저장 후 더블클릭합니다.
제미나이 전용 에러 제로 프롬프트
[🚨 에러 방지 기본 안전장치]
1. 단일 HTML 파일 완결성: 외부 라이브러리, 소셜 로그인, DB 없이 순수 바닐라 HTML/CSS/JS로 완성한다.
2. 진단 데이터 심기 모드: const DIAGNOSIS = [{ area: "덧셈", correct: 8, total: 10 }, { area: "뺄셈", correct: 5, total: 10 }, ...] 상수에 영역별 정답률을 내장한다.
3. 맞춤형 문제 자동 생성: Math.random()으로 약점 영역의 문제를 무한히 새로 생성하고, 오답률이 높은 영역의 비중을 자동으로 높인다.
4. 레이더 차트: 외부 Chart.js 없이 순수 Canvas 삼각함수로 4~6각형 레이더 차트를 직접 렌더링한다.
5. A4 인쇄 서식: @media print를 적용한 1인 1학습 리포트(이름은 화면 입력 후 인쇄, 저장 0) 발급 기능 내장.
6. Web Audio 사운드: 정답 '똑', 오답 '삑', 진단 완료 '팡파르'를 순수 Web Audio API로 합성한다.
7. 학생 개인정보 0: 학생 실명을 절대 저장하지 않으며, 번호 및 닉네임만 사용한다.
8. // TODO, /* 생략 */ 등의 미완성 코드는 절대 넣지 말고 끝까지 완성한다.
[❓ 역질문 유도]
코드를 즉시 작성하지 말고, 기획을 구체화하기 위한 다음 3가지 질문을 먼저 나에게 던져줘:
1. 진단할 연산 유형은 무엇인가요? (기본: 덧셈, 뺄셈, 곱셈, 나눗셈 4대 영역)
2. 학년 수준은 몇 학년으로 설정할까요? (3학년: 2자리 연산 / 6학년: 분수·소수 포함)
3. 진단 문항 수는 몇 개로 할까요? (기본: 10문항)🎯 에디터 한줄평
"전교생이 똑같은 문제지를 푸는 것은 마치 모든 아이에게 같은 크기의 신발을 신기라는 것과 같습니다. 이 도구는 아이들이 어디서 넘어지는지를 찾아내고, 그 지점에 딱 맞는 연습문제를 무한히 만들어줍니다. 기초학력 도움말은 교사의 사랑이기 전에 정확한 진단이 필요합니다."
📚 기술·교육 참고 링크
- 초등 기초학력 다중 지원 대상자 연산 진단 및 맞춤형 학습 지원 가이드
- 교육과정 연계: 초등 3~6학년 수학(수와 연산), 기초학력 보장 지원 시스템
