Pooli

실시간 가족 그룹 데이터 사용 관리 및 트래픽 처리 프로젝트

테이블 (30)

Redis 동기화 유실 방지용 Outbox 테이블 (TRAFFIC_REDIS_OUTBOX)

  • pk (id) — BIGINT — 기본 키 — NOT NULL
  • 동기화 이벤트 타입 (event_type) — VARCHAR(64) — NOT NULL
  • payload — TEXT — NOT NULL — redis 접근 메서드의 파라미터 정보 등을 저장
  • 멱등키 (uuid) — VARCHAR(64) — NOT NULL
  • 재시도 처리 상태 (status) — VARCHAR(16) — NOT NULL — PENDING/PROCESSING/SUCCESS/FAIL
  • 재시도 횟수 (retry_count) — INT — NOT NULL
  • 레코드 생성 일자 (created_at) — DATETIME(6) — NOT NULL
  • status 갱신 일자 (status_updated_at) — DATETIME(6) — NOT NULL

가족 결합 (FAMILY)

  • 가족 결합 식별자 (family_id) — BIGINT — 기본 키 — NOT NULL
  • 공유풀 기본 제공량 (pool_base_data) — BIGINT — NOT NULL
  • 공유풀 총량 (pool_total_data) — BIGINT — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)
  • 가족 공유 데이터 임계치 (family_threshold) — BIGINT — NOT NULL
  • 가족 공유 데이터 임계치 활성화 여부 (is_threshold_active) — BOOLEAN — NOT NULL

각 단말의 일별 & 앱별 데이터 사용량 기록 테이블 (DAILY_APP_TOTAL_DATA)

  • 데이터 사용일자 (usage_date) — DATE — 기본 키 — NOT NULL — UK
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL — UK
  • 어플리케이션 식별자 (application_id) — INT — 외래 키 → 어플리케이션.어플리케이션 식별자 — NOT NULL — UK
  • 개인 데이터 사용량 (individual_usage_data) — BIGINT — NOT NULL
  • 공유 데이터 사용량 (shared_usage_data) — BIGINT — NOT NULL
  • QoS 데이터 사용량 (qos_usage_data) — BIGINT — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

각 단말의 일별 전체 데이터 사용량 기록 테이블 (DAILY_TOTAL_DATA)

  • 데이터 사용일자 (usage_date) — DATE — 기본 키 — NOT NULL — UK
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL — UK
  • 누적 데이터 사용량(개인 + 공유) (total_usage_data) — BIGINT — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

권한 - 회선 매핑 정보 (PERMISSION_LINE)

  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL — UK
  • 권한 정보 식별자 (permission_id) — INT — 외래 키 → 권한 정보.권한 정보 식별자 — NOT NULL — UK
  • 활성화 권한 부여 여부 (is_enable) — BOOLEAN — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 수정시점 (updated_at) — DATETIME(6)

권한 정보 (PERMISSION)

  • 권한 정보 식별자 (permission_id) — INT — 기본 키 — NOT NULL
  • 권한 이름 (permission_title) — VARCHAR(20) — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

답변 내역 (ANSWER)

  • 답변 내역 식별자 (answer_id) — BIGINT — 기본 키 — NOT NULL
  • 유저 식별자 (user_id) — BIGINT — 외래 키 → 사용자.유저 식별자 — NOT NULL — 답변을 작성한 관리자
  • 문의 내역 식별자 (question_id) — BIGINT — 외래 키 → 문의 내역.문의 내역 식별자 — NOT NULL
  • 내용 (content) — VARCHAR(2000) — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)

답변 내역 첨부 파일 (ANSWER_ATTACHMENT)

  • 답변 내역 첨부 파일 식별자 (answer_attachment_id) — BIGINT — 기본 키 — NOT NULL
  • 답변 내역 식별자 (answer_id) — BIGINT — 외래 키 → 답변 내역.답변 내역 식별자 — NOT NULL
  • S3 Key (s3_key) — VARCHAR(512)
  • 파일 크기 (file_size) — INT — Byte 단위
  • 생성 시점 (created_at) — TIMESTAMP — NOT NULL
  • 삭제 시점 (deleted_at) — TIMESTAMP

당일 가족 공유 데이터 사용량/기여량 누적 기록 (FAMILY_SHARED_USAGE_DAILY)

  • 데이터 사용 일자 (usage_date) — DATE — 기본 키 — NOT NULL
  • 가족 결합 식별자 (family_id) — BIGINT — 외래 키 → 가족 결합.가족 결합 식별자 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 당일 공유풀 데이터 사용량 (usage_amount) — BIGINT — NOT NULL
  • 충전 데이터량 (contribution_amount) — BIGINT — NOT NULL — 회선에서 공유풀로 충전한 데이터량
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

