Mainthelab

테이블 (49)

FAQ (faq_entry)

  • FAQ ID (faq_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • FAQ 코드 (faq_code) — VARCHAR(50) — NOT NULL — 관리자 목록 표시 코드. UNIQUE 후보이나 생성 형식·대소문자/collation·고유성·수정 정책이 Open이므로 승인 전 실제 UK는 미적용.
  • 질문 (question) — VARCHAR(255) — NOT NULL — 관리자 편집·고객 조회에 표시하는 질문. 부분 일치 검색은 데이터량·검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 답변 (answer) — TEXT — NOT NULL — 관리자 편집·고객 조회에 표시하는 답변. 빈 문자열·최대 길이·서식/sanitization은 Open이며 Mock 문구를 운영 기본값으로 사용하지 않는다.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 관리자 목록 정렬용 updated_at 인덱스 후보. 애플리케이션에서 갱신하며 DB 자동 갱신 규칙은 승인하지 않았다.
  • 표시 순서 (display_order) — INT — NOT NULL — 고객 FAQ 표시 순서. 명시적 정수값을 사용하고 DB 기본값을 두지 않는다.
  • 노출 여부 (is_exposed) — BOOLEAN — NOT NULL — 고객 FAQ 노출 여부. DB 기본값을 두지 않는다.

USIM 수령·배송 (usim_fulfillment)

  • 수령·배송 ID (fulfillment_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 수령·배송 유형 (delivery_type) — INT — NOT NULL — KBOOKS v1.3 기준 1 배송, 2 픽업. 임의 기본값 없음. 픽업은 store_id 필수, 배송은 주소 필드 검증이 필요하며 조건 제약 방식은 API/물리 설계에서 확정한다.
  • 수령 상태 (pickup_status) — VARCHAR(30) — 주문번호 기반 USIM 수령 상태. 부분환불 후에는 order_item.quantity-누적 refund_quantity의 잔여수량만 수령 가능하며 수령 결과·주문 현재 상태·상태 이력을 원자적으로 기록한다.
  • 우편번호 (zip_code) — VARCHAR(20) — delivery_type=1 배송일 때 사용하는 주소 스냅샷. 필수 조건과 형식은 KBOOKS/API 설계에서 검증한다.
  • 주소 1 (address_line1) — VARCHAR(255) — delivery_type=1 배송일 때 사용하는 주소 스냅샷. 필수 조건은 KBOOKS/API 설계에서 검증한다.
  • 주소 2 (address_line2) — VARCHAR(255) — delivery_type=1 배송일 때 사용하는 선택 주소 스냅샷.
  • 수령완료 일시 (pickup_completed_at) — DATETIME(3) — 주문번호 기반 수령완료가 성공한 시각. 미수령/배송은 NULL.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 주문 상품 ID (order_item_id) — BIGINT — 외래 키 → 주문 상품.주문 상품 ID — NOT NULL — 주문상품당 수령·배송 레코드 0..1. order_item_id UK 후보이며 별도 바우처/수령번호는 두지 않는다. FK 연쇄 삭제는 승인하지 않았다.
  • 픽업 위치 ID (store_id) — BIGINT — 외래 키 → 픽업 위치.픽업 위치 ID — delivery_type=2 픽업이면 운영 중인 store_info를 참조하고 배송은 NULL이다. 위치 운영 중단은 신규 선택만 차단하며 과거 수령·주문 FK는 유지한다.
  • 수령 처리자 사용자 ID (processed_by_user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 주문번호 기준 수령완료 처리자. 매장 직원 계정/포털을 뜻하지 않으며 사용자 비활성·익명화 후에도 수령 이력을 연쇄 삭제하지 않는다.

eSIM 선물 (esim_gift)

  • 선물 ID (gift_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 수신자명 (recipient_name) — VARCHAR(100) — NOT NULL — 확정 선물 입력 표면의 수신자명. 실명 여부·최대 길이·문자 규칙과 수신자 본인 확인은 Open이며 Mock 이름을 기본값으로 사용하지 않는다.
  • 수신자 연락처 (recipient_contact) — VARCHAR(255) — NOT NULL — 수신자 전달 연락값. 전달 채널 매핑은 외부 연동 경계이며 저장 암호화·업무별 마스킹·비목적 조회 금지를 적용한다.
  • 선물 상태 (gift_status) — VARCHAR(30) — NOT NULL — 선물 전달 상태. 상품 소유권 이전·계정 claim 상태로 사용하지 않으며 미사용 발권 정보만 같은 선물 기록에서 재전송할 수 있다. 외부 발송 실패 코드는 어댑터 이력으로 분리한다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL — 선물 내역의 생성/요청 시각. 별도 sent_at은 실제 발송 계약이 확정되기 전 추가하지 않는다.
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 상태 등 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 발권 상세 ID (issuance_detail_id) — BIGINT — 외래 키 → 발권 상세.발권 상세 ID — NOT NULL — 선물 대상 발권 상세를 필수 참조한다. 소유권 이전 엔티티를 만들지 않으며 사용 여부는 발권 상세로 확인하고 미사용 정보 재전송 행위는 감사 기록으로 남긴다. FK 연쇄 삭제는 사용하지 않는다.

감사 로그 (audit_log)

  • 감사 로그 ID (audit_log_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 수행 동작 (action) — VARCHAR(100) — NOT NULL
  • 대상 리소스 (resource) — VARCHAR(100) — NOT NULL
  • 대상 식별값 (resource_id) — VARCHAR(100)
  • 상세 정보 (metadata) — JSON — 업무 감사에 필요한 최소 metadata만 저장한다. 자격증명·토큰·결제 비밀·원문 활성화 값·불필요한 고객정보를 복제하지 않는다.
  • IP 주소 (ip_address) — VARCHAR(45)
  • 기록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수행 사용자 ID (actor_user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 행위를 수행한 사용자. 시스템 행위는 NULL을 허용한다. 계정 비활성·익명화 후에도 감사 이력을 연쇄 삭제하지 않으며 정확한 보존기간은 외부 준법 입력으로 분리한다.

게시 콘텐츠 (content_entry)

  • 콘텐츠 ID (content_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 콘텐츠 유형 (content_type) — VARCHAR(30) — NOT NULL — 공지 NOTICE 또는 이벤트 EVENT. 유형으로 노출 위치를 구분하며 DB 기본값을 두지 않는다.
  • 제목 (title) — VARCHAR(255) — NOT NULL — 관리자·고객에게 표시하는 제목. 부분 일치 검색 표면이므로 데이터량·검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 서식 본문 (body_rich_text) — TEXT — NOT NULL — 글자 크기 기본/14/16/18/24px, 굵기, 색상, 좌/중/우 정렬, 링크를 포함한 sanitize된 기본 리치 텍스트. 본문 이미지·표·직접 HTML은 저장하지 않는다.
  • 썸네일 이미지 참조 (thumbnail_image_ref) — VARCHAR(255) — 썸네일 에셋 참조. jpg/png/webp·파일당 2MB 검증은 API/업로드 계층에서 적용하고 저장소·교체·삭제·보존 정책은 Open.
  • 상세 이미지 참조 (detail_image_ref) — VARCHAR(255) — 상세 이미지 에셋 참조. jpg/png/webp·파일당 2MB 검증은 API/업로드 계층에서 적용하고 저장소·교체·삭제·보존 정책은 Open.
  • 노출 시작일 (exposure_start_date) — DATE — 선택 노출 시작일. 한국시간 해당일 00:00부터 포함하며 종료일과 함께 설정하면 시작일이 종료일보다 늦을 수 없다.
  • 노출 종료일 (exposure_end_date) — DATE — 선택 노출 종료일. 한국시간 종료일 다음 날 00:00 미만까지 노출하며 종료 후에도 관리자 이력에 보관한다. 활성 카드 최대 10개는 최신 노출 시작 기준 조회로 제한한다.
  • 수동 노출 여부 (is_exposed) — BOOLEAN — NOT NULL — 수동 노출 여부. 노출기간 밖에서는 이 값과 관계없이 미노출하며 archived_at이 있으면 항상 미노출한다. DB 기본값을 두지 않는다.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 보관 일시 (archived_at) — DATETIME(3) — 운영 삭제 확인 후 콘텐츠를 비노출·보관한 시각. NULL이면 보관되지 않은 상태이며 하드 삭제·복구 기본 동작을 추측하지 않는다.

결제 거래 (payment_transaction)

  • 결제 ID (payment_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • PG 제공자 (provider) — VARCHAR(30) — NOT NULL — MVP 결제 제공자는 TossPayments를 사용한다. 계정·키·콜백 설정은 외부 구성이고 DB 기본값이나 비밀값을 저장하지 않는다.
  • 결제 수단 (payment_method) — VARCHAR(50) — NOT NULL — 카드·체크카드 기준 결제수단. 카드성 간편결제의 부분취소 가능 여부는 Toss 응답으로 검증하며 네이버페이·카카오페이·토스페이 단독 옵션을 추가하지 않는다.
  • 결제 상태 (payment_status) — VARCHAR(30) — NOT NULL — 결제 요청·승인·실패·취소 결과를 보존한다. 캡처 성공 거래만 승인 금액 권위로 사용하고 상태·provider_payment_key·approved_amount·approved_at의 일관성을 서비스 트랜잭션에서…
  • PG 결제 식별값 (provider_payment_key) — VARCHAR(255) — TossPayments 결제 조회·취소 식별값. 승인 전에는 NULL이며 값이 있으면 (provider, provider_payment_key) UNIQUE로 중복 결제·환불 실행을 방지한다.
  • 결제 요청 금액 (requested_amount) — BIGINT — NOT NULL — PG에 요청한 KRW 정수 금액. 0 이상 검증 후보.
  • 결제 승인 금액 (approved_amount) — BIGINT — TossPayments에서 캡처 성공한 KRW 승인 금액. 승인 전/실패 거래는 NULL이며 제휴사 순매출은 주문일과 이 권위 금액을 사용하고 부분/전체환불 완료 주문을 제외한다.
  • 승인 일시 (approved_at) — DATETIME(3) — PG 승인 시각. 승인 전/실패 거래는 NULL.
  • 실패 코드 (failure_code) — VARCHAR(50)
  • 실패 사유 (failure_message) — TEXT — 운영 표시용 sanitize된 실패 설명. 원시 결제 payload·비밀키·카드정보·개인정보 전체를 저장하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 주문 ID (order_id) — BIGINT — 외래 키 → 고객 주문.주문 ID — NOT NULL — 주문별 모든 결제 시도·결과를 보존한다. (order_id, created_at, payment_id) 인덱스를 사용하고 주문/결제 이력을 연쇄 삭제하지 않는다.

고객 1:1 문의 (customer_inquiry)

  • 문의 ID (inquiry_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 문의 코드 (inquiry_code) — VARCHAR(50) — NOT NULL — 고객·관리자 목록 표시 코드. UNIQUE 후보이나 생성 형식·대소문자/collation·고유성·수정 정책이 Open이므로 승인 전 실제 UK는 미적용.
  • 문의 유형 (inquiry_category) — VARCHAR(50) — NOT NULL — 확정된 문의 유형 선택 표면을 보존한다. 최종 코드셋·확장·수정 가능 여부는 Open이며 Mock 옵션을 운영 enum/기본값으로 사용하지 않는다.
  • 문의 제목 (inquiry_title) — VARCHAR(255) — NOT NULL — 고객 작성·관리자 검색/상세에 사용하는 문의 제목. 부분 일치 검색은 데이터량·검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 문의 내용 (inquiry_body) — TEXT — NOT NULL — 고객이 제출한 문의 원문. 빈 문자열·최대 길이·sanitization 검증은 Open.
  • 답변 내용 (answer_body) — TEXT — 현재 확정 표면은 문의당 답변 0..1건이다. answer_body와 answered_at은 함께 NULL 또는 함께 값이 있도록 하는 무결성 검증 후보. 다중 대화·담당자·답변 이력은 Open.
  • 답변 일시 (answered_at) — DATETIME(3) — 문의 답변이 기록된 시각. 현재 상태는 inquiry_status에 별도로 저장하며 answer_body/answered_at 존재 여부만으로 상태·전이를 도출하지 않는다. 답변 수정 시각 의미와 상태별 인덱스는…
  • 문의 접수 일시 (created_at) — DATETIME(3) — NOT NULL — 별도 초안/접수 전 단계가 확정되지 않아 submitted_at을 중복 저장하지 않고 이 생성 시각을 문의 접수 시각으로 사용한다.
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 답변 저장 등 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 문의 작성 사용자에 필수 귀속한다. (user_id, created_at, inquiry_id) 인덱스를 사용하고 회원 비활성·익명화 후에도 문의 이력을 연쇄 삭제하지 않는다.
  • 문의 상태 (inquiry_status) — VARCHAR(30) — NOT NULL — 현재 문의 상태 RECEIVED 또는 ANSWERED. 새 문의는 서비스가 RECEIVED를 명시하고 답변 저장과 ANSWERED 전환을 같은 트랜잭션으로 처리하며 DB 기본값을 두지 않는다.

고객 주문 (customer_order)

  • 주문 ID (order_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보. 주문 도메인 내부 식별자이며 고객 노출·수령 확인에는 order_number를 사용한다.
  • 주문번호 (order_number) — VARCHAR(50) — NOT NULL — 소비자·관리자 조회와 USIM 수령완료에 사용하는 외부 주문번호. UNIQUE와 정확 조회 인덱스가 필요하며 표시 형식은 API 생성 책임으로 분리한다.
  • 주문 상태 (order_status) — VARCHAR(30) — NOT NULL — 현재 주문 상태의 권위 원천. 취소 거절은 요청 직전 상태로 복구하고 승인 결과는 CANCELLED 또는 환불 결과로 기록한다. 전환 결과·업무 증거·order_status_history를 한 트랜잭션으로 저장하며…
  • 주문자 이름 스냅샷 (buyer_name) — VARCHAR(100) — NOT NULL — 주문 시점 주문자 이름 필수 스냅샷. 전체 값은 권한 있는 관리자/CS만 조회하고 제휴사 화면·CSV는 첫 글자만 서버에서 마스킹한다. 회원 변경·탈퇴와 무관하게 이력을 보존한다.
  • 주문자 이메일 스냅샷 (buyer_email) — VARCHAR(255) — NOT NULL — 주문 시점 이메일 필수 스냅샷. 주문 처리 목적의 권한 있는 응답에만 포함하며 제휴사 포털·CSV에는 제공하지 않는다.
  • 주문자 연락처 스냅샷 (buyer_phone) — VARCHAR(20) — NOT NULL — 주문 시점 연락처 필수 스냅샷. 전체 값은 권한 있는 관리자/CS만 조회하고 제휴사 화면·CSV는 뒤 4자리만 서버에서 마스킹한다.
  • 상품 합계 금액 (item_subtotal_amount) — BIGINT — NOT NULL — KRW 정수 금액. 0 이상 검증 후보.
  • 쿠폰 할인 금액 (coupon_discount_amount) — BIGINT — NOT NULL — KRW 정수 금액. 1주문 1쿠폰 범위이며 0 이상 검증 후보. 쿠폰 발급 레코드 관계는 쿠폰 도메인에서 연결한다.
  • 사용 포인트 금액 (point_used_amount) — BIGINT — NOT NULL — KRW 정수 금액. 300P 이상, 보유 포인트와 결제 금액 이내 규칙을 서버에서 검증하며 0 이상 검증 후보.
  • 최종 결제 예정 금액 (payable_amount) — BIGINT — NOT NULL — 상품 합계에서 확정 할인·포인트 사용을 반영한 KRW 주문 스냅샷. PG 승인 금액과 대조하며 0 이상 검증 후보.
  • 판매 채널 (sales_channel) — VARCHAR(30) — NOT NULL — 일반 서비스와 제휴사 채널을 서버 레코드에서 분리한다. partner_id와의 일관성을 검증하고 (sales_channel, partner_id, ordered_at, order_id) 인덱스로 제휴사 소유 주문만…
  • 주문 일시 (ordered_at) — DATETIME(3) — NOT NULL — 결제·주문 흐름이 확정해 기록하는 주문 시각. 임의 DB 기본값 없음.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 회원 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 회원 주문이면 사용자 계정을 참조하고 비회원 주문은 NULL을 허용한다. 이름·이메일·연락처 스냅샷은 회원 여부와 무관하게 필수이며 탈퇴 시 주문 FK를 연쇄 삭제하지 않는다. (user_id, ordered_at…
  • 제휴사 ID (partner_id) — BIGINT — 외래 키 → 제휴사.제휴사 ID — 제휴사 채널 주문이면 필수 참조하고 일반 채널은 NULL이다. sales_channel+partner_id 일관성을 CHECK/API에서 강제하며 귀속 변경·재배정·FK 연쇄 삭제를 허용하지 않는다.
  • 관리 메모 (admin_memo) — TEXT — 확정 주문 상세 화면의 현재 관리 메모 1개를 저장한다. 수정 시 현재값을 교체하며 수정 행위는 audit_log에 기록한다. 별도 메모 이력은 승인된 요구사항이 없어 만들지 않는다.

공급사 발권 신청 (supplier_issuance)

  • 발권 신청 ID (issuance_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 공급사명 (supplier_name) — VARCHAR(50) — NOT NULL — 현재 계약 근거는 KBOOKS v1.3. 공급사 코드셋과 임의 기본값은 확정하지 않았다.
  • 공급사 주문번호 (supplier_order_id) — VARCHAR(50) — NOT NULL — KBOOKS order_id 업무키. (supplier_name, supplier_order_id) UNIQUE로 중복 발권을 거부하고 운영자 재시도는 명시적인 새 시도로 기록한다.
  • 정규화 발권 상태 (issuance_status) — VARCHAR(30) — NOT NULL — 서비스 발권 상태 PENDING/COMPLETED/FAILED. 결제 성공 후 실패는 FAILED로 유지하고 자동 환불하지 않으며 운영자 해결 선택 전 성공 상태로 변경하지 않는다.
  • 공급사 상태 코드 (supplier_status_code) — INT — KBOOKS 원시 상태를 보존한다. v1.3 상태 코드와 내부 주문/발권 상태는 분리하며 원시 값에 임의 기본값 없음.
  • 신청 수량 (requested_quantity) — INT — NOT NULL — 공급사에 신청한 수량. 양수이며 주문상품 수량과의 정합성 검증 후보.
  • 렌탈 관리 번호 (rental_management_number) — VARCHAR(100) — KBOOKS v1.3 eSIM 생성/콜백의 상위 rental_mgmt_num. 응답 전에는 NULL이며 고유성은 확정하지 않았다.
  • 신청 일시 (requested_at) — DATETIME(3) — NOT NULL — 공급사 요청을 실제로 전송한 시각. 애플리케이션에서 명시하며 임의 DB 기본값 없음.
  • 완료 일시 (completed_at) — DATETIME(3) — 발권 완료가 확인된 시각. 대기·실패 상태는 NULL.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 주문 상품 ID (order_item_id) — BIGINT — 외래 키 → 주문 상품.주문 상품 ID — NOT NULL — 주문상품별 모든 발권 시도 이력. (order_item_id, requested_at, issuance_id) 인덱스를 사용하며 중복 업무키는 거부하고 FK 연쇄 삭제는 사용하지 않는다.

관리자 역할 (admin_role)

  • 관리자 역할 ID (role_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 역할 키 (role_key) — VARCHAR(50) — NOT NULL — UK. 내부 관리자 역할 키는 SUPER_ADMIN/OPERATOR/CS/MARKETER 4종으로 고정하며 사용자 정의 역할과 편집 UI를 제공하지 않는다.
  • 역할명 (role_name) — VARCHAR(100) — NOT NULL
  • 사용 여부 (is_active) — BOOLEAN — NOT NULL — 고정 역할 사용 여부. 역할 키 자체를 사용자 정의하거나 삭제하지 않으며 마지막 활성 SUPER_ADMIN 배정을 제거·교체하는 작업은 서버 트랜잭션에서 거부한다.

관리자 역할 배정 (admin_user_role)

  • 관리자 역할 배정 ID (admin_user_role_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 배정 일시 (assigned_at) — DATETIME(3) — NOT NULL
  • 관리자 역할 ID (role_id) — BIGINT — 외래 키 → 관리자 역할.관리자 역할 ID — NOT NULL — 고정 관리자 역할 4종 중 하나를 참조한다. 역할 교체는 기존 배정을 원자적으로 교체하고 감사 기록·대상 세션 폐기를 함께 수행한다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 계정당 내부 관리자 역할 배정은 최대 1개다. 실제 migration은 user_id UNIQUE를 구현해야 한다. PARTNER 연결과 동시 보유는 금지하며 FK 연쇄 삭제는 승인하지 않았다.

국가 (nation_info)

  • 국가 코드 (nation_cd) — CHAR(3) — 기본 키 — NOT NULL — PK. 공급사 NATION_CD 영문 3자리 자연키이며 코드 자체가 고유하다. 연결 상품·카테고리가 있으면 삭제하지 않고 비활성 처리하며 전체 공급사 코드셋·라벨은 외부 계약 입력으로 유지한다.
  • 국가명 (nation_name) — VARCHAR(100) — NOT NULL — 서비스와 관리자 화면에 표시하는 필수 국가명. 고유 식별은 nation_cd가 담당하며 표시명 중복 여부를 별도 UK로 추측하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL
  • 표시 순서 (display_order) — INT — NOT NULL — 소비자·관리자 국가 표시 순서. 명시적 정수값을 사용하며 DB 기본값을 두지 않는다.
  • 노출 여부 (is_exposed) — BOOLEAN — NOT NULL — 소비자 국가 선택 노출 여부. 활성 상태와 분리하며 DB 기본값을 두지 않는다.
  • 사용 여부 (is_active) — BOOLEAN — NOT NULL — 연결 상품·카테고리가 있는 국가는 삭제하지 않고 비활성 처리한다. DB 기본값을 두지 않는다.

등급별 쿠폰 규칙 (grade_coupon_rule)

  • 등급 쿠폰 규칙 ID (grade_coupon_rule_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 회원 등급 표시값 (grade_label) — VARCHAR(100) — NOT NULL — 관리 화면의 등급별 쿠폰 라벨. 자동 회원등급 자격·변경·혜택 매트릭스가 추가되기 전에는 자동 발급 권위로 사용하지 않으며 회원 등급 마스터를 생성하지 않는다.
  • 발급 조건 표시값 (issue_condition_text) — TEXT — 확정 화면의 발급 조건 입력 표면. 자동 발급 트리거·주기·중복 조건은 Open이며 텍스트를 자동 처리 규칙으로 사용하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 쿠폰 ID (coupon_id) — BIGINT — 외래 키 → 쿠폰 정의.쿠폰 ID — NOT NULL — 등급별 쿠폰 화면의 쿠폰 정의 참조. (coupon_id, grade_label) 중복 방지 후보가 쿠폰별 조회를 함께 지원한다. FK 연쇄 삭제는 승인하지 않았다.

로그인 식별자 (auth_identity)

  • 로그인 식별자 ID (auth_identity_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 로그인 제공자 (provider) — VARCHAR(30) — NOT NULL — 소비자 소셜 제공자는 KAKAO/NAVER/APPLE/GOOGLE 4종으로 고정한다. 내부 관리자·파트너 비밀번호 인증 식별자는 별도 서버 검증 코드로 구분하며 이메일을 제공자 식별키로 사용하지 않는다.
  • 제공자 사용자 식별값 (provider_subject) — VARCHAR(255) — NOT NULL — 제공자 고유 사용자 식별값. (provider, provider_subject) case-insensitive 여부를 제공자 계약에 맞춰 UNIQUE로 강제하며 이메일로 대체하지 않는다.
  • 인증정보 해시 (credential_hash) — VARCHAR(255) — 비밀번호 인증이 필요한 내부 관리자 또는 파트너 계정에만 사용한다.
  • 연결 일시 (created_at) — DATETIME(3) — NOT NULL
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 인증 주체를 필수 참조한다. 한 사용자에서 같은 provider 연결은 1개만 허용하므로 (user_id, provider) UNIQUE가 필요하다. 이미 다른 사용자에 연결된 식별자의 소유권은 이전하지 않으며 F…

마케팅 캠페인 (marketing_campaign)

  • 캠페인 ID (campaign_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 캠페인 코드 (campaign_code) — VARCHAR(50) — NOT NULL — 목록·상세에 표시하는 운영 코드. UNIQUE 후보이나 생성 형식·대소문자/collation·고유성·수정 정책이 Open이므로 승인 전 실제 UK는 미적용.
  • 캠페인명 (campaign_name) — VARCHAR(255) — NOT NULL — 목록·상세에 표시하는 캠페인명. 이름/코드 부분 일치 검색은 데이터량·검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 캠페인 상태 (campaign_status) — VARCHAR(30) — NOT NULL — 캠페인 상태 DRAFT/SCHEDULED/SENDING/COMPLETED/CANCELLED/FAILED. DB 기본값 없이 서비스가 명시하고 confirmed transition만 저장한다.
  • 템플릿 참조 (template_reference) — VARCHAR(255) — 템플릿 선택 표면을 보존하는 선택 참조. 운영 식별자·저장 위치·버전·제공자 payload 계약은 Open이며 Mock 템플릿명을 운영값으로 사용하지 않는다.
  • 푸시 유형 (push_type) — VARCHAR(30) — NOT NULL — SERVICE 또는 ADVERTISING 분류. 광고는 마케팅 동의 권위를 적용하고 서비스 알림과 별도로 처리한다. 제공자 payload·제한 시간은 외부 경계다.
  • 캠페인 기간 시작 일시 (period_start_at) — DATETIME(3) — 선택 캠페인 기간 시작 일시. 종료보다 늦지 않도록 하는 검증 후보이나 예약 발송 시각과의 관계·포함 경계·시간대는 Open.
  • 캠페인 기간 종료 일시 (period_end_at) — DATETIME(3) — 선택 캠페인 기간 종료 일시. 시작보다 빠르지 않도록 하는 검증 후보이나 상태 전이·노출/발송 종료 의미와 시간대는 Open.
  • 예약 발송 일시 (scheduled_at) — DATETIME(3) — 별도 예약 발송 일시이며 발송 캘린더의 권위 원천이다. 애플리케이션 UTC로 저장하고 관리자에는 한국시간으로 표시한다. DRAFT 외 예약 확정은 이 값과 SCHEDULED 상태를 함께 저장한다.
  • 푸시 제목 (push_title) — VARCHAR(30) — 확정 화면의 최대 30자와 **nickname** 치환 태그를 보존한다. 필수 여부·문자 수 계산 방식·제공자별 검증은 Open.
  • 푸시 본문 (push_body) — VARCHAR(200) — 확정 화면의 최대 200자와 **nickname** 치환 태그를 보존한다. 필수 여부·문자 수 계산·개행·플랫폼별 표시/제공자 검증은 Open.
  • 수신 대상 유형 (recipient_type) — VARCHAR(50) — NOT NULL — 1차 대상은 ALL_ELIGIBLE로 고정한다. 세그먼트 확장은 별도 정책 전까지 제공하지 않으며 DB 기본값을 두지 않는다.
  • 수신 대상 조건 (recipient_definition) — TEXT — 향후 세그먼트 조건 확장용 선택 정의. 1차 ALL_ELIGIBLE 발송에서는 NULL이며 이메일·등급·구매 카테고리 구조를 미리 확정하지 않는다.
  • 큰 아이콘 참조 (large_icon_ref) — VARCHAR(255) — 선택 큰 아이콘 에셋 참조. 저장소·형식·크기·교체·삭제·보존과 제공자 제약은 Open.
  • 리치 푸시 이미지 참조 (rich_image_ref) — VARCHAR(255) — 선택 리치 푸시 이미지 에셋 참조. 저장소·형식·크기·교체·삭제·보존과 플랫폼/제공자 제약은 Open.
  • 링크 유형 (link_type) — VARCHAR(30) — 링크 유형 선택 표면을 보존한다. 최종 내부 destination·딥링크 매핑과 유형 목록은 Open이며 Mock 옵션을 운영 enum으로 확정하지 않는다.
  • 링크 URL (link_url) — VARCHAR(255) — 링크 유형에 따른 선택 URL/목적지 값. 외부 URL scheme·allowlist·redirect와 내부 링크 검증은 Open.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.

발권 상세 (issuance_detail)

  • 발권 상세 ID (issuance_detail_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 개별 렌탈 번호 (rental_mst_num) — VARCHAR(100) — KBOOKS item-level rental_mst_num. 사용량/CS 정확 조회용 비고유 인덱스 후보이며 고유성은 확정하지 않았다.
  • eSIM 매핑 ID (esim_mapping_id) — VARCHAR(255) — 공급사 eSIM 매핑 식별값. 응답 전/비 eSIM 상세는 NULL 가능하며 고유성은 확정하지 않았다.
  • ICCID (iccid) — TEXT — 공급사 ICCID의 접근 제한 저장값. 애플리케이션/스토리지 암호화를 적용하고 일반 API·로그·문서에 원문을 노출하지 않으며 권한 있는 고객 설치/운영 지원 응답만 최소 제공한다.
  • QR 코드 내용 (qr_code_content) — TEXT — 공급사 eSIM QR 활성화 비밀값. 애플리케이션/스토리지 암호화를 적용하고 일반 API·로그·감사 metadata·문서에 원문을 노출하지 않는다.
  • QR 경로 (qr_path) — VARCHAR(255) — 접근 제한 QR 에셋 참조. 공개 URL로 취급하지 않고 권한 있는 설치 응답에서만 서명된 단기 접근을 제공한다. 저장소 선택은 외부 인프라 경계다.
  • SM-DP+ 주소 (smdp_address) — TEXT — SM-DP+ 설치 비밀값의 접근 제한 저장값. 애플리케이션/스토리지 암호화 후 권한 있는 설치 흐름에만 최소 제공하고 일반 API·로그·감사 metadata에서 제외한다.
  • 활성화 코드 (activation_code) — TEXT — 공급사 activation code 비밀값. 애플리케이션/스토리지 암호화를 적용하고 권한 있는 설치 흐름 외 원문 노출을 금지한다.
  • iOS 설치 URL (ios_install_url) — TEXT — iOS 원터치 설치 URL 또는 이에 준하는 활성화 비밀값의 접근 제한 저장값. 암호화하고 권한 있는 설치 응답에만 제공하며 일반 로그·문서에서 제외한다.
  • 로밍 전화번호 (roaming_phone_number) — TEXT — 공급사 로밍 전화번호의 접근 제한 저장값. 개인정보로 분류해 암호화·업무별 마스킹하고 일반 API와 제휴사 응답에서 제외한다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 발권 신청 ID (issuance_id) — BIGINT — 외래 키 → 공급사 발권 신청.발권 신청 ID — NOT NULL — 발권 신청의 수량만큼 상세가 0..N 비동기로 도착할 수 있다. FK 요건상 issuance_id 좌측 인덱스가 필요하나 InnoDB 보조 인덱스가 PK를 함께 보유하므로 (issuance_id, issuance_…
  • 지갑 목록 숨김 여부 (is_wallet_hidden) — BOOLEAN — NOT NULL — 확정된 지갑 목록 숨김 기능만 보존한다. 기본값·재노출/복구·숨김 가능 상태·선물 후 처리·별도 사용자별 소유권 모델은 Open이므로 DB 기본값 없음.

발권 실패 이력 (issuance_failure)

  • 발권 실패 ID (failure_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 실패 코드 (failure_code) — VARCHAR(50) — 공급사/연동 실패 코드. 공급사가 코드를 제공하지 않는 실패도 있어 NULL 허용.
  • 실패 사유 (failure_message) — TEXT — 운영 표시용 sanitize된 공급사/연동 실패 설명. 원시 민감 payload·활성화 비밀값·자격증명을 저장하지 않는다.
  • 실패 일시 (failed_at) — DATETIME(3) — NOT NULL — 실패가 확인된 실제 시각. 애플리케이션에서 명시하며 임의 DB 기본값 없음.
  • 해결 일시 (resolved_at) — DATETIME(3) — 운영자가 RETRY 또는 REFUND를 선택해 해결 결과가 확정된 시각. 미해결은 NULL이며 자동 해결·자동 환불 기본값을 두지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 발권 신청 ID (issuance_id) — BIGINT — 외래 키 → 공급사 발권 신청.발권 신청 ID — NOT NULL — 발권 신청별 실패 이력용 (issuance_id, failed_at, failure_id) 인덱스 후보. FK 연쇄 삭제는 승인하지 않았다.
  • 해결 처리자 사용자 ID (resolved_by_user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 재시도 또는 환불을 선택한 내부 운영자. 미해결은 NULL이며 사용자 비활성·익명화가 실패 이력을 삭제하지 않도록 비연쇄 FK를 사용한다.
  • 해결 선택 (resolution_action) — VARCHAR(30) — 운영자가 발권 실패를 해결할 때 선택한 RETRY 또는 REFUND. 미해결 상태는 NULL이며 자동 환불 기본값을 두지 않는다.

사용자 계정 (user_account)

  • 사용자 ID (user_id) — VARCHAR(30) — 기본 키 — NOT NULL — PK. 애플리케이션에서 생성하는 CUID 계열 식별값이며 DB AUTO_INCREMENT를 사용하지 않는다.
  • 이메일 (email) — VARCHAR(255) — 소셜 제공자가 검증한 연락용 이메일. NULL 허용. trim+lowercase 정규화 후 존재할 때 case-insensitive UNIQUE를 적용한다. 이메일만으로 계정을 인증·자동 연결하지 않으며 미제공·미…
  • 이름 (display_name) — VARCHAR(100)
  • 휴대폰 번호 (phone_number) — VARCHAR(20)
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL
  • 비활성 일시 (deactivated_at) — DATETIME(3) — 계정 비활성·탈퇴 시각. 값이 있으면 신규 인증을 차단하며 주문·환불·감사 이력은 연쇄 삭제하지 않는다.
  • 익명화 일시 (anonymized_at) — DATETIME(3) — 개인 식별정보 익명화 완료 시각. 정확한 법정 보존기간과 실행 일정은 외부 준법 입력으로 분리한다.
  • 보존 만료 예정 일시 (retention_expires_at) — DATETIME(3) — 익명화·보존 처리 대상 시점. 정확한 기간은 외부 준법 정책 승인 후 계산하며 DB 기본값을 두지 않는다.

사용자 알림 (user_notification)

  • 알림 ID (notification_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 알림 유형 (notification_type) — VARCHAR(50) — NOT NULL — 확정된 알림 유형 구분 필드. 최종 코드셋·라벨 및 아이콘/tone 표현 매핑은 Open이며 Mock 배지 문구를 저장하지 않는다.
  • 알림 제목 (title) — VARCHAR(255) — NOT NULL — 알림함에 표시할 제목. VARCHAR(255)는 승인 전 물리 후보이며 Mock 제목을 기본값으로 사용하지 않는다.
  • 알림 내용 (body) — TEXT — NOT NULL — 알림함에 표시할 본문. 본문 형식·최대 길이·치환 변수 정책은 Open이며 Mock 본문을 기본값으로 사용하지 않는다.
  • 발생 일시 (occurred_at) — DATETIME(3) — NOT NULL — 알림 원인 이벤트의 발생 시각. Mock 상대시간 문자열을 저장하지 않고 이 시각에서 표시하며 자동 생성 기본값은 두지 않는다.
  • 읽은 일시 (read_at) — DATETIME(3) — NULL이면 미읽음으로 도출한다. 별도 unread boolean을 중복 저장하지 않으며 전체 읽음·재읽음 정책은 Open.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 사용자 알림함 소유자를 필수 참조한다. (user_id, read_at, occurred_at, notification_id) 계열 인덱스로 읽음/미읽음을 조회하며 계정 비활성·익명화로 연쇄 삭제하지 않는다.
  • 알림 분류 (notification_class) — VARCHAR(30) — NOT NULL — SERVICE 또는 ADVERTISING 분류. 광고 알림은 마케팅 동의 권위를 확인하고 서비스 알림과 별도로 처리하며 DB 기본값을 두지 않는다.

사용자 약관 동의 (user_policy_consent)

  • 약관 동의 ID (consent_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 동의 일시 (consented_at) — DATETIME(3) — NOT NULL — 사용자가 해당 정책 문서 버전에 동의한 실제 시각. 애플리케이션에서 명시하며 DB 기본값을 두지 않는다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 동의한 사용자를 필수 참조한다. 사용자당 정책 문서 버전별 동의 증거는 보존하며 계정 비활성·익명화로 연쇄 삭제하지 않는다.
  • 정책 문서 ID (policy_document_id) — BIGINT — 외래 키 → 약관·정책 문서.정책 문서 ID — NOT NULL — 동의한 불변 정책 문서 버전을 필수 참조한다. (user_id, policy_document_id) UNIQUE로 같은 버전 중복 동의를 방지하며 문서 삭제에 연쇄 삭제하지 않는다.

상품 (item_info)

  • 상품 ID (id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 상품 구분 코드 (TYPE) (type) — INT — NOT NULL — 공급사 TYPE 원본값. 전체 허용값과 라벨은 Open.
  • SIM 유형 코드 (SIM_TYPE) (sim_type) — INT — NOT NULL — 공급사 SIM_TYPE 원본값. eSIM/USIM 구분은 필수이며 전체 코드셋은 Open.
  • 공급사 상품 코드 (PLAN_CD) (plan_cd) — VARCHAR(50) — NOT NULL — KBOOKS 주문 생성과 관리자 코드 검색에 사용하는 공급사 코드. trim 후 case-insensitive UNIQUE를 적용하고 등록 후 변경하지 않는다. 정확·접두 검색 인덱스는 UK와 실제 EXPLAIN을…
  • 상품명 (PRODUCT_NAME) (product_name) — VARCHAR(255) — NOT NULL
  • 판매가 (SELL_PRICE) (sell_price) — BIGINT — NOT NULL — 소비자 판매가. PRICE와 혼용하지 않는다. 0 이상 값만 허용하는 제약 후보.
  • 공급 원가 (PRICE) (price) — BIGINT — NOT NULL — 공급 원가. 소비자 가격으로 노출하지 않는다. 0 이상 값만 허용하는 제약 후보.
  • 통신사 (COMPANY) (company) — VARCHAR(100) — NOT NULL
  • 네트워크 (NETWORK) (network) — VARCHAR(50) — NOT NULL
  • 데이터 제공 조건 (data_amount) — VARCHAR(100) — NOT NULL — 상품 목록·상세 표시용 데이터 조건. 공급사 원본에서의 생성·분리 규칙은 Open.
  • 사용 기간 (USAGE_DAYS) (usage_days) — INT — NOT NULL — 공급사 USAGE_DAYS. 양수 값만 허용하는 제약 후보.
  • 수령/배송 처리 여부 (PICKUP_YN) (pickup_yn) — CHAR(1) — NOT NULL — Y는 픽업·배송 처리가 필요함을 뜻하며 바우처 발급을 뜻하지 않는다. Y 또는 N만 허용하는 제약 후보이며 기본값은 두지 않는다.
  • 판매 상태 (sales_status) — VARCHAR(30) — NOT NULL — 판매 상태는 ON_SALE 또는 SOLD_OUT으로 관리한다. 숨김은 판매 상태가 아니라 is_exposed=false 표시 결과이며 DB 기본값을 두지 않는다.
  • 노출 여부 (is_exposed) — BOOLEAN — NOT NULL — 판매 상태와 분리한 노출 여부. true는 VISIBLE, false는 HIDDEN 표시 책임이며 DB 기본값을 두지 않는다. 제휴사 연결 노출과의 최종 가격·노출 계산은 별도 정책 경계다.
  • 상품 유형별 안내 문구 (guide_text) — TEXT
  • 1인 최대 구매 수량 (max_purchase_quantity) — INT — NOT NULL — 상품별 1회 주문 기준 최대 구매 수량. 양수만 허용하며 DB 기본값 없이 관리자가 명시적으로 설정한다.
  • 상품 할인율 (discount_rate) — DECIMAL(5,2) — 상품 할인 입력율. 0.00~100.00 범위의 DECIMAL(5,2)로 저장하되 외부 가격 계산·반올림·제휴사 할인 우선순위가 승인되기 전에는 SELL_PRICE를 변경하는 권위로 사용하지 않는다.
  • QoS 속도 (qos_kbps) — INT — 선택 QoS 속도값(kbps). 값이 있으면 양수여야 하며 적용 조건·제공사 동작·고객 안내는 외부 연동 경계로 분리한다.
  • 유효기간 (validity_days) — INT — 선택 상품 유효기간(일). 값이 있으면 양수이며 SIM 활성화 시점부터 적용한다. 구매·설치 시점부터 계산하지 않는다.
  • 썸네일 이미지 참조 (thumbnail_image_ref) — VARCHAR(255) — 기능은 유지한다. 현재 길이는 물리 제안이며 객체 키·URL 여부, 저장소·형식·크기·교체 정책은 Open이다.
  • 상세 이미지 참조 (detail_image_ref) — VARCHAR(255) — 기능은 유지한다. 현재 길이는 물리 제안이며 객체 키·URL 여부, 저장소·형식·수량·교체 정책은 Open이다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL
  • 국가 코드 (NATION_CD) (nation_cd) — CHAR(3) — 외래 키 → 국가.국가 코드 — NOT NULL — 공급사 NATION_CD. 상품은 국가 1개를 필수 참조한다. 국가 비활성은 신규 노출·선택을 차단하고 상품·주문 이력 FK는 연쇄 삭제하지 않는다.

상품 카테고리 (catalog_category)

  • 카테고리 ID (category_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 카테고리명 (category_name) — VARCHAR(100) — NOT NULL — 관리자·소비자 표시 카테고리명. 고유 식별은 category_cd가 담당하며 표시명 중복 여부를 별도 UK로 추측하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL
  • 카테고리 코드 (category_cd) — VARCHAR(50) — NOT NULL — 내부 카테고리 식별 코드. case-insensitive UNIQUE가 필요하며 연결 이후 삭제 대신 비활성 처리한다.
  • 표시 순서 (display_order) — INT — NOT NULL — 소비자·관리자 카테고리 표시 순서. 명시적 정수값을 사용하며 DB 기본값을 두지 않는다.
  • 노출 여부 (is_exposed) — BOOLEAN — NOT NULL — 소비자 카테고리 노출 여부. 활성 상태와 분리하며 DB 기본값을 두지 않는다.
  • 사용 여부 (is_active) — BOOLEAN — NOT NULL — 연결 국가·상품이 있는 카테고리는 삭제하지 않고 비활성 처리한다. DB 기본값을 두지 않는다.

설치 가이드 (installation_guide)

  • 설치 가이드 ID (installation_guide_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 플랫폼 (platform) — VARCHAR(30) — NOT NULL — 확정 화면의 iOS/Android/공통 구분을 보존한다. 임의 기본값 없음. 플랫폼 필터 인덱스 후보이며 최종 저장 코드·플랫폼 확장·모델별 분기는 Open.
  • 제목 (title) — VARCHAR(255) — NOT NULL — 관리자·고객에게 표시하는 가이드 제목. 부분 일치 검색은 데이터량·검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 요약 (summary_text) — TEXT — 목록과 고객 안내에 표시할 선택 요약. 필수 여부와 부분 일치 검색 방식은 Open이며 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 관리자 목록에 표시하는 최근 수정 시각. 애플리케이션에서 갱신하며 DB 자동 갱신 규칙은 승인하지 않았다.

설치 가이드 단계 (installation_guide_step)

  • 설치 가이드 단계 ID (installation_guide_step_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 표시 순서 (display_order) — INT — NOT NULL — 가이드 안의 표시 순서. (installation_guide_id, display_order) UK 후보이나 시작값·간격·중복·동시 재정렬 정책이 Open이므로 승인 전 미적용. 임의 기본값 없음.
  • 안내 내용 (instruction_text) — TEXT — NOT NULL — 고객에게 표시하는 단계 안내 내용. 빈 문자열 허용 여부와 검증 방식은 Open이며 Mock 문구를 운영 기본값으로 사용하지 않는다.
  • 단계 이미지 참조 (image_ref) — VARCHAR(255) — 단계별 선택 이미지 에셋 참조. 파일 형식·크기·개수·저장소·교체·삭제 정책은 Open.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 설치 가이드 ID (installation_guide_id) — BIGINT — 외래 키 → 설치 가이드.설치 가이드 ID — NOT NULL — 가이드별 단계 순서 조회용 (installation_guide_id, display_order, installation_guide_step_id) 인덱스 후보. 단계는 가이드에 필수 귀속하며 FK 연쇄 삭제는 승인…

알림 수신 설정 (notification_preference)

  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — PK/FK. 사용자당 현재 설정 행은 0..1개다. 각 채널 변경은 notification_preference_history에 불변 이력으로 기록하며 사용자 비활성·익명화가 동의 이력을 연쇄 삭제하지 않는다.
  • 앱 푸시 수신 (app_push_enabled) — BOOLEAN — NOT NULL
  • SMS/LMS 수신 (sms_lms_enabled) — BOOLEAN — NOT NULL
  • 이메일 수신 (email_enabled) — BOOLEAN — NOT NULL
  • 선택 마케팅 정보 수신 동의 (marketing_consent) — BOOLEAN — NOT NULL — 선택 마케팅 정보 수신 동의. 최초 기본값은 false이며 변경마다 채널·값·시각 이력을 기록한다. 서비스 알림은 광고와 별도 분류하고 실제 발송 제공자는 외부 경계다.
  • 변경 일시 (updated_at) — DATETIME(3) — NOT NULL

알림 수신 설정 이력 (notification_preference_history)

  • 알림 설정 이력 ID (preference_history_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 알림 채널 (channel) — VARCHAR(30) — NOT NULL — APP_PUSH/SMS_LMS/EMAIL/MARKETING 중 변경된 항목. 서비스 알림 분류와 마케팅 선택 동의를 구분한다.
  • 변경 값 (enabled) — BOOLEAN — NOT NULL — 변경 후 수신 또는 동의 값. DB 기본값을 두지 않는다.
  • 변경 일시 (changed_at) — DATETIME(3) — NOT NULL — 사용자가 설정을 변경한 실제 시각. 애플리케이션에서 명시하며 DB 기본값을 두지 않는다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 설정을 변경한 사용자를 필수 참조한다. (user_id, changed_at, preference_history_id) 인덱스로 동의 이력을 조회하며 계정 비활성·익명화로 연쇄 삭제하지 않는다.

약관·정책 문서 (policy_document)

  • 정책 문서 ID (policy_document_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 문서 유형 (document_type) — VARCHAR(50) — NOT NULL — 이용약관·개인정보 처리방침 등 문서 유형. (document_type, version)으로 버전을 식별하고 유형별 현재본은 최대 1개만 허용한다.
  • 문서 본문 (document_body) — TEXT — 관리자 화면은 미등록 빈 문서를 허용하므로 NULL 허용. 본문 형식·sanitization·필수 게시 조건·법무 승인과 현재 고객 제공 문구의 최종성은 Open.
  • 시행일 (effective_date) — DATE — 문서 시행일. 미등록/작성 중 문서는 NULL 가능하며 현재본 게시 전에는 필수로 검증한다. 고객 표시는 한국시간 날짜 기준이다.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 문서 버전 (version) — VARCHAR(50) — NOT NULL — 문서 유형별 불변 버전 식별값. (document_type, version) UNIQUE가 필요하다.
  • 현재 버전 여부 (is_current) — BOOLEAN — NOT NULL — 같은 document_type에서 고객에게 적용하는 현재 버전 여부. DB 기본값 없이 게시 전환 트랜잭션이 이전 현재본과 원자적으로 교체한다.
  • 필수 동의 여부 (requires_consent) — BOOLEAN — NOT NULL — 해당 버전이 사용자 필수 동의 증거를 요구하는지 명시한다. DB 기본값을 두지 않는다.

역할 권한 연결 (role_permission)

  • 역할 권한 ID (role_permission_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 부여 일시 (granted_at) — DATETIME(3) — NOT NULL
  • 관리자 역할 ID (role_id) — BIGINT — 외래 키 → 관리자 역할.관리자 역할 ID — NOT NULL — UK 후보: (role_id, permission_id). 동일 권한 중복 연결을 방지한다.
  • 권한 ID (permission_id) — BIGINT — 외래 키 → 접근 권한.권한 ID — NOT NULL

인증 세션 (auth_session)

  • 세션 ID (session_id) — VARCHAR(64) — 기본 키 — NOT NULL — PK. 애플리케이션에서 생성하는 불투명 세션 식별값이다.
  • 리프레시 토큰 해시 (refresh_token_hash) — VARCHAR(128) — NOT NULL — UK. secret pepper를 적용한 리프레시 토큰 해시만 저장한다. 매 갱신 시 현재 해시를 교체하고 이전 토큰 재사용이 감지되면 해당 세션을 폐기한다.
  • 액세스 토큰 식별값 (access_token_jti) — VARCHAR(64) — NOT NULL — UK. 활성 세션과 15분 Access Token 결합 검증에 사용하는 jti이며 리프레시 회전 시 함께 교체한다.
  • IP 주소 (ip_address) — VARCHAR(45)
  • 사용자 에이전트 (user_agent) — VARCHAR(255)
  • 만료 일시 (expires_at) — DATETIME(3) — NOT NULL — 세션 생성 시점부터 고정 30일 만료 시각. 갱신해도 연장하지 않으며 DB 기본값을 두지 않는다.
  • 해지 일시 (revoked_at) — DATETIME(3) — 현재/전체 로그아웃, 회전 토큰 재사용, 관리자 역할 변경, 비활성 제휴사 처리로 세션을 폐기한 시각. NULL이면 만료 전 활성 후보.
  • 마지막 사용 일시 (last_used_at) — DATETIME(3)
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 세션 소유 사용자를 필수 참조한다. 현재/전체 세션 조회·폐기를 위해 (user_id, revoked_at) 인덱스가 필요하며 계정 삭제에 따른 FK 연쇄 삭제는 사용하지 않는다.

인플루언서 코드 소유자 (influencer_profile)

  • 인플루언서 ID (influencer_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 표시 이름 (display_name) — VARCHAR(100) — NOT NULL — 관리자 쿠폰 코드 소유자 표시값. 별도 로그인·포털·역할·정산 정보를 만들지 않는다. 부분 일치 검색 표면이므로 일반 단일 B-tree 인덱스는 미적용.
  • 등록 일시 (created_at) — DATETIME(3) — NOT NULL — 관리자 목록의 등록일 근거.
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.

장바구니 (shopping_cart)

  • 장바구니 ID (cart_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 판매 채널 (sales_channel) — VARCHAR(30) — NOT NULL — 일반 서비스와 각 제휴사 장바구니를 서버 레코드에서 완전히 분리한다. 임의 기본값 없이 채널·partner_id 일관성을 검증하며 잘못된 제휴사 귀속은 주문 생성 전에 거부한다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 장바구니 최근 변경 시각. 애플리케이션에서 변경마다 갱신하고 이 시각부터 30일이 지나면 만료 대상으로 조회한다. DB 자동 갱신·만료 기본값은 두지 않는다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 회원 소유 장바구니일 때 참조하고 비회원 장바구니는 NULL이다. user_id와 guest_cart_token_hash 중 정확히 하나만 소유자로 사용하며 로그인 시 비회원 장바구니를 자동 병합하지 않는다. FK…
  • 제휴사 ID (partner_id) — BIGINT — 외래 키 → 제휴사.제휴사 ID — 제휴사 채널 장바구니일 때 참조하고 일반 채널은 NULL이다. sales_channel과 partner_id 일관성을 CHECK/API에서 검증하며 비활성·없는 제휴사 귀속을 거부한다. FK 연쇄 삭제는 사용하지…
  • 비회원 장바구니 토큰 해시 (guest_cart_token_hash) — VARCHAR(128) — 비회원 장바구니 소유 검증용 불투명 토큰의 해시. 원문 토큰은 저장하지 않으며 회원 user_id와 동시 소유하지 않고 로그인 시 자동 병합하지 않는다. 값이 있을 때 UK 후보.

장바구니 상품 (shopping_cart_item)

  • 장바구니 상품 ID (cart_item_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 수량 (quantity) — INT — NOT NULL — 장바구니 수량. 양수이고 상품별 1회 주문 최대 구매수량 이하여야 한다. 같은 cart_id+item_id 추가는 새 행이 아니라 이 수량을 증가시키며 임의 기본값을 두지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 장바구니 ID (cart_id) — BIGINT — 외래 키 → 장바구니.장바구니 ID — NOT NULL — 장바구니별 상품 조회 FK. (cart_id, item_id) UNIQUE로 동일 상품 중복 행을 방지하고 수량 합산은 하나의 트랜잭션으로 처리한다. FK 연쇄 삭제는 사용하지 않는다.
  • 상품 ID (item_id) — BIGINT — 외래 키 → 상품.상품 ID — NOT NULL — 기존 상품을 참조한다. 상품별 장바구니 역조회는 실제 운영 필요 확인 후 인덱스 후보이며 FK 연쇄 삭제는 승인하지 않았다.

접근 권한 (permission)

  • 권한 ID (permission_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 권한 키 (permission_key) — VARCHAR(100) — NOT NULL — UK 후보. 서버 가드가 참조하는 권한 식별 키다.
  • 대상 리소스 (resource) — VARCHAR(50) — NOT NULL
  • 허용 동작 (action) — VARCHAR(50) — NOT NULL
  • 권한명 (permission_name) — VARCHAR(100) — NOT NULL
  • 사용 여부 (is_active) — BOOLEAN — NOT NULL

제휴사 (partner)

  • 제휴사 ID (partner_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 제휴사명 (partner_name) — VARCHAR(255) — NOT NULL — 관리자·판매 페이지·파트너 포털에 표시하는 제휴사명. 부분 일치 검색은 데이터량·검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 판매 페이지 슬러그 (slug) — VARCHAR(100) — NOT NULL — 고정 템플릿 URL 식별값. 영문 소문자·숫자·하이픈만 허용하고 case-insensitive UNIQUE를 적용하며 최초 게시 후 변경하지 않는다.
  • 운영 상태 (operating_status) — VARCHAR(30) — NOT NULL — ACTIVE 또는 INACTIVE. INACTIVE이면 판매 페이지·신규 로그인·신규 주문을 차단하고 연결 계정 세션을 폐기하며 관리자 조회·과거 주문·감사 이력은 유지한다. DB 기본값을 두지 않는다.
  • 로고/CI 이미지 참조 (logo_image_ref) — VARCHAR(255) — 선택 로고/CI 에셋 참조. 판매 페이지 상단 PANGSIM 로고는 고정이고 파트너 브랜드는 배너 영역에 노출한다. 저장소·형식·크기·교체는 외부 자산 경계다.
  • 메인 배너 이미지 참조 (banner_image_ref) — VARCHAR(255) — 선택 고정 템플릿 배너 에셋 참조. 자유형 랜딩 빌더를 제공하지 않으며 저장소·형식·크기·교체는 외부 자산 경계다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.

제휴사 계정 연결 (partner_account)

  • 제휴사 계정 연결 ID (partner_account_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 공통 인증 주체를 필수 참조하고 계정당 제휴사 연결은 최대 1개다. user_id UNIQUE가 필요하며 내부 관리자 역할·소비자 소유권과 동시 보유하지 않는다. 관리자 발급/초기화 계정만 사용하고 FK 연쇄 삭제…
  • 제휴사 ID (partner_id) — BIGINT — 외래 키 → 제휴사.제휴사 ID — NOT NULL — 제휴사 계정은 하나의 제휴사를 필수 참조한다. MVP 화면은 1개 계정을 관리하지만 DB는 partner_id UNIQUE를 적용하지 않아 향후 다계정을 허용한다. 계정 재배정·FK 연쇄 삭제를 허용하지 않는다.

제휴사 상품군 할인 정책 (partner_product_group_policy)

  • 상품군 할인 정책 ID (partner_product_group_policy_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • SIM 유형 코드 (sim_type) — INT — NOT NULL — eSIM/USIM 상품군 구분. 공급사 SIM_TYPE 원본값과 동일한 코드로 저장하고 임의 기본값을 두지 않는다.
  • 할인율 (discount_rate) — DECIMAL(5,2) — 선택 상품군 할인 입력율 DECIMAL(5,2). 0.00~100.00 범위로 저장하되 외부 가격 계산·반올림·전역 상품 할인 우선순위가 승인되기 전에는 판매가격 권위로 사용하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 제휴사 ID (partner_id) — BIGINT — 외래 키 → 제휴사.제휴사 ID — NOT NULL — 제휴사별 eSIM/USIM 정책을 (partner_id, sim_type) UNIQUE로 관리한다. 제휴사 비활성·보관 시 이력을 연쇄 삭제하지 않는다.

제휴사 연결 상품 (partner_product)

  • 제휴사 연결 상품 ID (partner_product_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL — 연결 레코드 존재로 제휴사 판매 상품을 표현한다. 전역 상품이 판매중·노출 상태여야 최종 노출 가능하며 연결 자체가 판매가격을 변경하지 않는다.
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 제휴사 ID (partner_id) — BIGINT — 외래 키 → 제휴사.제휴사 ID — NOT NULL — (partner_id, item_id) UNIQUE로 제휴사별 상품 연결 중복을 방지한다. 제휴사 비활성·보관 시 연결과 과거 주문 귀속을 연쇄 삭제하지 않는다.
  • 상품 ID (item_id) — BIGINT — 외래 키 → 상품.상품 ID — NOT NULL — 내부 관리자 상품을 참조한다. 제휴사가 상품을 직접 등록·수정하지 않으며 eSIM/USIM 구분은 item_info.sim_type을 사용한다. 상품 비활성 시 FK 이력을 연쇄 삭제하지 않는다.

주문 상태 이력 (order_status_history)

  • 상태 이력 ID (history_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 이전 상태 (from_status) — VARCHAR(30) — 최초 상태 기록은 NULL 가능. 취소요청 이력은 거절 시 정확히 복구할 요청 직전 상태를 보존하며 임의 기본값을 두지 않는다.
  • 변경 상태 (to_status) — VARCHAR(30) — NOT NULL — 변경 결과 상태. 현재 customer_order 상태와 같은 트랜잭션으로 기록하고 발권·환불·수령 업무 증거가 확정되지 않은 성공 상태를 기록하지 않는다.
  • 변경 사유 (reason) — TEXT
  • 변경 일시 (changed_at) — DATETIME(3) — NOT NULL — 상태 전이가 실제로 발생한 시각. 애플리케이션에서 명시하며 임의 DB 기본값 없음.
  • 주문 ID (order_id) — BIGINT — 외래 키 → 고객 주문.주문 ID — NOT NULL — 주문 상태 이력 조회용 (order_id, changed_at, history_id) 인덱스 후보. 감사 이력의 FK 연쇄 삭제는 승인하지 않았다.
  • 변경자 사용자 ID (actor_user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 관리자 또는 시스템 변경을 구분하기 위해 시스템은 NULL을 허용한다. 사용자 비활성·익명화가 상태 이력을 삭제하지 않도록 비연쇄 FK를 사용한다.

주문 상품 (order_item)

  • 주문 상품 ID (order_item_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 공급사 상품 코드 스냅샷 (plan_cd_snapshot) — VARCHAR(50) — NOT NULL — KBOOKS 주문 생성 시 사용한 PLAN_CD를 주문 시점 값으로 보존한다. 원본 상품 코드 변경과 무관한 스냅샷이며 고유 제약 없음.
  • 상품명 스냅샷 (product_name_snapshot) — VARCHAR(255) — NOT NULL — 관리자·고객 주문 이력용 상품명 스냅샷.
  • SIM 유형 스냅샷 (sim_type_snapshot) — INT — NOT NULL — eSIM/USIM 구분을 주문 시점에 보존한다. 전체 공급사 코드셋은 Open이며 임의 기본값 없음.
  • 주문 단가 (unit_price_amount) — BIGINT — NOT NULL — 주문 시점 KRW 단가. 0 이상 검증 후보.
  • 주문 수량 (quantity) — INT — NOT NULL — 주문 시점 확정 수량. 양수이고 해당 상품의 주문 시점 최대 구매수량 이하여야 하며 환불·USIM 수령 잔여수량 계산의 기준이다.
  • 서비스 시작일 (service_start_date) — DATE — KBOOKS start_date에 대응한다. 선택 시점과 변경 정책은 Open이므로 NULL 허용과 무기본값을 유지한다.
  • 사용 기간 스냅샷 (usage_days_snapshot) — INT — NOT NULL — 주문 시점 사용 기간. 양수 검증 후보.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 주문 ID (order_id) — BIGINT — 외래 키 → 고객 주문.주문 ID — NOT NULL — 주문 1건은 주문상품 1건 이상을 가진다. FK 요건상 order_id가 BTREE 인덱스의 좌측 시작이어야 한다. InnoDB 보조 인덱스는 PK를 함께 보유하므로 (order_id, order_item_id)…
  • 상품 ID (item_id) — BIGINT — 외래 키 → 상품.상품 ID — NOT NULL — 원본 상품을 참조하되 주문명·단가·PLAN_CD·SIM 유형·사용기간은 주문 시점 스냅샷으로 보존한다. FK 연쇄 삭제는 승인하지 않았다.

주문 환불 (order_refund)

  • 환불 ID (refund_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 환불 유형 (refund_type) — VARCHAR(20) — NOT NULL — 전체환불/부분환불 구분. 취소요청 자체의 상태 전이와 혼용하지 않으며 임의 기본값 없음.
  • 환불 처리 상태 (refund_status) — VARCHAR(30) — NOT NULL — 성공·실패 결과를 이력으로 보존한다. 실패 시 주문 상태를 임의 변경하지 않는다. 운영 조회용 (refund_status, created_at, refund_id) 인덱스 후보.
  • 환불 요청 금액 (refund_amount) — BIGINT — NOT NULL — 실제 승인 결제금액 기준 KRW 환불액. 상품별 payable 비중으로 배분하고 반올림 차액은 마지막 환불 항목에 반영한다. 누적 성공 환불액은 승인 금액을 초과할 수 없다.
  • 처리 전 누적 환불 금액 (previous_refunded_amount) — BIGINT — NOT NULL — 환불 요청 직전 누적 성공 환불액 스냅샷. 첫 환불은 0이며 승인 금액 초과·중복 환불 방지를 위해 필수 저장한다.
  • 처리 후 잔여 결제 금액 (remaining_paid_amount) — BIGINT — NOT NULL — 이번 성공 환불 후 잔여 실결제금액 스냅샷. 0 이상 필수이며 모든 잔여수량 환불이면 0과 REFUNDED 종료 상태가 일치해야 한다.
  • 환불 사유 (reason) — TEXT — NOT NULL
  • 쿠폰 복구 선택 (coupon_restore_choice) — VARCHAR(20) — NOT NULL — RESTORE_ALL 또는 DO_NOT_RESTORE만 허용한다. 주문의 쿠폰 복구는 최대 한 번이며 부분 복구·만료기간 연장은 제공하지 않는다.
  • 포인트 복구 선택 (point_restore_choice) — VARCHAR(20) — NOT NULL — RESTORE_ALL 또는 DO_NOT_RESTORE만 허용한다. 주문의 포인트 복구는 최대 한 번이며 환불 성공 결과와 원장 반영을 같은 트랜잭션으로 처리한다.
  • PG 취소 식별값 (provider_cancel_reference) — VARCHAR(255) — TossPayments 취소 결과 식별값. 값이 있으면 제공자 취소 결과의 중복 처리를 방지하도록 UNIQUE/멱등 검증하며 원시 비밀 payload는 저장하지 않는다.
  • PG 결과 코드 (provider_result_code) — VARCHAR(50)
  • PG 결과 메시지 (provider_result_message) — TEXT
  • 처리 일시 (processed_at) — DATETIME(3) — PG 성공·실패 결과가 확정된 처리 시각. 요청 중에는 NULL 가능.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 결제 ID (payment_id) — BIGINT — 외래 키 → 결제 거래.결제 ID — NOT NULL — 환불은 실제 승인된 Toss 결제 거래에 귀속한다. (payment_id, created_at, refund_id) 인덱스를 사용하고 누적 성공 환불을 잠금·트랜잭션으로 검증하며 FK 연쇄 삭제를 사용하지 않는다.
  • 처리자 사용자 ID (processor_user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — 환불 처리 운영자. 외부 콜백 결과 반영은 NULL 가능하지만 관리자 부분환불 요청은 actor를 필수로 감사하며 사용자 비활성·익명화가 환불 이력을 삭제하지 않는다.

지원 단말기 (supported_device)

  • 지원 단말기 ID (device_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 제조사 (manufacturer) — VARCHAR(100) — NOT NULL — 필수 제조사 표시값. 제조사 마스터 엔티티는 승인된 요구가 없어 추가하지 않는다.
  • 모델명 (model_name) — VARCHAR(100) — NOT NULL — 필수 고객 표시 모델명. 단말 식별 UK는 model_code+os_name이 담당한다.
  • 제조사 모델 코드 (model_code) — VARCHAR(100) — NOT NULL — 필수 제조사 모델 코드. os_name과 함께 case-insensitive UNIQUE를 적용하며 예시값을 정책으로 사용하지 않는다.
  • 운영체제 (os_name) — VARCHAR(50) — NOT NULL — 필수 운영체제 식별값. model_code와 함께 case-insensitive UNIQUE를 적용하며 출시 OS 코드셋·마스터 테이블은 승인 전 추가하지 않는다.
  • 최소 OS 버전 (minimum_os_version) — VARCHAR(50) — NOT NULL — 필수 최소 지원 OS 버전 표시값. 비교·정규화는 애플리케이션 검증 책임이며 승인되지 않은 버전 파서나 별도 마스터 엔티티를 추가하지 않는다.
  • eSIM 지원 여부 (esim_supported) — BOOLEAN — NOT NULL — 필수 eSIM 지원 여부이며 DB 기본값을 두지 않는다. 관리자 변경은 같은 데이터셋의 소비자 호환 목록에 즉시 반영하며 bulk/delete 전용 스키마는 추가하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL

카테고리 포함 국가 (catalog_category_nation)

  • 카테고리 ID (category_id) — BIGINT — 외래 키 → 상품 카테고리.카테고리 ID — NOT NULL — 복합 PK의 첫 번째 열. 카테고리별 포함 국가 조회를 지원하며 연결 카테고리 비활성 시에도 관계 이력을 연쇄 삭제하지 않는다.
  • 국가 코드 (nation_cd) — CHAR(3) — 외래 키 → 국가.국가 코드 — NOT NULL — 복합 PK의 두 번째 열. 국가 기준 역조회 인덱스는 실제 조회와 EXPLAIN으로 승인하며 연결 국가 비활성 시에도 관계를 연쇄 삭제하지 않는다.

쿠폰 사용 이력 (coupon_usage)

  • 쿠폰 사용 ID (coupon_usage_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 실제 할인 금액 (discount_amount) — BIGINT — NOT NULL — 주문에 실제 적용된 KRW 할인 금액. 혜택 텍스트를 임의 파싱해 계산하지 않으며 0 이상 검증 후보.
  • 사용 일시 (used_at) — DATETIME(3) — NOT NULL — 쿠폰이 주문에 실제 적용된 시각. 사용 이력/내보내기용 (used_at, coupon_usage_id) 인덱스 후보이며 임의 DB 기본값 없음.
  • 복구 일시 (restored_at) — DATETIME(3) — 환불에서 전체 쿠폰 복구가 성공한 최초 시각. 하나의 주문 쿠폰은 최대 한 번만 복구하며 만료 연장·부분 복구·후속 중복 복구를 허용하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 쿠폰 발급 ID (coupon_issuance_id) — BIGINT — 외래 키 → 회원 쿠폰 발급.쿠폰 발급 ID — NOT NULL — 발급 쿠폰 사용·복구 이력 FK. 사용 이력은 보존하되 1주문 1쿠폰과 restored_at 단일값으로 중복 복구를 방지하며 FK 연쇄 삭제를 사용하지 않는다.
  • 주문 ID (order_id) — BIGINT — 외래 키 → 고객 주문.주문 ID — NOT NULL — 1주문 1쿠폰을 강제하는 UNIQUE FK. 주문번호 기반 사용 이력과 복구 판단에 사용하며 주문 삭제에 따른 연쇄 삭제를 허용하지 않는다.
  • 복구 환불 ID (refund_id) — BIGINT — 외래 키 → 주문 환불.환불 ID — 환불에서 쿠폰 전체 복구가 성공한 경우에만 참조하고 미복구/일반 사용은 NULL. 후속 부분환불 중복 복구 방지는 Open이며 FK 연쇄 삭제는 승인하지 않았다.

쿠폰 정의 (coupon_definition)

  • 쿠폰 ID (coupon_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 쿠폰명 (coupon_name) — VARCHAR(255) — NOT NULL — 관리자·고객에게 표시하는 쿠폰명. 부분 일치 검색 표면이므로 데이터량과 검색 방식 확인 전 일반 단일 B-tree 인덱스를 확정하지 않는다.
  • 혜택 표시값 (benefit_text) — VARCHAR(255) — 확정 화면의 혜택 입력값을 보존한다. 정액/정률·할인값·상한·최소금액·계산식은 Open이며 텍스트를 계산 근거로 사용하지 않는다.
  • 적용 조건 표시값 (condition_text) — TEXT — 복합 적용 조건 기능은 유지한다. 대상·우선순위·조합 규칙의 구조화 모델은 Open이며 부분 일치 검색 인덱스는 미적용.
  • 유효 시작일 (valid_from) — DATE — 쿠폰 공통 유효 시작일. 시작/종료 포함 경계와 서비스 시간대는 Open이며 임의 기본값 없음.
  • 유효 종료일 (valid_to) — DATE — 쿠폰 공통 유효 종료일. valid_to가 valid_from보다 이르지 않도록 검증 후보. 종료 포함 경계와 서비스 시간대는 Open.
  • 운영 상태 (operating_status) — VARCHAR(30) — NOT NULL — 관리자 활성/비활성 표면을 유지하고 만료는 날짜로 산출한다. 임의 기본값 없음. 목록용 (operating_status, valid_to, coupon_id) 인덱스 후보.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.

쿠폰 코드 (coupon_code)

  • 쿠폰 코드 ID (coupon_code_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 쿠폰 코드 (code) — VARCHAR(100) — NOT NULL — 일반/인플루언서 쿠폰 코드. trim 후 case-insensitive UNIQUE로 정확 조회하며 코드 발급 후 다른 쿠폰으로 재배정하지 않는다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 쿠폰 ID (coupon_id) — BIGINT — 외래 키 → 쿠폰 정의.쿠폰 ID — NOT NULL — 하나의 쿠폰 정의가 0..N 코드를 가진다. FK 요건상 coupon_id 좌측 인덱스가 필요하나 InnoDB 보조 인덱스가 PK를 함께 보유하므로 (coupon_id, coupon_code_id) 중복 인덱스는…
  • 인플루언서 ID (influencer_id) — BIGINT — 외래 키 → 인플루언서 코드 소유자.인플루언서 ID — 인플루언서 전용 코드일 때만 소유자를 참조하고 일반 코드는 NULL. 별도 로그인·포털·계정을 뜻하지 않는다. 소유자별 코드 조회 인덱스 후보이며 FK 연쇄 삭제는 승인하지 않았다.

포인트 원장 (point_ledger)

  • 포인트 거래 ID (point_transaction_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 거래 유형 (transaction_type) — VARCHAR(30) — NOT NULL — 포인트 거래 유형 EARN/RESERVE/SPEND/REVERSAL/MANUAL_ADJUSTMENT. 기본값 없이 명시하고 수동조정은 SUPER_ADMIN만 필수 사유·감사와 함께 수행한다.
  • 포인트 변동량 (amount_delta) — BIGINT — NOT NULL — 적립·복원은 양수, 사용은 음수인 0이 아닌 변동량. 예약/확정/취소 상태와 멱등키를 함께 사용해 보유액·주문금액 초과, 중복 사용·복원을 트랜잭션으로 방지한다.
  • 사유 (reason_text) — VARCHAR(255) — NOT NULL — 운영·고객 이력에 표시하는 필수 사유. prototype의 운영팀 수동 조정 문구를 기본값으로 승격하지 않으며 부분 일치 검색 인덱스는 미적용.
  • 발생 일시 (occurred_at) — DATETIME(3) — NOT NULL — 포인트 변동이 실제 발생한 시각. 애플리케이션에서 명시하며 임의 DB 기본값 없음.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 회원별 포인트 원장과 확정 잔액 산출 FK. (user_id, occurred_at, point_transaction_id) 인덱스를 사용하고 사용자 비활성·익명화가 금융성 이력을 삭제하지 않는다.
  • 주문 ID (order_id) — BIGINT — 외래 키 → 고객 주문.주문 ID — 주문 기반 예약·사용·적립 원인이 있을 때 참조한다. idempotency_key로 중복 처리를 막고 주문/포인트 이력을 연쇄 삭제하지 않는다.
  • 환불 ID (refund_id) — BIGINT — 외래 키 → 주문 환불.환불 ID — 환불 성공에 따른 포인트 복원 거래에서 참조한다. 주문당 복원은 최대 한 번이며 idempotency_key와 환불 트랜잭션으로 중복을 방지하고 FK 연쇄 삭제를 사용하지 않는다.
  • 처리 상태 (transaction_status) — VARCHAR(30) — NOT NULL — 포인트 예약·확정·취소 처리 상태. 임의 기본값 없이 서비스 트랜잭션이 명시하며 잔액 계산은 확정 상태만 반영한다.
  • 멱등 키 (idempotency_key) — VARCHAR(100) — NOT NULL — 포인트 예약·사용·복원·수동조정의 중복 처리를 방지하는 서버 생성 업무키. 원문 비밀값이 아니며 UNIQUE가 필요하다.

픽업 위치 (store_info)

  • 픽업 위치 ID (id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 후보. USIM 픽업 주문이 참조하며 연결 주문이 있는 위치는 삭제·재배정하지 않고 운영 중단 상태로 보존한다.
  • 매장 코드 (store_cd) — VARCHAR(50) — NOT NULL — 고유하고 등록 후 변경하지 않는 매장 코드. case-insensitive UNIQUE를 적용하며 KBOOKS pickup_location 매핑은 외부 계약 어댑터에서 검증한다.
  • 매장명 (store_name) — VARCHAR(100) — NOT NULL — 관리자·고객에게 표시하는 필수 매장명. 검색 방식은 부분 일치로 확인되었으나 최종 검색 구현은 Open이다.
  • 부스 코드 (booth_cd) — VARCHAR(50) — NOT NULL — 고유하고 등록 후 변경하지 않는 부스 코드. case-insensitive UNIQUE를 적용하며 임의 기본값을 두지 않는다.
  • 부스명 (booth_name) — VARCHAR(100) — NOT NULL — 관리자·고객에게 표시하는 필수 부스명. 매장명 자동 복사는 승인하지 않았다.
  • 주소 (address) — VARCHAR(255)
  • 운영시간 안내 (operating_hours_text) — VARCHAR(255) — 고객에게 표시하는 한국시간 기준 운영시간 안내 문자열. 구조화 일정·시간대 변환 규칙을 추측하지 않고 표시값 자체를 관리한다.
  • 픽업 안내 (pickup_guide_text) — TEXT — 주문번호 기준 수령 안내에 사용하며 바우처/수령번호 발급을 뜻하지 않는다.
  • 운영 상태 (operating_status) — VARCHAR(30) — NOT NULL — 운영 중/운영 중단을 구분하며 기본값을 두지 않는다. 운영 중단 위치는 신규 선택을 차단하고 기존 주문 이력은 유지한다. 공개 선택용 (operating_status) 인덱스 후보.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL

환불 대상 상품 (refund_item)

  • 환불 대상 ID (refund_item_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 환불 수량 (refund_quantity) — INT — NOT NULL — 이번 환불 대상 수량. 양수이며 동일 주문상품의 누적 성공 환불 수량이 주문 수량을 넘지 않아야 한다. 남은 USIM 수령 가능수량 계산의 기준이다.
  • 대상별 환불 금액 (refund_amount) — BIGINT — NOT NULL — 상품별 실제 결제금액 비중으로 배분한 필수 KRW 환불액. 반올림 차액은 마지막 환불 항목에 반영하고 모든 항목 합은 order_refund.refund_amount와 일치해야 한다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 환불 ID (refund_id) — BIGINT — 외래 키 → 주문 환불.환불 ID — NOT NULL — 환불 요청별 대상 FK. (refund_id, order_item_id) UNIQUE로 동일 요청의 동일 주문상품 중복을 방지하고 FK 연쇄 삭제를 사용하지 않는다.
  • 주문 상품 ID (order_item_id) — BIGINT — 외래 키 → 주문 상품.주문 상품 ID — NOT NULL — 환불 결제가 속한 동일 주문의 상품이어야 한다. 누적 수량·금액 검증은 주문/결제/환불 잠금 트랜잭션에서 수행하며 FK 연쇄 삭제를 사용하지 않는다.

회원 쿠폰 발급 (coupon_issuance)

  • 쿠폰 발급 ID (coupon_issuance_id) — BIGINT — 기본 키 — NOT NULL — PK. MariaDB BIGINT AUTO_INCREMENT 적용 후보.
  • 발급 상태 (issuance_status) — VARCHAR(30) — NOT NULL — 사용 가능·사용·만료·복구 화면 상태를 지원한다. 최종 코드·전이·쿠폰 중지 영향은 Open이며 임의 기본값 없음.
  • 발급 일시 (issued_at) — DATETIME(3) — NOT NULL — 쿠폰이 회원에게 실제 발급된 시각. 애플리케이션에서 명시하며 임의 DB 기본값 없음.
  • 개별 만료 일시 (expires_at) — DATETIME(3) — 개별 발급 만료 시각. 쿠폰 공통 기간과의 우선순위·종료 경계는 Open이므로 NULL 허용과 무기본값을 유지한다.
  • 생성 일시 (created_at) — DATETIME(3) — NOT NULL
  • 수정 일시 (updated_at) — DATETIME(3) — NOT NULL — 애플리케이션 갱신 시각. DB 자동 갱신 규칙은 승인하지 않았다.
  • 쿠폰 ID (coupon_id) — BIGINT — 외래 키 → 쿠폰 정의.쿠폰 ID — NOT NULL — 쿠폰별 발급 이력용 (coupon_id, issued_at, coupon_issuance_id) 인덱스 후보. 발급 대상·수량·중복·중지 영향은 Open이며 FK 연쇄 삭제는 승인하지 않았다.
  • 사용자 ID (user_id) — VARCHAR(30) — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — 회원 쿠폰 목록용 (user_id, issuance_status, expires_at, coupon_issuance_id) 인덱스 후보. 사용자 삭제가 발급·사용 이력을 삭제해서는 안 되며 FK 삭제 동작은 Ope…
  • 쿠폰 코드 ID (coupon_code_id) — BIGINT — 외래 키 → 쿠폰 코드.쿠폰 코드 ID — 코드 기반 발급일 때만 참조한다. 코드 없이 직접 발급되는 방식의 허용·조건은 Open. 코드별 발급 이력 인덱스 후보이며 FK 연쇄 삭제는 승인하지 않았다.