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 (손님이 쓴 언어)