hoopnote
기능
요금제
사용 가이드
FAQ
로그인
도입 안내서 받기 →
사용 가이드 · hoopnote Academy
처음 쓰는 분을 위한
시작 가이드
등하원 알림, 출결 체크, 알림장 발송까지 — 단계별로 따라해보세요.
최종 업데이트: 2026-07-29
버전: v0729
대상: 코치 · 원장
⚡ 빠른 시작
📖 상세 매뉴얼
지금 바로 시작해보세요.
첫 달 완전 무료.
카카오 계정만 있으면 됩니다. 설치 불필요.
앱 시작하기 →
# hoopnote Academy — 온보딩 가이드 > **코트에 집중하세요. 확인 연락은 시스템이 대신합니다.** > > 처음 사용하시는 코치·원장님을 위한 시작 가이드입니다. --- ## 준비물 - 스마트폰 (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단계 — 알림장 작성·발송 (수업·경기 후) 하단 내비 → **알림장** 탭 1. 학생 선택 2. 코치 메모 입력 > 예시: "오늘 수비 집중력 향상. 민준 3점슛 2개 성공. 서연 패스 좋았음." 3. `학생별로 나누기` → 메모가 학생별로 정리됩니다 (약 10초) 4. 학생별 코멘트 확인·수정 후 `알림톡 발송` 학부모 폰에 카카오 알림톡으로 즉시 도착합니다. --- ## 자주 쓰는 기능 | 기능 | 경로 | 주 사용자 | |---|---|---| | 수납 알림톡 | 더보기 → 회차 관리 | 원장 | | 공지 알림톡 | 더보기 → 공지 알림톡 | 코치·원장 | | 일정 관리 | 더보기 → 일정 관리 | 코치·원장 | | 경기 기록 | 더보기 → 경기 기록 | 코치 | | 셔틀 출발 알림 | `/shuttle` 접속 → 홈 화면 추가 (PWA) | 인솔 코치 | --- ## 문제가 생겼을 때 | 증상 | 해결 방법 | |---|---| | 출결 화면에 클래스가 안 보임 | 클래스 설정에서 수업 요일이 지정되어 있는지 확인 | | 알림톡이 안 가요 | 학부모 연락처가 등록되어 있는지 확인 (학생 관리) | | 수강권 회차가 안 줄어요 | 패키지 등록 여부 확인 (더보기 → 회차 관리) | | 학원 등록 팝업이 계속 뜸 | 설정 > 학원 정보에서 학원명 저장 후 재로그인 | | 알림장 학생별 정리가 느려요 | 정상입니다. 정리에 약 10~20초 걸립니다. | 문의: **hello@hoopnote.kr** (평일 09:00~18:00)
# hoopnote Academy 상세 사용설명서 **코치·원장 통합 가이드 · v2.3 · 2026-07-29** --- ## 목차 1. hoopnote Academy 소개 2. 로그인 3. 원장 대시보드 4. 학원 정보 설정 5. 학생 관리 6. CSV 일괄 등록 7. 출결 체크 8. 세션 패키지 9. 수납 알림톡 10. 정산 현황 11. 알림장 작성 12. 공지 · 일정 등록 13. 경기 기록 14. 경기 히스토리 15. 내 프로필 16. 셔틀 출발 알림 (PWA) 17. 자주 묻는 질문 18. 이용 안내 & 플랜 --- ## 1. hoopnote Academy 소개 > **"코트에 집중하세요. 확인 연락은 시스템이 대신합니다."** | 업무 | 기존 방식 | hoopnote | |---|---|---| | 학생 명단 | 엑셀/수기 | 클래스별 탭 + CSV 일괄 등록 (2,000명) | | 출결 체크 | 종이 출석부 | 원터치 + 자동 패키지 소진 | | 학원비 수납 | 계좌이체 안내 | 결제선생 청구서 링크 + 카카오 알림톡 안내 | | 학부모 소통 | 단톡방 타이핑 | **학생별 알림장 + 카카오 알림톡** | | 경기 기록 | 수기 스코어시트 | 8버튼 실시간 + 박스스코어 | | 정산 | 매월 수동 계산 | 자동 + 수수료 + 미수금 현황 | **역할**: 🧑💼 원장 · 👨🏫 코치 · 👨👩👧 학부모 (로그인 불필요, 알림톡 링크 열람) --- ## 2. 로그인 ### 로그인 방법 1. `academy.hoopnote.kr` 접속 2. **카카오로 시작하기** 버튼 클릭 3. 카카오톡 계정 선택 → 자동 로그인 4. 첫 로그인 시 프로필 자동 등록 ### 코치 초대 원장이 대시보드에서 생성한 **코치 초대 링크**를 공유하면, 코치가 링크 클릭 → 카카오 로그인 → 가입 요청 → 원장 승인 순으로 진행됩니다. > 코치 주의: 앱을 먼저 열지 않아도 됩니다. 카카오톡에서 링크를 바로 누르면 됩니다 (`academy.hoopnote.kr/invite/...` 형식). --- ## 3. 원장 대시보드 `/academy-dashboard` — 학원 전체 현황 한눈에 보기 (원장 전용) | 섹션 | 내용 | |---|---| | **통계 카드 4개** | 코치 수 / 학생 수 / 이번 달 경기 / 알림톡 사용량 | | **코치 초대** | 8자리 토큰 링크 + 카톡 공유 + 재생성 | | **오늘 출결 현황** | 수업별 출석/결석/미확인 카운트 (실시간) | | **미수금 현황** | 총 미수금액 + 학생 수 | | **코치별 활동** | 학생/경기/알림장 수 + 역할 배지 + 제거 버튼 | --- ## 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` — 결제선생 청구서 링크 안내 + 학부모 알림톡 > 결제선생 사업장 등록을 마친 학원에서 사용할 수 있습니다. hoopnote는 결제를 직접 받지 않고, 결제선생 청구서 링크를 학부모에게 안내합니다. 학원비는 원장님 명의 계좌로 바로 입금됩니다. ### 사용 방법 1. 클래스 선택 2. 수강료(원), 월, 납부기한 입력 3. 학생 체크 (또는 `전체 선택`) 4. `N명에게 수납 알림톡 발송` ### 학부모가 받는 알림톡 예시 ``` [hoopnote 용인농구학원] 4월 학원비 안내 김민준 학부모님 안녕하세요. 4월 학원비 150,000원을 안내드립니다. 납부기한: 4월 말 결제: 결제선생 청구서 링크로 안내됩니다 ``` --- ## 10. 정산 현황 `/settlement` — 월별 수납 현황 (원장 전용) - **N월 정산 예정액** — 총 수납 - 수수료 (수수료율은 학원별 설정값이 화면에 표시됩니다) - 주간별 집계 + 이번 달 수납 내역 표 - 정산 계좌 등록: `/settings` > 학원 정보 --- ## 11. 알림장 작성 `/notices/new` — 코치 메모 → 학생별 알림장 ### 흐름 1. 클래스 선택 2. 코치 메모 작성 > "오늘 3:3 연습. 민재 드리블 좋아짐. 준호 슈팅 더 연습. 서연 패스 좋았음." 3. `학생별로 나누기` 버튼 → 약 10초 대기 4. 학생별 개인 코멘트 확인·수정 5. 발송 → 학부모 알림톡 + 열람 링크 발송 > 발송은 코치·원장이 누르는 순간에만 실행됩니다. 확인 전에 학부모에게 나가지 않습니다. ### 안전장치 | 항목 | 설명 | |---|---| | PII 보호 | 학생 실명은 외부 처리 서버로 나가지 않음 (UUID 토큰 치환) | | 없는 내용 차단 | 메모에 언급 안 된 학생에게 억지 코멘트 없음 | | 문구 주입 차단 | "이전 지시 무시" 등 공격어 탐지 | ### 학부모 열람 알림톡 링크 → `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. 셔틀 출발 알림 (PWA) `/shuttle` — 탑승 확인 + 학부모 출발 알림 (모바일 전용) **설치**: `/shuttle` 접속 → 브라우저 "홈 화면에 추가" → 독립 실행 (앱 설치 불필요) 1. 요일 탭 선택 2. 클래스 선택 3. 탑승 학생 체크 (또는 `전체 탑승`) 4. `셔틀 출발 알림 발송` → 학부모에게 즉시 알림톡 --- ## 17. 자주 묻는 질문 **Q1. 학생 등록에 필수 필드는?** 이름과 등번호(0~99)만 필수. 나머지는 나중에 편집 가능. **Q2. 동명이인이 섞이나요?** 아니요. UUID 매칭으로 완전히 분리됩니다. **Q3. 전화번호 형식은?** 어떤 형식이든 자동 정규화. 엑셀 그대로 붙여넣기 OK. **Q4. 학원비 결제는 어떻게 되나요?** hoopnote가 직접 받지 않고 결제선생 청구서 링크로 안내합니다. 결제와 장부는 원장님이 결제선생에서 관리하고, 학원비는 원장님 명의 계좌로 바로 입금됩니다. hoopnote 구독 요금 결제 방법은 도입 상담 시 안내드립니다. **Q5. 알림톡이 안 갔어요.** 학부모 연락처 등록 여부 / 학원 전화번호 등록 여부 / 알림톡 잔여량 순으로 확인. **Q6. 코치는 어떤 기능을 쓸 수 있나요?** 담당 클래스의 출결, 알림장 작성, 경기 기록. 원장만 정산/수납/전체 학생 조회 가능. **Q7. 학생도 경기 기록 참여 가능한가요?** 네. 6자리 PIN으로 로그인 없이 참여 가능합니다. --- ## 18. 이용 안내 & 플랜 ### 요금 요금은 **월 100,000원부터** 시작합니다. **정규 등록 학생 1명당 990원**으로 계산하고, **500명 초과분에는 단계별 할인이 적용됩니다**(최저 단가 660원). 알림톡은 정규 원생당 월 100건을 학원 전체에서 합산하며, 초과 시 건당 15원입니다. 요금은 부가세 별도이고, **방학특강 등록 학생은 계산에 포함되지 않습니다**. 공통: **첫 달 완전 무료** · 약정 없음, 언제든 해지 · 코치 수와 클래스 수는 요금에 영향을 주지 않습니다 ### 이용 참고 | 항목 | 상태 | |---|---| | 학원비 결제 | 결제선생 청구서 링크로 안내 — hoopnote는 결제 자금과 결제수단 정보를 보관하지 않습니다 | | 학원 전화번호 미등록 | ⚠️ 모든 자동 알림 스킵 — `/settings`에서 즉시 등록 필요 | --- ## 📞 기술 지원 - **이메일**: hello@hoopnote.kr (평일 09:00~18:00) - **앱 내 문의**: 설정 > 도움말 > 문의하기