문의 내역 (QUESTION)

  • 문의 내역 식별자 (question_id) — BIGINT — 기본 키 — NOT NULL
  • 문의 카테고리 식별자 (question_category_id) — INT — 외래 키 → 문의 카테고리.문의 카테고리 식별자 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 제목 (title) — VARCHAR(50) — NOT NULL
  • 내용 (content) — VARCHAR(1000) — NOT NULL
  • 답변 여부 (is_answer) — BOOLEAN — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)

문의 내역 첨부 파일 (QUESTION_ATTACHMENT)

  • 문의 내역 첨부 파일 식별자 (question_attachment_id) — BIGINT — 기본 키 — NOT NULL
  • 문의 내역 식별자 (question_id) — BIGINT — 외래 키 → 문의 내역.문의 내역 식별자 — NOT NULL
  • S3 Key (s3_key) — VARCHAR(512) — NOT NULL
  • 파일 크기 (file_size) — INT — NOT NULL — Byte 단위, 사진 제한 크기 설정해두기
  • 생성 시점 (created_at) — TIMESTAMP — NOT NULL
  • 삭제 시점 (deleted_at) — TIMESTAMP

문의 카테고리 (QUESTION_CATEGORY)

  • 문의 카테고리 식별자 (question_category_id) — INT — 기본 키 — NOT NULL
  • 문의 카테고리 명 (question_category_name) — VARCHAR(20) — NOT NULL — uk
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)

반복 차단 요일 및 시간대 정보 (REPEAT_BLOCK_DAY)

  • 반복 차단 요일 식별자 (repeat_block_day_id) — BIGINT — 기본 키 — NOT NULL
  • 반복적 차단 식별자 (repeat_block_id) — BIGINT — 외래 키 → 반복적 차단 정보.반복적 차단 식별자 — NOT NULL
  • 요일 (day_of_week) — ENUM('SUN','MON','TUE','WED','THU','FRI','SAT') — NOT NULL
  • 시작 시간 (start_at) — TIME — NOT NULL
  • 종료 시간 (end_at) — TIME — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

반복적 차단 정보 (REPEAT_BLOCK)

  • 반복적 차단 식별자 (repeat_block_id) — BIGINT — 기본 키 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 활성화 상태 (is_active) — BOOLEAN — NOT NULL — 활성화 / 비활성화
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

사용자 (USERS)

  • 유저 식별자 (user_id) — BIGINT — 기본 키 — NOT NULL
  • 이름 (user_name) — VARCHAR(50) — NOT NULL
  • 이메일 (email) — VARCHAR(50) — NOT NULL
  • 비밀번호 (password) — VARCHAR(255) — NOT NULL
  • 나이 (age) — TINYINT — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

알람 기록 (ALARM_HISTORY)

  • 알람 기록 식별자 (alarm_history_id) — BIGINT — 기본 키 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 알람 코드 (alarm_code) — ENUM('LIMIT','POLICY', 'PERMISSION','QUESTION') — NOT NULL — enum
  • 값 (value) — TEXT — json
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 읽음 시점 (read_at) — DATETIME(6)

알람 설정 (ALARM_SETTING)

  • 유저 식별자 (user_id) — BIGINT — 외래 키 → 사용자.유저 식별자 — NOT NULL
  • 가족 데이터 알림 설정 (family_alarm) — BOOLEAN — NOT NULL
  • 개인 데이터 알림 설정 (user_alarm) — BOOLEAN — NOT NULL
  • 정책 변경 알림 설정 (policy_change_alarm) — BOOLEAN — NOT NULL
  • 정책 한도 알림 설정 (policy_limit_alarm) — BOOLEAN — NOT NULL
  • 권한 변경 알림 설정 (permission_alarm) — BOOLEAN — NOT NULL
  • 문의 사항 알림 설정 (question_alarm) — BOOLEAN — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

어플리케이션 (APPLICATION)

  • 어플리케이션 식별자 (application_id) — INT — 기본 키 — NOT NULL
  • 어플리케이션 이름 (application_name) — VARCHAR(20) — NOT NULL
  • 카테고리 (category) — ENUM( 'SNS','ENTERTAINMENT','WEB','EDUCATION','SHOPPING','OTHER') — NOT NULL

역할 (ROLE)

  • 역할 식별자 (role_id) — INT — 기본 키 — NOT NULL
  • 역할 이름 (role_name) — VARCHAR(10) — NOT NULL

역할 매핑 테이블 (USER_ROLE)

  • 유저 식별자 (user_id) — BIGINT — 외래 키 → 사용자.유저 식별자 — NOT NULL
  • 역할 식별자 (role_id) — INT — 외래 키 → 역할.역할 식별자 — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL

