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 — 출석 번호