popup

테이블 (19)

admin_user

  • admin_id — bigint — 기본 키 — NOT NULL — 관리자ID
  • admin_login_id — varchar(50) — NOT NULL — 관리자 로그인ID
  • admin_name — varchar(100) — NOT NULL — 관리자명
  • is_active — boolean — NOT NULL — 사용 여부
  • created_at — datetime — NOT NULL — 등록 시각

choice(선지) (question_choice)

  • choice_id — bigint — 기본 키 — NOT NULL — 선지ID
  • content — text — NOT NULL — 선지 내용
  • is_active (Field) — 활성상태
  • created_by (Field2) — 생성자
  • created_at (Field3) — 생성일

department

  • dept_id — varchar(20) — 기본 키 — NOT NULL — 부서ID (HR 원천키)
  • parent_dept_id — varchar(20) — 외래 키 → department.dept_id — 상위 부서ID (최상위는 NULL)
  • dept_name — varchar(100) — NOT NULL — 부서명
  • sort_order — int — NOT NULL — 표시 순서
  • is_active — boolean — NOT NULL — 사용 여부
  • synced_at — datetime — NOT NULL — HR 동기화 시각

employee(직원) (employee)

  • emp_no — varchar(20) — 기본 키 — NOT NULL — 사번
  • emp_name — varchar(100) — NOT NULL — 성명
  • dept_id — varchar(20) — 외래 키 → department.dept_id — 소속 부서ID
  • hire_date — date — 입사일 (신규입사자 그룹 판정용)
  • resign_due_date — date — 퇴사 예정일 (퇴사예정자 그룹 판정용)
  • employment_status — varchar(20) — NOT NULL — 재직상태: ACTIVE(재직)/RESIGNING(퇴사예정)/RESIGNED(퇴사) — 퇴사자는 물리삭제 대신 논리처리
  • synced_at — datetime — NOT NULL — HR 동기화 시각

login_log (login_event)

  • event_id — bigint — 기본 키 — NOT NULL — 이벤트ID
  • emp_no — varchar(20) — 외래 키 → employee(직원).emp_no — NOT NULL — 사번
  • client_ip — varchar(45) — NOT NULL — 접속 IP
  • logged_in_at — datetime — NOT NULL — 로그인 시각

popup(팝업) (popup)

  • popup_id — bigint — 기본 키 — NOT NULL — 팝업ID
  • popup_type — varchar(10) — NOT NULL — 유형: NOTICE(공지)/QUIZ(퀴즈)/SURVEY(설문)/VIDEO(영상)
  • title — varchar(200) — NOT NULL — 제목
  • content — text — 본문(공지) 또는 안내문(퀴즈/설문/영상)
  • priority — int — NOT NULL — 노출 우선순위 (작을수록 먼저, 동률이면 등록일순)
  • status — varchar(10) — NOT NULL — 상태: DRAFT(작성중)/ACTIVE(활성)/INACTIVE(중지)
  • trigger_type — varchar(10) — NOT NULL — 노출 트리거: LOGIN(로그인 시)/SCHEDULE(특정 시각)
  • repeat_type — varchar(10) — NOT NULL — 반복: NONE/DAILY/MONTHLY/YEARLY (매n시간은 코드 추가로 확장)
  • valid_from — datetime — NOT NULL — 유효기간 시작
  • valid_to — datetime — NOT NULL — 유효기간 종료
  • pass_required — boolean — NOT NULL — 퀴즈 통과 필수 여부 (true면 is_passed=true 제출만 완료 인정)
  • allow_never_show — boolean — NOT NULL — "다시 표시하지 않음" 허용 여부 (공지 전용 옵션)
  • created_by — bigint — 외래 키 → admin_user.admin_id — NOT NULL — 등록 관리자ID
  • created_at — datetime — NOT NULL — 등록 시각
  • updated_at — datetime — NOT NULL — 수정 시각
  • repeat_day_of_month (Field) — 지정된 반복일
  • repeat_month (Field2) — 지정된 반복월(매년 반복시)

