Shortsgenerator - ERD

테이블 (18)

User

  • id (user_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 사용자 이메일 (email) — varchar(255) — NOT NULL — 사용자 이메일, 소셜 로그인시 사용된 이메일
  • 비밀번호 (password) — varchar(60) — 사용자 비밀번호, 소셜 로그인 사용시 해당 없음? 아니면 회원가입 강제
  • 이름(닉네임) (name) — varchar(40) — NOT NULL — 사용자 닉네임, 소셜 로그인 사용시 등록된 이름
  • 회원가입 날짜 (created_at) — datetime — NOT NULL — 회원가입 날짜
  • 정보수정 날짜 (updated_at) — datetime — 개인정보 수정시 등록되는 날짜
  • 사용자에게 할당된 스토리지 id (user_storage_id) — varchar(255) — 클라우드 저장소 내 사용자에게 할당된 저장 공간명
  • 소셜 로그인 제공자 서비스 이름 (provider) — varchar(20) — 소셜 로그인을 제공하는 서비스 기업 이름 (구글, 네이버 등)
  • 소셜 로그인 제공자 id (provider_id) — varchar(100) — 소셜 로그인 제공자 id

결제 주문 (Orders)

  • id — int — 기본 키 — NOT NULL — Auto Increment, PK
  • 토스에 보낸 주문 번호 (order_id) — varchar(30) — 기본 키 — NOT NULL — 토스에 보낸 주문번호, unique key
  • id (user_id) — int — 외래 키 → User.id — NOT NULL — Auto Increment
  • id (product_id) — int — 외래 키 → 서비스에서 구매할 수 있는 상품 종류.id — NOT NULL — Auto Increment
  • 주문명 (order_name) — varchar(50) — NOT NULL — 주문명(ex 크레딧 100개), 결제 생성시 필수파라미터
  • 최초 결제 요청금액 (amount) — int — NOT NULL — 결제 요청시 요청한 금액, product와 비교해서 유효성 검증 필요
  • 주문 상태 (status) — enum string — NOT NULL — PENDIG, PAID, CANCELED 중 하나로, 결제 상태와 별개로 크레딧 지급 여부 확인에 필요?하지 않을까
  • 요청 날짜 (created_at) — datetime — NOT NULL — 주문 요청 날짜

사용자별 현재 잔액 크레딧 (Credits)

  • id (credit_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (user_id) — int — 외래 키 → User.id — NOT NULL — Auto Increment
  • 크레딧 잔액 (balance) — int — NOT NULL — 사용자가 보유한 크레딧(정수값)
  • 수정된 날짜 (updated_at) — NOT NULL — 크레딧 값이 변경된 날짜

서비스에서 구매할 수 있는 상품 종류 (Products)

  • id (product_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 상품명 (name) — varchar(30) — NOT NULL — 구매할 수 있는 크레딧 상품명
  • 크레딧 가격 (credit_amount) — int — NOT NULL — 해당 상품을 구매할 시 제공하는 크레딧 가격 (ex 1_000 크레딧) 또는 크레딧으로 구매할 수 있는 가격
  • 원화 가격 (cash_amount) — int — NOT NULL — 해당 상품 구매시 필요한 원화 가격
  • 업데이트 날짜 (updated_at) — datetime — 상품 정보 수정할 시 업데이트된 날짜

쇼츠 영상 생성 작업 (Job)

  • id (job_id) — varchar(255) — 기본 키 — NOT NULL — UUID
  • id (user_id) — int — 외래 키 → User.id — NOT NULL — Auto Increment
  • 사용자가 요청시 입력한 소스 (source) — text — NOT NULL — 영상 생성 소스
  • 작업 시작 시간 (created_at) — datetime — NOT NULL — 요청을 받아 작업 생성 시작 시간

영상 생성 작업에 필요한 하위 업무 (Task)

  • id (task_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (job_id) — varchar(255) — 외래 키 → 쇼츠 영상 생성 작업.id — NOT NULL — UUID
  • Task 유형 (type) — varchar(255) — NOT NULL — 제목, 대본, 음성, 이미지 중 하나
  • 작업 상태 (status) — varchar(255) — NOT NULL — PENDING, PROCESSING, COMPLETED, FAIL

영상 주제 추천 (Topic)

  • id (topic_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 실시간 트렌드 항목 (trend) — varchar(255) — NOT NULL — Google Trends 실시간 트렌드 상위 5개 항목 중 하나
  • 추천된 주제 (sub_idea) — varchar(255) — NOT NULL — gpt api 호출로 생성된 추천 주제
  • 매력도 (score) — int — 관심을 가질 수 있을 정도(수치)

영상 편집 프로젝트 (Project)

  • id (project_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (user_id) — int — 외래 키 → User.id — NOT NULL — Auto Increment
  • 메타데이터 저장 경로 (metadata_path) — varchar(255) — NOT NULL — 클라우드에 저장된 프로젝트 메타데이터 json 파일 경로
  • 썸네일 이미지 (thumbnail_image) — varchar(255) — 프로젝트 리스트에 표시될 썸네일 이미지 경로, 클라우드에 저장된 경로
  • 렌더링된 영상의 저장 경로 (render_video_path) — varchar(255) — 렌더링 완료된 영상의 저장 경로
  • 스토리지 내부 프로젝트 저장 공간 id (project_strorage_id) — varchar(255) — 사용자에게 할당된 스토리지 내 프로젝트 저장 공간명

이미지 생성 요청 (Generation_Requests)

  • id (gen_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 토스에 보낸 주문 번호 (order_id) — varchar(64) — 기본 키 — 토스에 보낸 주문 번호, unique key
  • id (maker_id) — int — 외래 키 → 이미지 컨셉.id — NOT NULL — Auto Increment
  • 사용자 id(회원인 경우) (user_id) — int — 회원이 요청한 경우에 대한 user_id
  • 이메일 (email) — varchar(100) — NOT NULL — 결과물 발송할 이메일
  • 결제 타입 (pay_type) — varchar(30) — NOT NULL — CASH, CREDIT 중 하나
  • 처리 상태 (status) — varchar(30) — NOT NULL — PENDING_PAYMENT, PAID, PROCESSING, GENERATED, DELIVERED, FAILED
  • 결제 금액 (cash_amount) — int — 현금 결제를 사용한 경우 결제 금액
  • 크레딧 금액 (credit_amount) — int — 크레딧 결제를 사용한 경우 크레딧 가격
  • 생성에 사용한 모델 (model) — varchar(100) — NOT NULL — 이미지 생성에 사용한 모델명
  • 프롬프트 (prompt) — text — NOT NULL — 이미지 생성에 사용한 프롬프트
  • 요청 날짜 (request_at) — datetime — NOT NULL
  • 생성 완료 날짜 (finished_at) — datetime — 생성 완료 시간 혹은 생성 실패 시간
  • 이메일 발송 날짜 (delivered_at) — datetime — 이메일 발송한 날짜

이미지 컨셉 (Makers)

  • id (maker_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (category_id) — int — 외래 키 → 이미지 컨셉 그룹.id — NOT NULL — Auto Increment
  • id (product_id) — int — 외래 키 → 서비스에서 구매할 수 있는 상품 종류.id — NOT NULL — Auto Increment
  • 컨셉 제목 (title) — varchar(100) — NOT NULL — 컨셉 제목(귀멸의 칼날 캐릭터 변환 등)
  • 컨셉 상세 설명 (description) — text — NOT NULL — 해당 컨셉에 대한 상세 설명
  • 출력물 개수 (output_count) — int — NOT NULL — 생성할 이미지 개수(컨셉마다 상이)
  • 프롬프트 (prompt) — text — NOT NULL — 이미지 생성에 필요한 프롬프트
  • 썸네일 이미지 (thumbnail_url) — varchar(255) — NOT NULL — 해당 컨셉에 표시될 썸네일 이미지 저장 경로(클라우드)
  • 예시 이미지 (image_url) — varchar(255) — NOT NULL — 상세 페이지에 표시될 예시 이미지
  • 생성 날짜 (created_at) — datetime — NOT NULL
  • 업데이트 날짜 (updated_at) — datetime

이미지 컨셉 그룹 (Maker_Categories)

  • id (category_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 컨셉 이름 (name) — varchar(100) — NOT NULL — 컨셉 그룹 이름(애니메이션, 화풍 변경 등)
  • 생성 날짜 (created_at) — datetime — NOT NULL
  • 업데이트 날짜 (updated_at) — datetime

컨셉 - 태그 조인 테이블 (Maker_Tags)

  • id — int — 기본 키 — NOT NULL — Auto Increment
  • id (tag_id) — int — 외래 키 → 태그.id — NOT NULL — Auto Increment
  • id (maker_id) — int — 외래 키 → 이미지 컨셉.id — NOT NULL — Auto Increment
  • 우선순위 (priority) — int — NOT NULL — 특정 컨셉의 태그 우선순위, 낮을수록 먼저
  • — unique(tag_id, maker_id)

컨셉 좋아요(회원만 가능) (Maker_Likes)

  • id (like_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (user_id) — int — 외래 키 → User.id — NOT NULL — Auto Increment
  • id (maker_id) — int — 외래 키 → 이미지 컨셉.id — NOT NULL — Auto Increment
  • 좋아요 표시 날짜 (created_at) — datetime — NOT NULL
  • — unique(maker_id, user_id)

크레딧 사용 내역(원장, 충전 or 차감) (Credit_Ledgers)

  • id (ledger_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (user_id) — int — 외래 키 → User.id — NOT NULL — Auto Increment
  • 유형 (type) — enum string — NOT NULL — CHARGE(충전), CONSUME(사용), REVOKE(취소) 중 하나
  • 반영된 가격 (amount) — int — NOT NULL — 가감은 type 으로 구분하도록 하고, 양수값으로 저장
  • 사용 내역 근거 (reason) — enum string — NOT NULL — 해당 사용 내역이 발생한 원인으로, 충전, 사용, 회수 등의 원인 상세 (CHARGE_PURCHASE, CONSUME_VIDEO, CONSUME_CLOUD...)
  • 발생한 날짜 (created_at) — datetime — NOT NULL — 해당 사용 내역이 발생한 날짜

태그 (Tags)

  • id (tag_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 태그명 (name) — varchar(50) — NOT NULL — 태그 이름(일러스트, 귀칼, ...)
  • 생성 날짜 (created_at) — datetime — NOT NULL
  • 업데이트 날짜 (updated_at) — datetime

토스페이먼츠 결제 취소 (Payments_Cancels)

  • id (cancel_id) — int — 기본 키 — NOT NULL — Auto Increment
  • 페이먼트 키 (payment_key) — varchar(200) — 외래 키 → 토스페이먼츠 응답 정보.페이먼트 키 — NOT NULL — unique key, 결제 식별키, 조회 취소 승인에 모두 사용되며 저장하도록 명시됨
  • 취소 상태 (status) — varchar(10) — NOT NULL — 취서 상태, DONE 이면 성공적 취소
  • 취소 트랜잭션 식별자 (transaction_key) — varchar(64) — NOT NULL — 취소 건의 키값, Payment 응답에 포함, 멱등성, 중복 방지
  • 실제 취소된 금액 (cancle_amount) — int — NOT NULL — 결제 취소한 금액
  • 환불 가능 잔액 (refundable_amount) — int — NOT NULL — 결제 취소 후 환불 가능한 잔액
  • 결제 취소 이유 (cancel_reason) — varchar(200) — NOT NULL — 결제 취소한 이유, 최대 200자
  • 취소 날짜 (cancled_at) — datetime — NOT NULL — 결제 취소가 일어난 날짜와 시간 정보, UTC

토스페이먼츠 응답 정보 (Payments)

  • id — int — 기본 키 — NOT NULL — Auth Increment
  • 페이먼트 키 (payment_key) — varchar(200) — 기본 키 — NOT NULL — unique key, 결제 식별키, 조회 취소 승인에 모두 사용되며 저장하도록 명시됨
  • 토스에 보낸 주문 번호 (order_id) — varchar(30) — 외래 키 → 결제 주문.토스에 보낸 주문 번호 — NOT NULL — 토스에 보낸 주문번호, unique key
  • 결제 상태 (status) — enum string — NOT NULL — READY, IN_PROGRESS... API 문서에 정의된 값
  • 총 결제 금액 (total_amount) — int — NOT NULL — 결제 상태가 변해도 최초에 결제된 결제 금액으로 유지
  • 취소 가능 잔액 (balance_amount) — int — NOT NULL — 취소할 수 있는 금액(잔고), 결제 취소나 부분 취소가 되고 나서 남은 값
  • 결제 수단 (method) — string — 카드, 가상계좌, 간편결제... API 문서에 정의된 값
  • 통화 (currency) — varchar(10) — NOT NULL
  • 마지막 거래의 키값 (last_transaction_key) — string — 한 결제 건의 승인 거래와 취소 거래를 구분하는 데 사용
  • 소비자 인증수단 (customer_identity_number) — varchar(50) — NOT NULL — 추후에 현금영수증 발급요청시 요청 파라미터에 필요
  • 결제 날짜 (reqeust_at) — datetime — NOT NULL — 결제가 일어난 날짜와 시간 정보, UTC
  • 결제 승인 날짜 (approved_at) — datetime — 결제 승인이 일어난 날짜와 시간 정보, UTC

하위 업무 수행 결과 (Task_Result)

  • id (sub_task_id) — int — 기본 키 — NOT NULL — Auto Increment
  • id (task_id) — int — 외래 키 → 영상 생성 작업에 필요한 하위 업무.id — NOT NULL — Auto Increment
  • 작업 종류 (result_type) — varchar(20) — NOT NULL — TITLE, SCENARIO, IMAGE_PROMPT, VOICE, IMAGE 중 하나
  • 시나리오 - 이미지 간 쌍을 맞추기 위한 시퀀스 (sequence) — int — 시나리오 와 이미지는 서로 다른 행으로 저장되어야 하는데, 한 쌍을 구분하기 위한 필드
  • 작업으로 생성된 결과물 (result) — Text — 작업 결과물이며 오디오와 이미지의 경우 저장 경로가 저장됨
  • 작업 완료 시간 (completed_at) — datetime — 해당 작업이 완료된 시간