본문으로 건너뛰기

[Fivemonkeys_강강] 강의 운영 자동화 - 수강생 관리 / 대시보드 / 문자 발송

송주환

2026.06.02

[Fivemonkeys_강강] 강의 운영 자동화 - 수강생 관리 / 대시보드 / 문자 발송 본문 이미지

## 📝 한줄 요약

학원에서 매번 수동으로 하던 출석 체크, 진도 기록, SMS 발송을 Claude Code와 함께 웹사이트 하나로 통합했습니다.

**바쁘시면 이것만 읽어도 돼요:**
- Claude Code로 강의 관리 웹사이트 구축 — 출석·진도·SMS 통합
- AI가 커리큘럼을 멋대로 추정해 넣었다가 적발됨(할루시네이션) → 실제 교재 목차로 교체
- 이제 학생 선택 후 클릭 한 번으로 SMS 발송 가능 (숙제 및 공지사항 문자 발송 가능)

한국사이트 스크린샷

## 🎯 이런 분들께 도움돼요
- 학원·과외를 운영하며 정리가 안돼 복잡한 선생님들
- 개발자 없이 업무 자동화 도구를 직접 만들어보고 싶은 분
- 소규모 운영(학생 10명 내외)이라 외부 솔루션이 오버스펙인 분

## 😫 문제 상황 (Before)

학생이 8명밖에 안 되는 규모지만, 반복 작업은 생각보다 많이 쌓임.

수업이 끝날 때마다 출석을 따로 기록하고, 진도는 어디까지 나갔는지 머릿속에서 꺼내서 메모장에 적고, 매번 일일히 수동으로 문자를 발송해야 함. 특이사항이 생기면 학부모에게 문자를 일일이 보내야 했음. 학생 수가 적다 보니 전문 학원 관리 소프트웨어를 쓰기엔 오버스펙.

## 🛠️ 사용한 도구
- **도구명**: Claude Code
- **모델**: Claude Sonnet 4.6
- **문자 발송 API** : 솔라피(일반 문자 한 건 85원)
- **특이사항**: 총총(오케스트레이터)이 강강(개발 담당 서브에이전트)에게 작업을 위임하는 서브에이전트 구조로 운영

---

## 🔧 작업 과정

### 뼈대 만들기 — "학년 넣고, SMS 로그도 보여줘"

처음에는 기본 골격부터 요청했습니다. 학생 정보에 학년을 넣고, SMS 발송 내역을 한눈에 볼 수 있으면 된다고 했습니다.

```
수강생 등록에 학년 항목 추가해줘, 그리고 sms 발송 기능은 진도관리에 있는 곳에 넣고싶어, 각 개인마다 진도가 다르니까 거기서 진도 확인하고 sms 발송할 수 있게, 지금 있는 sms 발송은 sms 발송 로그관련된 내용으로 수정해줘 내가 보낸 sms 내용 일시 한 눈에 확인할 수 있게
```

Claude Code가 Next.js 기반 웹사이트를 만들어줬습니다. 수강생 등록 화면에 학년 항목이 생겼고, 진도 관리 화면에 학생별 SMS 발송 버튼이 붙었습니다. 기존에 있던 SMS 화면은 발송 이력 로그 화면으로 바뀌었습니다.

---

### 디테일 추가 — "부모님 연락처도 넣어줘"

기본 기능이 돌아가니 하나 더 생각이 났습니다.

```
연락처에 부모님 연락처도 포함해줘, 그리고 sms 발송도 학생 따로, 부모님 연락처에 보내는거 따로 수정해줘
```

학생 DB에 부모님 연락처 필드가 추가됐고, SMS 발송 시 학생에게 보낼지 부모님께 보낼지 선택할 수 있게 됐습니다. 그 다음엔 출석과 진도 관리 화면이 분리되어 있는 게 번거롭다는 생각이 들어서 하나로 합쳐달라고 했습니다.

---

### AI가 맘대로 커리큘럼을 채운 사건 — 제일 인상적인 순간

새 기능을 요청했습니다. 내가 어떤 학년을 가르치는지 등록해두면, 수업 추가할 때 그 학년 커리큘럼 단원이 자동으로 나오게 해달라는 내용이었습니다.

