한국 초3~고3 인터랙티브 교육 플랫폼

2022 개정 교육과정 기준 5과목(국·영·수·사·과) 488 단원 / 약 800 인터랙티브 학습 자원. 단일 Next.js 16 웹앱. 비영리·개인 학습용.

진행 현황

항목	값
단원 메타 등록	392 / 488 (NCIC 마스터 인덱스 기반)
인터랙티브 콘텐츠 작성	148+ 단원 (Wave 1–3 병렬 에이전트 완료)
콘텐츠 완료율	61.6% (244 stub → 148 done)
인터랙티브 컴포넌트	98개 (components/interactive/)
풀텍스트 검색	fuse.js 392 docs · Ctrl+K 단축키
진도 트래커	zustand + localStorage (단원별 완료/즐겨찾기)
SEO	sitemap.xml (428 URL) + robots.txt + 동적 metadata
외부 학습 자료	위키백과 ko 60+ 항목 (한국사 15 시대 + 5 인물 + 17 시·도 + 8 행성 + 5 생물계 + 10 동물, CC BY-SA 3.0)
디자인 시스템	CUFA 위키 다크테마 포팅 (Pretendard + JetBrains Mono)

과목별 진척 현황

과목	완료 단원	전체 라우트	완료율
수학 (Math)	60+	138	43.5%
국어 (Korean)	24+	41	58.5%
영어 (English)	22+	34	64.7%
과학 (Science)	26+	104	25.0%
사회 (Social)	18+	75	24.0%

최근 완성 (Wave 3, 2026-05-04): +32 units

• 초3·4 도형/그래프 (8), 중1 사회/수학 (7), 중2·3 함수/도형 (9), 고등 영·사 (8)

선행 완성 사례 (Wave 1–2):

• M3-NA-01 (세 자리 수), M5-NA-04 (분수 덧셈), M6-CR-02 (비례식)
• H5-HI-01 (한국사 타임라인), S5-LI-01 (생물 분류)
• E-GR-04 (영어 시제), E-VOC-01 (알파벳 파닉스)
• K-RD-01 (글의 구조), S7-MA-01 (입자 모형)

기술 스택

• Next.js 16.2 (App Router, Turbopack, Route Groups)
• React 19.2 + TypeScript 5
• Tailwind CSS 4 (CSS-first, OKLCH 토큰, @custom-variant dark)
• next-themes (다크 모드)
• zustand v5 + persist (진도 트래커)
• fuse.js v7 (가중치 풀텍스트 검색)
• KaTeX + react-katex (수식)
• recharts (그래프)
• vitest + Playwright (테스트)
• Pretendard 가변 폰트 (SIL OFL)

시작하기

npm install
npm run dev
# http://localhost:3000

빌드:

npm run build
npm start

타입 검사:

npx tsc --noEmit

디렉토리

edu-platform/
├── app/                   # Next.js App Router
│   ├── (units)/           # 단원 라우트 그룹
│   ├── error.tsx
│   ├── not-found.tsx
│   ├── loading.tsx
│   ├── layout.tsx         # 루트 레이아웃 (lang="ko")
│   └── page.tsx           # 홈
├── components/
│   ├── primitives/        # 공용 빌딩 블록
│   └── interactive/       # 단원별 인터랙티브 컴포넌트
├── lib/
│   ├── types.ts           # 타입 + 라벨
│   ├── curriculum/        # 단원 메타데이터 (분할)
│   └── metadata.ts        # makeUnitMetadata helper
├── docs/                  # 양산 매뉴얼 (488 단원 인덱스 / 20 패턴 / playbook)
└── public/

핵심 원칙

1. 데이터 정직성: 단원 정보는 NCIC(https://ncic.re.kr) 원문 기준
2. 저작권 안전: 디즈니/지브리/마블/문학 본문 인용 금지
3. 본질 우선: 화려함보다 개념의 핵심이 보이는 시각화
4. 모바일 우선: 슬라이더 터치 영역 최소 44px
5. 즉시 반응: 입력 → 결과 100ms 이내

양산 가이드

docs/03-claude-code-playbook.md 참조.

라이선스

• 코드: MIT (LICENSE)
• 콘텐츠: CC BY-NC 4.0 (docs/LICENSE-CONTENT.md, 작성 예정)
• 교육과정 메타데이터 출처: NCIC 2022 개정 교육과정

보안

SECURITY.md 참조.

기여

CONTRIBUTING.md 참조.