느티나무 교실 도우미

특수학급 시간표(전체 · 학생별), 나와의 약속판, 칭찬통장, 이름표를 만드는 Next.js 앱입니다.

특수학급 시간표

timetable.py를 Next.js 웹 앱으로 옮긴 것입니다. 모든 처리는 브라우저 안에서 이루어지며 파일은 서버로 전송되지 않습니다.

실행

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

배포용: npm run build && npm start

사용 순서 (파일 이름은 상관없음)

1. 특수학생 정보 — 화면에서 직접 입력 (학년 · 반 · 이름 · 수강 과목). 입력한 내용은 브라우저에 자동 저장됩니다.
2. 학급 시간표 (.xlsx) — A열 "1 - 1" 제목, 그 아래 1교시~7교시

특수학급 시간표 양식은 public/templates/special-class-template.docx 를 기본으로 사용합니다. 양식을 바꾸려면 이 파일을 같은 이름의 새 .docx 파일로 교체하세요.

시간표 생성하기 → 미리보기 확인 → 다운로드

만들어지는 파일

• 전체 특수학급 시간표 — 각 칸에 [과목] 과 학생 이름
• 학생별 시간표 — 같은 양식에 그 학생이 특수학급에서 수업하는 칸만 과목명으로 채움 (예: 강동아 특수학급 시간표 (2026년 1학기).docx)
• 모두 다운로드 (ZIP) — 전체 시간표 + 학생별 시간표/ 폴더

구조

• src/lib/timetable.ts — 엑셀 읽기, 시간표 계산, 워드 템플릿 채우기 (timetable.py와 같은 결과)
• src/components/ — 업로드 단계, 생성 중 화면, 결과 미리보기

나와의 약속판

메인 화면의 나와의 약속판 만들기 → 이름과 연 · 월 선택 → 미리보기 확인 → 그림 파일로 저장 (PNG) 또는 인쇄 · PDF로 저장.

• 앱이 약속판을 SVG로 직접 그립니다 (src/lib/promiseBoardSvg.ts). 무료이고, 날짜와 이름이 항상 정확합니다.
• 글꼴은 Google Fonts 의 Jua 를 쓰며, 저장할 때 약속판에 쓰인 글자만 담은 글꼴을 그림 안에 넣습니다.

칭찬통장 · 이름표

메인 화면의 칭찬통장 생성하기 / 이름표 생성하기.

• 칭찬통장: 표지 · 속지(이름 · 지점 · 계좌번호 · 구분 · 발행일, 도장, 서명 칸) · 거래 내역(날짜 | 내용 | 적립P | 차감P | 계)을 템플릿 모양대로 그립니다 (src/lib/bankbookSvg.ts). A6 가로 크기, A4 가로 한 장에 4쪽씩 인쇄하며, 첫 장은 표지 · 속지 · 거래 내역 2쪽, 둘째 장부터는 거래 내역 4쪽이고 A4 장수(1~10장)를 고를 수 있습니다.
• 이름표: 테두리(오색 · 한 가지 색 · 직접 고른 색) 카드에 캐릭터 · 반 이름 · 학생 이름을 넣습니다. 캐릭터는 남녀 6색 기본 캐릭터 또는 AI 캐릭터(바탕을 투명하게 지워 카드 안에만 들어감)이고, 학생마다 바꿀 수 있습니다. A4 세로 한 장에 14개(90 × 40mm)씩 인쇄합니다 (src/lib/nameTagSvg.ts).
• 칭찬통장 표지 그림과 이름표 캐릭터는 그림 설명(프롬프트)을 적으면 Pollinations 무료 공개 API로 그립니다 (src/lib/aiImage.ts). 가입 · API 키가 필요 없지만 같은 인터넷 주소에서 약 45초에 한 장만 그릴 수 있어, 제한에 걸리면 앱이 기다렸다가 다시 시도합니다.
• 한글 설명은 같은 서비스의 무료 텍스트 API로 영어로 옮겨 보냅니다. 학생 이름은 보내지 않고, 글자는 모두 그림 위에 코드로 그립니다.