학교 행정업무 최적화 모델 1.0 — 상세 설명서

개요1. 이 시스템은 무엇인가

동아리·방과후 부서마다 만들던 출석부와 지도일지를 웹에서 작성하고, 손글씨 전자서명까지 받아 A4 문서로 인쇄·PDF 저장하는 도구입니다. 설치할 것이 없고 주소만 열면 태블릿·PC·휴대폰 어디서나 같은 화면이 뜹니다.

핵심 특징

1부 교사용2. 접속과 화면 구성

1. 브라우저 주소창에 gisan-hwaldong.pages.dev 를 입력합니다. (즐겨찾기·홈 화면에 추가해 두면 편합니다.)
2. 학교 항공사진 화면이 뜨면 접속 코드를 입력하고 입장을 누릅니다. 코드는 관리자에게 받으세요.
3. 부서 목록이 나옵니다. 담당 부서의 열기를 누르면 그 부서의 작업 화면으로 들어갑니다.

탭 구조 — 왼쪽에서 오른쪽 순서대로 진행하면 됩니다

헤더(맨 위 줄)에는 가＋(글자 크기), 💡 도움말(안내문 접기), ↻ 새로고침, 📋 연수 등록부, ⚙ 관리자, 로그아웃과 저장 상태 표시가 있습니다. 오른쪽 끝의 “✓ 저장됨” 표시로 저장 여부를 항상 확인할 수 있습니다.

1부 교사용3. ① 기본설정 — 부서 정보와 지도계획

운영계획서 불러오기(자동 분석)

학교에 제출한 운영계획서 파일을 그대로 올리면 부서명·장소·요일/시간과 차시별 주제·활동내용이 한 번에 채워집니다.

• 지원 형식: Excel(.xlsx/.csv) · Word(.docx) · PDF · 텍스트(.txt)
• 한글(HWP)은 “다른 이름으로 저장 → PDF”로 바꿔서 올리세요.
• 파일이 없으면 아래 칸에 표 내용을 복사·붙여넣기하고 붙여넣은 내용으로 채우기를 눌러도 됩니다. (한 줄에 “차시 / 주제 / 내용”)

부서 정보

학교명(관리자에서 변경) · 학년도·학기 · 부서명 · 활동 장소 · 운영 요일·시간을 입력합니다. 여기 넣은 값이 출석부·지도일지 문서 상단에 그대로 인쇄됩니다.

지도계획(차시별 운영계획)

차시마다 예정일 · 활동 주제 · 활동 내용을 적어 둡니다. 여기를 채워 두면 ③지도일지에서 날짜만 고르면 주제·내용이 자동으로 들어옵니다.

• + 차시 추가 로 줄을 늘리고, 줄 끝 × 로 지웁니다.
• 예정일 달력에 날짜를 넣으면 그 날짜가 출석부의 회차로도 함께 등록되고, 날짜순으로 자동 정렬됩니다.
• 기본 템플릿으로 초기화 는 지도계획을 처음 상태로 되돌립니다(되돌리기 전 확인 창이 뜹니다).

1부 교사용4. ② 출석부 — 참여 학생·회차·출결

4-1. 참여 학생 선택

전교생 명단에서 우리 부서에 오는 학생만 체크합니다. 체크한 학생만 아래 출석부 표에 나타납니다. 전체 선택/전체 해제 도 있습니다.

4-2. 회차(날짜) 추가

1. 날짜 칸에서 활동한 날짜를 고릅니다.
2. + 회차 추가 를 누르면 출석부에 그 날짜 열이 생깁니다.
3. 회차를 지우려면 날짜 칩의 × 를 누릅니다. (출결·일지가 있는 회차는 확인 창이 뜹니다.)

같은 날 여러 차시를 진행한 경우

오전·오후처럼 하루에 두 번 이상 운영했다면, 같은 날짜를 한 번 더 추가하세요. “같은 날 2번째 회차로 추가할까요?”라는 확인 창이 뜨고, 확인하면 회차가 하나 더 생깁니다.

• 표시는 7/30, 7/30②, 7/30③ … 처럼 원 숫자로 구분됩니다(문서·CSV에도 그대로 반영).
• 회차마다 출결도 지도일지도 따로 관리됩니다. 하루 최대 9회차까지 가능합니다.
• 실수로 같은 날짜를 두 번 누른 경우에는 확인 창에서 취소를 누르면 됩니다.

4-3. 출결 입력

학생×날짜 칸을 누를 때마다 상태가 순서대로 바뀝니다.

