schoolmate

테이블 (26)

JWT Refresh Token (tbl_token)

  • token_id — BIGINT — 기본 키
  • user_id — BIGINT — 외래 키 → 사용자 정보.user_id
  • token_value — VARCHAR(255) — NOT NULL — Refresh Token
  • expiration — DATETIME — NOT NULL

강좌 시간표 (tbl_course_time_slot)

  • slot_id — BIGINT — 기본 키 — NOT NULL — 강좌 시간표 PK
  • course_id — BIGINT — 외래 키 → 수업 정보.course_id — NOT NULL — 수업 코드 FK
  • day_of_week — VARCHAR(10) — NOT NULL — ENUM: MON, TUE, WED, THU, FRI
  • period — INT — NOT NULL — ENUM: 1~8교시
  • classroom — VARCHAR(50) — NOT NULL — 강의실명

과목 정보 (tbl_subject)

  • subject_id — BIGINT — 기본 키
  • name — VARCHAR(50) — NOT NULL — 국어, 수학, 영어 등

관리자 정보 (tbl_admin_detail)

  • admin_id — BIGINT — 외래 키 → 사용자 정보.user_id — NOT NULL
  • level — INT — NOT NULL — ENUM: 1(최고), 5(일반)

교사 정보 (tbl_teacher_detail)

  • teacher_id — BIGINT — 외래 키 → 사용자 정보.user_id — NOT NULL
  • subject_id — BIGINT — 외래 키 → 과목 정보.subject_id
  • homeroom_grade — INT — 담임 학년 (Nullable)
  • homeroom_class_no — VARCHAR(20) — 담임 반 (Nullable)

대량 등록 로그_학생 초기 항목 등록 등 (tbl_bulk_upload_log)

  • upload_id — BIGINT — 기본 키
  • file_id — BIGINT — 외래 키 → 통합 파일 관리.file_id
  • upload_type — ENUM('STUDENT_REG', 'ATTENDANCE_REG', 'TEACHER_REG') — NOT NULL
  • status — ENUM('PENDING', 'PROCESSING', 'COMPLETED', 'FAILED')
  • total_count — INT
  • success_count — INT
  • fail_count — INT
  • error_log — TEXT
  • created_at — DATETIME — NOT NULL
  • finished_at — DATETIME
  • request_id — VARCHAR(50) — NOT NULL — UNIQUE, 요청 ID, 로그 추적용,index, tbl_log와 논리적 연결

로그 내역 (tbl_log)

  • log_id — BIGINT — 기본 키
  • user_id — BIGINT — 외래 키 → 사용자 정보.user_id — 작업자
  • table_code_id — INT — 외래 키 → 테이블 목록.table_code_id
  • change_type — VARCHAR(20) — NOT NULL — ENUM: LOGIN, LOGOUT, CREATE, UPDATE, DELETE
  • modifed_at — DATETIME — NOT NULL — 데이터 수정 일시
  • target_id — BIGINT — NOT NULL — 변경된 Row의 PK
  • request_id — VARCHAR(50) — UNIQUE, 요청 ID, 로그 추적용,index

로그 상세 내역 (tbl_log_detail)

  • log_detail_id — BIGINT — 기본 키
  • log_id — BIGINT — 외래 키 → 로그 내역.log_id
  • column_name — VARCHAR(50) — NOT NULL — 변경된 컬럼명 (예: status)
  • before_value — TEXT — 변경 전 값 (모든 타입을 문자로 저장)
  • after_value — TEXT — 변경 후 값 (모든 타입을 문자로 저장)

비밀번호 변경 이력 (tbl_pwd_history)

  • pwd_history_id (history_id) — BIGINT — 기본 키
  • user_id — BIGINT — 외래 키 → 사용자 정보.user_id
  • password — VARCHAR(255) — NOT NULL
  • created_at — DATETIME — NOT NULL

사용자 정보 (tbl_user)

  • user_id — BIGINT — 기본 키 — NOT NULL
  • email — VARCHAR(100) — NOT NULL — 이메일
  • password — VARCHAR(255) — NOT NULL — BCrypt 암호화
  • name — VARCHAR(50) — NOT NULL
  • role — VARCHAR(20) — NOT NULL — ENUM: ADMIN, TEACHER, STUDENT,
  • status — VARCHAR(20) — ENUM: ACTIVE, INACTIVE, LOCKED
  • birth_date — DATE — 생년월일 (yyyy-MM-dd)
  • auth_code — VARCHAR(50) — 초기 생성용 인증코드 (참조용)
  • login_fail_count — INT — 로그인 실패 횟수(5회 잠금)
  • last_login_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

수강 신청 (tbl_enrollment)

  • enrollment_id — BIGINT — 기본 키 — NOT NULL — 수강 신청 PK
  • course_id — BIGINT — 외래 키 → 수업 정보.course_id — NOT NULL — 수업 코드 FK
  • student_id — BIGINT — 외래 키 → 학생 정보.student_id — NOT NULL
  • status — VARCHAR(20) — ENUM: APPLIED, CANCELED, FORCED_CANCELED
  • created_at — DATETIME — NOT NULL — 수강 신청 날짜