요금제 (PLAN)

  • 요금제 식별자 (plan_id) — INT — 기본 키 — NOT NULL
  • 요금제 카테고리 (plan_category) — VARCHAR(20) — NOT NULL
  • 요금제 이름 (plan_name) — VARCHAR(30) — NOT NULL
  • 기본 제공 데이터 량 (basic_data_amount) — BIGINT — NOT NULL — 무제한일 경우 -1
  • 추가 공유풀 데이터량 (shared_pool_amount) — BIGINT — NOT NULL — 속한 가족 결합의 데이터 잔량에 자동 추가되는 데이터
  • 네트워크 타입 (network_type) — ENUM('LTE', '5G') — NOT NULL
  • 기본 제공 데이터 소진 시 제한된 데이터 속도 (qos_speed_limit) — INT — NOT NULL — 단위 - KB, 무제한, 종량제 요금의 경우 0
  • 무제한여부 (is_unlimited) — BOOLEAN — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

일별 동기화 배치 target 테이블 (LINE_DAILY_BATCH_TARGET)

  • id — BIGINT — 기본 키 — NOT NULL
  • 배치 대상 일자 (usage_date) — DATE — NOT NULL
  • 배치 대상 회선 (line_id) — BIGINT — NOT NULL
  • 배치 처리 상태 (status) — VARCHAR(16) — NOT NULL
  • 배치 처리 상태 갱신 일자 (status_updated_at) — DATETIME(6) — NOT NULL
  • 담당 워커 식별자 (worker_id) — VARCHAR(128)
  • 재시도 횟수 (retry_count) — INT — NOT NULL — 최대 10회 재시도
  • 마지막 에러 코드 (last_error_code) — VARCHAR(64)
  • 마지막 에러 메시지 (last_error_message) — VARCHAR(512)
  • 레코드 생성 일자 (created_at) — DATETIME(6) — NOT NULL

일별 배치 메타데이터 테이블 (LINE_DAILY_BATCH_JOB)

  • id — BIGINT — 기본 키 — NOT NULL
  • 배치 이름 (batch_name) — VARCHAR(64) — NOT NULL
  • 배치 대상 일자 (usage_date) — DATE — NOT NULL
  • 배치 진행 상태 (status) — VARCHAR(16) — NOT NULL
  • 배치 진행 상태 갱신 일자 (status_updated_at) — DATETIME(6) — NOT NULL
  • 배치 시작 일자 (run_started_at) — DATETIME(6)
  • 배치 종료 일자 (finished_at) — DATETIME(6)
  • 배치 대상 레코드 수 (target_count) — BIGINT — NOT NULL
  • 배치 성공 레코드 수 (success_count) — BIGINT — NOT NULL
  • 배치 실패 레코드 수 (failed_count) — BIGINT — NOT NULL
  • 배치 스킵 레코드 수 (skipped_count) — BIGINT — NOT NULL — 동기화할 redis 데이터가 하나도 없는 레코드 수
  • 처리한 레코드 수 갱신일자 (processed_count_updated_at) — DATETIME(6)
  • 배치 매니저 워커 식별자 (manager_instance_id) — VARCHAR(128)
  • 마지막 에러 코드 (last_error_code) — VARCHAR(64)
  • 마지막 에러 메시지 (last_error_message) — VARCHAR(512)
  • 레코드 생성 일자 (created_at) — DATETIME(6) — NOT NULL

정책 정보 (POLICY)

  • 정책 정보 식별자 (policy_id) — INT — 기본 키 — NOT NULL
  • 정책 카테고리 식별자 (policy_category_id) — INT — 외래 키 → 정책 카테고리.정책 카테고리 식별자 — NOT NULL
  • 정책 이름 (policy_name) — VARCHAR(50) — NOT NULL
  • 상태 (is_active) — BOOLEAN — NOT NULL
  • 신규 여부 (is_new) — BOOLEAN — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

정책 카테고리 (POLICY_CATEGORY)

  • 정책 카테고리 식별자 (policy_category_id) — INT — 기본 키 — NOT NULL
  • 카테고리 이름 (policy_category_name) — VARCHAR(20) — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

