열정2팀_최종

테이블 (15)

SNS 게시물 (sns_posts)

  • id — BIGINT — 기본 키 — NOT NULL — 게시물 ID
  • video_output_id — BIGINT — 외래 키 → 완성 영상 산출물.id — NOT NULL — 게시(공유)한 산출물 ID
  • sns_connection_id — BIGINT — 외래 키 → SNS 연동 계정.id — 연결에 사용한 SNS 연동 계정 ID
  • post_platform — VARCHAR(30) — 게시 플랫폼
  • external_post_id — VARCHAR(100) — 플랫폼상의 실제 게시물 ID - 공유(핸드오프) 시점이 아니라, 사장님이 나중에 "이 영상=이 게시물"이라고 연결 확정한 시점에 채워짐(성과 API 조회 키)
  • post_caption — TEXT — 캡션/문구
  • post_hashtags — VARCHAR(500) — 해시태그
  • post_status — VARCHAR(20) — 상태(공유완료·연결대기/연결완료) - 백엔드가 게시 성공여부를 직접 확인할 수 없으므로 "실제 게시물과의 연결 상태"를 의미
  • posted_at — DATETIME — 게시일시(연결된 게시물의 실제 게시 시각)
  • created_at — DATETIME — 레코드 생성일시(공유 버튼을 누른 시각)

SNS 연동 계정 (sns_connections)

  • id — BIGINT — 기본 키 — NOT NULL — 연동 ID
  • user_id — BIGINT — 외래 키 → 사용자(사장님).id — NOT NULL — 사용자 ID
  • sns_platform — VARCHAR(30) — 연동 플랫폼(INSTAGRAM/YOUTUBE/NAVER/TIKTOK)
  • sns_account_name — VARCHAR(100) — 플랫폼상의 계정명(동일 플랫폼 복수 연동 시 구분용)
  • access_token — VARCHAR(500) — 게시물 연결·통계 조회 API 호출용 액세스 토큰
  • refresh_token — VARCHAR(500) — 리프레시 토큰
  • token_expires_at — DATETIME — 토큰 만료일시

가게 (stores)

  • id — BIGINT — 기본 키 — NOT NULL — 가게 ID
  • user_id — BIGINT — 외래 키 → 사용자(사장님).id — NOT NULL — 소유 사용자 ID
  • name — VARCHAR(200) — 상호명
  • category — VARCHAR(100) — 업종
  • sub_category — VARCHAR(100) — 세부 업종
  • address — VARCHAR(255) — 주소
  • latitude — DECIMAL(10, 7) — 위도
  • longitude — DECIMAL(10, 7) — 경도
  • phone — VARCHAR(20) — 전화번호
  • business_hours — VARCHAR(500) — 영업시간/휴무일
  • price_range — VARCHAR(50) — 가격대
  • brand_tone — TEXT — 브랜드 분위기/말투
  • brand_color — VARCHAR(20) — 브랜드 색상
  • logo_url — VARCHAR(255) — 로고 이미지 URL
  • info_source — VARCHAR(50) — 이 정보를 가져온 출처(NAVER/KAKAO/MANUAL 등)
  • external_channel_url — VARCHAR(255) — 네이버플레이스/배달앱 등 외부 채널 URL
  • created_at — DATETIME — 등록일시
  • updated_at — DATETIME — 수정일시

가게 대표 메뉴 (store_menus)

  • id — BIGINT — 기본 키 — NOT NULL — 메뉴 ID
  • store_id — BIGINT — 외래 키 → 가게.id — NOT NULL — 가게 ID
  • name — VARCHAR(200) — 메뉴명
  • price — INT — 가격
  • description — TEXT — 설명
  • image_url — VARCHAR(255) — 메뉴 이미지 URL
  • is_new_menu — BOOLEAN — 신메뉴 여부(추천 우선순위에 사용)
  • is_event_menu — BOOLEAN — 이벤트 메뉴 여부
  • is_sold_out — BOOLEAN — 품절 여부(홍보 소재 제외 판단에 사용)
  • created_at — DATETIME — 등록일시
  • updated_at — DATETIME — 수정일시

가게 리뷰(가져올 수 있는지 모르겠음) (store_reviews)

  • id — BIGINT — 기본 키 — NOT NULL — 리뷰 ID
  • store_id — BIGINT — 외래 키 → 가게.id — NOT NULL — 가게 ID
  • review_source — VARCHAR(50) — 리뷰 출처(수집 범위 준수·중복 판단 근거)
  • review_content — TEXT — 리뷰 원문/정규화 내용
  • review_rating — DECIMAL(2, 1) — 평점
  • written_at — DATETIME — 작성 시각
  • collected_at — DATETIME — 수집 시각

