자기조절학습은 메타인지(metacognition), 전략적 행동(strategic action), 학습 동기(motivation) 세 요소로 구성됩니다. 학습자가 스스로 목표를 설정하고(Plan), 실행하며(Do), 평가하는(Review) 순환 과정입니다.
학습자가 무엇을, 어떻게, 언제 배울지 스스로 결정하는 학습 패러다임. 교사 주도(pedagogy)도, 성인 학습(andragogy)도 아닌, 완전한 자기 결정.
"자기 생각에 대한 생각" — 자신이 뭘 알고 뭘 모르는지 인식하는 능력. SRL의 핵심 요소이며, 어린 시절부터 훈련 가능.
행동 후 긍정적 강화(보상)가 따르면 행동이 강화됩니다. 게임 시간이라는 즉각적 보상이 학습 행동을 강화하는 구조.
내재적 동기의 3대 요소: 자율성(Autonomy), 유능감(Competence), 관계성(Relatedness). 외재적 보상만으로는 지속 불가 — 내재적 동기를 함께 키워야 합니다.
한국 교재를 쉽게 검색하여 클릭으로 등록. 페이지/챕터 정보 포함.
| 기능 | 설명 | 데이터 소스 |
|---|---|---|
| 교재 검색 | 제목/저자/ISBN으로 검색 → 자동 완성 목록 | Aladin Open API (알라딘), Naver Books API |
| 원클릭 등록 | 검색 결과 클릭 → 제목/저자/표지/ISBN 자동 입력 | API 응답 데이터 |
| 페이지 설정 | 총 페이지 수 입력 → 진도율 자동 계산 | 사용자 입력 (API에 page 정보 있으면 자동) |
| 챕터 구성 | 챕터명 + 페이지 범위 등록 → 챕터별 진도 추적 | 사용자 입력 (목차 OCR 가능) |
| 표지 이미지 | 검색 시 표지 자동 로드 → Trophy Shelf에 표시 | API 썸네일 URL |
| 바코드 스캔 | 카메라로 ISBN 바코드 스캔 → 자동 검색 | 브라우저 Camera API + ISBN lookup |
| 기능 | 설명 |
|---|---|
| 부모 가입 | Google OAuth / 이메일+비밀번호 |
| 가정(Family) 생성 | 부모 가입 시 자동 생성. 고유 ID 부여. |
| 자녀 프로필 | 부모가 자녀 추가 (이름, 나이, 아바타). 자녀는 계정 없음. |
| 자녀 접근 | 부모가 생성한 PIN(4자리) 또는 QR 코드로 로그인 |
| 데이터 격리 | KV 키 프리픽스: family:{familyId}:child:{childId}: |
| 역할 구분 | 부모(관리자) vs 자녀(사용자). 부모만 설정/결제 가능. |
| 기능 | 상태 | 설명 |
|---|---|---|
| 주간 캘린더 | 완성 | 월~일 7일 뷰, 날짜별 달성률 |
| 요일별 기본 과목 | 완성 | Settings에서 요일별 프리셋 |
| 일일 플래너 | 완성 | Plan 칩 → 슬롯 자동 배치 |
| 타이머 | 완성 | Start/Pause/End 실시간 타이머 |
| 과목 커스텀 | 완성 | 무제한 과목, 카테고리, 색상, 포인트 |
| 교재 추적 | 완성 | 과목-교재 연결, 진도, 완료 |
| Trophy Shelf | 완성 | 완료 교재 히스토리 |
| 교재 검색 등록 | TODO | 알라딘/네이버 API 연동 |
| 챕터별 진도 | TODO | 교재 내 챕터 구성 + 챕터 단위 추적 |
| 페이지 진도 | TODO | 오늘 몇 페이지까지 했는지 |
| 바코드 스캔 | TODO | ISBN 스캔 → 자동 교재 등록 |
| 기능 | 상태 | 설명 |
|---|---|---|
| 게임 시간 보상 | 완성 | 목표 달성 → 30분 자동 적립 |
| 게임 타이머 | 완성 | Start/Pause/End + 잔고 차감 |
| 30분 경고 | 완성 | Notification + beep + 팝업 |
| 부모 알림 | 완성 | 잔고 부족 시 텔레그램/카카오톡 |
| 레벨 시스템 | TODO | XP 획득, 레벨업 애니메이션 |
| 뱃지/업적 | TODO | "7일 연속!", "100시간 돌파!" 등 |
| 캐릭터 커스텀 | TODO | 강아지 옷/악세사리 아이템 획득 |
| 가족 리더보드 | TODO | 형제끼리 선의의 경쟁 |
| 기능 | 상태 | 설명 |
|---|---|---|
| 부모 뷰 | 완성 | ?view=parent 접근 |
| 게임 시간 관리 | 완성 | 보너스/패널티/동결 |
| 주간 리포트 | TODO | 주간 학습 시간/과목/달성률 요약 |
| AI 인사이트 | TODO | "수학 집중도 하락 추세" 등 |
| 카카오톡 알림 | TODO | 일일 학습 완료/게임 사용 알림 |
| 멀티 자녀 뷰 | TODO | 자녀별 탭 전환 |
| 기능 | 상태 | 설명 |
|---|---|---|
| CF Pages 호스팅 | 완성 | 프론트엔드 |
| CF Worker API | 완성 | 백엔드 |
| CF KV 스토리지 | 완성 | 데이터 저장 |
| Google OAuth | TODO | 부모 로그인 |
| CF D1 (SQLite) | TODO | 관계형 데이터 (멀티테넌트) |
| 도메인 확보 | TODO | 이름 확정 후 |
| 결제 (Toss/Stripe) | TODO | 사업자 등록 후 |
| 이용약관 | TODO | 아동 개인정보 포함 |
| 한국어 UI | TODO | i18n 시스템 |
| PWA 매니페스트 | TODO | 앱처럼 설치 |
| 랜딩 페이지 | TODO | 마케팅용 랜딩 |
| 레이어 | 기술 | 이유 |
|---|---|---|
| 프론트엔드 | Vanilla JS → (추후 React/Svelte) | 초기 빠른 개발, 추후 마이그레이션 |
| 호스팅 | Cloudflare Pages | 무료, CDN, 빠름 |
| 백엔드 | Cloudflare Workers | 서버리스, 무료 티어, 글로벌 |
| DB | CF D1 (SQLite) + KV | D1=관계형(유저), KV=키값(세션) |
| 인증 | Google OAuth 2.0 + JWT | 가장 보편적, 무료 |
| 결제 | Toss Payments (KR) / Stripe (글로벌) | 국내+해외 커버 |
| 교재 API | 알라딘 Open API + 네이버 Books API | 한국 도서 데이터 최대 |
| 알림 | 카카오톡 알림톡 + 텔레그램 Bot | 한국 학부모 도달률 |
| AI | Claude API (Anthropic) | 학습 인사이트 분석 |
| 코드 관리 | GitHub (private) | 별도 repo: hongongdang |
혼공댕 🐕 — Git repo 생성 완료 → 멀티테넌트 기반 구축
제안서: study-buddy-proposal.pages.dev
프로덕트 문서: hongongdang.pages.dev