수강 신청 장바구니 (tbl_cart)

  • cart_id — BIGINT — 기본 키 — NOT NULL — 장바구니 PK
  • course_id — BIGINT — 외래 키 → 수업 정보.course_id — NOT NULL — 수업 코드 FK
  • student_id — BIGINT — 외래 키 → 학생 정보.student_id — NOT NULL — 학생 ID FK
  • created_at — DATETIME — NOT NULL — 장바구니 담은 날짜

수업 정보 (tbl_course)

  • course_id — BIGINT — 기본 키 — NOT NULL
  • academic_year_id — BIGINT — 외래 키 → 학기 정보.academic_year_id
  • subject_id — BIGINT — 외래 키 → 과목 정보.subject_id
  • teacher_id — BIGINT — 외래 키 → 교사 정보.teacher_id — NOT NULL
  • name — VARCHAR(100) — NOT NULL — 강좌명
  • course_type — VARCHAR(20) — NOT NULL — ENUM: MANDATORY(필수), ELECTIVE(선택)
  • max_capacity — INT — NOT NULL — 최대 정원
  • current_count — INT — 현재 신청 인원
  • tuition — INT — 수강료
  • status — VARCHAR(20) — ENUM: OPEN, CLOSED, CANCELED,RUNNING,REFUSE
  • created_at — DATETIME — NOT NULL

시설 (tbl_facility)

  • facility_id — BIGINT — 기본 키 — NOT NULL
  • name — VARCHAR(50) — NOT NULL — 시설명
  • status — VARCHAR(20) — NOT NULL — 예약 가능/불가능
  • open_time (open) — TIME — NOT NULL — 시설 오픈 시간
  • close_time (close) — TIME — NOT NULL — 시설 마감 시간
  • admin_id — BIGINT — 외래 키 → 관리자 정보.admin_id — NOT NULL

시설 이용 제한 (tbl_facility_restriction)

  • restriction_id — BIGINT — 기본 키 — NOT NULL — 시설 이용 제한 ID
  • facility_id — BIGINT — 외래 키 → 시설.facility_id — NOT NULL
  • start_date — DATE — NOT NULL — 시설 이용 제한 시작 날짜
  • end_date — DATE — NOT NULL — 시설 이용 제한 종료 날짜
  • reason — VARCHAR(255) — NOT NULL — 시설 이용 제한 사유 (공사, 점검 등)
  • created_at — DATETIME — NOT NULL — 제한 정보 등록 시각

시설예약 (tbl_reservation)

  • reservation_id — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • facility_id — BIGINT — 외래 키 → 시설.facility_id — NOT NULL
  • student_id — BIGINT — 외래 키 → 학생 정보.student_id — NOT NULL
  • start_time — TIME — NOT NULL — 시작 시간
  • end_time — TIME — NOT NULL — 종료 시간 (1시간 단위라면 start_time만 있어도 무방)
  • status — VARCHAR(20) — 예약상태 ENUM: WAITING, APPROVED, REJECTED, CANCELED
  • reservation_date — DATE — NOT NULL — 예약 날짜
  • created_at — DATETIME — NOT NULL — 예약 신청 시각 (동시 신청 시 우선순위 판단 기준)
  • rejection_reason — VARCHAR(255) — 에약 불가 이유

출결 (tbl_attendance)

  • attendance_id — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • class_date — DATE — NOT NULL — 수업일자
  • period — TINYINT — NOT NULL — 교시(1~8)
  • reason — VARCHAR(255) — 사유(선택)
  • state — ENUM('SAVED', 'CONFIRMED', 'CLOSED') — NOT NULL — 출결 상태(SAVED/CONFIRMED/CLOSED)
  • saved_by — BIGINT — NOT NULL — 확정한 교사 user_id(담임/책임교사)
  • saved_at — DATETIME — NOT NULL — 저장일시
  • confirmed_by — BIGINT — 확정한 교사 user_id(담임/책임교사)
  • confirmed_at — DATETIME — 확정일시
  • closed_at — DATETIME — 마감일시(선택)
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시
  • attendance_code_id — BIGINT — 외래 키 → 출결 코드.attendance_code_id — NOT NULL — 출결코드 FK
  • enrollment_id — BIGINT — 외래 키 → 수강 신청.enrollment_id — NOT NULL — 수강신청 FK

출결 마감 이력 (tbl_attendance_closure)

  • closure_id — BIGINT — 기본 키 — NOT NULL — 마감이력 PK
  • academic_year_id — BIGINT — NOT NULL — 학년도/학기 FK
  • scope_type — ENUM('MONTH', 'SEMESTER') — NOT NULL — 마감 범위 타입(MONTH/SEMESTER)
  • scope_value — VARCHAR(20) — NOT NULL — 범위 값(예: 2025-09 또는 2025-1)
  • grade — INT — 학년(선택)
  • class_no — INT — 반(선택)
  • course_id — BIGINT — 외래 키 → 수업 정보.course_id — 강좌(선택)
  • closed_at — DATETIME — NOT NULL — 마감일시
  • user_id — BIGINT — 외래 키 → 사용자 정보.user_id — NOT NULL — 마감관리자 FK

