TogetherShop

테이블 (17)

api_keys : 필요한가? (api_keys)

  • key_id — bigint — 기본 키 — NOT NULL — API 키 고유 식별자
  • service_name — varchar(100) — NOT NULL — 외부 서비스 명
  • key_name — varchar(100) — NOT NULL — API 키 이름
  • api_key — varchar(500) — NOT NULL — API 키 값
  • secret_key — varchar(500) — API 시크릿 키
  • endpoint_url — varchar(500) — API 엔드포인트 URL
  • is_active — tinyint(1) — API 키 활성화 여부
  • expires_at — timestamp — API 키 만료 일시
  • created_at — timestamp — API 키 등록 일시
  • updated_at — timestamp — API 키 수정 일시

businesses

  • business_id — bigint — 기본 키 — NOT NULL — 사업자 고유 식별자
  • username — varchar(50) — NOT NULL — 사용자명 (로그인 ID)
  • email — varchar(100) — NOT NULL — 이메일 주소
  • password_hash — varchar(255) — NOT NULL — 암호화된 비밀번호
  • business_name — varchar(200) — NOT NULL — 상호명
  • business_registration_number — varchar(20) — NOT NULL — 사업자등록번호
  • representative_name — varchar(100) — NOT NULL — 대표자 성명
  • phone_number — varchar(20) — NOT NULL — 사업장 전화번호
  • business_type — varchar(100) — 사업자 유형 (개인/법인)
  • business_category — varchar(100) — 업종 분류
  • address — varchar(500) — 사업장 주소
  • detailed_address — varchar(500) — 상세 주소
  • latitude — decimal(10, 8) — 위도 좌표
  • longitude — decimal(11, 8) — 경도 좌표
  • business_hours — text — 영업시간 정보
  • description — text — 사업장 소개
  • profile_image_url — varchar(500) — 프로필 이미지 URL
  • verification_status — enum('PENDING', 'VERIFIED', 'REJECTED') — 사업자 인증 상태
  • together_index — decimal(5, 2) — 함께지수 점수
  • created_at — timestamp — 계정 생성 일시
  • updated_at — timestamp — 정보 수정 일시
  • status — enum('ACTIVE', 'INACTIVE', 'SUSPENDED') — 계정 상태 (활성/비활성/정지)

chat_messages

  • message_id — bigint — 기본 키 — NOT NULL — 메시지 고유 식별자
  • partnership_id — bigint — 외래 키 → partnerships.partnership_id — NOT NULL — 제휴 관계 ID
  • sender_business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 메시지 발신 사업자 ID
  • receiver_business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 메시지 수신 사업자 ID
  • message_type — enum('TEXT', 'IMAGE', 'FILE', 'SYSTEM', 'PROPOSAL') — 메시지 유형
  • content — text — 메시지 내용
  • file_url — varchar(500) — 첨부 파일 URL
  • proposal_data — json — 제안서 데이터
  • sent_at — timestamp — 메시지 발송 일시
  • read_at — timestamp — 메시지 읽음 일시
  • status — enum('SENT', 'DELIVERED', 'READ') — 메시지 상태

community_comments : 사용안함 (community_comments)

  • comment_id — bigint — 기본 키 — NOT NULL — 댓글 고유 식별자
  • post_id — bigint — 외래 키 → community_posts : 사용안함.post_id — NOT NULL — 게시글 ID
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 댓글 작성 사업자 ID
  • parent_comment_id — bigint — 외래 키 → community_comments : 사용안함.comment_id — 부모 댓글 ID (대댓글용)
  • content — text — NOT NULL — 댓글 내용
  • like_count — int — 댓글 좋아요 수
  • created_at — timestamp — 댓글 작성 일시
  • updated_at — timestamp — 댓글 수정 일시
  • status — enum('ACTIVE', 'HIDDEN', 'DELETED') — 댓글 상태

community_posts : 사용안함 (community_posts)

  • post_id — bigint — 기본 키 — NOT NULL — 게시글 고유 식별자
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 게시글 작성 사업자 ID
  • category — varchar(100) — NOT NULL — 게시글 카테고리
  • title — varchar(500) — NOT NULL — 게시글 제목
  • content — text — NOT NULL — 게시글 내용
  • images — json — 게시글 이미지 URL 배열
  • tags — json — 게시글 태그 배열
  • view_count — int — 조회수
  • like_count — int — 좋아요 수
  • comment_count — int — 댓글 수
  • is_notice — tinyint(1) — 공지사항 여부
  • is_featured — tinyint(1) — 추천 게시글 여부
  • created_at — timestamp — 게시글 작성 일시
  • updated_at — timestamp — 게시글 수정 일시
  • status — enum('ACTIVE', 'HIDDEN', 'DELETED') — 게시글 상태