시간대(분반)별로 오는 학생이 다를 때

같은 프로그램인데 오전반·오후반처럼 회차마다 참여 학생이 다른 경우의 입력 순서입니다.

1. 같은 날짜를 두 번 추가해 회차를 나눕니다(7/30, 7/30②).
2. 그 회차에 실제로 온 학생만 출결을 입력합니다.
3. 날짜 아래 나머지– 를 누르면 빈칸인 학생이 모두 미참여(–)로 한 번에 처리됩니다.

그 밖의 입력 도구

• 날짜 아래 전체○ — 그 회차만 전원 출석 처리
• 표 아래 ✓ 전체 출석 (모든 회차) — 모든 회차를 한 번에 처리(확인 창이 뜹니다)
• 맨 오른쪽 비고란 — 결석·지각 사유 등을 적으면 문서에 함께 인쇄됩니다
• 키보드로도 입력할 수 있습니다(칸 이동 후 Enter 또는 Space)

4-4. 출석 통계 · 엑셀(CSV) 내보내기

표 아래에서 학생별 출석·결석 횟수와 출석률, 부서 평균 출석률을 볼 수 있습니다. 엑셀(CSV) 내보내기를 누르면 학기말 보고·NEIS 입력에 쓸 수 있는 파일이 내려받아집니다(한글 깨짐 없이 엑셀에서 바로 열립니다).

출석률 = (출석 + 지각 + 조퇴) ÷ (전체 회차 − 미참여 회차)

1부 교사용5. ③ 지도일지

1. 날짜(활동 회차)를 고릅니다. 같은 날 여러 차시면 ②③ 표시로 구분되어 나옵니다.
2. 차시·참석 인원·활동 주제·활동 내용이 자동으로 채워집니다. (참석 인원은 출석부 기준, 주제·내용은 지도계획 기준)
3. 필요하면 고치고, 특이사항/평가를 적은 뒤 일지 저장을 누릅니다.

• 전체 날짜 일지 자동 생성 — 모든 회차의 일지를 한 번에 만듭니다. 같은 날짜의 기존 일지는 갱신되며, 실행 전 확인 창이 뜹니다. 먼저 만든 뒤 특이사항만 채워 넣는 방식이 빠릅니다.
• 작성된 일지는 아래 목록에 쌓이고 수정·삭제할 수 있습니다(삭제 시 확인 창).

1부 교사용6. ④ 서명 · 출력

6-1. 결재라인 구성(부서별)

문서 상단 결재란에 넣을 역할을 체크합니다. 지도교사 · 담당교사 · 교감 · 교장 중에서 고르며, 기본값은 지도교사·담당교사·교감입니다. 체크한 역할만 서명란과 결재란에 나타납니다.

6-2. 서명 넣는 두 가지 방법

6-3. 미리보기와 출력

• 미리보기 — 완성된 문서를 화면에서 확인합니다. 켜 두면 편집하는 동안 옆 패널에서 즉시 갱신되어 결과를 보면서 작업할 수 있습니다.
• 출력할 월 선택 — 회차가 여러 달에 걸쳐 있으면 원하는 월만 골라 인쇄할 수 있습니다.
• 용지 방향 — 기본은 세로입니다. 한 달 회차가 아주 많아 가로폭이 부족하면 가로로 바꾸세요.
• 🖨 PDF 저장 / 인쇄 — 인쇄 창에서 프린터 대신 “PDF로 저장”을 고르면 파일로 보관할 수 있습니다.

1부 교사용7. 연수 등록부 (부서와 별개)

교직원 연수·교육의 참석 서명부를 만드는 독립 기능입니다. 헤더의 📋 연수 등록부로 들어가며 관리자 코드는 필요 없습니다.

1. + 새 연수 등록부 로 만들고 열기.
2. 연수 정보(일자·과정명·장소·주관/강사·시간·이수시간·비고)를 입력합니다.
3. 참석자를 교직원 등록부에서 ＋ 참석자 추가 하거나 전체 교직원 추가 후 불참자를 제외합니다.
4. 참석자가 코드(개인 코드 4자리)로 서명하거나 손서명으로 그 자리에서 서명합니다.
5. 미리보기 → 🖨 인쇄 / PDF 저장.

1부 교사용8. 편의 기능과 안전장치

1부 교사용9. 자주 묻는 질문 (교사용)

Q. 저장 버튼이 안 보입니다.

없는 게 맞습니다. 입력하는 즉시 저장되며, 헤더 오른쪽에 “✓ 저장됨”이 표시됩니다. “⏳ 저장 중…”이 오래 머물면 인터넷 연결을 확인하세요.

