사용 가이드 · hoopnote Academy

처음 쓰는 분도
5분이면 됩니다

출결 체크, AI 알림장, 학원비 수납까지 — 단계별로 따라해보세요.

최종 업데이트: 2026-04-22 버전: v0422 대상: 코치 · 원장

지금 바로 시작해보세요.
첫 달 완전 무료.

카카오 계정만 있으면 됩니다. 설치 불필요.

앱 시작하기 →

# hoopnote Academy — 베타 온보딩 가이드

> **코칭만 하세요. 알림장은 AI가 씁니다.**
>
> 처음 사용하시는 코치·원장님을 위한 5분 시작 가이드입니다.

---

## 준비물

- 스마트폰 (iOS / Android) 또는 PC 브라우저
- 카카오 계정

---

## 1단계 — 로그인

1. **academy.hoopnote.kr** 접속
2. `카카오로 로그인` 버튼 탭
3. 카카오 계정 인증

> 처음 로그인하면 "학원을 등록하세요" 팝업이 뜹니다 → 2단계로 이동.

---

## 2단계 — 학원 & 클래스 설정

### 학원 정보 등록

`설정` > `학원 정보` 에서:

| 항목 | 예시 |
|---|---|
| 학원명 | 용인 농구학원 |
| 학원 연락처 | 010-1234-5678 (**필수** — 미등록 시 모든 자동 알림 스킵) |
| 주소 | 경기도 용인시 기흥구 |

### 클래스 만들기

`학생 관리` > 클래스 탭 > `+ 클래스 추가`

| 항목 | 설명 |
|---|---|
| 클래스명 | 초등 화목반, 중등 주말반 등 |
| **수업 요일** | 출결·셔틀 필터 기준 — 이 설정이 없으면 출결 화면에 클래스가 표시되지 않습니다 |
| 색상 | 구분하기 편한 색 선택 |

---

## 3단계 — 학생 등록

### 방법 1 — 직접 입력 (1~5명)

`학생 관리` > `+ 학생 추가` → 이름, 등번호, 학부모 연락처 입력 후 저장

### 방법 2 — CSV 일괄 등록 (6명 이상 추천)

`학생 관리` > `CSV 등록` → 샘플 CSV 받기 → 엑셀에서 작성 후 업로드

```
이름,번호,학부모연락처,클래스명
김민준,7,01012345678,초등 화목반
이서연,11,01087654321,초등 화목반
```

> 최대 2,000명까지 일괄 업로드 가능합니다.

---

## 4단계 — 출결 체크 (매 수업마다)

하단 내비 → **출석** 탭

1. **요일 탭** 선택 (오늘 자동 선택됨)
2. **클래스** 선택 (해당 요일 클래스만 표시)
3. 학생별 버튼 탭 → 출석 / 결석 / 지각 / 사유 순환
4. 또는 `전체 출석` 버튼으로 일괄 처리 후 예외만 수정
5. `N명 출석 저장` — 수강권 회차 자동 소진

---

## 5단계 — AI 알림장 발송 (수업·경기 후)

하단 내비 → **알림장** 탭

1. 학생 선택
2. 코치 메모 30초 입력
   > 예시: "오늘 수비 집중력 향상. 민준 3점슛 2개 성공. 서연 패스 좋았음."
3. `AI 다듬기` → AI가 학부모용 문장으로 변환 (약 10초)
4. 학생별 코멘트 확인 후 `알림톡 발송`

학부모 폰에 카카오 알림톡으로 즉시 도착합니다.

---

## 자주 쓰는 기능

| 기능 | 경로 | 주 사용자 |
|---|---|---|
| 수납 알림톡 | 더보기 → 회차 관리 | 원장 |
| 공지 알림톡 | 더보기 → 공지 알림톡 | 코치·원장 |
| 일정 관리 | 더보기 → 일정 관리 | 코치·원장 |
| 경기 기록 | 더보기 → 경기 기록 | 코치 |
| AI 비서 채팅 | 더보기 → AI 비서 | 원장 |
| 셔틀 출발 알림 | `/shuttle` 접속 → 홈 화면 추가 (PWA) | 인솔 코치 |

---

## 문제가 생겼을 때

| 증상 | 해결 방법 |
|---|---|
| 출결 화면에 클래스가 안 보임 | 클래스 설정에서 수업 요일이 지정되어 있는지 확인 |
| 알림톡이 안 가요 | 학부모 연락처가 등록되어 있는지 확인 (학생 관리) |
| 수강권 회차가 안 줄어요 | 패키지 등록 여부 확인 (더보기 → 회차 관리) |
| 학원 등록 팝업이 계속 뜸 | 설정 > 학원 정보에서 학원명 저장 후 재로그인 |
| AI 알림장이 느려요 | 정상입니다. AI 처리 시간은 약 10~20초입니다. |

