🎯 학생 숙제 관리 시스템 기술 명세 (MOC)

1. 프로젝트 개요

학생들의 ‘입체어휘 4000’ 시리즈 학습과 ‘소리훈련’ 과제를 체계적으로 트래킹하기 위한 경량 웹 관리 시스템. 별도의 서버 없이 브라우저 환경에서 작동하며, 데이터는 로컬 환경에 보존됨.

2. 데이터 아키텍처 (Data Logic)

LocalStorage 기반 데이터 모델

• Student Object: 이름, 수강 클래스, 현재 진도 단계.
• Homework Logs: 과제 제출 날짜, 점수, AI 피드백 내용, 소리훈련 녹음 확인 여부.

CSV 백업 & 복원 (Data Portability)

• Papa Parse 라이브러리를 활용하여 학생 명단 및 과제 기록을 CSV 파일로 내보내거나 가져올 수 있음.

3. UI/UX 설계 원칙

• 3-Panel Layout: 학생 리스트(좌) / 과제 입력 및 현황(중) / AI 피드백 및 통계(우).
• Progress Visualization: 진도율에 따른 색상 변화 및 성취도 그래프.

4. 리소스 경로

• Source Code Path: F:/homework-system
• Main Entry: index.html (모듈화 버전)

Status Note: 데이터 모듈(data-manager.js)과 UI 모듈(ui-manager.js)의 통합 완료. 실전 수업 활용 준비 완료 상태.