학원루프 (HagwonLoop) 운영 콘솔

인증 후 학생/수업/출결/학원 설정 API를 바로 실행할 수 있는 관리자 화면입니다. 브라우저 기준 API 경로는 /api/v1/* 입니다.

1) 인증

전화번호 비밀번호

admin: 01011112222/admin1234, teacher: 01011113333/teacher1234, parent: 테스트 알림 섹션의 학부모 생성 입력값 사용

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.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) 실행 로그

초기화 중...