문의: **hello@hoopnote.kr** (평일 09:00~18:00)

# hoopnote Academy 상세 사용설명서

**코치·원장 통합 가이드 · v2.2 · 2026-04-22**

---

## 목차

1. hoopnote Academy 소개
2. 로그인
3. 원장 대시보드
4. 학원 정보 설정
5. 학생 관리
6. CSV 일괄 등록
7. 출결 체크
8. 세션 패키지
9. 수납 알림톡
10. 정산 현황
11. AI 알림장 작성
12. 공지 · 일정 등록
13. 경기 기록
14. 경기 히스토리
15. 내 프로필
16. AI 비서 채팅
17. 셔틀 출발 알림 (PWA)
18. 자주 묻는 질문
19. 베타 기간 제약사항 & 플랜

---

## 1. hoopnote Academy 소개

> **"코칭만 하세요. 알림장은 AI가 씁니다."**

| 업무 | 기존 방식 | hoopnote |
|---|---|---|
| 학생 명단 | 엑셀/수기 | 클래스별 탭 + CSV 일괄 등록 (2,000명) |
| 출결 체크 | 종이 출석부 | 원터치 + 자동 패키지 소진 |
| 학원비 수납 | 계좌이체 안내 | 링크 + 카카오 알림톡 자동 발송 |
| 학부모 소통 | 단톡방 타이핑 | **AI 자동 학생별 알림장** |
| 경기 기록 | 수기 스코어시트 | 8버튼 실시간 + 박스스코어 |
| 정산 | 매월 수동 계산 | 자동 + 수수료 + 미수금 현황 |

**역할**: 🧑‍💼 원장 · 👨‍🏫 코치 · 👨‍👩‍👧 학부모 (로그인 불필요, 알림톡 링크 열람)

---

## 2. 로그인

### 로그인 방법

1. `academy.hoopnote.kr` 접속
2. **카카오로 시작하기** 버튼 클릭
3. 카카오톡 계정 선택 → 자동 로그인
4. 첫 로그인 시 프로필 자동 등록

### 코치 초대

원장이 대시보드에서 생성한 **코치 초대 링크**를 공유하면, 코치가 링크 클릭 → 카카오 로그인 → 가입 요청 → 원장 승인 순으로 진행됩니다.

> 코치 주의: 앱을 먼저 열지 않아도 됩니다. 카카오톡에서 링크를 바로 누르면 됩니다 (`academy.hoopnote.kr/invite/...` 형식).

---

## 3. 원장 대시보드

`/academy-dashboard` — 학원 전체 현황 한눈에 보기 (원장 전용)

| 섹션 | 내용 |
|---|---|
| **통계 카드 4개** | 코치 수 / 학생 수 / 이번 달 경기 / 알림톡 사용량 |
| **코치 초대** | 8자리 토큰 링크 + 카톡 공유 + 재생성 |
| **오늘 출결 현황** | 수업별 출석/결석/미확인 카운트 (실시간) |
| **미수금 현황** | 총 미수금액 + 학생 수 |
| **코치별 활동** | 학생/경기/알림장 수 + 역할 배지 + 제거 버튼 |
| **AI 활동 로그** | 최근 30일 AI 호출 내역 |

---

## 4. 학원 정보 설정

`/settings` — 학원 이름, 알림장 템플릿 설정 (원장 전용)

| 항목 | 필수 | 설명 |
|---|---|---|
| 학원 이름 | ✅ | 최대 50자 |
| 지점명 | 선택 | 비우면 이름에서 자동 추출 |
| 학원 전화 | **필수** | 미등록 시 모든 자동 알림이 발송되지 않음 |
| 주소 | 선택 | 알림장 푸터용 |

### 알림장 템플릿

- **인사말** — 알림장 시작 문구
- **마무리말** — 알림장 끝 문구
- **톤** — 따뜻한 / 격식체 / 편한
- **미리보기** — 실시간 반영

---

## 5. 학생 관리

`/students` — 클래스 + 학생 (원장: 전체, 코치: 담당 클래스만)

### 학생 등록 방식 3가지

1. **`+ 학생 등록`** — 1명씩 수동 폼
2. **`엑셀 붙여넣기`** — 엑셀 셀 복사 후 탭 구분 텍스트 붙여넣기
3. **`CSV 파일 가져오기`** — 파일 업로드

### 학생 데이터 필드

- **필수**: 이름 (50자), 등번호 (0~99)
- **선택**: 학부모명, 학부모 연락처, 생년월일, 포지션 (PG/SG/SF/PF/C), 주소, 비고, 셔틀 위치

---

## 6. CSV 일괄 등록

최대 2,000명 지원 (자동 4회 청크 처리)

### 사용 흐름