coupon_templates

  • template_id — bigint — 기본 키 — NOT NULL — 쿠폰 템플릿 고유 식별자
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 쿠폰 발급 사업자 ID
  • template_name — varchar(200) — NOT NULL — 쿠폰 템플릿 명
  • discount_type — enum('PERCENTAGE', 'FIXED_AMOUNT') — NOT NULL — 할인 유형 (비율/고정금액)
  • discount_value — decimal(10, 2) — NOT NULL — 할인 값 (% 또는 금액)
  • minimum_order_amount — decimal(10, 2) — 최소 주문 금액
  • maximum_discount_amount — decimal(10, 2) — 최대 할인 금액
  • description — text — 쿠폰 설명
  • terms_and_conditions — text — 쿠폰 사용 조건
  • image_url — varchar(500) — 쿠폰 이미지 URL
  • valid_days — int — 쿠폰 유효 일수
  • max_issue_count — int — 최대 발급 개수
  • max_use_per_customer — int — 고객당 최대 사용 횟수
  • is_active — tinyint(1) — 템플릿 활성화 여부
  • created_at — timestamp — 템플릿 생성 일시
  • updated_at — timestamp — 템플릿 수정 일시

coupons

  • coupon_id — bigint — 기본 키 — NOT NULL — 쿠폰 고유 식별자
  • template_id — bigint — 외래 키 → coupon_templates.template_id — NOT NULL — 쿠폰 템플릿 ID
  • customer_id — bigint — 외래 키 → customers.customer_id — 쿠폰 소유 고객 ID
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 쿠폰 발급 사업자 ID
  • coupon_code — varchar(50) — NOT NULL — 쿠폰 코드
  • jti_token — varchar(500) — NOT NULL — JWT JTI 토큰 (보안용)
  • qr_code_data — text — QR 코드 데이터
  • pin_code — varchar(10) — 쿠폰 PIN 코드
  • issue_date — timestamp — 쿠폰 발급 일시
  • expire_date — timestamp — NOT NULL — 쿠폰 만료 일시
  • used_date — timestamp — 쿠폰 사용 일시
  • status — enum('ISSUED', 'USED', 'EXPIRED', 'CANCELLED') — 쿠폰 상태
  • issue_channel — enum('ONLINE', 'OFFLINE', 'PARTNERSHIP') — 쿠폰 발급 경로

customers

  • customer_id — bigint — 기본 키 — NOT NULL — 고객 고유 식별자
  • username — varchar(50) — NOT NULL — 사용자명 (로그인 ID)
  • email — varchar(100) — NOT NULL — 이메일 주소
  • password_hash — varchar(255) — NOT NULL — 암호화된 비밀번호
  • name — varchar(100) — NOT NULL — 고객 실명
  • phone_number — varchar(20) — 휴대폰 번호
  • birth_date — date — 생년월일
  • gender — enum('M', 'F', 'OTHER') — 성별 (남성/여성/기타)
  • push_token — varchar(500) — FCM 푸시 알림 토큰
  • created_at — timestamp — 계정 생성 일시
  • updated_at — timestamp — 정보 수정 일시
  • status — enum('ACTIVE', 'INACTIVE', 'SUSPENDED') — 계정 상태 (활성/비활성/정지)

grouppurchase_participants

  • participant_id — BIGINT — 기본 키
  • project_id — BIGINT — 외래 키 → grouppurchase_projects.project_id
  • business_id — BIGINT — NOT NULL
  • quantity — INT — NOT NULL
  • status — ENUM('APPLIED', 'CONFIRMED', 'CANCELLED')
  • joined_at — TIMESTAMP

grouppurchase_projects

  • project_id — BIGINT — 기본 키
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 사업자 고유 식별자
  • title — VARCHAR(200) — NOT NULL
  • description — TEXT
  • target_quantity — INT — NOT NULL
  • current_quantity — INT
  • status — ENUM('OPEN', 'CLOSED', 'FULFILLED', 'CANCELLED')
  • start_date — DATETIME
  • end_date — DATETIME
  • created_at — TIMESTAMP
  • updated_at — TIMESTAMP

partnerships

  • partnership_id — bigint — 기본 키 — NOT NULL — 제휴 관계 고유 식별자
  • requester_business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 제휴 요청 사업자 ID
  • partner_business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 제휴 대상 사업자 ID
  • status — enum('REQUESTED', 'ACCEPTED', 'REJECTED', 'TERMINATED') — 제휴 상태
  • start_date — date — 제휴 시작일
  • end_date — date — 제휴 종료일
  • created_at — timestamp — 제휴 요청 일시
  • updated_at — timestamp — 제휴 상태 변경 일시