```
내 수업 항목이라는 왼쪽 네비게이션 메뉴 추가해줘, 그리고 거기서 내가 어떤 학년을 수업하는지 저장할 수 있게 해줘, 수업 추가할때 학년에 맞는 커리큘럼 (비상교재 오투 기준) 단원을 넣을 수 있게
```

기능 자체는 잘 만들어줬는데, 문제는 커리큘럼 데이터였습니다. AI가 "비상교재 오투"의 실제 목차를 모르니까 그럴듯한 단원명을 스스로 추정해서 채워 넣었습니다.

```
뭐야.... 이렇게 맘대로 하면 안돼 앞으로, 실제 있는 데이터 기반으로 나한테 알려줘야해
```

이 한 마디로 정리됐습니다. AI가 모르는 건 모른다고 해야지, 그럴듯하게 만들어 넣으면 안 된다는 원칙을 확인한 순간이었습니다.

AI가 추정으로 넣은 데이터를 전부 지우고, 내가 제공한 실제 목차로 다시 채웠습니다. 중1·중2 합쳐 총 37개 소단원, 전부 실제 교재 기준입니다.

---

### 막혔던 버그 두 가지 — 그냥 넘어가지 않고 끝까지

**버그 1: 학년 필터링이 안 되는 문제**

수업 화면에서 "중1 수업"을 선택하면 중1 학생 명단이 나와야 하는데, 화면이 비어 있었습니다.

```
잘돼 근데 이제 수업관리에서 중1이면은 중1 명단이 떠야하는데 안떠 수정해줘
```

원인을 찾아보니, 수업에 저장된 학년이 "중1 1학기"이고 학생 정보에 저장된 학년은 "중1"이라 비교할 때 다른 값으로 인식했던 겁니다. 수업 학년에서 학기 정보를 빼고 비교하도록 수정했더니 바로 해결됐습니다.

**버그 2: SMS 발송 실패**

SMS 버튼을 눌렀더니 오류가 났습니다.

```
학생: 실패: 해당 그룹에 발송 가능한 메시지가 존재하지 않습니다.
```

두 가지 문제가 겹쳐 있었습니다. 첫째, SMS API에 전화번호 문자열만 보내야 하는데 학생 정보 객체 전체를 보내고 있었습니다. 둘째, 전화번호에 하이픈(-)이 있으면 솔라피 API가 거부합니다. 두 가지를 모두 수정하고 나서 테스트에 성공했습니다.

```
성공했네
```

짧지만 이 한 마디가 제일 시원했습니다.

---

## ✅ 결과 (After)

### Before vs After
| 항목 | Before | After |
|------|--------|-------|
| 출석 기록 | 수동 메모 | 웹 화면에서 클릭으로 처리 |
| 진도 관리 | 흩어진 메모 | 학생별 진도 화면에서 통합 확인 |
| SMS 발송 | 연락처 앱에서 직접 발송 | 학생 선택 후 클릭 한 번으로 발송 |
| 발송 이력 | 확인 불가 | 발송 내용·일시 로그로 기록 |
| 커리큘럼 | 머릿속에만 있음 | 실제 교재 기준 37소단원 DB 등록 |

### 결과물
- 로컬(localhost)에서 실행 가능한 강의 관리 웹사이트
- 솔라피 API 연동 완료 — 실제 SMS 발송 테스트 성공
- 비상교재 오투 중1·중2 실제 커리큘럼 37소단원 등록

## 💬 이 과정에서 배운 AI 활용 팁

### 효과적이었던 것
1. **할루시네이션**: AI가 추정으로 넣은 커리큘럼 데이터는 쓸 수 없었습니다. "모르면 모른다고 해"라고 한 번 정해두고, 실제 데이터가 있는 위치를 알려주니 제대로 크롤링 했습니다.
2. **버그를 그냥 넘기지 않기**: "화면이 비어 있다", "발송이 안 된다"처럼 증상을 구체적으로 말해주면 AI가 원인을 찾아줍니다. 그냥 지나치면 나중에 더 큰 문제가 됩니다.
3. **한 번에 하나씩 요청하기**: 요청을 한꺼번에 너무 많이 넣으면 빠진 게 생깁니다. 하나 완료되면 확인하고 다음 요청으로 넘어가는 게 결과 품질이 더 좋았습니다.