출결 정정 요청 (tbl_attendance_correction_request)

  • request_id — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT 정정요청 PK
  • before_attendance_code_id — BIGINT — NOT NULL — 변경 전 출결코드 FK
  • requested_attendance_code_id — BIGINT — NOT NULL — 변경 요청 출결코드 FK
  • request_reason — TEXT — NOT NULL — 정정 사유(필수)
  • status — ENUM('PENDING', 'APPROVED', 'REJECTED') — NOT NULL — 요청 상태
  • requested_by — BIGINT — NOT NULL — 요청자(교사) user_id
  • requested_at — DATETIME — NOT NULL — 요청일시
  • decided_by — BIGINT — 처리자(관리자) user_id
  • decided_at — DATETIME — 처리일시
  • admin_comment — TEXT — 관리자 코멘트(반려 시 권장)
  • pending_flag — TINYINT(1) — PENDING 표시용(선택)
  • attendance_id — BIGINT — 외래 키 → 출결.attendance_id — NOT NULL — 출결 FK

출결 정정 요청 첨부파일 (tbl_attendance_correction_file)

  • file_id — BIGINT — 기본 키 — NOT NULL — 첨부파일 PK
  • original_name — VARCHAR(255) — NOT NULL — 업로드한 원본 파일명
  • stored_name — VARCHAR(255) — NOT NULL — 서버 저장용 파일명(UUID 등)
  • file_path — VARCHAR(500) — NOT NULL — 저장 경로
  • content_type — VARCHAR(100) — NOT NULL — MIME 타입
  • file_size — BIGINT — NOT NULL — 파일 크기 (byte)
  • uploaded_at — DATETIME — NOT NULL — 업로드 일시

출결 코드 (tbl_attendance_code)

  • attendance_code_id — BIGINT — 기본 키 — NOT NULL — 출결코드 PK
  • code — VARCHAR(30) — NOT NULL — 코드값 (예: PRESENT, LATE, ABSENT, SICK, OFFICIAL)
  • name — VARCHAR(50) — NOT NULL — 표시명 (예: 출석, 지각, 결석, 병가, 공가)
  • is_excused — TINYINT(1) — NOT NULL — 공결/병가 등 참작 여부(1=참작,0=일반)
  • is_active — TINYINT(1) — NOT NULL — 사용 여부(1=사용,0=비활성)
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

테이블 목록 (tbl_table_code)

  • table_code_id — INT — 기본 키
  • table_name — VARCHAR(50) — NOT NULL — 실제 테이블명 (예: tbl_user)
  • description — VARCHAR(100) — 테이블 설명 (예: 사용자 기본 정보)
  • created_at — DATETIME — NOT NULL

통합 파일 관리 (tbl_file)

  • file_id — BIGINT — 기본 키
  • user_id — BIGINT — 외래 키 → 사용자 정보.user_id
  • original_name — VARCHAR(255) — NOT NULL
  • saved_name — VARCHAR(255) — NOT NULL
  • saved_path — VARCHAR(255) — NOT NULL
  • file_size — BIGINT — NOT NULL
  • file_ext — VARCHAR(10) — NOT NULL
  • content_type — VARCHAR(100)
  • table_code_id — INT — 외래 키 → 테이블 목록.table_code_id — 연결된 테이블 ID
  • related_id — BIGINT — NOT NULL — 연결 대상 PK
  • is_deleted — CHAR(1)
  • created_at — DATETIME — NOT NULL

학기 정보 (tbl_academic_year)

  • academic_year_id — BIGINT — 기본 키
  • year — INT — NOT NULL — 2025, 2026...
  • semester — INT — NOT NULL — 1, 2
  • start_date — DATE — NOT NULL
  • end_date — DATE — NOT NULL
  • is_current — BOOLEAN — 현재 학기 여부

학사 일정 (tbl_academic_schedule)

  • schedule_id — BIGINT — 기본 키
  • academic_year_id — BIGINT — 외래 키 → 학기 정보.academic_year_id
  • schedule_date — DATE — NOT NULL
  • schedule_type — VARCHAR(20) — NOT NULL — ENUM: START, EXAM, HOLIDAY
  • content — VARCHAR(255) — NOT NULL
  • target_grade — VARCHAR(20) — 1, 2, 3, ALL
  • created_at — DATETIME — NOT NULL

학생 정보 (tbl_student_detail)

  • student_id — BIGINT — 외래 키 → 사용자 정보.user_id — NOT NULL
  • student_grade — INT — NOT NULL — 학년 (1, 2, 3)
  • student_class_no — VARCHAR(20) — 반 (1~10)
  • student_no — INT — 출석 번호