SYSTEM BLUEPRINT

피아노 학원 수강 관리
사용자별 화면 설계

강사, 원장, 시스템 관리자 관점에서 수강권과 레슨 회차 관리 흐름을 정의한 설계도입니다.

강사 시나리오

담당 학생 수업 처리 흐름

강사가 모바일에서 담당 학생을 확인하고 수업 완료, 최근 이력 확인, 실수 취소까지 처리하는 흐름입니다.

1. 로그인

강사 계정으로 접속

2. 담당 학생 확인

오늘 수업 학생 목록

3. 수업 완료

+1회 버튼으로 차감

4. 이력 확인

최근 처리 기록 확인

5. 실수 복구

잘못 입력한 기록 취소

강사 | 화면 01

강사용 오늘 학생 목록

app.lesson.local/teacher/today
Piano Lesson Manager
오늘 담당 학생
김하은잔여 6회
이서준잔여 2회
박지민잔여 10회
학생 선택

[화면 개요 및 목적]

강사가 로그인 후 가장 먼저 보는 화면입니다. 담당 학생, 잔여 회차, 수업 완료 버튼이 한 화면에 모입니다.

[핵심 기능 로직]

강사 계정과 학생 담당자 값을 기준으로 조회 범위를 제한하고, 오늘 처리할 학생만 우선 노출합니다.

  • FlutterFlow List View
  • Teacher Role Filter
강사 | 화면 02

수업 완료 +1회 처리

app.lesson.local/teacher/student
오늘 담당 학생
8명
김하은 잔여 6회
이서준 잔여 2회
박지민 잔여 10회
빠른 처리
김하은 수업 완료
처리 후 잔여 회차 5회
실수 시 최근 기록 취소 가능

[화면 개요 및 목적]

학생 상세에서 수업 완료 버튼을 누르면 잔여 회차가 줄고 수업 이력이 생성됩니다.

[핵심 기능 로직]

lesson_logs에 완료 이력을 추가하고 수강권 잔여 회차는 이력을 기준으로 계산합니다.

  • Lesson Log Action
  • Remaining Count Rule
강사 | 화면 03

최근 이력과 실수 입력 취소

Piano Lesson Manager
최근 처리 이력
오늘 17:10김하은 +1회
어제 16:00이서준 +1회
취소 가능최근 기록
기록 취소

[화면 개요 및 목적]

방금 처리한 수업 기록을 확인하고, 실수 입력은 취소하여 잔여 회차를 복구합니다.

[핵심 기능 로직]

기록 삭제보다 취소 상태를 남겨 언제 누가 복구했는지 확인할 수 있게 합니다.

  • Cancel Log
  • Audit Trail
원장 시나리오

수강권과 결제 운영 흐름

원장이 전체 학생, 수강권, 홀딩, 결제, 만료 예정 현황을 확인하고 관리하는 흐름입니다.

1. 전체 현황

학생과 수강권 상태

2. 수강권 등록

기간과 회차 입력

3. 결제 기록

결제일과 금액 저장

4. 홀딩 적용

만료일 자동 연장

5. 확인 목록

만료와 회차 부족 확인

원장 | 화면 01

원장 운영 대시보드

app.lesson.local/owner/dashboard
만료 7일 전
5명
잔여 2회 이하
3명
이번 달 결제
21건
원장 대시보드
김하은만료 6일 전
이서준잔여 2회
박지민결제 확인
최유나홀딩 종료 예정
오늘 확인할 운영 목록

[화면 개요 및 목적]

원장이 오늘 확인해야 할 만료 예정, 잔여 회차 부족, 결제 미기록 학생을 한눈에 봅니다.

[핵심 기능 로직]

수강권 만료일, 잔여 회차, 결제 기록을 기준으로 확인 목록을 자동 분류합니다.

  • Owner Dashboard
  • Status Query
원장 | 화면 02

수강권 등록과 결제 기록

app.lesson.local/owner/pass
수강권 상세
시작일 2026.08.20
만료 예정일 2026.11.20
총 회차 24회
잔여 회차 13회
홀딩 적용
휴원 기간 7일
새 만료일 2026.11.27
자동 연장 반영

[화면 개요 및 목적]

학생별 수강권 기간, 총 회차, 결제 정보를 등록하는 화면입니다.

[핵심 기능 로직]

수강권 종류별 기본 회차를 불러오고 결제 기록을 연결해 원장 확인 목록에 반영합니다.

  • Pass Form
  • Payment Record
원장 | 화면 03

홀딩 적용과 만료일 자동 연장

app.lesson.local/owner/hold
수강권 상세
시작일 2026.08.20
만료 예정일 2026.11.20
총 회차 24회
잔여 회차 13회
홀딩 적용
휴원 기간 7일
새 만료일 2026.11.27
자동 연장 반영

[화면 개요 및 목적]

휴원 또는 개인 사정으로 홀딩을 적용하면 만료 예정일이 자동으로 늘어납니다.

[핵심 기능 로직]

홀딩 시작일과 종료일의 차이를 계산해 수강권 만료 예정일에 더하고 이력을 남깁니다.

  • Data Aggregation & Visualization
  • Hold Extension Rule
시스템 관리자 시나리오

계정과 데이터 관리 흐름

계정 권한, 데이터 백업, 변경 이력을 관리해 작은 학원도 안정적으로 운영할 수 있게 합니다.

1. 계정 관리

원장과 강사 등록

2. 권한 설정

담당 학생 범위 제한

3. 데이터 구조

학생, 수강권, 이력

4. 변경 이력

차감, 취소, 홀딩 기록

5. 납품 안내

프로젝트 이전과 가이드

시스템 관리자 | 화면 01

강사 계정과 담당 학생 설정

app.lesson.local/admin/users
계정 관리
김선생담당 12명
박선생담당 9명
원장전체 조회
신규 강사초대 대기
담당 학생 지정

[화면 개요 및 목적]

원장이 강사 계정을 만들고 담당 학생 범위를 지정하는 관리 화면입니다.

[핵심 기능 로직]

담당 강사 필드를 기준으로 강사별 학생 조회 범위를 제한합니다.

  • Firebase Auth
  • Role Mapping
시스템 관리자 | 화면 02

변경 이력 확인

app.lesson.local/admin/logs
변경 이력
김하은 +1회김선생
이서준 기록 취소원장
박지민 홀딩 7일원장
최유나 수강권 등록원장

[화면 개요 및 목적]

수업 완료, 취소, 홀딩 적용 등 주요 변경 이력을 확인합니다.

[핵심 기능 로직]

데이터 삭제 대신 상태 변경 이력을 남겨 실수 입력과 복구 내역을 추적합니다.

  • Audit Logs
  • Firestore Rules
시스템 관리자 | 화면 03

납품과 사용 가이드

app.lesson.local/admin/guide
납품 체크리스트
로우코드 프로젝트이전 준비
DB 구조 문서완료
관리자 가이드완료
배포 주소완료

[화면 개요 및 목적]

로우코드 프로젝트 이전, 소스 내보내기, 관리자 사용 가이드를 정리합니다.

[핵심 기능 로직]

납품 후 원장이 직접 계정과 수강권을 관리할 수 있도록 화면별 사용 절차를 제공합니다.

  • Project Transfer
  • Issue Tracking & Status Management