AI 교무실 만들기 키트

이런 불편을 덜어 줍니다

교무실의 일은 여러 도구에 흩어져 있습니다. 휴대폰 한 화면으로 모읍니다.

지금

업무 요청은 단체 대화방에

수업 중에도 알림이 울리고, 누가 읽었는지·끝냈는지 일일이 확인해야 합니다.

바꾸면 학교 일을 아는 업무 메신저로. 받는 사람은 [넵]·[완료] 하나만 누르고, 수업 중에는 쉬는 시간에 배달됩니다.

지금

양식은 드라이브 어딘가에

부서 폴더를 뒤지고, 링크만 알면 누구나 보는 자료도 섞여 있습니다.

바꾸면 교직원만 들어오는 자료실에서 부서별로 찾고 검색합니다.

지금

시간표가 바뀌면 다시 엑셀

파일을 다시 뽑아 나눠 주고, 휴대폰에서 확대해 봅니다.

바꾸면 한 번 올리면 교사·학급·교실별로, 지금 빈 교실까지 보입니다.

시작은 세 단계

코딩을 몰라도 됩니다. 다만 Claude Code나 Codex를 한 번은 써 보셨으면 좋습니다.

템플릿으로 내 저장소 만들기

GitHub 저장소에서 Use this template → Create a new repository를 누르고, 이름을 정한 뒤 Private(비공개)을 고릅니다.

꼭 비공개로. 이 저장소에 우리 학교 정보와 구축 기록이 쌓입니다.

내 컴퓨터로 받아 폴더 열기

터미널에서 아래처럼 받고, 그 폴더에서 Claude Code(claude) 또는 Codex(codex)를 실행합니다.

# 「내아이디/저장소이름」을 1단계에서 만든 것으로 바꿉니다 $ git clone https://github.com/내아이디/저장소이름.git $ cd 저장소이름 $ claude # 또는 codex

첫마디

이렇게만 말하면 AI가 우리 학교 사정부터 묻기 시작합니다(20~30분 인터뷰).

우리 학교 교무실 만들기 시작하자

그다음은 AI가 이끕니다

대화가 끊겨도 괜찮습니다. 우리 학교 정보(school-profile.md)와 구축 기록(progress.md)에 남아, 다음 대화가 이어받습니다.

인터뷰학교 사정·쓰는 도구·가장 덜고 싶은 불편

단계 계획먼저 있어야 할 것부터 순서를 짭니다

설계 메모화면·권한을 정하고 함정을 미리 옮겨 둡니다

구현작게 나눠 만들고 휴대폰에서 확인

관문 검사넘어가기 전에 놓친 것을 자동으로 찾습니다

이렇게 말하면 됩니다

누르면 복사됩니다.

관문 검사는 이런 것을 찾습니다

권한(RLS)을 켜지 않은 표

코드에 들어간 비밀 키·.env 파일

뷰를 통해 원래 표를 고칠 수 있는 권한

로그인 안 해도 읽히는 정책·뷰

「교직원만」 제한 정책이 빠진 표

로그인 확인 없이 열리는 서버 코드

서울 오전 9시 전에 하루 어긋나는 날짜

아이폰에서 흔들리는 하단 탭

통과한 것은 짧게 한 줄로

시작 전에 꼭 알아 두세요

기술보다 이쪽이 더 중요합니다. 미리 알면 중간에 지치지 않습니다.

시간 — 한 학기

원본 학교는 거의 매일 붙어서 핵심 기능까지 한 달, 지금 모습까지 한 달 반 걸렸습니다. 수업하면서라면 핵심 기능(급식·공지·시간표·자료실·알림)까지 한 학기를 잡으세요.

책임 — 막히는 게 정상

교직원 정보를 다루는 사이트입니다. 관리자 합의, 학교 공용 계정, 정보보안 확인이 없으면 키트가 1단계로 넘어가지 않습니다.

비용 — 무료로 시작

Supabase·Vercel 무료 요금제로 시작합니다. AI 도우미를 붙이면 월 몇만 원 — 결제 주체를 먼저 정하고 회사 콘솔에 지출 한도를 겁니다.

첫 목표 — 작게

핵심 기능을 만들어 시범 사용자 3~5명에게 한 주 써 보게 하는 것. 업무 요청·교실 칠판·AI 도우미 같은 큰 기능은 그 뒤에.

준비물 체크리스트

체크한 것은 이 기기에 기억됩니다. 자세한 내용은 준비물 문서에.

0 / 9

교감 선생님(또는 학교 관리자)과 합의했다무엇을, 누가 운영, 비용은 어디서
정보보안 담당께 확인했다교직원·학생 정보를 해외 클라우드에 두는 것, 처리 범위
학교 공용 메일을 정했다서비스 계정을 개인 명의로 만들면 전근 때 사이트가 같이 떠납니다
GitHub 계정
Supabase 계정데이터베이스·로그인·파일. 서울 지역으로
Vercel 계정사이트 주소. GitHub와 연결하면 자동 배포
내 컴퓨터에 Node.js와 git
Claude Code 또는 Codex
시범 사용자 3~5명첫 공개 전에 한 주 써 볼 선생님

무엇을 만들 수 있나

원본 학교의 모듈 33개입니다. 핵심부터 만들고, 나머지는 학교 사정에 맞게 고릅니다. 학교마다 다른 것(시간표 파일 형식, 학부모 창구 등)은 인터뷰에서 정합니다.

핵심 먼저

앱 틀·공통 부품 중
로그인·계정 중
관리 화면 중
급식 하
공지 하~중
홈 중
시간표 중
일정 중
담임 배정 하
자료실 중
알림(웹푸시) 중
알림함 하~중

선택 학교 사정 따라

결석 접수 중
체험학습 신청 하~중
보건실 알림 하~중
교실 칠판 알림 상
세특 도우미 상
수업교체 중~상
교과협의록 하~중
분실물 함 중
학생 사진 명렬표 (기본 꺼짐) 중
학교 행사 화면 하~중
날씨 따라 바뀌는 안내 중

키트 안에 든 것

에이전트가 읽는 문서이지만, 사람이 읽어도 되게 썼습니다.

키트는 계속 좋아집니다

새 함정, 더 꼼꼼한 관문 검사가 생기면 새 판이 나옵니다. 템플릿으로 만든 저장소는 저절로 따라오지 않으니, 가끔 이렇게 말하세요.

「키트 업데이트해 줘」

AI가 바뀌는 것을 먼저 보여 주고, 허락을 받은 뒤에 적용합니다. 직접 하려면:

node kit/scripts/update-kit.mjs

우리 학교 것은 안전합니다

앱 코드, 우리 학교 정보, 구축 기록은 건드리지 않습니다. 키트 문서라도 우리가 고친 파일은 덮어쓰지 않고, 키트 쪽도 바뀌었으면 새 판을 옆에 두어 함께 합칩니다.

질문과 나눔

막히면 혼자 끙끙대지 말고 물어 주세요. 우리 학교에서 새로 알게 된 함정을 나눠 주시면, 다음 학교가 덜 헤맵니다.

Discussions에서 묻기·나누기 GitHub 저장소