진음악학원

테이블 (33)

account (사용자계정(DESK사용))

  • id — INT — 기본 키 — NOT NULL — PK
  • username — VARCHAR(50) — NOT NULL — 로그인 아이디
  • password — VARCHAR(255) — 비밀번호 (8자 이상)
  • name — VARCHAR(50) — NOT NULL — 이름
  • memo — VARCHAR(255) — 메모
  • is_super_admin — TINYINT(1) — NOT NULL — 최고관리자 여부 0/1 (원장/그리드 2개=1)
  • status — VARCHAR(20) — NOT NULL — 상태 (정상/중단)
  • created_at — DATETIME — NOT NULL

account_branch (계정:지점 권한)

  • id — INT — 기본 키 — NOT NULL — PK
  • account_id — INT — 외래 키 → account.id — NOT NULL — FK account
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch

account_menu (계정:메뉴 권한)

  • id — INT — 기본 키 — NOT NULL — PK
  • account_id — INT — 외래 키 → account.id — NOT NULL — FK account
  • menu_id — INT — 외래 키 → menu.id — NOT NULL — FK menu

branch (지점)

  • id — INT — 기본 키 — NOT NULL — PK
  • name — VARCHAR(50) — NOT NULL — 지점명 (목동점 등)
  • phone — VARCHAR(20) — 발신번호 (지점당 1개)
  • status — VARCHAR(20) — NOT NULL — 상태 (정상/중단)
  • created_at — DATETIME — NOT NULL

branch_business ((지점:사업자 = N:M관계))

  • id — INT — 기본 키 — NOT NULL — PK
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch
  • business_id — INT — 외래 키 → business.id — NOT NULL — FK business

business (사업자)

  • id — INT — 기본 키 — NOT NULL — PK
  • name — VARCHAR(50) — NOT NULL — 사업자명 (진뮤직그룹 등)
  • biz_no — VARCHAR(20) — 사업자등록번호
  • address — VARCHAR(255) — 주소 (영수증 표기용)
  • phone — VARCHAR(20) — 전화번호 (영수증 표기용)
  • created_at — DATETIME — NOT NULL

cash_receipt (현금영수증)

  • id — INT — 기본 키 — NOT NULL — PK
  • payment_id — INT — 외래 키 → payment.id — NOT NULL — FK payment
  • business_id — INT — 외래 키 → business.id — FK business (발행 사업자)
  • receipt_no — VARCHAR(50) — 발급번호
  • issue_date — DATE — 발행일
  • receipt_type — VARCHAR(20) — 발급수단 (소득공제/지출증빙)
  • phone — VARCHAR(20) — 발급 휴대폰번호
  • created_at — DATETIME — NOT NULL

class (반)

  • id — INT — 기본 키 — NOT NULL — PK
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch
  • business_id — INT — 외래 키 → business.id — FK business (이 반 수강료 결제 사업자)
  • name — VARCHAR(50) — NOT NULL — 반이름
  • subject — VARCHAR(50) — 과목/파트 (자유텍스트, 예: 기타/베이스)
  • group_type — ENUM('취미', '입시', '전문') — NOT NULL — 그룹유형 (수업일지 양식 결정, 생성 후 변경불가)
  • image — VARCHAR(20) — 수업일지 이미지 (드럼/베이스/기타/피아노/마이크/키보드/로고)
  • default_sessions — INT — NOT NULL — 기본회차 (양수만 가능)
  • default_tuition — INT — NOT NULL — 기본수강료(원)
  • default_period_days — INT — 한 청구서당 유효기간. 유효기간 지나면 수업못들음.
  • is_extension — TINYINT(1) — NOT NULL — 기본 연장여부 0/1 - 3단 디폴트 1단계(반->수강->청구서)
  • is_public — TINYINT(1) — NOT NULL — 수업일지 학생공개 여부 0/1
  • has_evaluation — TINYINT(1) — NOT NULL — 평가서작성 사용 여부 (디폴트 취미 = 0 / 전문,입시=1 이지만 수정가능)
  • status — VARCHAR(20) — NOT NULL — 중단되면 더이상 해당반으로 수강을 등록할 수 없음. 이미 수강중인것은 유지
  • reg_date — DATE — 등록일
  • memo — VARCHAR(255) — 메모
  • created_at — DATETIME — NOT NULL
  • eval_item1 — VARCHAR(20) — 평가서 평가항목 첫번쨰
  • eval_item2 — VARCHAR(20)
  • eval_item3 — VARCHAR(20)
  • eval_item4 — VARCHAR(20)
  • eval_item5 — VARCHAR(20)

