SmartSub V2

테이블 (9)

AI 니즈 요약 (p_store_insights)

  • 인사이트 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 매장 ID (store_id) — UUID — 외래 키 → 매장.매장 ID — NOT NULL — FK 리포트 대상 매장 ID
  • 대상 일자 (target_date) — DATE — NOT NULL — 분석 대상 날짜 (예: 2026-06-11)
  • 일일 대화수 (total_chat_count) — INTEGER — NOT NULL — 당일 매장에서 발생한 총 AI 대화 건수
  • 핵심 키워드 TOP3 (top_keywords) — VARCHAR(255) — NOT NULL — 가장 많이 나온 질문 키워드 (JSON 형태 저장 가능)
  • AI 컨설팅 제안 (ai_recommendation) — TEXT — 대화 패턴을 분석해 AI가 사장님에게 주는 매장 개선 팁

결제 (p_payments)

  • 결제 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 유저 ID (user_id) — UUID — 외래 키 → 유저.유저 ID — NOT NULL — 필수 FK
  • 상품 ID (product_id) — UUID — 외래 키 → 상품.상품 ID — NOT NULL — 필수 FK
  • 구독 ID (subscription_id) — UUID — 외래 키 → 구독.구독 ID — 선택 FK
  • 결제 유형 (payment_type) — ENUM — NOT NULL — ONE_TIME, SUBSCRIPTION
  • 결제 상태 (status) — ENUM — NOT NULL — READY, SUCCESS, FAILED, CANCELED
  • 상품명 스냅샷 (product_name_snapshot) — VARCHAR(100) — NOT NULL — 결제 당시 상품명
  • 상품 단가 (unit_price) — DECIMAL(10,2) — NOT NULL — 결제 당시 상품 단가
  • 결제 금액 (amount) — DECIMAL(10,2) — NOT NULL — 최종 결제 금액
  • 결제 수량 (quantity) — INTEGER — NOT NULL — 결제 상품 수량
  • 멱등키 (idempotency_key) — VARCHAR(100) — NOT NULL — 중복 결제 방지 키, UNIQUE
  • 실패 사유 (failure_reason) — VARCHAR(500) — 결제 실패 사유
  • 결제 완료 일시 (paid_at) — DATETIME(6) — 결제 성공 일시

공통 (BaseEntity)

  • 생성 일시 (created_at) — DATETIME(6) — NOT NULL — 생성 일시
  • 생성인 (created_by) — UUID — NOT NULL — 생성자 ID
  • 수정 일시 (updated_at) — DATETIME(6) — NOT NULL — 수정 일시
  • 수정인 (updated_by) — UUID — NOT NULL — 수정자 ID
  • 삭제 일시 (deleted_at) — DATETIME(6) — 삭제 일시, NULL이면 미삭제
  • 삭제인 (deleted_by) — UUID — 삭제자 ID

구독 (p_subscriptions)

  • 구독 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 유저 ID (user_id) — UUID — 외래 키 → 유저.유저 ID — NOT NULL — FK
  • 상품 ID (product_id) — UUID — 외래 키 → 상품.상품 ID — NOT NULL — FK
  • 구독 상태 (status) — ENUM — NOT NULL — ACTIVE, PAUSED, CANCELED
  • 구독 주기 (cycle_type) — ENUM — NOT NULL — WEEKLY, MONTHLY
  • 구독 수량 (quantity) — INTEGER — NOT NULL — 정기구독 상품 수량
  • 시작일 (start_date) — DATE — NOT NULL — 구독 시작일
  • 종료일 (end_date) — DATE — 구독 종료일
  • 다음 결제일 (next_payment_date) — DATE — NOT NULL — 다음 정기결제 예정일

