학원 운영의 핵심 네 개, 하나로 묶는 HagwonLoop
AI로 만들어진 게시물입니다.
분절된 학원 운영을 하나의 흐름으로 묶는 방법
학원 운영에서는 같은 업무가 여러 화면과 기능에 흩어져 있으면, 핵심 판단이 느려지고 실수가 늘어납니다.
특히 "등록·출결·결제·알림"은 가장 자주 반복되는 축이라, 한 단계라도 끊기면 운영 리듬이 깨집니다.
HagwonLoop는 이 네 축을 분절되지 않은 운영 흐름으로 정리하려는 구조를 전면에 둔 플랫폼입니다.
`04_PORTFOLIO_BRIEF.md`와 `portfolio-data.js`에서 HagwonLoop는 명시적으로 "학원 운영의 등록·출결·결제·알림을 한 흐름으로 묶는 교육 운영 플랫폼"으로 소개됩니다.

관리자 화면에서 템플릿 설정, 수업 개설, 학생 등록·수강, 청구까지 학원 운영 흐름을 한 화면 구조로 보여준다.
왜 지금 이 글이 필요한가
요즘 많은 학원이 운영 자동화를 이야기할 때"결제만" 혹은 "출결만" 먼저 손대는 경우가 많습니다. 그러나 현장에서는 문제의 원인이 분절된 업무 체계에 있는 경우가 더 흔합니다.
HagwonLoop 공개 소스는 학원 운영을 "백오피스 우선" 구조로 잡고, 등록/운영/알림 흐름을 단계적으로 확장한다는 설계를 내세웁니다.
즉, 이 글은 성능·가격 비교형 비교 리뷰가 아닙니다.
업무를 어디서부터 시작해 어떤 동선으로 운영할 것인가에 대한 관점으로 설명합니다.
기본 메시지: 한 화면이 아니라 한 흐름
서비스 설명 키워드는 세 부분입니다.
1) **역할별 운영 흐름 정렬**
`04_PORTFOLIO_BRIEF.md`의 `Current Highlights`와 `Ops / Automation Points`는 관리자, 교사, 학부모 역할을 분리해 설명합니다.
`manifest.json`의 `gallery`도 역할별 화면(관리자 운영, 교사 출결, 학부모 내 아이 기록)로 공개 화면 구성을 갖추고 있습니다.
2) **운영 플로우 중심 고도화**
`portfolio-data.js`의 HagwonLoop 항목은 접근성을 위해 등록→출결→결제→알림을 한 흐름으로 묶고, 백오피스 우선 설계를 강화할 것을 명시합니다.
3) **운영 인프라의 안정성 방향성**
동일 항목에서 FastAPI, Nginx, Docker가 기술 키워드로 제시되며, `README.md`에는 배포/정합성 관점 가드와 서비스 격리 체크, health/readiness 체크 명령, 재기동 전 점검 흐름이 함께 제시됩니다.
핵심 업무 흐름을 기준으로 보는 HagwonLoop
아래 흐름은 실제 소개자료에서 제안하는 핵심 전개 순서에 맞춰 확인하면 이해가 쉬워집니다.
1. 등록과 운영 프로필의 연결
관리자/교사가 학생·수업·운영 정책을 구성할 수 있는 백오피스 맥락을 먼저 잡는 흐름이 출발점입니다.
`portfolio-data.js`의 `approach` 문구는 바로 이 점을 강조합니다.
2. 출결 운영의 정규화
출결은 단순 기록이 아니라 수업 운영의 신뢰성을 만드는 축입니다.
`README.md`는 요일/시간대 그리드 기반 수업 화면, 출결 처리 API, 자동 체크 및 요약 대시보드가 함께 제시되며, 화면 흐름을 운영 루프로 확장하려는 정합성이 보입니다.

교사 화면에서 출결 현황과 수업 기준 조회 흐름을 확인할 수 있어 현장 출결 운영 역할이 분리되어 있음을 보여준다.
3. 결제·청구 자동화 방향
기본 문헌에서 요금 템플릿 기반 청구 합산, 학부모 결제/결제 상태 조회, 인보이스 승인/관리 흐름이 정리됩니다.
이는 단순 결제 버튼 추가가 아니라 월 단위 운영 리듬과 결제 오퍼레이션을 같은 맥락에 두려는 설계로 읽힙니다.
4. 알림 체계와 안내 신뢰성
학부모 안내는 `README.md`의 자동 알림/재시도 정책, 테스트 알림 API 등에서 운영 점검 루프로 드러납니다.
학부모 화면을 분리해 제공하고, 채널 정책에 맞춰 전달 흐름을 정리하는 방식은 수동 공지를 줄이는 방향과 일치합니다.
실제로는 어디서부터 확인하면 좋은가
글에서 과장된 수치나 가정으로 매듭짓는 대신, 제품 스크린샷을 중심으로 검증 포인트를 제시하는 것이 좋습니다.
권장 확인 순서:
- 관리자 운영 대시보드(전체 현황, 수업/결제/템플릿 연동 가능성)
- 교사 출결 화면(수업 선택, 즉시 출결 처리, 이슈 추적)
- 학부모 내 아이 기록 화면(출결/영상/기록 열람)
- 운영 콘솔 패널(테스트 알림, 월청구/상태 확인, 부모 연결)
이 순서는 공개된 gallery 및 문서가 실제로 다루는 역할 축과 맞물립니다.

학부모 화면에서 자녀 기록과 출석·영상 조회 흐름을 확인할 수 있어 운영 결과가 보호자 경험까지 연결된다는 점을 보여준다.
놓치기 쉬운 운영 포인트
기능 설명만으로는 놓치기 쉬운 항목은 다음입니다.
- **서비스 격리 원칙**: `README.md`는 다른 프로젝트 영향 방지를 위한 배포 점검을 명시합니다.
- **안전한 운영 흐름**: 내부 작업 큐(예: attendance-auto-check, notification-retry)처럼 운영 자동화를 문서 단계에서 분리해 설계합니다.
- **확장성 대비**: 모바일 앱/학생 성과 기록 같은 확장 항목은 문서화돼 있으며, 현재 진행 중인 고도화의 방향성 체크포인트가 됩니다.
마무리
HagwonLoop는 “결제 기능이 있다, 출결 기능이 있다”가 아니라, 운영 책임이 분절되지 않는 구조를 만든다는 점이 핵심입니다.
학원 운영에 필요한 네 가지 축을 하나의 흐름으로 묶고, 역할별 경험을 같은 운영 체계로 설계했다는 점을 중심으로 소개하면, 티스토리 독자가 이해하기 쉬운 실무형 글이 됩니다.
실제 운영 화면과 역할별 흐름을 확인하려면 https://hagwonloop.devscent.com 에서 공식 화면과 운영 기능을 점검해 보세요.
AI로 만들어진 게시물입니다.