popup_audit_log

  • audit_id — bigint — 기본 키 — NOT NULL — 감사ID
  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — 팝업ID (삭제 시 NULL 유지)
  • admin_id — bigint — 외래 키 → admin_user.admin_id — NOT NULL — 변경 관리자ID
  • action — varchar(20) — NOT NULL — 행위: CREATE/UPDATE/DELETE/ACTIVATE/DEACTIVATE
  • detail — json — NOT NULL — 변경 내용 (변경 전/후 스냅샷 등)
  • changed_at — datetime — NOT NULL — 변경 시각

popup_display_log

  • display_id — bigint — 기본 키 — NOT NULL — 노출ID
  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID
  • emp_no — varchar(20) — 외래 키 → employee(직원).emp_no — NOT NULL — 사번
  • client_ip — varchar(45) — 노출 당시 접속 IP
  • trigger_type — varchar(10) — NOT NULL — 노출 트리거
  • shown_at — datetime — NOT NULL — 노출 시각

popup_question

  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID
  • question_id — bigint — 외래 키 → question(문항).question_id — NOT NULL — 문항ID
  • display_order — int — NOT NULL — 출제 순서
  • is_required — boolean — NOT NULL — 필수 응답 여부
  • score — decimal(5, 1) — NOT NULL — 배점 (퀴즈 채점용)

popup_schedule_time(팝업 노출 시각) (popup_schedule_time)

  • show_time — time — 기본 키 — NOT NULL — 노출 시각 (예 09:00, 14:30)
  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID

popup_submission

  • submission_id — bigint — 기본 키 — NOT NULL — 제출ID
  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID
  • emp_no — varchar(20) — 외래 키 → employee(직원).emp_no — NOT NULL — 사번
  • attempt_no — int — NOT NULL — 시도 회차 (클라이언트 재시도 3회 규칙 추적)
  • submit_status — varchar(10) — NOT NULL — 결과: SUCCESS/FAIL(기술적 실패)
  • fail_reason — varchar(200) — 실패 사유
  • score — decimal(6, 1) — 득점 (퀴즈 서버 채점 결과)
  • is_passed — boolean — 통과 여부 (퀴즈)
  • client_ip — varchar(45) — 제출 당시 접속 IP
  • submitted_at — datetime — NOT NULL — 제출 시각

popup_target(팝업 대상) (popup_target)

  • target_id — bigint — 기본 키 — NOT NULL — 대상조건ID
  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID
  • target_type — varchar(10) — NOT NULL — 유형: ALL(전체)/DEPT(부서)/GROUP(속성그룹)/EMP(사번)/IP(IP대역)
  • dept_id — varchar(20) — 외래 키 → department.dept_id — 대상 부서ID (DEPT)
  • include_sub_depts — boolean — NOT NULL — 하위 부서 자동 포함 여부 (DEPT)
  • group_id — bigint — 외래 키 → target_group(타겟 그룹).group_id — 대상 그룹ID (GROUP)
  • emp_no — varchar(20) — 외래 키 → employee(직원).emp_no — 대상 사번 (EMP)
  • ip_range — varchar(50) — 대상 IP/대역 (IP) — 단일 IP는 /32. 매칭: client_ip <<= ip_range. 사번·IP 충돌 시 사번 우선
  • created_at — datetime — NOT NULL — 등록 시각

popup_user_status(팝업 유저 상태) (popup_user_status)

  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID
  • emp_no — varchar(20) — 외래 키 → employee(직원).emp_no — NOT NULL — 사번
  • status — varchar(12) — NOT NULL — PENDING(미완료·재노출대상)/COMPLETED(제출완료)/NEVER_SHOW(공지 다시표시안함). 공지 단순 닫기는 상태 유지
  • shown_count — int — NOT NULL — 누적 노출 횟수
  • first_shown_at — datetime — 최초 노출 시각
  • last_shown_at — datetime — 최근 노출 시각
  • completed_at — datetime — 완료 시각
  • updated_at — datetime — NOT NULL — 갱신 시각

