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