처리 완료 기록 테이블(done log) (TRAFFIC_DEDUCT_DONE)

  • pk (traffic_deduct_done_id) — BIGINT — 기본 키 — NOT NULL
  • 메시지의 trace_id (trace_id) — VARCHAR(64) — NOT NULL — UUID & UK
  • 메시지의 record_id (record_id) — VARCHAR(128)
  • 회선 식별자 (line_id) — BIGINT — NOT NULL
  • 가족 결합 그룹 식별자 (family_id) — BIGINT — NOT NULL
  • 데이터 사용한 app 식별자 (app_id) — INT — NOT NULL
  • 사용 요청한 총 데이터량 (api_total_data) — BIGINT — NOT NULL
  • 실제로 차감된 데이터량 (deducted_total_bytes) — BIGINT — NOT NULL
  • 차감하지 못한 데이터량 (api_remaining_data) — BIGINT — NOT NULL
  • 최종 메시지 처리 상태 (final_status) — VARCHAR(32) — NOT NULL
  • 최종 Lua 처리 상태 (last_lua_status) — VARCHAR(32)
  • 레코드 생성 일시 (created_at) — DATETIME(6) — NOT NULL
  • 메시지 처리 시작 일시 (started_at) — DATETIME(6) — NOT NULL — 워커 기준
  • 메시지 처리 완료 일시 (finished_at) — DATETIME(6) — NOT NULL — 워커 기준
  • 총 처리 소요 시간 (latency) — BIGINT — 워커 기준
  • Redis 복구 상태 (restore_status) — VARCHAR(32) — NOT NULL
  • Redis 복구 상태 갱신 일시 (restore_status_updated_at) — DATETIME(6) — NOT NULL — 기본값: created_at
  • Redis 복구 재시도 횟수 (restore_retry_count) — INT — NOT NULL
  • Redis 복구 실패 마지막 에러 메시지 (restore_last_error_message) — VARCHAR(1000)

회선 (LINE)

  • 회선 식별자 (line_id) — BIGINT — 기본 키 — NOT NULL
  • 유저 아이디 (user_id) — BIGINT — 외래 키 → 사용자.유저 식별자 — NOT NULL
  • 요금제 아이디 (plan_id) — INT — 외래 키 → 요금제.요금제 식별자 — NOT NULL
  • 전화번호 (phone) — VARCHAR(20) — NOT NULL — UK
  • 차단 종료 시간 (block_end_at) — DATETIME
  • 데이터 잔량 (total_data) — BIGINT — NOT NULL
  • 대표회선여부 (is_main) — BOOLEAN — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)
  • 개인 데이터 임계치 (individual_threshold) — BIGINT
  • 개인 데이터 임계치 활성화 여부 (is_threshold_active) — BOOLEAN — NOT NULL

회선 - 가족 결합 등록 (FAMILY_LINE)

  • 가족 결합 식별자 (family_id) — BIGINT — 외래 키 → 가족 결합.가족 결합 식별자 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 그룹 내 역할 (role) — ENUM('OWNER', 'MEMBER') — NOT NULL — (대표,구성원)
  • 가족원에게 정보 공개 여부 (is_public) — BOOLEAN — NOT NULL
  • 생성시점 (created_at) — DATETIME(6) — NOT NULL
  • 수정 시점 (updated_at) — DATETIME(6)

회선 별 앱 데이터 사용 제한 정책 (APP_POLICY)

  • 앱 데이터 정책 식별자 (app_policy_id) — BIGINT — 기본 키 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 어플리케이션 식별자 (application_id) — INT — 외래 키 → 어플리케이션.어플리케이션 식별자 — NOT NULL
  • 하루 데이터 사용 한도 (data_limit) — BIGINT — NOT NULL — 단위: Byte, -1: 무제한
  • 데이터 제한 속도 (speed_limit) — INT — NOT NULL — 단위: Kbps, -1: 무제한
  • 활성화 여부 (is_active) — BOOLEAN — NOT NULL
  • 화이트리스트 적용 여부 (is_whitelist) — BOOLEAN — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)

회선별 데이터 사용 한도 정보 (LINE_LIMIT)

  • 회선별 제한 정책 식별자 (limit_id) — BIGINT — 기본 키 — NOT NULL
  • 회선 식별자 (line_id) — BIGINT — 외래 키 → 회선.회선 식별자 — NOT NULL
  • 하루 데이터 사용 한도 (daily_data_limit) — BIGINT — NOT NULL — 단위: Byte
  • 하루 데이터 사용 한도 활성화 여부 (is_daily_limit_active) — BOOLEAN — NOT NULL
  • 월별 공유풀 사용 한도 (shared_data_limit) — BIGINT — NOT NULL — 단위: Byte
  • 월별 공유풀 사용 한도 활성화 여부 (is_shared_limit_active) — BOOLEAN — NOT NULL
  • 생성 시점 (created_at) — DATETIME(6) — NOT NULL
  • 삭제 시점 (deleted_at) — DATETIME(6)
  • 수정 시점 (updated_at) — DATETIME(6)