popup_video(영상) (popup_video)

  • popup_id — bigint — 외래 키 → popup(팝업).popup_id — NOT NULL — 팝업ID
  • video_url — text — NOT NULL — 영상 URL
  • duration_sec — int — 영상 길이(초)
  • complete_threshold_pct — decimal(5, 2) — NOT NULL — 시청 완료 기준 % (팝업별 설정, 기본 95)

question(문항) (question)

  • question_id — bigint — 기본 키 — NOT NULL — 문항ID
  • question_category — varchar(10) — NOT NULL — 용도: QUIZ/SURVEY/COMMON(공용)
  • question_type — varchar(10) — NOT NULL — 응답 유형: SINGLE(단일선택)/MULTI(복수선택)/TEXT(주관식)
  • content — text — NOT NULL — 문항 내용
  • is_active — boolean — NOT NULL — 사용 여부
  • created_by — bigint — 외래 키 → admin_user.admin_id — NOT NULL — 등록 관리자ID
  • created_at — datetime — NOT NULL — 등록 시각
  • updated_at — datetime — NOT NULL — 수정 시각

question_choice(문항 선지 N:M 테이블) (Untitled)

  • question_id — bigint — 외래 키 → question(문항).question_id — NOT NULL — 문항ID
  • choice_id — bigint — 외래 키 → choice(선지).choice_id — NOT NULL — 선지ID
  • display_order (Field) — 표시 순서 (선지 번호, 세로 정렬 순서 보장)
  • is_correct (Field2) — 정답 여부(퀴즈 채점용, 설문은 false)

submission_answer(응답) (submission_answer)

  • answer_id — bigint — 기본 키 — NOT NULL — 응답ID
  • question_id (question_id2) — bigint — 외래 키 → question_choice(문항 선지 N:M 테이블).question_id — NOT NULL — 문항ID
  • choice_id (choice_id2) — bigint — 외래 키 → question_choice(문항 선지 N:M 테이블).choice_id — NOT NULL — 선지ID
  • submission_id — bigint — 외래 키 → popup_submission.submission_id — NOT NULL — 제출ID
  • answer_text — text — 응답 텍스트 (주관식)

target_group(타겟 그룹) (target_group)

  • group_id — bigint — 기본 키 — NOT NULL — 그룹ID
  • group_name — varchar(100) — NOT NULL — 그룹명 (예: 신규 입사자, 퇴사 예정자, 직급, 근속년수)
  • rule_type — varchar(20) — NOT NULL — 판정 규칙: NEW_HIRE(입사일 기준)/RESIGNING(퇴사예정일 기준)/CUSTOM
  • rule_params — json — NOT NULL — 규칙 파라미터 (예: {"within_days":30})
  • is_active — boolean — NOT NULL — 사용 여부
  • created_at — datetime — NOT NULL — 등록 시각

video_watch_progress(영상 시청 진행 정보) (video_watch_progress)

  • popup_id — bigint — 외래 키 → popup_video(영상).popup_id — NOT NULL — 팝업ID (영상)
  • emp_no — varchar(20) — 외래 키 → employee(직원).emp_no — NOT NULL — 사번
  • max_position_sec — int — NOT NULL — 최대 도달 지점(초) — 완료 판정: max_position_sec / duration_sec * 100 >= complete_threshold_pct
  • cumulative_watch_sec — int — NOT NULL — 누적 실제 시청 시간(초)
  • last_position_sec — int — NOT NULL — 마지막 재생 위치(초) — 이어보기용
  • is_completed — boolean — NOT NULL — 시청 완료 여부
  • completed_at — datetime — 완료 시각
  • updated_at — datetime — NOT NULL — 갱신 시각