payment_histories

  • payment_id — bigint — 기본 키 — NOT NULL — 결제 내역 고유 식별자
  • customer_id — bigint — 외래 키 → customers.customer_id — NOT NULL — 결제 고객 ID
  • business_id — bigint — 외래 키 → businesses.business_id — 결제 대상 사업자 ID
  • external_payment_id — varchar(200) — 외부 결제 시스템 ID
  • payment_method — varchar(50) — 결제 수단
  • amount — decimal(12, 2) — NOT NULL — 결제 금액
  • payment_date — timestamp — NOT NULL — 결제 일시
  • raw_data — json — 원본 결제 데이터
  • processed_at — timestamp — 데이터 처리 일시

performance_reports

  • report_id — bigint — 기본 키 — NOT NULL — 성과 리포트 고유 식별자
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 사업자 ID
  • report_type — enum('DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY') — NOT NULL — 리포트 주기 유형
  • report_date — date — NOT NULL — 리포트 기준 날짜
  • coupon_issued_count — int — 쿠폰 발급 수
  • coupon_used_count — int — 쿠폰 사용 수
  • coupon_usage_rate — decimal(5, 2) — 쿠폰 사용률
  • total_revenue — decimal(12, 2) — 총 매출액
  • coupon_revenue — decimal(12, 2) — 쿠폰 관련 매출액
  • new_customer_count — int — 신규 고객 수
  • returning_customer_count — int — 재방문 고객 수
  • average_rating — decimal(3, 2) — 평균 평점
  • review_count — int — 리뷰 수
  • partnership_count — int — 제휴 관계 수
  • detailed_data — json — 상세 성과 데이터
  • generated_at — timestamp — 리포트 생성 일시

push_notifications

  • notification_id — bigint — 기본 키 — NOT NULL — 알림 고유 식별자
  • customer_id — bigint — 외래 키 → customers.customer_id — NOT NULL — 알림 수신 고객 ID
  • business_id — bigint — 외래 키 → businesses.business_id — 알림 발송 사업자 ID
  • title — varchar(200) — NOT NULL — 알림 제목
  • message — text — NOT NULL — 알림 메시지
  • notification_type — enum('LOCATION_BASED', 'COUPON', 'PARTNERSHIP', 'MARKETING', 'SYSTEM') — NOT NULL — 알림 유형
  • data — json — 알림 추가 데이터
  • sent_at — timestamp — 알림 발송 일시
  • read_at — timestamp — 알림 읽음 일시
  • clicked_at — timestamp — 알림 클릭 일시
  • status — enum('SENT', 'DELIVERED', 'READ', 'CLICKED', 'FAILED') — 알림 상태

reviews

  • review_id — bigint — 기본 키 — NOT NULL — 리뷰 고유 식별자
  • customer_id — bigint — 외래 키 → customers.customer_id — NOT NULL — 리뷰 작성 고객 ID
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 리뷰 대상 사업자 ID
  • rating — decimal(2, 1) — NOT NULL — 평점 (0-5점)
  • content — text — 리뷰 내용
  • created_at — timestamp — 리뷰 작성 일시
  • status — enum('ACTIVE', 'HIDDEN', 'DELETED') — 리뷰 상태

system_settings

  • setting_id — bigint — 기본 키 — NOT NULL — 설정 고유 식별자
  • setting_key — varchar(100) — NOT NULL — 설정 키
  • setting_value — text — 설정 값
  • description — text — 설정 설명
  • data_type — enum('STRING', 'INTEGER', 'DECIMAL', 'BOOLEAN', 'JSON') — 데이터 타입
  • is_active — tinyint(1) — 설정 활성화 여부
  • created_at — timestamp — 설정 생성 일시
  • updated_at — timestamp — 설정 수정 일시

together_index_logs : 사용안함 (together_index_logs)

  • log_id — bigint — 기본 키 — NOT NULL — 함께지수 로그 고유 식별자
  • business_id — bigint — 외래 키 → businesses.business_id — NOT NULL — 사업자 ID
  • calculation_date — date — NOT NULL — 계산 기준 날짜
  • cross_visit_success_rate — decimal(5, 2) — 교차 방문 성공률
  • coupon_usage_rate — decimal(5, 2) — 쿠폰 사용률
  • revisit_rate — decimal(5, 2) — 재방문율
  • complaint_refund_rate — decimal(5, 2) — 불만/환불 비율
  • response_speed_score — decimal(5, 2) — 응답 속도 점수
  • user_rating_average — decimal(3, 2) — 사용자 평점 평균
  • final_score — decimal(5, 2) — 최종 함께지수 점수
  • calculation_details — json — 계산 상세 내역
  • created_at — timestamp — 로그 생성 일시