1. 학생 관리 → 클래스 선택
2. `CSV 파일 가져오기` 버튼
3. `샘플 CSV 다운로드` → 샘플 받기
4. 엑셀에서 샘플 형식 유지, "CSV UTF-8"로 저장
5. 모달에서 파일 선택 또는 드래그 앤 드롭
6. 프리뷰 확인 (처음 10명, 유효/에러/중복 카운트)
7. `N명 가져오기` 버튼 → 자동 청크 업로드

### CSV 컬럼 예시

```
이름,등번호,학부모명,학부모전화,생년월일,포지션,주소,비고
김민준,10,김철수,010-1234-5678,2013-05-15,PG,서울 강남구,
이서연,13,이영수,01045678901,2013-11-03,PF,,
```

> 전화번호는 어떤 형식이든 자동 정규화됩니다 (`010-1234-5678`, `01012345678`, `+82 10 1234 5678` 모두 OK).

---

## 7. 출결 체크

`/attendance` — 수업 시작 후 체크 (코치 주 사용)

### 출결 상태

| 상태 | 의미 | 패키지 소진 |
|---|---|---|
| **출석** ✅ | 정상 출석 | 1회 소진 |
| **결석** ❌ | 무단 결석 | 1회 소진 |
| **지각** ⏰ | 지각 | 1회 소진 |
| **사유** 📝 | 사전 통보·공결 (병원 등) | 소진 안 함 → 이월 |

### 사용 방법

1. 날짜 선택 (기본: 오늘)
2. 요일 탭 선택 — 오늘 요일이 자동 선택됨
3. 클래스 선택
4. 학생별 상태 버튼 터치 (탭할수록 상태 순환)
5. 또는 `전체 출석` 버튼 후 예외 학생만 수정
6. `N명 출석 저장`

---

## 8. 세션 패키지

`/packages` — 학생별 수강권 관리 (원장 주 사용)

패키지(월 10회권, 분기 30회권 등)를 등록하면 출석 시 자동 소진됩니다.

### 이월 계산

```
사유결석 - 보강 = 이월 회수
→ 다음 패키지 가격에서 자동 공제
```

---

## 9. 수납 알림톡

`/tuition` — 학원비 결제 링크 + 학부모 알림톡

### 사용 방법

1. 클래스 선택
2. 수강료(원), 월, 납부기한 입력
3. 학생 체크 (또는 `전체 선택`)
4. `N명에게 수납 알림톡 발송`

### 학부모가 받는 알림톡 예시

```
[hoopnote 용인농구학원] 4월 학원비 안내

김민준 학부모님 안녕하세요.
4월 학원비 150,000원을 안내드립니다.

납부기한: 4월 말
결제 링크: https://academy.hoopnote.kr/pay/xxx
```

---

## 10. 정산 현황

`/settlement` — 월별 수납 현황 (원장 전용)

- **N월 정산 예정액** — 총 수납 - 수수료(4.5%)
- 주간별 집계 + 이번 달 수납 내역 표
- 정산 계좌 등록: `/settings` > 학원 정보

---

## 11. AI 알림장 작성

`/notices/new` — 코치 메모 → AI 자동 학생별 알림장

### 흐름

1. 클래스 선택
2. 코치 메모 작성 (30초)
   > "오늘 3:3 연습. 민재 드리블 좋아짐. 준호 슈팅 더 연습. 서연 패스 좋았음."
3. `AI 학생별 분류` 버튼 → 약 10초 대기
4. 학생별 개인 코멘트 확인
5. 발송 → 학부모 알림톡 + 열람 링크 자동 발송

### AI 안전장치

| 항목 | 설명 |
|---|---|
| PII 보호 | 학생 실명은 AI 서버로 나가지 않음 (UUID 토큰 치환) |
| Hallucination 방지 | 언급 안 된 학생에게 억지 코멘트 없음 |
| 프롬프트 인젝션 차단 | "이전 지시 무시" 등 공격어 탐지 |

### 학부모 열람

알림톡 링크 → `academy.hoopnote.kr/notice/<view_token>` — 로그인 불필요, 30일 자동 만료

---

## 12. 공지 · 일정 등록

`/schedules/new` — 대회/휴강/셔틀/보강 공지 + 알림톡 발송

### 공지 타입 7종

| 타입 | 주요 입력값 |
|---|---|
| 🏆 대회 안내 | 대회명/날짜/장소/집결시간/준비물 |
| 💰 원비 수납 | 월/금액/마감일/계좌 |
| 🚫 휴강 안내 | 휴강일/사유 |
| 📗 보강 안내 | 보강일시/담당 코치 |
| 🚌 셔틀 출발 | 출발 시간 |
| 🔄 셔틀 변경 | 변경일/전후 시간/사유 |
| 📊 월간 리포트 | 자동 생성 |

