pop-up
Tables (18)
admin_user
- admin_id — bigint — Primary key — NOT NULL — 관리자ID
- admin_login_id — varchar(50) — NOT NULL — 관리자 로그인ID
- admin_name — varchar(100) — NOT NULL — 관리자명
- is_active — boolean — NOT NULL — 사용 여부
- created_at — timestamptz — NOT NULL
department
- dept_id — varchar(20) — Primary key — NOT NULL — 부서ID (HR 원천키)
- parent_dept_id — varchar(20) — Foreign key → department.dept_id — 상위 부서ID (최상위는 NULL)
- dept_name — varchar(100) — NOT NULL — 부서명
- sort_order — integer — NOT NULL — 표시 순서
- is_active — boolean — NOT NULL — 사용 여부
- synced_at — timestamptz — NOT NULL — HR 동기화 시각
employee
- emp_no — varchar(20) — Primary key — NOT NULL — 사번
- emp_name — varchar(100) — NOT NULL — 성명
- dept_id — varchar(20) — Foreign key → department.dept_id — 소속 부서ID
- hire_date — date — 입사일 (신규입사자 그룹 판정용)
- resign_due_date — date — 퇴사 예정일 (퇴사예정자 그룹 판정용)
- employment_status — varchar(20) — NOT NULL — 재직상태: ACTIVE(재직)/RESIGNING(퇴사예정)/RESIGNED(퇴사) — 퇴사자는 물리삭제 대신 논리처리
- synced_at — timestamptz — NOT NULL — HR 동기화 시각
login_event
- event_id — bigint — Primary key — NOT NULL — 이벤트ID
- emp_no — varchar(20) — Foreign key → employee.emp_no — NOT NULL — 사번
- client_ip — inet — NOT NULL — 접속 IP
- logged_in_at — timestamptz — NOT NULL — 로그인 시각
popup
- popup_id — bigint — Primary key — NOT NULL — 팝업ID
- popup_type — varchar(10) — NOT NULL — 유형: NOTICE(공지)/QUIZ(퀴즈)/SURVEY(설문)/VIDEO(영상)
- title — varchar(200) — NOT NULL — 제목
- content — text — 본문(공지) 또는 안내문(퀴즈/설문/영상)
- priority — integer — 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 — timestamptz — NOT NULL — 유효기간 시작
- valid_to — timestamptz — NOT NULL — 유효기간 종료
- pass_required — boolean — NOT NULL — 퀴즈 통과 필수 여부 (true면 is_passed=true 제출만 완료 인정)
- allow_never_show — boolean — NOT NULL — "다시 표시하지 않음" 허용 여부 (공지 전용 옵션)
- created_by — bigint — Foreign key → admin_user.admin_id — NOT NULL — 등록 관리자ID
- created_at — timestamptz — NOT NULL
- updated_at — timestamptz — NOT NULL
popup_audit_log
- audit_id — bigint — Primary key — NOT NULL — 감사ID
- popup_id — bigint — Foreign key → popup.popup_id — 팝업ID (삭제 시 NULL 유지)
- admin_id — bigint — Foreign key → admin_user.admin_id — NOT NULL — 변경 관리자ID
- action — varchar(20) — NOT NULL — 행위: CREATE/UPDATE/DELETE/ACTIVATE/DEACTIVATE
- detail — jsonb — NOT NULL — 변경 내용 (변경 전/후 스냅샷 등)
- changed_at — timestamptz — NOT NULL — 변경 시각
popup_display_log
- display_id — bigint — Primary key — NOT NULL — 노출ID
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
- emp_no — varchar(20) — Foreign key → employee.emp_no — NOT NULL — 사번
- client_ip — inet — 노출 당시 접속 IP
- trigger_type — varchar(10) — NOT NULL — 노출 트리거
- shown_at — timestamptz — NOT NULL — 노출 시각
popup_question
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
- question_id — bigint — Foreign key → question.question_id — NOT NULL — 문항ID
- display_order — integer — NOT NULL — 출제 순서
- is_required — boolean — NOT NULL — 필수 응답 여부
- score — numeric(5,1) — NOT NULL — 배점 (퀴즈 채점용)
popup_schedule_time
- show_time — time — Primary key — NOT NULL — 노출 시각 (예 09:00, 14:30)
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
popup_submission
- submission_id — bigint — Primary key — NOT NULL — 제출ID
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
- emp_no — varchar(20) — Foreign key → employee.emp_no — NOT NULL — 사번
- attempt_no — integer — NOT NULL — 시도 회차 (클라이언트 재시도 3회 규칙 추적)
- submit_status — varchar(10) — NOT NULL — 결과: SUCCESS/FAIL(기술적 실패)
- fail_reason — varchar(200) — 실패 사유
- score — numeric(6,1) — 득점 (퀴즈 서버 채점 결과)
- is_passed — boolean — 통과 여부 (퀴즈)
- client_ip — inet — 제출 당시 접속 IP
- submitted_at — timestamptz — NOT NULL — 제출 시각
popup_target
- target_id — bigint — Primary key — NOT NULL — 대상조건ID
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
- target_type — varchar(10) — NOT NULL — 유형: ALL(전체)/DEPT(부서)/GROUP(속성그룹)/EMP(사번)/IP(IP대역)
- dept_id — varchar(20) — Foreign key → department.dept_id — 대상 부서ID (DEPT)
- include_sub_depts — boolean — NOT NULL — 하위 부서 자동 포함 여부 (DEPT)
- group_id — bigint — Foreign key → target_group.group_id — 대상 그룹ID (GROUP)
- emp_no — varchar(20) — Foreign key → employee.emp_no — 대상 사번 (EMP)
- ip_range — cidr — 대상 IP/대역 (IP) — 단일 IP는 /32. 매칭: client_ip <<= ip_range. 사번·IP 충돌 시 사번 우선
- created_at — timestamptz — NOT NULL
popup_user_status
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
- emp_no — varchar(20) — Foreign key → employee.emp_no — NOT NULL — 사번
- status — varchar(12) — NOT NULL — PENDING(미완료·재노출대상)/COMPLETED(제출완료)/NEVER_SHOW(공지 다시표시안함). 공지 단순 닫기는 상태 유지
- shown_count — integer — NOT NULL — 누적 노출 횟수
- first_shown_at — timestamptz — 최초 노출 시각
- last_shown_at — timestamptz — 최근 노출 시각
- completed_at — timestamptz — 완료 시각
- updated_at — timestamptz — NOT NULL
popup_video
- popup_id — bigint — Foreign key → popup.popup_id — NOT NULL — 팝업ID
- video_url — text — NOT NULL — 영상 URL
- duration_sec — integer — 영상 길이(초)
- complete_threshold_pct — numeric(5,2) — NOT NULL — 시청 완료 기준 % (팝업별 설정, 기본 95)
question
- question_id — bigint — Primary key — 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 — Foreign key → admin_user.admin_id — NOT NULL
- created_at — timestamptz — NOT NULL
- updated_at — timestamptz — NOT NULL
question_choice
- choice_id — bigint — Primary key — NOT NULL — 선지ID
- question_id — bigint — Foreign key → question.question_id — NOT NULL — 문항ID
- content — text — NOT NULL — 선지 내용
- display_order — integer — NOT NULL — 표시 순서 (세로 정렬 순서 보장)
- is_correct — boolean — NOT NULL — 정답 여부 (퀴즈 채점용, 설문은 false)
submission_answer
- answer_id — bigint — Primary key — NOT NULL — 응답ID
- submission_id — bigint — Foreign key → popup_submission.submission_id — NOT NULL — 제출ID
- question_id — bigint — Foreign key → question.question_id — NOT NULL — 문항ID
- choice_id — bigint — Foreign key → question_choice.choice_id — 선택 선지ID (객관식)
- answer_text — text — 응답 텍스트 (주관식)
target_group
- group_id — bigint — Primary key — NOT NULL — 그룹ID
- group_name — varchar(100) — NOT NULL — 그룹명 (예: 신규 입사자)
- rule_type — varchar(20) — NOT NULL — 판정 규칙: NEW_HIRE(입사일 기준)/RESIGNING(퇴사예정일 기준)/CUSTOM
- rule_params — jsonb — NOT NULL — 규칙 파라미터 (예: {"within_days":30})
- is_active — boolean — NOT NULL — 사용 여부
- created_at — timestamptz — NOT NULL
video_watch_progress
- popup_id — bigint — Foreign key → popup_video.popup_id — NOT NULL — 팝업ID (영상)
- emp_no — varchar(20) — Foreign key → employee.emp_no — NOT NULL — 사번
- max_position_sec — integer — NOT NULL — 최대 도달 지점(초) — 완료 판정: max_position_sec / duration_sec * 100 >= complete_threshold_pct
- cumulative_watch_sec — integer — NOT NULL — 누적 실제 시청 시간(초)
- last_position_sec — integer — NOT NULL — 마지막 재생 위치(초) — 이어보기용
- is_completed — boolean — NOT NULL — 시청 완료 여부
- completed_at — timestamptz — 완료 시각
- updated_at — timestamptz — NOT NULL