가게 분석 인사이트 (store_insights)

  • id — BIGINT — 기본 키 — NOT NULL — 인사이트 ID
  • store_id — BIGINT — 외래 키 → 가게.id — NOT NULL — 가게 ID
  • insight_type — VARCHAR(30) — 유형(상권분석/리뷰요약/카드뉴스/다음숏폼추천 등)
  • insight_title — VARCHAR(200) — 제목
  • insight_content — TEXT — 분석 내용
  • insight_source — VARCHAR(50) — 근거 출처(외부데이터/AI추론)
  • generated_at — DATETIME — 생성/갱신일시(데이터 신선도 판단에 사용)

가게 사진 (store_photos)

  • id — BIGINT — 기본 키 — NOT NULL — 사진 ID
  • store_id — BIGINT — 외래 키 → 가게.id — NOT NULL — 가게 ID
  • file_url — VARCHAR(255) — 파일 URL
  • photo_category — VARCHAR(50) — 분류(간판/외관/내부/메뉴/과정/인물/기타, 필수 사진 부족 판단에 사용)
  • has_sensitive_info — BOOLEAN — 고객 얼굴 등 민감정보 포함 여부(편집 시 사용 제한 판단)
  • created_at — DATETIME — 등록일시

가게 숏폼 제작 프로젝트 (store_shorts_projects)

  • id — BIGINT — 기본 키 — NOT NULL — 숏폼 프로젝트 ID
  • store_id — BIGINT — 외래 키 → 가게.id — NOT NULL — 가게 ID
  • user_id — BIGINT — 외래 키 → 사용자(사장님).id — NOT NULL — 작성자 사용자 ID
  • video_format_id — BIGINT — 외래 키 → 숏폼 포맷 카탈로그.id — 선택한 포맷 ID
  • store_target_customer_id — BIGINT — 외래 키 → 가게 타깃 고객.id — 선택한 타깃 ID
  • promotion_purpose — VARCHAR(50) — 홍보 목적(메뉴소개/이벤트/가게소개/고객늘리기)
  • promotion_sub_goal — VARCHAR(50) — 세부 목표
  • face_exposure_mode — VARCHAR(20) — 얼굴 노출 모드
  • shooting_condition — TEXT — 촬영 조건(촬영자 유무, 가능 시간 등)
  • shorts_status — VARCHAR(20) — 진행 상태(초안/진행중/완료)
  • created_at — DATETIME — 생성일시
  • updated_at — DATETIME — 수정일시

가게 타깃 고객 (store_target_customers)

  • id — BIGINT — 기본 키 — NOT NULL — 타깃 ID
  • store_id — BIGINT — 외래 키 → 가게.id — NOT NULL — 가게 ID
  • target_type — VARCHAR(20) — 타깃 유형(주/보조/성장)
  • target_description — TEXT — 타깃 설명(생활맥락/구매동기 등)
  • confirm_status — VARCHAR(20) — 사장님 확인 상태(확인/수정/숨김) - 마이페이지에서 지속 재사용
  • ai_confidence — VARCHAR(20) — AI 추론 신뢰도
  • created_at — DATETIME — 생성일시
  • updated_at — DATETIME — 수정일시

게시물 성과 지표 (sns_post_metrics)

  • id — BIGINT — 기본 키 — NOT NULL — 지표 ID
  • sns_post_id — BIGINT — 외래 키 → SNS 게시물.id — NOT NULL — 게시물 ID
  • metric_name — VARCHAR(50) — 지표명(views/likes/comments/shares/saves 등)
  • metric_value — DECIMAL(18, 2) — 지표 값
  • collected_at — DATETIME — 수집 시각(주기적으로 스냅샷을 쌓아 추이 그래프·베스트 게시물 분석에 사용)

사용자(사장님) (users)

  • id — BIGINT — 기본 키 — NOT NULL — 사용자 ID
  • email — VARCHAR(255) — 이메일
  • phone — VARCHAR(20) — 전화번호
  • password_hash — VARCHAR(255) — 비밀번호 해시
  • name — VARCHAR(100) — 이름/닉네임
  • account_status — VARCHAR(20) — 계정 상태(활성/탈퇴 등, 로그인 가능 여부 판단)
  • terms_agreed — BOOLEAN — 이용약관/개인정보 필수 동의 여부
  • marketing_agreed — BOOLEAN — 마케팅 수신 선택 동의 여부
  • agreed_at — DATETIME — 약관 동의 시각
  • created_at — DATETIME — 가입일시
  • updated_at — DATETIME — 수정일시

