HAGWON OPS CLOUD

학원루프 (HagwonLoop) 운영 허브

소형 학원 운영(학생, 수업, 출결, 알림)과 결제(학원비, 플랫폼 구독)를 하나의 흐름으로 관리하는 역할 기반 화면입니다. 브라우저 기준 API 경로는 /api/v1/* 입니다.

테스트 전용 직접 URL: /console

0) 실사용 홈

로그인하면 역할별(원장/강사/학부모/시스템관리자) 홈 요약이 표시됩니다.

1) 인증

전화번호 비밀번호

system_admin: 01000001111/system1234, admin: 01011112222/admin1234, teacher: 01011113333/teacher1234, parent: 01011114444/parent1234

2) 학생 관리

학생 검색 페이지 크기

학생 이름 학년

학생 ID 조회

3) 수업 생성

수업 검색 페이지 크기

수업명

시작시간 종료시간

대상 학생 ID 목록 (콤마 구분)

3.5) parent-학생 연결

자동 결석 알림 대상을 만들기 위해 /api/v1/relations/parent-student를 호출합니다.

parent_user_id student_id

4) 출결 체크인 / 조회

수업 ID 학생 ID

5) 학원/모듈

로그인 후 권한을 확인하세요. admin은 저장/모듈변경 가능, teacher는 조회 전용입니다.

학원명 타임존 알림 채널 연락처 로고 URL 브랜드 색상 (#RRGGBB)

5.5) 플랫폼 구독 설정/견적 (admin)

/api/v1/platform-subscription/me 설정 저장/조회 및 /api/v1/platform-subscription/quote 견적 계산, /api/v1/platform-subscription/payment-method 결제수단 설정을 실행합니다.

플랜 최대 학생수 (50단위)

video payment attendance_report

청구 기간(옵션, YYYY-MM) 인보이스 조회 건수

결제수단 provider 카드 브랜드(선택) billing_key 카드 끝4자리(선택)

활성화

결제수단이 아직 조회되지 않았습니다.

구독 설정이 아직 조회되지 않았습니다.

5.54) 플랫폼 가격정책 (system_admin)

/api/v1/system/platform-pricing-policy 조회/수정 API를 실행합니다.

student_tier_size audit log 조회 건수 monthly_base_price yearly_base_price monthly_increment_per_tier yearly_increment_per_tier video_addon_base_price video_addon_increment_per_tier payment_addon_base_price attendance_report_addon_base_price

가격정책이 아직 조회되지 않았습니다.

5.545) 운영 대시보드 (system_admin)

구독/인보이스 요약 지표를 빠르게 확인합니다.

대시보드 데이터가 아직 조회되지 않았습니다.

5.55) 플랫폼 구독 모니터링 (system_admin)

/api/v1/system/platform-subscriptions 전역 구독 목록/상세를 조회합니다.

조회 건수 (1~500) 플랜 필터 상세 인보이스 건수 (1~200) 학원 키워드(이름/ID) 정렬 기준 정렬 순서 요약 기간 from(옵션, YYYY-MM) 요약 기간 to(옵션, YYYY-MM) 상세 조회 academy_id

configured only

요약 데이터가 아직 조회되지 않았습니다.

상세 데이터가 아직 조회되지 않았습니다.

5.56) 플랫폼 인보이스 모니터링 (system_admin)

/api/v1/system/platform-invoices 전역 인보이스를 조회합니다.

조회 건수 (1~500) 상태 필터 플랜 필터 academy_id 필터(옵션) billing_period 필터(옵션, YYYY-MM) billing_period_from(옵션, YYYY-MM) billing_period_to(옵션, YYYY-MM) 정렬 기준 정렬 순서

요약 통계가 아직 조회되지 않았습니다.

월별 트렌드가 아직 조회되지 않았습니다.

5.6) 학원비 청구 상태 (admin)

학원비 템플릿/학생 프로필/월 청구서를 관리하고, 현금 결제 수동 확인을 수행합니다.

템플릿명 월 금액(원) 주당 횟수 요일(콤마)

학생 ID(프로필) 템플릿 ID(선택)

청구 월(YYYY-MM) 조회 개수

청구 상태 요약이 아직 조회되지 않았습니다.

5.7) 학원비 환불 요청/처리 (admin/parent)

parent는 본인 연결 학생의 청구서 기준 환불 요청을 생성하고, admin은 요청 목록 조회/승인/거절을 처리합니다.

Parent: 내 청구서/환불요청

내 청구 월(YYYY-MM) 내 청구 조회 개수

환불 요청 invoice_id 요청 금액(비우면 잔액 전체) 요청 사유

내 환불요청 상태 필터 내 환불요청 조회 개수

Admin: 환불요청 처리

환불요청 상태 필터 환불요청 조회 개수

처리 request_id 승인 금액(승인 시, 비우면 요청금액) 승인 여부 처리 사유(거절 시 필수)

6) 테스트 알림

운영 알림 설정 점검용 API 입니다. admin/teacher 권한에서 /api/v1/notifications/test-absence 호출합니다.

parent_user_id 학부모 전화번호(생성용) 학부모 비밀번호(생성용) 채널 student_id class_id

push 포함

7) 내 Push 토큰

현재 로그인 사용자 기준으로 /api/v1/push-tokens/me를 호출합니다. parent 계정으로 로그인 후 등록하면 테스트 결석 알림에서 push 대상이 됩니다.

platform device_id push_token

8) 실행 로그

초기화 중...