Q. 다른 선생님이 입력한 내용이 안 보입니다.

보통은 자동으로 반영됩니다. 그래도 안 보이면 헤더의 ↻ 새로고침을 누르세요.

Q. 하루에 두 번 수업했는데 날짜를 추가할 수 없습니다.

같은 날짜를 다시 추가하면 “같은 날 2번째 회차로 추가할까요?” 확인 창이 뜹니다. 확인하면 7/30② 로 회차가 하나 더 생깁니다.

Q. 시간대별로 학생이 다른데 안 온 학생이 결석으로 잡힙니다.

결석(×) 대신 미참여(–) 로 표시하세요. 출결을 입력한 뒤 날짜 아래 나머지– 를 누르면 나머지가 한 번에 처리됩니다.

Q. 실수로 회차(또는 학생)를 지웠습니다.

회차·학생은 되돌리기가 없으므로 다시 입력해야 합니다. 부서 전체를 지운 경우에는 관리자 휴지통에서 그대로 복원할 수 있으니 관리자에게 연락하세요.

Q. 인쇄하면 표가 잘리거나 글씨가 세로로 깨집니다.

현재 버전에서는 해결되어 있습니다. 그래도 회차가 아주 많다면 용지 방향을 가로로 바꾸거나, 출력할 월을 나눠서 인쇄하세요.

Q. 개인 코드를 잊었습니다.

관리자에게 문의하면 바로 확인해 줍니다. 급하면 손서명으로 코드 없이 서명할 수 있습니다.

Q. 학생 이름이 명단에 없습니다.

부서 목록 탭 아래 ‘학교 전체 명단’에서 학년·성별·이름을 넣어 추가하거나 관리자에게 요청하세요. 한 번 추가하면 모든 부서에서 쓸 수 있습니다.

2부 관리자10. 관리자 — 진입과 초기 세팅

메인 화면 헤더의 ⚙ 관리자 → 관리자 코드를 입력하면 들어갑니다. 메인으로 돌아가거나 새로고침하면 자동으로 다시 잠깁니다(공용 기기 대비). 관리자 화면 안에서 작업하는 동안은 재입력이 필요 없습니다.

학교 도입 시 초기 세팅 순서

1. 로그인 코드 변경 — ‘로그인 코드 변경’에서 접속 코드와 관리자 코드를 학교 코드로 바꿉니다. 가장 먼저 하세요.
2. 학교 정보 — 학교명을 확인/변경합니다(문서에 인쇄되는 이름).
3. 학생 명단 — 전교생 명단을 채웁니다.
4. 교직원·외부강사 등록부 — 엑셀 명부를 올리거나 직접 추가합니다.
5. 개인 코드 일괄 발급 → 인쇄해서 개별 배부.
6. 전자서명 등록 — 협의회 때 태블릿을 돌려 각자 서명하게 합니다.
7. 부서 생성 + 부서별 서명자 지정.
8. 백업 1회 실행 — 이후 백업 리마인더의 기준이 됩니다.

2부 관리자11. 명단 · 교직원 · 서명자 관리

11-1. 학생 명단(전교생 공통)

학년·성별·이름으로 추가하고, 검색으로 찾아 삭제합니다. 관리자 화면과 부서 목록 탭 양쪽에서 관리할 수 있으며 내용은 같습니다.

11-2. 교직원 · 외부강사 등록부

교직원과 방과후 외부강사를 한 곳에서 관리합니다. 사람마다 직위 · 이름 · 구분(교직원/외부강사) · 전자서명 · 개인 코드를 가집니다.

• 엑셀 명부 업로드 — 직위(책)·이름 형식의 명부를 올리면 교직원이 갱신됩니다. 외부강사와 기존 개인 코드는 보존됩니다(학기 초 명부 갱신에 안전).
• 서명 등록 — 사람별 서명 버튼 → 서명판에 본인이 직접 서명 → 저장. 스타일러스 펜도 지원합니다.
• 배정 열은 그 사람이 서명자로 지정된 부서 수입니다.

개인 코드 발급과 배부

11-3. 부서별 서명자 지정

부서 × 역할(지도교사·담당교사·교감·교장) 표에서 담당 교직원을 미리 지정합니다. 지정만으로는 서명이 들어가지 않고, 본인이 코드를 입력해야 서명이 적용됩니다. 부서 담당 선생님이 매번 사람을 찾을 필요가 없어집니다.