숏폼 포맷 카탈로그 (video_formats)

  • id — BIGINT — 기본 키 — NOT NULL — 포맷 ID
  • format_title — VARCHAR(200) — 포맷명
  • format_type — VARCHAR(20) — 유형(밈/TTS/잔잔한 소개)
  • reference_url — VARCHAR(255) — 원본 참고 URL(원본 파일은 저장하지 않고 링크만 보관)
  • source_platform — VARCHAR(50) — 원본 플랫폼(임베드 방식 분기에 사용)
  • expected_duration_sec — INT — 예상 촬영/영상 시간(초)
  • shooting_difficulty — VARCHAR(20) — 촬영 난이도
  • face_exposure_level — VARCHAR(20) — 얼굴 노출 요구 수준
  • created_at — DATETIME — 등록일시
  • updated_at — DATETIME — 수정일시' ) COMMENT '숏폼 포맷 카탈로그 - 사용자가 탐색/선택하는 밈·TTS·잔잔한 소개 포맷 목록(원본 영상은 임베드만, 파일 저장 없

스토리보드 장면 (storyboard_scenes)

  • id — BIGINT — 기본 키 — NOT NULL — 장면 ID
  • shorts_project_id — BIGINT — 외래 키 → 가게 숏폼 제작 프로젝트.id — NOT NULL — 숏폼 프로젝트 ID
  • scene_order — INT — 장면 순서
  • scene_description — TEXT — 화면/행동/구도 설명
  • scene_dialogue — TEXT — 대사/TTS 텍스트
  • scene_subtitle — TEXT — 자막 텍스트
  • shot_type — VARCHAR(50) — 샷 유형(촬영 가이드 오버레이 선택에 사용)
  • target_duration_sec — INT — 목표 길이(초)

완성 영상 산출물 (video_outputs)

  • id — BIGINT — 기본 키 — NOT NULL — 산출물 ID
  • shorts_project_id — BIGINT — 외래 키 → 가게 숏폼 제작 프로젝트.id — NOT NULL — 숏폼 프로젝트 ID
  • edit_recipe — TEXT — 편집 레시피(JSON) - 이 산출물을 만든 편집 명령
  • video_url — VARCHAR(255) — 결과 영상 파일 URL
  • cover_image_url — VARCHAR(255) — 커버 이미지 URL
  • target_platform — VARCHAR(50) — 대상 플랫폼/출력 규격(프로젝트당 여러 플랫폼별 산출물 존재)
  • resolution — VARCHAR(20) — 해상도
  • has_licensed_audio — BOOLEAN — 상업 안전 음원 포함 여부
  • render_status — VARCHAR(20) — 상태(대기/처리중/완료/실패)
  • created_at — DATETIME — 생성일시(수정 요청마다 새 행이 쌓여 자연스럽게 버전 이력이 됨)
  • updated_at — DATETIME — 수정일시

촬영 택스트 (shooting_tasks)

  • id — BIGINT — 기본 키 — NOT NULL — 태스크 ID
  • shorts_project_id — BIGINT — 외래 키 → 가게 숏폼 제작 프로젝트.id — NOT NULL — 숏폼 프로젝트 ID
  • scene_id — BIGINT — 외래 키 → 스토리보드 장면.id — 연결된 콘티 장면 ID
  • task_type — VARCHAR(50) — 태스크 유형(영상촬영/대사/B-roll 등)
  • task_title — VARCHAR(200) — 태스크명
  • task_status — VARCHAR(20) — 진행 상태(완료/진행중/미완료/재촬영 필요)
  • display_order — INT — 태스크 보드 노출 순서
  • footage_url — VARCHAR(255) — 촬영본 파일 URL(재촬영 시 덮어씀, 테이크 이력 없음)
  • footage_type — VARCHAR(20) — 촬영본 파일 유형(VIDEO/IMAGE/AUDIO)
  • footage_duration_sec — INT — 촬영본 길이(초)
  • ai_eval_score — DECIMAL(5, 2) — AI 평가 점수(현재 촬영본 기준, 참고값)
  • ai_is_usable — BOOLEAN — 현재 촬영본의 편집 사용 가능 여부
  • ai_eval_issues — TEXT — AI가 발견한 문제점/개선 제안
  • ai_evaluated_at — DATETIME — AI 평가 수행 시각
  • updated_at — DATETIME — 상태/촬영본 최종 변경일시