매장 (p_stores)

  • 매장 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 유저 ID (user_id) — UUID — 외래 키 → 유저.유저 ID — NOT NULL — FK 매장 주인(사장님) ID
  • 매장명 (name) — VARCHAR(100) — NOT NULL — 매장 이름 (예: 대박삼겹살 홍대점)
  • 매장 기본 가이드 (common_info) — VARCHAR(1000) — 화장실 비번, 주차, 이용 팁 등 고정 안내 텍스트
  • 프롬프트 템플릿 (prompt_template) — VARCHAR(2000) — NOT NULL — AI 점장의 페르소나 설정 (말투, 기본 태도 등)
  • 매장 상태 (status) — ENUM — NOT NULL — ACTIVE, PAUSED, TERMINATED (매장 활성화 상태)

상품 (p_products)

  • 상품 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 매장 ID (store_id) — UUID — 외래 키 → 매장.매장 ID — NOT NULL — FK
  • 상품명 (name) — VARCHAR(100) — NOT NULL — 상품 이름
  • 상품 설명 (description) — VARCHAR(1000) — 관리자 입력 또는 AI 생성 상품 설명
  • 설명 출처 (description_source) — ENUM — NOT NULL — MANUAL, AI_GENERATED, AI_EDITED
  • 가격 (price) — DECIMAL(10,2) — NOT NULL — 상품 가격
  • 재고 수량 (stock_quantity) — INTEGER — NOT NULL — 현재 재고 수량
  • 상품 단위 (unit) — ENUM — NOT NULL — EA, PACK, BOX, SET, BOTTLE, CAN, G, KG, ML, L
  • 상태 (status) — ENUM — NOT NULL — ON_SALE, OUT_OF_STOCK, HIDDEN, DISCONTINUED

알림 (p_notifications)

  • 알림 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 유저 ID (user_id) — UUID — 외래 키 → 유저.유저 ID — NOT NULL — FK
  • 결제 ID (payment_id) — UUID — 외래 키 → 결제.결제 ID — NOT NULL — FK, 결제 관련 알림이면 사용
  • 수신 대상 (target) — VARCHAR(255) — Slack User ID 또는 Slack 채널 식별자
  • 제목 (title) — VARCHAR(255) — Slack 알림 제목
  • 메시지 (message) — VARCHAR(1000) — NOT NULL — Slack 알림 메시지
  • 알림 상태 (status) — ENUM — NOT NULL — READY, SUCCESS, FAILED
  • 재시도 횟수 (retry_count) — INTEGER — NOT NULL — Slack 알림 재시도 횟수
  • 실패 사유 (failure_reason) — VARCHAR(500) — Slack 알림 실패 사유
  • 발송 일시 (sent_at) — DATETIME(6) — Slack 알림 성공 발송 일시

유저 (p_users)

  • 유저 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 이메일 (email) — VARCHAR(255) — NOT NULL — 로그인 이메일, UNIQUE
  • 비밀번호 해시 (password_hash) — VARCHAR(255) — NOT NULL — BCrypt 해시 비밀번호
  • 이름 (name) — VARCHAR(50) — NOT NULL — 사용자 이름
  • 권한 (role) — ENUM — NOT NULL — USER, ADMIN, SYSTEM
  • 상태 (status) — ENUM — NOT NULL — ACTIVE, INACTIVE, WITHDRAWN

채팅 로그 (p_chat_logs)

  • 로그 ID (id) — UUID — 기본 키 — NOT NULL — PK
  • 매장 ID (store_id) — UUID — 외래 키 → 매장.매장 ID — NOT NULL — FK 대화가 발생한 매장 ID
  • 테이블 번호 (table_number) — VARCHAR(20) — NOT NULL — QR 파라미터에서 추출한 테이블 번호 (예: "3", "테이블A")
  • 손님 질문 (question) — TEXT — NOT NULL — 손님이 입력한 질문 원본
  • AI 답변 (answer) — TEXT — NOT NULL — OpenAI가 최종 생성하여 손님에게 전달한 답변 원본
  • 언어 종류 (language) — ENUM — NOT NULL — KOREAN, ENGLISH, JAPANESE, CHINESE (손님이 쓴 언어)