2부 관리자12. 대시보드 · 백업 · 휴지통 · 이력

12-1. 사용 현황 대시보드

부서별로 참여 인원 · 회차 · 일지(작성/회차) · 출결누락 · 서명(완료/결재라인)을 한 표로 보여 줍니다. 점검이 필요한 부서는 연한 배경과 빨간 숫자로 표시됩니다.

학기말에 이 표만 보고 미작성 부서에 연락하면 누락을 막을 수 있습니다.

12-2. 데이터 백업 / 복원

• ⬇ 백업 내보내기 — 전체 데이터를 JSON 파일로 내려받습니다. 학기말·연말에 보관하세요.
• 복원 — 백업 파일을 올리면 그 시점으로 되돌립니다. GitHub에 쌓이는 자동 스냅샷 파일도 그대로 복원됩니다.
• 마지막 백업일과 경과일이 표시되며, 오래되면 경고가 뜹니다.

12-3. 휴지통

삭제한 부서가 보관됩니다. 복원하면 출석부·지도일지·서명이 그대로 돌아오고, 영구삭제는 되돌릴 수 없습니다.

12-4. 변경 이력(감사 로그)

서명 적용, 부서 삭제/복원, 백업, 초기화 등 주요 변경이 일시 · 동작 · 내용으로 기록됩니다(최근 500건). “누가 언제 서명했는지” 확인할 때 씁니다.

12-5. 전체 데이터 초기화

3부 인수인계13. 시스템 구조와 운영

13-1. 구성

13-2. 자동화되어 있는 것

• 자동 배포 — 소스를 GitHub에 올리면 자동 검사(단위 테스트 311개 + 실브라우저 검사)를 통과한 경우에만 사이트에 반영됩니다. 검사에 실패하면 배포가 중단됩니다.
• 자동 백업 + 접속 유지 — 월·목 오전 7시에 전체 데이터를 읽어 스냅샷으로 저장합니다. 이 “읽기”가 무료 플랜의 자동 일시정지를 막는 역할도 합니다(특히 방학 중 필수).
• 장애 감시 — 위 작업이 실패하면 GitHub이 이메일로 알려 줍니다. 백업 실패 메일이 오면 데이터베이스에 문제가 생겼다는 신호입니다.

13-3. 데이터가 저장되는 방식(개요)

데이터는 용도별로 나뉘어 저장됩니다: 부서 목록 · 전교생 명단 · 부서별 상태(출결·일지·서명) · 접속 코드 · 교직원 등록부 · 휴지통 · 변경 이력 · 연수 등록부. 여러 사람이 동시에 저장해도 섞이지 않도록 서버에서 순번을 검사하며, 충돌하면 사용자에게 선택을 묻습니다.

13-4. 담당자가 바뀔 때 넘겨야 할 것

• 접속 코드 · 관리자 코드
• GitHub 저장소 · Cloudflare · Supabase 계정 접근 권한
• 최근 백업 파일(또는 저장소 backups/ 폴더 위치)
• 이 문서와 /guide.html 위치

3부 인수인계14. 보안 모델과 한계 — 꼭 알고 쓰기

더 엄격한 통제(계정 로그인, 결재 순서 강제)가 필요해지면 로그인 방식 전환을 검토해야 합니다. 다만 “쉽고 빠르게 쓴다”는 현재의 설계 원칙과 상충하므로, 실제 필요가 생겼을 때 결정하는 것으로 정리되어 있습니다.

3부 인수인계15. 개발 이력과 앞으로의 계획

지금까지

운영 방식 — 피드백을 받아 계속 고칩니다

완성해 놓고 쓰는 방식이 아니라, 쓰면서 불편한 점을 모아 그때그때 반영하는 방식으로 운영합니다. 실제로 “하루에 여러 차시가 입력이 안 된다”, “시간대별로 인원이 다르다”는 현장 의견이 당일 반영되었습니다.

• 불편한 점·오류는 한 줄이라도 담당자에게 남겨 주세요(형식 없음).
• 수정은 자동 검사를 통과해야만 배포되며, 배포해도 입력한 데이터에는 영향이 없습니다.

앞으로 검토 중인 것

• 행정업무 확장 — 결재·교직원 기반을 재사용해 가정통신문 대장, 회의록, 물품·예산 간이대장, 간이 공문 결재 등으로 확대(우선순위는 현장 의견에 따라 결정).
• 타 학교 이관 — 학교명을 바꿔 다른 학교에서도 쓸 수 있는 구조입니다(각 학교가 자체 데이터베이스로 사본 배포).