260105_포폴_학원관리웹_v2

포폴용 한국식 학원 행정 관리웹 설계

테이블 (18)

SMS 발송 내역 관리(수강생 보호자 대상) (FCT_SMS_LOG_T)

  • 내역 번호 (SMS_LOG_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 발송 일시 (SEND_DTM) — DATETIME — NOT NULL — 검색 편의를 위해 인덱싱 가능
  • 발송 내용 (CNTNTS) — VARCHAR(400) — NOT NULL — 메시지 길이 제한 적용
  • 수신인명 (TO_NMS) — TEXT — NOT NULL — 주로 강사의 담당 학급 대상, 수강생명. 정규화 없이 쉼표(,) 로 구분하여 저장
  • 수신인 번호 (TO_TELS) — TEXT — NOT NULL — 수신인 번호. 정규화 없이 쉼표(,) 구분하여 저장
  • 발신인 (FROM) — VARCHAR(20) — NOT NULL — 발신 강사ID. FK 없이, 검색용 인덱싱만 적용.
  • 발송 성공 여부 (SEND_SCS_YN) — CHAR(1) — NOT NULL — 에러 발생으로 발송되지 않은 경우도 있으므로 혹시나 해서.

공지사항 (FCT_NTC_T)

  • 공지사항 번호 (NTC_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 제목 (TITLE) — VARCHAR(100) — NOT NULL
  • 내용 (CONTENTS) — TEXT — NOT NULL
  • 상단 고정 여부 (FRZ_YN) — CHAR(1) — NOT NULL — 상단 고정. 배경색 변경 등 시각화 처리
  • 강조 여부 (RED_YN) — CHAR(1) — NOT NULL — Y인 경우 제목 볼드, 빨간색 처리
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

공통코드 관리 (SYS_CMN_CD_T)

  • 공통코드 번호 (CMN_CD_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 공통코드 (CMN_CD) — VARCHAR(20) — NOT NULL — UK. 값이 너무 길지 않도록 제한.
  • 값 (VAL) — VARCHAR(50) — NOT NULL — 실제 출력 의미
  • 코드 깊이 (DEPTH) — INT — NOT NULL — 최종 3단계 허용, 3단계 이상에서는 코드 생성 불가.
  • 정렬 순서 (SORT_SEQ) — INT — NOT NULL — 값이 작을수록 위, 왼쪽 등 우선 정렬. 순서 변경은 숫자 아닌 UI로 수정.
  • 사용여부 (USE_YN) — CHAR(1) — NOT NULL — Y 사용, N 미사용
  • 비고 (RMRK) — VARCHAR(200)
  • 상위코드 번호 (PARENT_CMN_CD_NO) — BIGINT(20) — 외래 키 → 공통코드 관리.공통코드 번호 — FK. 상위 분류 한 번 지정하면 수정불가, 하위코드 삭제 권장. 안 그러면 구현 복잡해진다.
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

공통코드 사용범위 관리 (FCT_CMN_CD_USAGE_T)

  • 사용범위 번호 (LINK_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 메뉴 번호 (MENU_NO) — BIGINT(20) — 외래 키 → 메뉴 관리.메뉴 번호 — NOT NULL — FK, 인덱싱 필수
  • 공통코드 번호 (CMN_CD_NO) — BIGINT(20) — 외래 키 → 공통코드 관리.공통코드 번호 — NOT NULL — FK, 직계 하위코드만 참조
  • 코드 호출키 (CALL_KEY) — VARCHAR(20) — NOT NULL — 데이터 호출 시 KEY. 데이터 MAP 의 KEY 값 e.g) COURSE_DROPDOWN1
  • 비고 (RMRK) — VARCHAR(200) — 용도 설명 e.g) 강의 분류코드

메뉴 관리 (SYS_MENU_T)

  • 메뉴 번호 (MENU_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • URL — VARCHAR(100) — NOT NULL — UK
  • 메뉴명 (MENU_NM) — VARCHAR(20) — NOT NULL
  • 메뉴 분류 (MENU_TYPE) — VARCHAR(10) — NOT NULL — 공통코드 사용. MENU, TAB, GNB(QUICK), FCT...
  • 정렬 순서 (SORT_SEQ) — INT — NOT NULL — 0, 10, 20... 단위로 중간값 끼워넣을 수 있도록 사용
  • 깊이 (DEPTH) — INT — NOT NULL — 최대 3단계.
  • 사용 여부 (USE_YN) — CHAR(1) — NOT NULL — 비활성시 하위 메뉴도 사용불가
  • 공용여부 (DFLT_YN) — CHAR(1) — NOT NULL — 인증 사용자에 대한 별도 접근권 검사 없는 화면. 대시보드 등
  • 화면 여부 (SCR_YN) — CHAR(1) — NOT NULL — 실제 최하단 화면인가? 권한 매핑할 화면 식별자.
  • 비고 (RMRK) — VARCHAR(100)
  • 상위 메뉴 번호 (PARENT_MENU_NO) — BIGINT(20) — 외래 키 → 메뉴 관리.메뉴 번호 — FK
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

사용자 관리 (DIM_USER_T)

  • 사용자 번호 (USER_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 사용자ID (USER_ID) — VARCHAR(20) — NOT NULL — UK. PK 로도 사용 가능하나 API 에서 계정을 노출하지 않기 위한 UK화.
  • 사용자PW (USER_PW) — VARCHAR(200) — NOT NULL
  • 암호화 솔트 (SALT) — VARCHAR(30) — NOT NULL
  • 사용자명 (USER_NM) — VARCHAR(20) — NOT NULL
  • 닉네임 (NICKNM) — VARCHAR(15) — 영어이름 등
  • 소속부서(팀) 코드 (DEPT_CD) — VARCHAR(20) — 이 경우엔 공통코드의 '과목' 사용
  • 연락처 (TEL) — VARCHAR(20)
  • 이메일 (EML) — VARCHAR(200) — NOT NULL — UK. 업무메일 중복 불가
  • 직급 번호 (ROLE_NO) — BIGINT(20) — 외래 키 → 직급 관리.직급 번호 — NOT NULL — FK.
  • 외국인 여부 (FRGN_YN) — CHAR(1) — NOT NULL — 'Y' 인 경우 주로 외국어 계열의 원어민 강사
  • 입사일 (JOIN_YMD) — DATE
  • 관리자 여부 (ADM_YN) — CHAR(1) — NOT NULL — 삭제 불가 계정
  • 재직 여부 (USE_YN) — CHAR(1) — NOT NULL — 비활성 계정은 로그인 제한
  • 비고 (RMRK) — VARCHAR(100)
  • 로그인 실패 횟수 (LGN_FAIL_CNT) — INT — NOT NULL — 비밀번호 5회 틀리면 계정 잠금, 성공 시 초기화
  • 비밀번호 변경일 (PW_MOD_YMD) — DATE — 마지막 비밀번호 변경 후 6개월이 지나면 변경 권장
  • 퇴사일 (QUIT_YMD) — DATE
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

수강생 관리 (DIM_STDNT_T)

  • 학생 번호 (STDNT_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 학생명 (STDNT_NM) — VARCHAR(30) — NOT NULL — 검색조회 편의상 인덱싱 권장
  • 학생 연락처 (STDNT_TEL) — VARCHAR(15)
  • 생년월일 (BIRTHDATE) — DATE
  • 등록 여부 (USE_YN) — CHAR(1) — NOT NULL
  • 소속 학교 (SCHOOL_NM) — VARCHAR(50) — 재학 학교 정보
  • 보호자 연락처 (NEXT_OF_KIN_TEL) — VARCHAR(15) — NOT NULL — 수강생이 성인이면 본인 연락처 가능. SMS 수신 대상.
  • 보호자명 (NEXT_OF_KIN_NM) — VARCHAR(30)
  • 주소1 (ADDR1) — VARCHAR(200)
  • 주소2 (ADDR2) — VARCHAR(50)
  • 비고(특이사항) (RMRK) — TEXT — 누구든 작성, 수정 가능.
  • 학급 번호 (CLS_NO) — BIGINT(20) — 외래 키 → 학급 관리.학급 번호 — FK
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

수강생 보호자 상담 내역 (FCT_COUNSEL_T)

  • 상담 이력 번호 (CNFRNC_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 학생 번호 (STDNT_NO) — BIGINT(20) — 외래 키 → 수강생 관리.학생 번호 — NOT NULL — FK
  • 상담일자 (CNFRNC_YMD) — DATE — NOT NULL
  • 상담내용 (CONTENTS) — TEXT — NOT NULL
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

수업 시간표 (FCT_TMTBL_T)

  • 시간표 번호 (TMTBL_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 학급 번호 (CLS_NO) — BIGINT(20) — 외래 키 → 학급 관리.학급 번호 — NOT NULL — FK
  • 적용 분기 (QUARTER) — INT — 1~4? 정확히는 2026.'2' 처럼 분기 표시
  • 적용 시작일 (START_YMD) — DATE — NOT NULL — 연월일
  • 적용 종료일 (END_YMD) — DATE — NOT NULL
  • 사용여부 (USE_YN) — CHAR(1) — NOT NULL
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

수업 시간표 세부내역 (FCT_TMTBL_DTL_T)

  • 시간표 세부내역 번호 (TMTBL_DTL_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 시간표 번호 (TMTBL_NO) — BIGINT(20) — 외래 키 → 수업 시간표.시간표 번호 — NOT NULL — FK
  • 수업 번호 (CLS_LIST_NO) — BIGINT(20) — 외래 키 → 학급별 수업 목록 관리.수업 번호 — NOT NULL
  • 수업 요일 (DAY) — INT — NOT NULL — 요일 ENUM 활용
  • 시작시간 (START_TM) — TIME — NOT NULL — 9:00, 14:00... (초는 무시
  • 종료시간 (END_TM) — TIME — NOT NULL — 10:00, 16:00... (초는 무시
  • 수업시간 (HOURS) — INT — NOT NULL — (단위: 60분) 1: 60분, 2: 120분...

시험 성적 관리 (FCT_EXAM_SCR_LOG_T)

  • 성적 번호 (EXAM_SCR_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 학생 번호 (STDNT_NO) — BIGINT(20) — 외래 키 → 수강생 관리.학생 번호 — NOT NULL — FK, 인덱싱
  • 시험일 (EXAM_YMD) — DATE — NOT NULL — 검색 편의상 인덱싱 권장
  • 시험 종류 코드 (EXAM_TYPE_CD) — VARCHAR(20) — NOT NULL — 중간/기말고사, 텀테스트, 쪽지시험 등
  • 시험 과목 (SBJCT_CD) — VARCHAR(20) — 국, 영, 수 등 과목 대분류. 공통코드 분류값 사용
  • 시험 내용 코드 (SBJCT_DTL_CD) — VARCHAR(20) — 구체적인 과목 분류. e.g) 문법, 독해... NULL 허용
  • 만점 기준 (MAX_SCR) — DOUBLE — 단위가 다른 경우도 있음
  • 취득 점수 (SCR) — DOUBLE — NOT NULL — 실제 취득 점수. 만점 기준보다 클 수 없음.
  • 소속 학급명 (CLSRM_NM) — VARCHAR(200) — 어떤 학급일 때 취득한 성적인지 로그 차원에서 표기.
  • 비고 (RMRK) — TEXT — 기타 특이사항
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20) — 성적 입력 담당자. 주로 담임 강사
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

직급 관리 (SYS_ROLE_T)

  • 직급 번호 (ROLE_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 직급명 (ROLE_NM) — VARCHAR(20) — NOT NULL — UK
  • 정렬 순서 (SORT_SEQ) — INT — NOT NULL — 숫자가 작을수록 위, 왼쪽에 표시. 직접 입력X, UI 통할 것
  • 사용여부 (USE_YN) — CHAR(1) — NOT NULL — 비활성 ROLE 을 가진 사용자는 로그인 제한
  • 시스템 권한 여부 (SYS_YN) — CHAR(1) — NOT NULL — 'Y' 의 경우 삭제 불가
  • 비고 (RMRK) — TEXT
  • 생성일시 (CRT_DTM) — DATETIME
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)

직급별 메뉴 접근권 관리 (FCT_ROLE_MENU_T)

  • Key — 기본 키 — NOT NULL
  • 메뉴 번호 (MENU_NO) — BIGINT(20) — 외래 키 → 메뉴 관리.메뉴 번호 — NOT NULL — PK. 인조키를 별도로 둘 것이냐? 는 고민 중.
  • 직급 번호 (ROLE_NO) — BIGINT(20) — 외래 키 → 직급 관리.직급 번호 — NOT NULL — PK. 메뉴에 직급이 매핑돼있으면 조회권 있음으로 취급
  • 등록 및 수정권한 (CU_YN) — CHAR(1) — NOT NULL — 신규 등록, 수정(C, U)은 한 세트로 운용.
  • 데이터 활성화 권한 (ACT_YN) — CHAR(1) — NOT NULL — USE_YN 등 활성화 여부 권한
  • 삭제 권한 (D_YN) — CHAR(1) — NOT NULL — 비활성화 아닌 삭제(D) 권한. 물리/논리 포함
  • 기타 권한 확장 가능 (SPARE1) — CHAR(1) — 특정 메뉴에서의 알림 수신이라든가... 확장 가능성

첨부파일 메타데이터 관리 (FCT_ATCH_INFO_T)

  • 첨부파일 번호 (ATCH_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 원본파일명 (ORGN_NM) — VARCHAR(255) — NOT NULL — 확장자 포함인데 파일명이 긴 경우는 어디까지 허용?
  • 파일저장명 (STORED_NM) — VARCHAR(255) — NOT NULL — UK. 실제 서버 저장 시 랜덤난수명UUID 사용
  • 물리적 저장 경로 (STORED_PATH) — VARCHAR(100) — NOT NULL — 서버 내부저장 상대경로
  • 파일 사이즈 (SIZE) — BIGINT(20) — NOT NULL — BYTE 단위
  • 파일 타입 (MIME) — VARCHAR(100) — MIME 타입 (image/png 등)
  • 확장자 (EXT) — VARCHAR(10)

첨부파일 참조 관리 (FCT_ATCH_REF_T)

  • 첨부파일 참조 번호 (ATCH_REF_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 첨부파일 번호 (ATCH_NO) — BIGINT(20) — 외래 키 → 첨부파일 메타데이터 관리.첨부파일 번호 — NOT NULL — FK
  • 참조 PK (REF_PK) — BIGINT(20) — NOT NULL — 첨부파일이 포함된 원글의 PK
  • 사용처 코드 (REF_CD) — VARCHAR(20) — NOT NULL — 공통코드 사용. 공지사항: NTC 등. VAL 값이 TB명

학급 관리 (DIM_CLS_T)

  • 학급 번호 (CLS_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 학급명 (STDNT_CLS_NM) — VARCHAR(50) — NOT NULL — 내신, 수능, 성인반 뭐 기타 등등...
  • 학급 식별키 (SUDNT_CLS_KEY) — VARCHAR(50) — UK. 식별코드 이어붙인 이름 e.g) ES-IM3-a
  • 담임 (USER_NO) — BIGINT(20) — 외래 키 → 사용자 관리.사용자 번호 — FK, 인덱싱? 강사 입장에서 본인 담당 학급 정보를 쉽게 조회하기 위한 것
  • 종합반 여부 (ALL_IN_ONE_YN) — CHAR(1) — NOT NULL — 'Y' 이면 다수 과목을 다루는 종합반. 그 외 디폴트는 단과 학급.
  • 수강생 교육단계 코드 (STDNT_STEP_CD) — VARCHAR(20) — 초/중/고등학교, 미취학/성인 등 수강생 소속 분류코드값
  • 대상 학습 수준 코드 (STDNT_LV_CD) — VARCHAR(20) — 초/중/고급자 분류코드값
  • 강의 난이도 (COURSE_LV) — INT — 강의 난이도 1~3. 값이 클수록 고급 수준.
  • 허용 정원 (CAPACITY) — INT — 정원수 초과 불가
  • 학급 순서 (CLS_SEQ) — CHAR(1) — NOT NULL — a, b, c... 알파벳 순서로 학급 정렬. 학년을 반영하기도 하나..?
  • 사용 교실 (CLS_LOC) — VARCHAR(50) — 학급 교실 위치
  • 선행학습 여부 (PRE_YN) — CHAR(1) — NOT NULL — 'Y'인 경우 특정 단계의 선행학습 반
  • 선행학습 목표단계 (PRE_STEP_CD) — VARCHAR(20) — PRE_YN 값이 'Y'인 경우에만 입력. 선행학습 목표. e.g.) pre-middle : 중등 선행
  • 원어민 강사 유무 (NTV_YN) — CHAR(1) — NOT NULL — 외국인 강사 수업이 있는 경우의 옵션
  • 운영 여부 (USE_YN) — CHAR(1) — NOT NULL — 'N' 인 경우 비활성화. 담임 및 학생 정보 연결해제
  • 비고 (RMRK) — TEXT
  • 생성일시 (CRT_DTM) — DATE
  • 생성자 (CRT_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATE
  • 수정자 (MOD_ID) — VARCHAR(20)

학급별 수업 목록 관리 (FCT_CLS_LIST_T)

  • 수업 번호 (CLS_LIST_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 학급 번호 (CLS_NO) — BIGINT(20) — 외래 키 → 학급 관리.학급 번호 — NOT NULL — FK, 인덱싱
  • 수업 과목 코드 (SBJCT_CD) — VARCHAR(20) — 국, 영, 수 등. 공통코드 참조
  • 수업 내용 코드 (SBJCT_TYPE_CD) — VARCHAR(20) — e.g) 영어: 파닉스, 문법, 기타 등등
  • 수업 방식 코드 (CRS_TYPE_CD) — VARCHAR(20) — 일반적인 수업인지, 과외인지, 활동인지...
  • 강사 (USER_NO) — BIGINT(20) — 외래 키 → 사용자 관리.사용자 번호 — FK
  • 비고 (RMRK) — TEXT — 수업교재, 준비물 등 여기에 명시

회의록 (FCT_MEETING_LOG_T)

  • 회의록 번호 (MEETING_LOG_NO) — BIGINT(20) — 기본 키 — NOT NULL — PK
  • 제목 (TITLE) — VARCHAR(100) — NOT NULL
  • 내용 (CONTENTS) — TEXT — NOT NULL
  • 회의일자 (MEETING_YMD) — DATE — NOT NULL
  • 회의 시작 시간 (START_TM) — TIME
  • 회의 종료 시간 (END_TM) — TIME
  • 참여인원 (ATTENDTEES) — VARCHAR(200) — 단순 텍스트, 참조X
  • 회의장소 (MEETING_LOC) — VARCHAR(100)
  • 회의 목적 (AGENDA) — VARCHAR(150)
  • 회의 결론 (CONCLUSION) — VARCHAR(200)
  • 중요도 (IMPORTANCE) — INT — 상중하. 숫자가 클수록 중요.
  • 생성자 (CRT_ID) — VAARCHAR(20)
  • 생성일시 (CRT_DTM) — DATETIME
  • 수정자 (MOD_ID) — VARCHAR(20)
  • 수정일시 (MOD_DTM) — DATETIME