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)