consent (동의서)

  • id — INT — 기본 키 — NOT NULL — PK
  • student_id — INT — 외래 키 → student.id — NOT NULL — FK student
  • img_sign — img — NOT NULL — 서명 이미지
  • is_signed — TINYINT(1) — NOT NULL — 서명여부 0/1
  • signed_at — DATETIME — 서명일시
  • created_at — DATETIME — NOT NULL

counsel (상담)

  • id — INT — 기본 키 — NOT NULL — PK
  • student_id — INT — 외래 키 → student.id — NOT NULL — FK student
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch
  • type_id — INT — 외래 키 → counsel_type.id — FK counsel_type (상담유형)
  • counselor — VARCHAR(50) — 상담자(처리 직원)
  • counsel_at — DATETIME — 상담일시
  • content — TEXT — 상담내용
  • result — VARCHAR(20) — 상담결과
  • status — VARCHAR(20) — NOT NULL — 상태 (처리중/완료)
  • created_at — DATETIME — NOT NULL

counsel_type (상담유형)

  • id — INT — 기본 키 — NOT NULL — PK
  • name — VARCHAR(30) — NOT NULL — 유형명 (상담/시간변경/휴원/결석지원 등)
  • color — VARCHAR(7) — 표시 색상 (HEX, 예: #E53935)
  • template_text — TEXT — 선택 시 상담내용에 자동입력되는 안내 텍스트 (단순 가이드, 치환 없음)
  • sort_order — INT — NOT NULL — 정렬순서
  • is_active — TINYINT(1) — NOT NULL — 사용여부 0/1

enrollment (수강)

  • id — INT — 기본 키 — NOT NULL — PK
  • student_id — INT — 외래 키 → student.id — NOT NULL — FK student
  • class_id — INT — 외래 키 → class.id — NOT NULL — FK class
  • default_extension — TINYINT(1) — NOT NULL — 연장여부 0/1 - 3단 디폴트 2단계 (반 연장여부 디폴트)
  • fixed_discount — INT — NOT NULL — 고정할인(원) - 청구서 할인금액 디폴트 (수강등록 시 입력)
  • note — TEXT — 특이사항
  • status — VARCHAR(20) — NOT NULL — 상태 자동계산 수강중/종강
  • created_at — DATETIME — NOT NULL
  • default_sessions — NOT NULL — 청구서 생성시 디폴트값 (반정보와 다를 수 있음)
  • default_tution — 청구서 생성시 디폴트값 (반정보와 다를수 있음)
  • default_period_days — 청구서 생성시 디폴트값(반정보와 다를 수 있음)

enrollment_schedule (고정시간표)

  • id — INT — 기본 키 — NOT NULL — PK
  • enrollment_id — INT — 외래 키 → enrollment.id — NOT NULL — FK enrollment
  • day_of_week — VARCHAR(10) — NOT NULL — 요일 (월/화/수…)
  • time_label — VARCHAR(20) — NOT NULL — 시간(9시~23시 30분단위)

evaluation (평가서)

  • id — INT — 기본 키 — NOT NULL — PK
  • enrollment_id — INT — 외래 키 → enrollment.id — NOT NULL
  • teacher_id — INT — 외래 키 → teacher.id — FK teacher (담당강사)
  • title — VARCHAR(100) — NOT NULL — 제목
  • period_start — DATE — NOT NULL
  • period_end — DATE — NOT NULL
  • overall_comment — TEXT — 최종코멘트
  • is_public — TINYINT(1) — NOT NULL — 공개여부 0/1
  • is_written — TINYINT(1) — NOT NULL — 작성여부 0/1
  • created_at — DATETIME — NOT NULL — 생성일자
  • sent_at — DATETIME — 전송일자
  • viewed_at — DATETIME — 열람일자
  • status — VARCHAR(20) — NOT NULL — 상태

evaluation_item (평가서_평가항목)

  • id — INT — 기본 키 — NOT NULL — PK
  • evaluation_id — INT — 외래 키 → evaluation.id — NOT NULL — FK evaluation
  • name — VARCHAR(50) — NOT NULL — 항목명
  • score — DECIMAL(2, 1) — 점수 (0.5~5.0)
  • sort_order — INT — NOT NULL — 정렬순서

evaluation_weakness (평가서_핵심보완포인트)

  • id — INT — 기본 키 — NOT NULL — PK
  • evaluation_id — INT — 외래 키 → evaluation.id — NOT NULL — FK evaluation
  • title — VARCHAR(100) — 제목
  • content — TEXT — 내용
  • sort_order — INT — NOT NULL — 정렬순서

invoice (청구서)

  • id — INT — 기본 키 — NOT NULL — PK
  • enrollment_id — INT — 외래 키 → enrollment.id — NOT NULL — FK enrollment (귀속 수강)
  • invoice_url — VARCHAR(255) — NOT NULL — 청구서 모바일 링크 (청구서마다 별도, 학생 결제 진입)
  • cycle_no — INT — NOT NULL — 차수
  • session_count — INT — NOT NULL — 회차
  • remaining_sessions — INT — NOT NULL — 상태[기간]이 만료 => 무조건 0 / 그 외 활성화된 회차 중 출결기록이 없는 회차
  • tuition — INT — NOT NULL — 수강료
  • discount — INT — NOT NULL — 할인금액(원) (수강 고정할인 디폴트, 수납내역 있어도 수정 가능)
  • is_extension — TINYINT(1) — NOT NULL — 연장여부 0/1 - 3단 디폴트 3단계 (수강 연장여부 디폴트)
  • first_attend_date — DATE — 첫출석일 (이 청구서 첫 출결일, 출석·결석 무관)
  • period_days — INT — 기간(일)
  • expiry_date — DATE — 만료(예정)일 자동계산 첫출석일+기간
  • complete_date — DATE — 회차완료일 (직전 청구서 종료일, 1차수는 NULL)
  • last_lesson_date — DATE — 마지막 수업일 자동계산 미차감 포함 마지막 출결일
  • pay_status — VARCHAR(20) — NOT NULL — 결제상태 자동계산 대기/예정/미납/완납
  • period_status — VARCHAR(20) — NOT NULL — 기간상태 자동계산 미정/유효/임박/만료/완강
  • memo — VARCHAR(255) — 청구서 관련 내부 메모
  • created_at — DATETIME — NOT NULL — 발행일

invoice_session (청구서_회차)

  • id — INT — 기본 키 — NOT NULL — PK
  • invoice_id — INT — 외래 키 → invoice.id — NOT NULL — FK invoice
  • session_no — INT — NOT NULL — 회차번호 (1~N)
  • is_active — TINYINT(1) — NOT NULL — 활성여부 0/1 (비활성=잔여 카운팅 제외·일지 숨김)

lesson_log (수업일지)

  • id — INT — 기본 키 — NOT NULL — PK
  • attendance_id — INT — 외래 키 → 출결.id — NOT NULL — FK attendance (1:1)
  • progress — TEXT — 수업진도 (공통)
  • feedback — TEXT — 피드백 (취미)
  • next_progress — TEXT — 다음진도 (취미)
  • homework — TEXT — 과제 (입시·전문)
  • strength — TEXT — 잘하는 점 (입시·전문)
  • improvement — TEXT — 개선이 필요한 점 (입시·전문)
  • memo — TEXT — 메모 (입시·전문)
  • created_at — DATETIME — NOT NULL

menu (메뉴)

  • id — INT — 기본 키 — NOT NULL — PK
  • name — VARCHAR(50) — NOT NULL — 메뉴명 (오늘업무 등)

message

  • id — INT — 기본 키 — NOT NULL — PK
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch
  • template_id — INT — 외래 키 → message_template.id — FK message_template
  • invoice_id — INT — 외래 키 → invoice.id — FK invoice (청구서 관련 발송, 일반발송은 NULL)
  • send_type — ENUM('수동', '자동') — NOT NULL — 발송 방식
  • channel — VARCHAR(20) — NOT NULL — 구분 (SMS/LMS/MMS/알림톡)
  • sender_no — VARCHAR(20) — 발신번호
  • sender_account — VARCHAR(50) — 발신자(계정)
  • title — VARCHAR(100) — 제목
  • content — TEXT — 본문
  • scheduled_at — DATETIME — 발송예약일시
  • requested_at — DATETIME — 요청일시
  • status — VARCHAR(20) — NOT NULL — 상태 (대기/발송/취소)
  • created_at — DATETIME — NOT NULL

message_recipient

  • id — INT — 기본 키 — NOT NULL — PK
  • message_id — INT — 외래 키 → message.id — NOT NULL — FK message
  • student_id — INT — 외래 키 → student.id — FK student
  • student_phone_id — INT — 외래 키 → student_phone.id — FK student_phone (실제 발송된 번호)
  • recipient_no — VARCHAR(20) — NOT NULL — 수신번호 (발송 시점 스냅샷)
  • recipient_name — VARCHAR(50) — 수신자
  • target — VARCHAR(20) — 대상 (본인/부/모 등)
  • result — VARCHAR(20) — NOT NULL — 전송결과 (성공/실패/대기)
  • sent_at — DATETIME — 전송일시

message_template

  • id — INT — 기본 키 — NOT NULL — PK
  • channel — VARCHAR(20) — NOT NULL — 채널 (SMS/LMS/MMS/알림톡)
  • name — VARCHAR(100) — NOT NULL — 템플릿명
  • title — VARCHAR(100) — 제목 (LMS/MMS)
  • content — TEXT — 본문
  • trigger_event — VARCHAR(30) — 자동발송 트리거 (NULL=수동전용 / 결제성공·만료임박·회차소멸예정·회차소멸 등)
  • created_at — DATETIME — NOT NULL

notice (공지사항(Master 작성 -> 강사모바일 표기))

  • id — INT — 기본 키 — NOT NULL — PK
  • title — VARCHAR(100) — 제목
  • content — TEXT — 본문
  • updated_at — DATETIME — NOT NULL — 마지막 수정일시

payment (결제내역)

  • id — INT — 기본 키 — NOT NULL — PK
  • invoice_id — INT — 외래 키 → invoice.id — NOT NULL — FK invoice
  • business_id — INT — 외래 키 → business.id — FK business (수납 사업자)
  • type — ENUM('결제', '취소', '환불') — NOT NULL — 구분
  • related_payment_id — INT — 외래 키 → payment.id — FK payment (취소·환불 시 원결제, 자기참조)
  • method — VARCHAR(20) — NOT NULL — 수납방법 (카드/계좌/모바일)
  • amount — INT — NOT NULL — 금액(원) - 결제는 양수, 취소·환불은 음수
  • card_name — VARCHAR(50) — 카드·기관명 (예: 삼성개인우대카드)
  • installment — VARCHAR(20) — 할부개월
  • approval_no — VARCHAR(50) — 승인번호
  • paid_at — DATETIME — 납부일자
  • status — VARCHAR(20) — NOT NULL — 상태
  • created_at — DATETIME — NOT NULL

recording (녹화)

  • id — INT — 기본 키 — NOT NULL — PK
  • attendance_id — INT — 외래 키 → 출결.id — NOT NULL — FK attendance (1:1)
  • youtube_url — VARCHAR(255) — 유튜브 영상 링크
  • is_youtube_updated — TINYINT(1) — NOT NULL — 링크 업데이트 여부 0/1
  • is_kakao_sent — TINYINT(1) — NOT NULL — 알림톡 발신 여부 0/1
  • memo — VARCHAR(255) — 메모
  • created_at — DATETIME — NOT NULL

settlement (정산서)

  • id — INT — 기본 키 — NOT NULL — PK
  • teacher_id — INT — 외래 키 → teacher.id — NOT NULL — FK teacher
  • title — VARCHAR(50) — 제목 (예: 2026년 02월)
  • settle_ym — VARCHAR(7) — NOT NULL — 정산년월 (YYYY-MM)
  • period_start — DATE — 정산기간 시작
  • period_end — DATE — 정산기간 종료
  • session_count — INT — NOT NULL — 수업 수 스냅샷
  • session_pay_sum — INT — NOT NULL — 회차수당 합계(원) 스냅샷
  • base_pay — INT — NOT NULL — 기본급(원) 스냅샷
  • allowance — INT — NOT NULL — 지원금/보조금(원) 스냅샷
  • gross_total — INT — NOT NULL — 총액(원) 스냅샷
  • income_tax — INT — NOT NULL — 소득세 3%(원) 스냅샷
  • local_tax — INT — NOT NULL — 지방세 0.3%(원) 스냅샷
  • net_total — INT — NOT NULL — 실지급액(원) 스냅샷
  • status — VARCHAR(20) — NOT NULL — 상태
  • created_at — DATETIME — NOT NULL

settlement_line

  • id — INT — 기본 키 — NOT NULL — PK
  • settlement_id — INT — 외래 키 → settlement.id — NOT NULL — FK settlement
  • attendance_id — INT — 외래 키 → 출결.id — FK attendance (원본 참조용)
  • lesson_date — DATE — 수업일 스냅샷
  • class_name — VARCHAR(80) — 반이름 스냅샷
  • student_name — VARCHAR(50) — 학생명 스냅샷
  • amount — INT — NOT NULL — 회차수당(원) 스냅샷

student (학생)

  • id — INT — 기본 키 — NOT NULL — PK
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch
  • name — VARCHAR(50) — NOT NULL — 학생명
  • gender — ENUM('남', '여') — NOT NULL — 성별
  • birth — DATE — 생년월일
  • school — VARCHAR(50) — 학교
  • grade — VARCHAR(20) — 학년
  • address — VARCHAR(255) — 주소
  • status — VARCHAR(20) — NOT NULL — 재원상태 자동계산 재원=수강중 강의 있음 / 휴원=없음
  • memo — TEXT
  • receipt_method — ENUM('핸드폰', '사업자') — NOT NULL — 현금영수증 발급수단 (없음일때는 발급번호 입력불가)
  • receipt_no — VARCHAR(30) — 발급번호 (핸드폰=전화번호 / 사업자=사업자번호)
  • student_url — VARCHAR(255) — 학생 고유 링크 (수업일지·평가서,녹화영상)
  • created_at — DATETIME — NOT NULL

student_phone (학생_연락처(최대3개, 본인은 필수))

  • id — INT — 기본 키 — NOT NULL — PK
  • student_id — INT — 외래 키 → student.id — NOT NULL — FK student
  • phone_role — ENUM('본인', '보호자1', '보호자2') — NOT NULL — 본인은 필수, 보호자1 보호자2 는 선택
  • relation — ENUM('부', '모', '배우자', '형제', '기타')
  • phone_no — VARCHAR(20) — NOT NULL — 전화번호
  • recv_kakao — TINYINT(1) — NOT NULL — 카톡(알림톡) 수신 0/1
  • recv_invoice — TINYINT(1) — NOT NULL — 청구서 수신 0/1
  • recv_sms — TINYINT(1) — NOT NULL — 문자(SMS) 수신 0/1

teacher (강사)

  • id — INT — 기본 키 — NOT NULL — PK
  • branch_id — INT — 외래 키 → branch.id — NOT NULL — FK branch (소속지점)
  • name — VARCHAR(50) — NOT NULL — 강사명
  • gender — ENUM('남', '여') — NOT NULL — 성별
  • birth — DATE — 생년월일
  • phone — VARCHAR(20) — 연락처
  • status — VARCHAR(20) — NOT NULL — 상태 (정상/중단)
  • mobile_url — VARCHAR(255) — 강사 고유 모바일 링크 (수업일지·정산서)
  • bank_name — VARCHAR(30) — 정산 입금 은행명
  • account_no — VARCHAR(40) — 정산 입금 계좌번호
  • base_pay — INT — NOT NULL — 기본급(원)
  • allowance — INT — NOT NULL — 보조금(원)
  • per_session_pay — INT — NOT NULL — 회차수당 기본값(원) - 3단 디폴트 1단계
  • settle_base_day — TINYINT — NOT NULL — 정산 마감 기준일 (매월 N일, 1~25)
  • created_at — DATETIME — NOT NULL

teacher_class (강사_반 관계)

  • id — INT — 기본 키 — NOT NULL — PK
  • teacher_id — INT — 외래 키 → teacher.id — NOT NULL — FK teacher
  • class_id — INT — 외래 키 → class.id — NOT NULL — FK class
  • per_session_pay — INT — 이 반에서의 회차수당(원) - 3단 디폴트 2단계 (강사 기본값 디폴트)

출결 (attendance)

  • id — INT — 기본 키 — NOT NULL — PK
  • invoice_id — INT — 외래 키 → invoice.id — NOT NULL — FK invoice (귀속 청구서)
  • session_id — INT — 외래 키 → invoice_session.id — FK invoice_session (차감 시 슬롯 연결, 미차감은 NULL)
  • student_id — INT — 외래 키 → student.id — NOT NULL — FK student 조회 편의용
  • teacher_id — INT — 외래 키 → teacher.id — FK teacher (실제 수업 강사)
  • attend_date — DATE — NOT NULL — 출결일
  • status — VARCHAR(20) — NOT NULL — 출결상태 (출석/결석/지각 등)
  • is_deducted — TINYINT(1) — NOT NULL — 차감여부 0/1 (미차감=보충)
  • per_session_pay — INT — 회차수당(원) - 3단 디폴트 최종 (강사-반 값 디폴트, 출결별 수정)
  • has_recording — TINYINT(1) — NOT NULL — 녹화여부 0/1
  • memo — VARCHAR(255) — 메모 (예: 아픔, 녹화 요청)
  • created_by — INT — 외래 키 → account.id — FK account (처리자, 입력한 직원)
  • created_at — DATETIME — NOT NULL