### 이렇게 하면 안 돼요
1. **AI가 채운 데이터 그냥 믿기**: 특히 교재·제품명·수치처럼 정확해야 하는 데이터는 AI가 그럴듯하게 꾸며낼 수 있습니다. 반드시 직접 확인하세요.
2. **동작 안 할 때 그냥 "다시 해줘" 반복**: 어떤 화면에서 어떤 버튼을 눌렀을 때 어떤 메시지가 나왔는지 구체적으로 전달해야 AI가 올바르게 수정합니다.

## 🌍 다른 업무에 적용한다면?

이번 구조(등록 → 관리 → 알림 발송)는 학원 외에도 비슷한 상황이 많습니다.
- 스터디 그룹 운영 — 참가자 등록·출석·공지 발송
- 소규모 피트니스 센터 — 회원 등록·수업 일정·결석 알림
- 커뮤니티 소모임 — 멤버 관리·활동 기록·공지 문자

핵심은 "반복되는 행동 3가지를 꼽아서 하나의 화면으로 묶어달라고 요청하는 것"입니다. 처음부터 완벽하게 만들려 하지 않고, 동작하는 것부터 만든 다음 버그를 잡아가는 방식이 효과적이었습니다.

## 🚀 앞으로의 계획

- **배포**: 굳이 배포하지 않고, 로컬에서만 돌아가게 구축, 필요성을 느끼면 배포할 예정
- **학생 포털**: 문자 메시지 템플릿 구축 예정 (진도 및 공지 등 여러 템플릿)
- **커리큘럼 확장**: 중3, 수학 과목 등 다른 교재 목차도 등록

## 📋 재사용 가능한 프롬프트

### 프롬프트 1: 반복 행정 업무 자동화 시작
> 나는 [직업/역할]이야. 매번 반복하는 작업이 있는데, [작업 A], [작업 B], [작업 C]야. 이걸 한 화면에서 처리할 수 있는 간단한 웹 도구를 만들어줘. 데이터는 로컬에 저장하면 돼.
>
> [직업/역할], [작업 A], [작업 B], [작업 C]를 본인 상황에 맞게 바꾸세요.

### 프롬프트 2: AI가 모르는 데이터를 안전하게 처리하기
> 아래 항목은 실제 데이터야. AI가 추정하거나 만들어내지 말고, 내가 제공하는 내용 그대로만 사용해줘:
> [실제 데이터 붙여넣기]
>
> AI에게 교재 목차, 제품명, 가격 같은 정확한 데이터를 넣어야 할 때 사용하세요.

### 프롬프트 3: 버그 리포트
> [기능 이름]에서 문제가 생겼어. 구체적인 상황은 이래:
> - 어떤 화면에서: [화면명]
> - 어떤 버튼을 눌렀을 때: [버튼명]
> - 나온 오류 메시지: [오류 내용]
> 원인 분석해주고 수정해줘.
>
> 버그 증상을 AI에게 전달할 때 이 형식으로 주면 원인 파악이 훨씬 빠릅니다.
3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

윤스케어 프로필 이미지
윤스케어2026.06.03

AI가 커리큘럼을 맘대로 추정해 넣었다가 적발하신 순간이 정말 재미있네요. "모르면 모른다고 해"라고 원칙을 세우고 실제 교재 목차 37개 소단원을 직접 넣으신 흐름이 좋아요. 출석·진도·SMS를 한 화면으로 묶어서 클릭 한 번에 발송까지 가능하게 만드신 결과물, 다음에 다른 과목으로 확장하실 때도 이 패턴 그대로 가져가실 수 있겠어요.

도로시J 프로필 이미지
도로시J2026.06.03

베스트 사례 발표도 여유있게^^ 이번에도 그 후속 작업으로 좋네요. 전체 플로우가 매우 체계적이라 잘 배웁니다. 활용할 곳이 많아요.
실제 데이터가 있는 위치를 알려주니 제대로 크롤링했다는 표현이 뭘가요??

송주환 프로필 이미지
송주환2026.06.03

클로드가 학년, 학기 별 목차를 긁어올 페이지를 구체적으로 알려줬다는 뜻입니다! (실제로 사용할 교재의 목차 url)

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기