ESP32-S3 Bench Guide
ESP32‑S3 N16R8 벤치 가이드: 실시간 핀아웃, 강의, 시뮬레이터 및 벤치 로그
교사를 위한 All-in-One 학교생활기록부(생기부) 에디터 데스크톱 프로그램
저장소 README에서 가져옴
README 전체를 불러오는 중입니다.
README 전문 보기 ↗Teacher Utility Kit — 교사를 위한 학교생활기록부 작성 도구
학생 명렬표 등록부터 영역 구성, 활동 생성, 생기부 작성, 내보내기까지. 아래 순서대로 진행하면 학생별 학교생활기록부 문장을 손쉽게 완성할 수 있는 데스크톱 애플리케이션입니다.
🛡️ Notice: 이 소프트웨어는 교육 및 비상업적 목적으로만 무료로 사용할 수 있습니다. 상업적 이용은 엄격히 금지됩니다. (자세한 내용은 하단의 라이선스 규정을 확인하세요.)
생기부의 각 항목을 영역(Area) 이라고 부릅니다. 그 안에 학생이 실제로 참여한 개별 활동(Activity) 여러 개를 담아 하나의 문장 묶음을 완성합니다.
영역 (Area) ─── 진로활동 [최대 1,500 byte]
│
├─ 활동 (Activity) 전공탐색 퀴즈
├─ 활동 (Activity) 전공 도서 독후감
├─ 활동 (Activity) 진로 상담 세션
└─ 활동 (Activity) ...
각 Activity마다 학생별로 기록을 작성하면, 프로그램이 합산된 문장을 해당 영역(Area) 항목으로 자동 병합합니다.
| 단계 | 작업 | 설명 |
|---|---|---|
| 1 | 학생 등록 | 학년·반·번호·이름 등록. 엑셀(.xlsx, .csv)로 전체 명렬표 일괄 가져오기 가능 |
| 2 | 영역 구성 | 자율활동·진로활동·동아리활동 등 생기부 영역 생성 및 NEIS 기준 바이트 제한 설정 |
| 3 | 활동 생성 | 영역 하위에 세부 활동(수행평가, 프로젝트, 체험학습 등) 생성 |
| 4 | 생기부 작성 | 학생 × 활동 격자 화면에서 내용 입력. 실시간 합산 바이트 초과 시 셀 붉은색 강조 |
| 5 | 내보내기 | 나이스 일괄 업로드 양식에 맞춘 엑셀 파일로 내보내기 |
자율활동·동아리활동·진로활동 영역을 병합하고 검수해야 하는 담임교사에게 최적화되어 있습니다.
지도교사들이 작성한 엑셀 데이터를 가져오기(Import) 하여, 초과된 바이트를 한눈에 파악하고 효율적으로 분량을 조절할 수 있습니다.
활용 팁: 바이트 초과 시 해당 셀이 붉은색으로 즉시 강조되므로, 길이를 줄여야 하는 학생을 직관적으로 찾아낼 수 있습니다.
세부능력 및 특기사항(세특)을 집중적으로 작성하는 교과교사에게 최적화되어 있습니다.
수행평가, 수업 참여도, 프로젝트 등 평가 요소들을 세부 활동(Activity)으로 분리하여 체계적으로 관리하세요.
활용 팁: 엑셀 스프레드시트와 유사한 격자형 인터페이스를 제공하여, 여러 학급과 학생의 세특을 화면 전환 없이 한 번에 연속해서 작성하기 편리합니다.
# 의존성 설치 (락파일 그대로 설치한다)
npm ci
이 프로젝트에서 직접 실행하는 명령은 세 개뿐이다.
| 명령 | 하는 일 |
|---|---|
npm run dev | 개발 모드로 앱을 띄운다 (Vite + Tauri) |
npm run build | 릴리즈 빌드를 만든다 |
npm run ci | 전체 검증 — Rust + 프론트엔드 단위 테스트 |
npm run dev
npm run build
npm run ci
package.json의 나머지 스크립트(vite:*, test:*)는 위 세 개가 부르는 내부 단계다.
직접 부르지 말 것. 로컬·IntelliJ 실행 구성·GitHub Actions가 모두 이 세 이름만 사용하며,
어느 한 곳에 개별 명령을 따로 적으면 그 순간 로컬과 CI가 갈라진다.
빌드 옵션은 build에 그대로 넘긴다. 배포 워크플로우도 이 방식을 쓴다.
npm run build -- --no-bundle # 포터블 실행 파일
npm run build -- --bundles nsis # Windows 설치 파일
npm run build -- --target universal-apple-darwin --bundles dmg # macOS
이 프로젝트는 여러 기여자의 도움으로 발전하고 있습니다. 상세한 기여 내역은 아래 문서에서 확인하실 수 있습니다.
본 프로젝트는 PolyForm Noncommercial 1.0.0 라이선스를 따릅니다. (LICENSE.md 파일 참조) 교육 및 비상업적 목적에 한해 자유롭게 사용할 수 있으며, 상업적 이용은 엄격히 금지됩니다.
본 섹션은 동 라이선스에 대한 저작권자의 공식 해석 및 추가 조건(Additional Terms)으로 간주됩니다.
본 프로그램은 공익적 목적의 학교 교육 및 비영리 교육 활동을 지원하기 위해 개발되었습니다.
다음과 같은 사용은 상업적 이용으로 간주되어 허용되지 않습니다.
PolyForm Noncommercial 1.0.0은 'educational institution'의 사용을 허용하나 이 용어를 정의하지 않습니다. 본 저작권자는 이 용어를 다음과 같이 해석합니다.