> D-3, D-1 리마인더 자동 생성됩니다.

---

## 13. 경기 기록

`/game/new` → `/game/[id]` — 실시간 8버튼 기록

### 설정 흐름

1. 포맷(5 vs 5 / 3 vs 3), 피리어드, 시간 선택
2. 홈팀/원정팀 이름 + 색상 설정
3. 클래스에서 선수 불러오기 → 선발 지정

### 8버튼

FG · 3P · FT · REB · AST · STL · BLK · TO

### PIN 기록 (벤치)

6자리 PIN으로 로그인 없이 기록 참여 가능 → `/record?pin=123456`

---

## 14. 경기 히스토리

`/history` — 완료 경기 + 누적 스탯

- **경기 목록** — 전체 / 이번 달 / 최근 3개월 필터
- **누적 기록** — 선수별 누적 (PTS, REB, AST …)
- 원장: 학원 전체, 코치: 본인 기록만

---

## 15. 내 프로필

`/profile` — 역할 배지 + 빠른 메뉴

| 표시 | 의미 |
|---|---|
| **원장** | 학원 소유자 — 전체 기능 접근 가능 |
| **코치** | 담당 클래스만 접근 가능 |
| **미설정** | 역할 배정 전 상태 — 원장에게 문의 |

---

## 16. AI 비서 채팅

`/assistant` — 자연어로 학원 현황 조회 및 업무 처리

### 자연어 질문 예시

```
"오늘 결석한 학생 알려줘"
"이번 달 미수금 얼마야?"
"김민준 패키지 몇 회 남았어?"
"준호 등번호 7번으로 바꿔줘"
"서연이를 수요일 반으로 옮겨줘"
"내일 대회 준비물 전달해줘"
"오늘 결석 알림 보내줘"
```

### 프리셋 버튼 3개

| 버튼 | 내용 |
|---|---|
| 오늘 일간 리포트 | 출결 + 결석자 + 미수금 + AI 활동 요약 |
| 이번 주 주간 리포트 | 주간 출석률 + 이벤트 현황 + 만료 임박 패키지 |
| 학원 현황 요약 | 현재 시점 스냅샷 전체 |

---

## 17. 셔틀 출발 알림 (PWA)

`/shuttle` — 탑승 확인 + 학부모 출발 알림 (모바일 전용)

**설치**: `/shuttle` 접속 → 브라우저 "홈 화면에 추가" → 독립 실행 (앱 설치 불필요)

1. 요일 탭 선택
2. 클래스 선택
3. 탑승 학생 체크 (또는 `전체 탑승`)
4. `셔틀 출발 알림 발송` → 학부모에게 즉시 알림톡

---

## 18. 자주 묻는 질문

**Q1. 학생 등록에 필수 필드는?**
이름과 등번호(0~99)만 필수. 나머지는 나중에 편집 가능.

**Q2. 동명이인이 섞이나요?**
아니요. UUID 매칭으로 완전히 분리됩니다.

**Q3. 전화번호 형식은?**
어떤 형식이든 자동 정규화. 엑셀 그대로 붙여넣기 OK.

**Q4. 온라인 결제가 안 되는 이유는?**
페이플(Payple) 계약 대기 중. 베타 기간은 수동 입금 방식.

**Q5. 알림톡이 안 갔어요.**
학부모 연락처 등록 여부 / 학원 전화번호 등록 여부 / 알림톡 잔여량 순으로 확인.

**Q6. 코치는 어떤 기능을 쓸 수 있나요?**
담당 클래스의 출결, 알림장 작성, 경기 기록. 원장만 정산/수납/전체 학생 조회 가능.

**Q7. 학생도 경기 기록 참여 가능한가요?**
네. 6자리 PIN으로 로그인 없이 참여 가능합니다.

---

## 19. 베타 기간 제약사항 & 플랜

### 학생 규모별 요금

요금은 **재학생 규모(100~299명 / 300~499명 / 500명 이상)에 따라 책정**됩니다. 학원 규모에 맞는 정확한 금액과 알림톡 포함 건수는 **도입 안내를 신청하시면 메일로 안내**드립니다.

공통: **첫 달 완전 무료** · 약정 없음, 언제든 해지 · 코치/클래스/경기 기록 무제한 · 연 결제 시 2개월 무료

### 베타 기간 제약

| 항목 | 상태 |
|---|---|
| 페이플 (온라인 결제) | 🔒 계약 대기 — 현재 수동 입금 |
| 학원 전화번호 미등록 | ⚠️ 모든 자동 알림 스킵 — `/settings`에서 즉시 등록 필요 |

---

## 📞 기술 지원

- **이메일**: hello@hoopnote.kr (평일 09:00~18:00)
- **앱 내 문의**: 설정 > 도움말 > 문의하기