학생이 직접 만든 풀이·글·작품을 AI와 대화하며 반응형 HTML로 완성·제출. 교과 무관, 직접 설치형 오픈소스(MIT).
이 앱은 학생이 자기가 직접 한 결과물(수학 풀이, 영어 글, 과학 보고서 등)을 AI와 대화하며 보기 좋은 반응형 웹페이지(HTML)로 만들고, 미리보기·수정을 거쳐 제출하는 수업 도구예요. 같은 와이파이에 접속한 학생들이 브라우저로 바로 들어와 사용하고, 선생님은 관리자 화면에서 제출물과 대화를 한눈에 봅니다. 핵심은 AI가 대신 풀어주지 않는다는 거예요. 학생이 스스로 한 것만 시각화하고, 답·풀이·서술형 대필은 하지 않습니다. 기본 템플릿은 수학이지만, 지침 파일(system-prompt.txt) 하나만 바꾸면 어떤 교과에도 맞출 수 있어요.
설치는 AI가 대신 해줍니다 (깃허브·코딩 몰라도 됩니다)
이건 '직접 설치형'이라 선생님 컴퓨터(또는 교실 PC)에서 돌리는데, 설치 자체를 AI 코딩 도구에게 통째로 맡기면 돼요. 아래 '설치 프롬프트'를 복사해서, 컴퓨터 터미널에서 실행한 AI 코딩 도구(Claude Code, Codex CLI, Gemini CLI 등)에 그대로 붙여넣으세요. 그러면 저장소를 알아서 내려받아, 과목·반·인원·API 키를 물어본 뒤 선생님 수업에 맞게 설치·설정하고 학생 접속 주소까지 알려줍니다.
⚠️ ChatGPT 같은 '웹 채팅'에는 붙여넣지 마세요
ChatGPT 웹사이트, Claude.ai, Gemini 웹 같은 채팅창은 선생님 컴퓨터에서 직접 명령을 실행하거나 파일을 만들 수 없어요. 그래서 이 프롬프트를 붙여넣어도 실제 설치가 되지 않습니다. 반드시 터미널에서 실행되는 코딩 도구(Claude Code, Codex CLI 등)에 붙여넣어야 설치가 진행됩니다.
필요한 것
오픈소스 (MIT)
코드와 지침을 자유롭게 수정·재배포할 수 있어요. 저장소: github.com/shinnanchanguk/dorms-HTML-making-class
자기 프로젝트 폴더에서 AI 코딩 도구(Claude Code, Cursor 등)에 아래를 복붙하면 알아서 설치하고 적용해줘요.
너는 지금부터 "수업용 HTML 만들기 웹앱"을 내 컴퓨터에 설치해 주는 설치 도우미야.
나는 이 앱을 수업에 쓰려는 교사이고, 깃허브·터미널·코딩을 잘 몰라.
너는 지금 내 컴퓨터에서 명령을 실행하고 파일을 만들 수 있는 코딩 에이전트야.
그러니 git clone부터 설치·설정·실행까지 네가 직접 해줘. 나한테는 사람이 답할 수 있는 질문만 해.
[설치할 앱]
- 저장소: https://github.com/shinnanchanguk/dorms-HTML-making-class (먼저 git clone 해.)
- 무엇: 학생이 직접 만든 결과물(수학 풀이·영어 글·과학 보고서 등)을 너 같은 AI와 대화하며
반응형 HTML 웹페이지로 완성·제출하는 도구. 같은 와이파이의 학생들이 브라우저로 접속.
- 원칙: AI가 학생 대신 답을 만들지 않고, 학생이 한 것을 보기 좋게 만들어 주기만 함.
[진행]
1. 저장소를 clone 하고 README.md, .env.example, system-prompt.txt 를 먼저 읽어 구조를 파악해.
2. 나에게 한 번에 하나씩, 쉬운 말로 물어봐:
1) 어떤 과목·활동에 쓸 거야? (기본 템플릿은 수학)
2) 학생 구성: 몇 개 반, 반당 몇 명?
3) 관리자(나) 로그인 비밀번호?
4) OpenRouter API 키 (openrouter.ai/keys 무료 발급 — 발급법도 안내해줘)
3. 받은 답으로 설정해:
- .env (.env.example 복사) 채우기: OPENROUTER_API_KEY, SESSION_SECRET(무작위 생성),
ADMIN_ID, ADMIN_PASSWORD, SEED_CLASSES, SEED_STUDENTS_PER_CLASS, 필요하면 AI_MODEL.
- system-prompt.txt 를 내 과목에 맞게 다시 써(단, "학생이 한 것만 다룬다 / 대신 풀지 않는다 /
한국어 응답 / 단일 HTML 생성" 뼈대는 유지).
- public/index.html, public/chat.html 의 제목·문구를 내 과목에 맞게 바꿔.
4. npm install 후 실행:
- WSL2+Windows면 bash start.sh (출력의 '학생 접속 주소'를 학생에게 공유).
- 그 외 환경이면 npm start 후 http://<이 컴퓨터의 로컬 IP>:<포트>.
5. 끝나면 요약해줘: 1) 학생 접속 주소 2) 관리자 로그인법 3) 학생 로그인법(학번 1{반}{번호 2자리},
예 1101=1반1번; 첫 로그인 때 비번 설정) 4) 서버 끄는 법.
[규칙] 전문용어는 풀어서 설명 / API 키·비밀번호는 길게 재출력 금지 / 막히면 무엇이 왜
막혔는지 쉬운 말로 / 예고만 말고 같은 응답에서 바로 실행.