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 — 해당 작업이 완료된 시간