열정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 — 상태/촬영본 최종 변경일시