mocae
Tables (20)
character_image
- character_image_id — BIGINT — Primary key — NOT NULL — 이미지 기록 고유 번호, PK / 1부터 자동 증가 / 물리 타입·NULL 표시는 초안
- character_id — BIGINT — Foreign key → project_character.character_id — NOT NULL — 소속 캐릭터 번호, FK / 프로젝트 캐릭터의 character_id를 참조. project_id·user_id는 중복 저장하지 않음 / 물리 타입·NULL 표시는 초안
- direction — VARCHAR(64) — NOT NULL — 이미지의 방향 / FRONT(정면), SIDE(옆면), BACK(후면) / 물리 타입·NULL 표시는 초안
- file_key — VARCHAR(2048) — NOT NULL — 저장된 이미지 파일의 위치 식별자 / 파일 자체나 만료되는 다운로드 URL 대신 저장소 내 파일 키를 기록. 저장소 종류·키 형식은 후속 / 물리 타입·NULL 표시는 초안
- source_type — VARCHAR(64) — NOT NULL — 이 프로젝트에 이미지가 들어온 방식 / UPLOAD(업로드), AI_GENERATED(AI 생성), PROJECT_COPY(다른 프로젝트에서 가져오기). 원본의 전체 출처 이력을 대신하는 값은 아님 / 물리 타입·…
- is_selected — TINYINT(1) — NOT NULL — 해당 방향의 현재 기준 이미지인지 / 같은 캐릭터·방향에서 최대 한 장 선택. 준비 중에는 선택된 이미지가 없을 수 있음 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 이 이미지 기록을 만든 시각 / 파일을 등록하거나 생성 결과를 저장하거나 가져와 새 기록을 만든 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 이 이미지 기록을 마지막으로 수정한 시각 / 선택 상태 등 이 행의 정보가 변경된 시각. 단순 조회로 변경하지 않음 / 물리 타입·NULL 표시는 초안
- confirmed_at — DATETIME — 현재 선택한 방향 이미지를 사용 기준으로 확정한 시각 / NULL이면 미확정. 현재 선택된 이미지에서만 유효. 후보 변경·정면 교체 시 아래 확정 해제 규칙 적용. 별도 is_confirmed 없음 / 물리 타입·…
credit_entry
- credit_entry_id — BIGINT — Primary key — NOT NULL — 크레딧 내역 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- user_id — BIGINT — Foreign key → user.user_id — NOT NULL — 크레딧 소유 회원 / 모든 내역에 저장. 해당 회원·결제·실행 소속 일치 검사 / 물리 타입·NULL 표시는 초안
- payment_id — BIGINT — Foreign key → payment.payment_id — NOT NULL — 이 크레딧 지급의 근거 결제 번호 / 지급·예약·차감·해제·소멸 모두 원래 지급 근거 결제 번호 사용. 결제.payment_id 명칭 확정(DEC-141) / 물리 타입·NULL 표시는 초안
- generation_run_id — BIGINT — Foreign key → generation_run.generation_run_id — 예약·정산을 구분하는 AI 실행 번호 / 예약·차감·예약 해제에 저장. 지급·일반 잔여 소멸에는 NULL / 물리 타입·NULL 표시는 초안
- entry_type — VARCHAR(64) — NOT NULL — 변경 종류 / 지급·예약·차감·예약 해제·소멸. 영문 코드 후속 / 물리 타입·NULL 표시는 초안
- amount — BIGINT — NOT NULL — 이번 처리의 크레딧 수량 / 양수. 잔액 변화 방향은 종류·원래 유효기간에 따라 결정 / 물리 타입·NULL 표시는 초안
- valid_from — DATETIME — 지급분의 사용 시작 시각 / 지급 행에만 저장. 다른 내역은 같은 payment_id의 지급 행에서 확인 / 물리 타입·NULL 표시는 초안
- expires_at — DATETIME — 지급분의 사용 종료 시각 / 지급 행에만 저장. 종료 시각부터 새 사용 불가. 기간 경계의 동시 처리 구현 후속 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 내역 발생 시각 / 모든 내역에 저장. 반영된 행의 종류·수량을 바꾸지 않고 새 사건은 새 행으로 기록 / 물리 타입·NULL 표시는 초안
generation_item
- generation_item_id — BIGINT — Primary key — NOT NULL — 이미지별 생성 항목 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- generation_job_id — BIGINT — Foreign key → generation_job.generation_job_id — NOT NULL — 소속 생성 요청 / 생성 작업.generation_job_id FK / 물리 타입·NULL 표시는 초안
- target_type — VARCHAR(64) — NOT NULL — 생성 대상 종류 / 캐릭터·동작·공유배너(DEC-136). CHARACTER·MOTION·SHARE_BANNER는 코드 예시 / 물리 타입·NULL 표시는 초안
- target_id — BIGINT — NOT NULL — 해당 대상의 PK / 타입에 따라 character_id·motion_id·share_banner_id 참조. 서버에서 실제 존재·프로젝트 소속 검사. 단일 일반 FK가 아님(DEC-136) / CHARACTER→…
- direction — VARCHAR(64) — 캐릭터의 요청 생성 방향 / 정면·옆면·후면. 다른 대상은 NULL. 성공 시 결과 캐릭터 이미지의 방향과 일치해야 함(DEC-136) / 물리 타입·NULL 표시는 초안
- sort_order — INT — NOT NULL — 묶음 안의 항목 순서 / 표시 순서. 동작·방향의 식별자를 대신하지 않음 / 물리 타입·NULL 표시는 초안
- item_status — VARCHAR(64) — NOT NULL — 해당 항목의 상태 / 대기·생성 중·성공·실패. 결과 불명확을 실패로 단정하지 않음. 영문 코드 후속 / 물리 타입·NULL 표시는 초안
- generated_at — DATETIME — 해당 이미지의 생성 성공 시각 / 성공 전 NULL. 묶음 전체 성공 시각과 구분 / 물리 타입·NULL 표시는 초안
- result_image_type — VARCHAR(64) — 결과가 저장된 이미지 테이블의 종류 / CHARACTER_IMAGE·PROJECT_IMAGE·SHARE_BACKGROUND는 코드 예시. 실제 저장 테이블을 결정 / 물리 타입·NULL 표시는 초안
- result_image_id — BIGINT — 해당 결과 테이블의 이미지 PK / result_image_type과 함께 해석. 여러 테이블을 참조하므로 단일 일반 FK를 선언하는 컬럼이 아님 / CHARACTER_IMAGE→character_image.cha…
- created_at — DATETIME — NOT NULL — 항목 기록 생성 시각 / 실제 실행 시작 시각과 구분 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 항목 기록 수정 시각 / 상세 갱신 범위 후속 / 물리 타입·NULL 표시는 초안
generation_job
- generation_job_id — BIGINT — Primary key — NOT NULL — 생성 요청 묶음 번호 / 1부터 자동 증가 PK. 물리 정수 타입 후속 / 물리 타입·NULL 표시는 초안
- project_id — BIGINT — Foreign key → project.project_id — NOT NULL — 소속 프로젝트 / 프로젝트.project_id FK. 소유 회원은 프로젝트에서 확인 / 물리 타입·NULL 표시는 초안
- job_type — VARCHAR(64) — NOT NULL — 생성 요청의 종류 / 캐릭터 방향 이미지·이모티콘 최초 생성·재생성·공유배너 배경 등. 세부 코드 후속. 무료/유료는 usage_type으로 구분 / 물리 타입·NULL 표시는 초안
- usage_type — VARCHAR(64) — NOT NULL — 요청 당시 적용한 이용 구분 / 무료 체험·무료 재생성·유료(DEC-154). 서버가 자격 검사 후 결정하며 같은 작업의 실패 재시도에서도 유지. FREE_TRIAL·FREE_REGENERATION·PAID는 코드…
- input_snapshot — JSON — NOT NULL — 요청 당시 생성 입력 사본 / JSON. 컨셉·동작·디자인 설명·참조 이미지 등. 생성 시작 후 변경하지 않으며 실패 재시도에도 유지. 생성 입력만 보관하며 과금 구분·수량은 중복 저장하지 않음(DEC-154).…
- generation_status — VARCHAR(64) — NOT NULL — 요청 묶음의 이미지 생성 상태 / 대기·생성 중·일부 실패·전체 실패·생성 완료(DEC-134). 영문 코드·타입 후속 / 물리 타입·NULL 표시는 초안
- generated_at — DATETIME — 묶음의 이미지 생성이 모두 성공한 시각 / 전체 성공 전 NULL. 실패 항목까지 모두 성공한 시각 기록(DEC-134) / 물리 타입·NULL 표시는 초안
- published_at — DATETIME — 해당 묶음 결과를 공개한 시각 / 정산·해당 종류의 공개 조건 충족 전 NULL. 무료 작업은 차감 없이 해당 조건 검사(DEC-134) / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 요청 기록 생성 시각 / 실제 실행 시작·완료 시각과 구분. 타입·기본값 후속 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 요청 기록 마지막 수정 시각 / 상태 등 작업 기록 변경 시 갱신. 하위 항목·실행 변경 시 갱신 범위 후속 / 물리 타입·NULL 표시는 초안
generation_run
- generation_run_id — BIGINT — Primary key — NOT NULL — 실행 이력 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- generation_job_id — BIGINT — Foreign key → generation_job.generation_job_id — NOT NULL — 소속 생성 작업 / 생성 작업.generation_job_id FK / 물리 타입·NULL 표시는 초안
- attempt_no — INT — NOT NULL — 같은 작업 안의 실행 순번 / 최초 실행 1, 첫 재시도 2. 같은 작업 안에서 중복 불가. 사용자 연속 클릭을 각각 새 시도로 세지 않음 / 물리 타입·NULL 표시는 초안
- run_status — VARCHAR(64) — NOT NULL — 이번 실행 자체의 상태 / 대기·실행 중·결과 확인 중·성공·일부 실패·전체 실패. 영문 코드·물리 제약 후속 / 물리 타입·NULL 표시는 초안
- started_at — DATETIME — 이번 실행의 실제 시작 시각 / 시작 전 NULL. 개별 외부 AI API 호출의 시각과 구분 / 물리 타입·NULL 표시는 초안
- finished_at — DATETIME — 이번 실행의 종료가 확인된 시각 / 대기·실행 중·결과 확인 중에는 NULL. 이번 실행 대상의 결과가 확인돼 종료될 때 기록. 정산 완료·결과 공개 시각과 구분 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 실행 기록 생성 시각 / 실제 실행 시작과 구분 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 실행 기록 수정 시각 / 상태·결과 확인에 따른 갱신. 상세 범위 후속 / 물리 타입·NULL 표시는 초안
generation_run_item
- generation_run_item_id — BIGINT — Primary key — NOT NULL — 실행별 항목 이력 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- generation_run_id — BIGINT — Foreign key → generation_run.generation_run_id — NOT NULL — 어떤 실행인지 / 생성 실행 이력.generation_run_id FK / 물리 타입·NULL 표시는 초안
- generation_item_id — BIGINT — Foreign key → generation_item.generation_item_id — NOT NULL — 어떤 이미지 항목인지 / 생성 작업 항목.generation_item_id FK. 실행과 항목의 소속 작업이 같아야 함 / 물리 타입·NULL 표시는 초안
- item_status — VARCHAR(64) — NOT NULL — 이번 실행에서 이 항목의 상태 / 대기·실행 중·결과 확인 중·성공·실패. 영문 코드 후속 / 물리 타입·NULL 표시는 초안
- result_image_type — VARCHAR(64) — 이번 실행이 만든 결과의 종류 / 기존 타입+ID 방식. 결과가 없으면 NULL / 물리 타입·NULL 표시는 초안
- result_image_id — BIGINT — 이번 실행이 만든 결과 이미지 PK / 타입에 따른 실제 테이블 참조. 일반 FK 아님. 결과가 없으면 NULL / CHARACTER_IMAGE→character_image.character_image_id; PR…
- error_message — TEXT — 이번 실행에서 확인된 항목 실패 사유 / 정상·미확인에는 실패 사유를 지어내지 않음. 보관 문구·길이·사용자 노출 정책 후속 / 물리 타입·NULL 표시는 초안
- started_at — DATETIME — 이번 실행에서 항목 처리를 시작한 시각 / 시작 전 NULL / 물리 타입·NULL 표시는 초안
- finished_at — DATETIME — 이번 항목 처리의 종료 확인 시각 / 실행 중·결과 확인 중에는 NULL. 성공·실패 확인 후 기록 / 물리 타입·NULL 표시는 초안
outline_item
- outline_item_id — BIGINT — Primary key — NOT NULL — 항목 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- post_process_id — BIGINT — Foreign key → post_process.post_process_id — NOT NULL — 소속 흰테두리 작업본 / 후작업.post_process_id FK / 물리 타입·NULL 표시는 초안
- project_image_id — BIGINT — Foreign key → project_image.project_image_id — NOT NULL — 사용할 원본 / 같은 프로젝트의 이용 가능한 프로젝트 이미지.project_image_id FK. 같은 post_process_id 안에서 동일 원본 중복 추가 금지(DEC-153) / 물리 타입·NULL 표시는…
- result_file_key — VARCHAR(2048) — 마지막으로 성공한 가공 결과 파일 / 실제 결과 없으면 NULL. 설정 변경·재처리 실패에도 기존 성공 파일은 보존하되 파일 존재만으로 현재 설정의 완료 결과로 판단하지 않음(DEC-128) / 물리 타입·NULL…
- process_status — VARCHAR(64) — NOT NULL — 현재 원본·설정에 대한 이미지별 처리 상태 / 처리 필요·처리 중·완료·실패. 부분 실패 시 성공 항목은 이용하고 실패 항목만 사용자 재시도(DEC-128). 영문 코드·타입·물리 제약 후속 / 물리 타입·NULL…
- sort_order — INT — NOT NULL — 표시 순서 / 작업본 안의 순서 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 항목 생성 시각 / 원본을 대상으로 등록한 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 항목 수정 시각 / 항목을 마지막으로 갱신한 시각 / 물리 타입·NULL 표시는 초안
payment
- payment_id — BIGINT — Primary key — NOT NULL — 결제 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- subscription_link_id — BIGINT — Foreign key → subscription_link.subscription_link_id — NOT NULL — 가입별 결제 연결 번호 / 구독 결제 연결.subscription_link_id 참조. 연결→구독→회원으로 소유자 확인 / 물리 타입·NULL 표시는 초안
- product_code — VARCHAR(64) — NOT NULL — 결제 당시 상품 코드 / 가입 연결의 구독 상품 코드 보존. 그로블 상품·옵션은 해당 상품과 대조(DEC-145) / 물리 타입·NULL 표시는 초안
- amount — DECIMAL(12, 2) — NOT NULL — 청구 금액 / 현재 상품 기준 9,900원. 성공 건은 실제 결제액, 실패 건은 청구 시도 금액. 가격 재검토는 별도 / 물리 타입·NULL 표시는 초안
- currency — CHAR(3) — NOT NULL — 결제 통화 / 현재 KRW / 물리 타입·NULL 표시는 초안
- payment_status — VARCHAR(64) — NOT NULL — 이번 청구의 상태 / 대기·진행 중·결과 확인 중·성공·실패. 영문 코드·취소·환불은 후속 / 물리 타입·NULL 표시는 초안
- provider — VARCHAR(64) — NOT NULL — 결제 서비스 / GROBLE. 가입별 연결의 provider와 일치 검사 / 물리 타입·NULL 표시는 초안
- provider_payment_id — VARCHAR(255) — NOT NULL — 제공자의 거래 번호 / 확인된 그로블 merchantUid 연결. provider와 함께 개별 청구 식별·중복 검사. 실거래 확인 전 임의 번호 생성 금지(DEC-151) / 물리 타입·NULL 표시는 초안
- paid_at — DATETIME — 검증된 결제 성공 시각 / 성공 전 NULL. 통지 수신 시각과 구분 / 물리 타입·NULL 표시는 초안
- failure_reason — TEXT — 확인된 실패 사유 / 실패 확정 때 저장. 결과 불명확을 실패로 기록하지 않음. 저장·노출 범위 후속 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 내부 결제 기록 생성 시각 / 결제창 진입 시각과 구분. 검증된 외부 거래 번호와 실제 청구 사실을 확인해 최초 기록(DEC-151) / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 상태·승인 정보 변경 시각 / 같은 청구의 결과 확인 시 갱신 / 물리 타입·NULL 표시는 초안
payment_event
- payment_event_id — BIGINT — Primary key — NOT NULL — 모캐 내부 이벤트 기록 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- provider — VARCHAR(64) — NOT NULL — 통지를 보낸 결제 서비스 / 현재 GROBLE / 물리 타입·NULL 표시는 초안
- provider_event_id — VARCHAR(255) — 제공자가 보낸 이벤트 번호 / 본문 id. 내부 PK와 구분하고 원문 문자열 보존 / 물리 타입·NULL 표시는 초안
- idempotency_key — VARCHAR(255) — NOT NULL — 같은 통지의 중복 처리 식별값 / X-Groble-Idempotency-Key. 현재 연결 판매자 계정 범위에서 provider와 함께 중복 검사 / 물리 타입·NULL 표시는 초안
- event_type — VARCHAR(64) — NOT NULL — 통지 종류 / 결제 완료·갱신 실패·해지·환불 등 제공자 이벤트 이름 보존 / 물리 타입·NULL 표시는 초안
- event_data — JSON — NOT NULL — 검증한 통지의 업무 처리 데이터 / JSON. 거래·참조·상품·금액·구독·실패·환불 정보 및 스키마 버전 등 필요한 내용 보존. 상세 키·보존 범위 후속 / 물리 타입·NULL 표시는 초안
- occurred_at — DATETIME — 사건이 실제 발생한 시각 / 제공자의 occurredAt. 단독으로 모든 최신 상태를 판정하지 않음 / 물리 타입·NULL 표시는 초안
- received_at — DATETIME — NOT NULL — 모캐가 처음 수신한 시각 / 재전송 때 최초 시각을 덮어쓰지 않음 / 물리 타입·NULL 표시는 초안
- process_status — VARCHAR(64) — NOT NULL — 모캐의 이벤트 반영 상태 / 수신·처리 중·완료·확인 필요·처리 실패. 결제 성공/실패와 별개 / 물리 타입·NULL 표시는 초안
- processed_at — DATETIME — 업무 반영이 완료된 시각 / 미완료면 NULL. 정책에 따른 반영 불필요 판정도 근거를 보존하고 완료 가능 / 물리 타입·NULL 표시는 초안
- error_message — TEXT — 처리 오류·확인 필요 사유 / 예: 연결할 회원 없음, 먼저 와야 할 거래 기록 없음. 결제 실패 사유와 구분 / 물리 타입·NULL 표시는 초안
post_process
- post_process_id — BIGINT — Primary key — NOT NULL — 후작업 기록의 고유 번호 / 1부터 자동 증가 / 물리 타입·NULL 표시는 초안
- project_id — BIGINT — Foreign key → project.project_id — NOT NULL — 소속 프로젝트 번호 / 기존 제작 후작업은 같은 프로젝트에서 이어감 / 물리 타입·NULL 표시는 초안
- work_type — VARCHAR(64) — NOT NULL — 후작업 종류 / 흰테두리·공유배너. WHITE_OUTLINE·SHARE_IMAGE는 코드 예시 / 물리 타입·NULL 표시는 초안
- settings — JSON — 종류별 현재 설정 / JSON. 흰테두리 두께 또는 배너 제목의 글꼴·크기·위치와 캐릭터 배치. 제목 원문·분위기는 공유배너 제작정보에 저장. 파일 목록·실행 상태는 제외 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 작업본 기록 생성 시각 / 현재 종류의 작업본을 처음 만든 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 작업본 기록 마지막 수정 시각 / 설정 등 이 기록을 마지막으로 수정한 시각 / 물리 타입·NULL 표시는 초안
project
- project_id — BIGINT — Primary key — NOT NULL — 프로젝트 식별자. 각 테이블에서 1부터 자동 증가하는 정수 PK / DEC-068·087·088, 정수 크기·DB 문법은 후속 / 물리 타입·NULL 표시는 초안
- user_id — BIGINT — Foreign key → user.user_id — NOT NULL — 소유 회원의 user_id를 참조하는 FK / DEC-038·087·088·089 / 물리 타입·NULL 표시는 초안
- name — VARCHAR(255) — NOT NULL — 프로젝트 이름 / 같은 회원의 미삭제 프로젝트 사이에서 중복 불가. 영문 대소문자 구분, 앞뒤 공백 제거·내부 공백 유지. 삭제된 이름 재사용 가능(DEC-078~080·082·088) / 물리 타입·NULL 표시…
- project_type — VARCHAR(64) — NOT NULL — 이모티콘·인스타툰 등 콘텐츠 종류 / DEC-031·094, EMOTICON·INSTATOON. 인스타툰 제공은 준비 중 유지 / 물리 타입·NULL 표시는 초안
- platform — VARCHAR(64) — NOT NULL — 프로젝트 전체에서 사용할 플랫폼 / 프로젝트 생성 후 변경 불가(DEC-124). 후작업도 이 값을 참조하며 별도 플랫폼 컬럼을 두지 않음. KAKAO·NAVER_OGQ는 코드 예시 / 물리 타입·NULL 표시는…
- product_type — VARCHAR(64) — NOT NULL — 선택한 플랫폼에서 만들 상품 유형 / STATIC_EMOTICON(멈춰있는 이모티콘)·STICKER(스티커)는 코드 예시. 플랫폼에 맞는 유형만 허용하며 프로젝트 생성 후 변경 불가(DEC-124) / 물리 타입·…
- start_type — VARCHAR(64) — NOT NULL — 이미지 제작부터 / 보유 이미지 후작업부터의 시작 방식 / DEC-030·031·094, IMAGE_CREATION·POST_PROCESSING / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 프로젝트 기록 생성 시각 / DEC-088 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 프로젝트 기록의 마지막 수정 시각 / DEC-088, 하위 작업 변경 시 갱신 범위는 후속 / 물리 타입·NULL 표시는 초안
- deleted_at — DATETIME — 소프트 삭제 시각. 미삭제 프로젝트는 값 없음 / DEC-081, 구체적인 날짜 타입은 후속 / 물리 타입·NULL 표시는 초안
- concept_inputs — JSON — 한 줄 컨셉, 성격·말투·성별·나이대·상황·희망 동작 등 현재 입력 조건 / JSON 한 컬럼. 성별 단일 선택 및 나머지 선택 항목의 복수 선택·기타 입력 규칙을 표현 / 물리 타입·NULL 표시는 초안
- concept_text — TEXT — 현재 컨셉 글. AI 초안과 사용자의 직접 수정 결과 / 텍스트. 이전 초안 이력은 저장하지 않음 / 물리 타입·NULL 표시는 초안
- concept_confirmed_at — DATETIME — 현재 컨셉을 확정한 시각 / 값이 없으면 미확정, 있으면 확정. 별도 확정 여부 컬럼은 두지 않음 / 물리 타입·NULL 표시는 초안
- concept_generation_count — INT — NOT NULL — 프로젝트에서 사용한 AI 컨셉 생성 횟수 / 최초 1회·다시 생성 2회를 합한 최대 3회. 결과 없는 오류·직접 수정·확정은 횟수 미차감 / 물리 타입·NULL 표시는 초안
- creation_step — VARCHAR(64) — AI 이미지 제작의 현재 단계 / CHARACTER·CONCEPT·MOTION·RESULT. 후작업 직접 시작은 NULL(해당 없음), DEC-093~097 / 물리 타입·NULL 표시는 초안
- last_work_type — VARCHAR(64) — 마지막으로 실제 진입한 작업 / IMAGE_CREATION·WHITE_OUTLINE·SHARE_IMAGE. 최초 진입 전 NULL, DEC-092·094~096 / 물리 타입·NULL 표시는 초안
- is_trial_project — TINYINT(1) — NOT NULL — 이 회원의 첫 무료 체험 제작으로 시작한 프로젝트인지 여부 / 최초 무료 프로젝트를 만들 때 true, 나머지는 false. 같은 user_id에서 true인 프로젝트는 소프트 삭제 기록까지 포함해 최대 한 건.…
- first_generation_started_at — DATETIME — 해당 프로젝트의 최초 이모티콘 이미지 생성이 실제로 시작된 시각 / 시작 전 NULL, 실제 최초 시작 때 한 번 기록. 이후 실패·재시도·구독 변경·삭제로 초기화하지 않음. 컨셉 글·방향 이미지·공유 배경 생성은…
project_character
- character_id — BIGINT — Primary key — NOT NULL — 캐릭터 기록의 고유 번호, PK / 각 테이블에서 1부터 자동 증가. 다른 프로젝트로 가져올 때 새 기록·새 번호 사용 / 물리 타입·NULL 표시는 초안
- project_id — BIGINT — Foreign key → project.project_id — NOT NULL — 소속 프로젝트의 project_id를 참조하는 FK / 해당 프로젝트의 번호 저장. 자동 증가하지 않으며 소유 회원은 프로젝트를 통해 확인 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 이 캐릭터 기록을 만든 시각 / 최초 등록 또는 가져와 새 기록을 만든 시각. 원본 캐릭터의 생성 시각을 그대로 쓰지 않음 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 이 캐릭터 기록의 마지막 수정 시각 / 단순 조회로 변경하지 않음. 하위 이미지 변경까지 반영할지는 후속 결정 / 물리 타입·NULL 표시는 초안
project_image
- project_image_id — BIGINT — Primary key — NOT NULL — 이미지 기록의 고유 번호 / 1부터 자동 증가 / 물리 타입·NULL 표시는 초안
- project_id — BIGINT — Foreign key → project.project_id — NOT NULL — 소속 프로젝트 번호 / 생성 결과·외부 업로드 모두 프로젝트 연결 / 물리 타입·NULL 표시는 초안
- motion_id — BIGINT — Foreign key → project_motion.motion_id — 이 이미지가 속한 동작 번호 / AI 이모티콘 결과는 필수. 외부 완성 이미지 업로드는 NULL / 물리 타입·NULL 표시는 초안
- file_key — VARCHAR(2048) — NOT NULL — 이미지 파일의 위치 식별자 / 파일 자체나 만료 URL 대신 저장소 내 파일 키를 기록 / 물리 타입·NULL 표시는 초안
- source_type — VARCHAR(64) — NOT NULL — 이미지가 들어온 방식 / AI_GENERATED(AI 생성), UPLOAD(외부 완성 이미지 업로드) / 물리 타입·NULL 표시는 초안
- is_selected — TINYINT(1) — 해당 동작에서 현재 사용할 결과 후보인지 / AI 후보는 true/false, 동작 없는 업로드는 NULL(해당 없음) / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 이미지 기록 생성 시각 / 새 결과·후보·업로드 기록을 만든 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 이미지 기록 마지막 수정 시각 / 선택 상태 등 이 기록의 정보를 변경한 시각 / 물리 타입·NULL 표시는 초안
project_motion
- motion_id — BIGINT — Primary key — NOT NULL — 동작 기록의 고유 번호 / 1부터 자동 증가 / 물리 타입·NULL 표시는 초안
- project_id — BIGINT — Foreign key → project.project_id — NOT NULL — 소속 프로젝트 번호 / 한 프로젝트의 여러 동작 연결 / 물리 타입·NULL 표시는 초안
- sort_order — INT — NOT NULL — 동작의 표시 순서 / 이모티콘은 1~16, 같은 프로젝트 안에서 중복 불가 / 물리 타입·NULL 표시는 초안
- description — TEXT — AI 제작 기준이 되는 동작 설명 / 추천안과 제작 전 직접 수정한 현재 설명 / 물리 타입·NULL 표시는 초안
- is_trial_target — TINYINT(1) — NOT NULL — 지정 무료 3종에 해당하는 동작인지 / 16종 중 지정 3개 구분. 회원의 무료 생성 권한 자체를 부여하는 값은 아님 / 물리 타입·NULL 표시는 초안
- confirmed_at — DATETIME — 동작 확인을 완료한 시각 / NULL이면 확인 미완료, 별도 확인 여부 컬럼은 두지 않음 / 물리 타입·NULL 표시는 초안
- edit_data — JSON — 현재 자막·글꼴·색·위치·크기·배치 등 편집 내용 / JSON 한 컬럼으로 현재 편집본 유지. 이미지 후보를 바꿔도 유지 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 동작 기록 생성 시각 / 기록을 만든 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 동작 기록 마지막 수정 시각 / 현재 설명·확인·편집 내용 등의 변경 시각 / 물리 타입·NULL 표시는 초안
share_background
- share_background_id — BIGINT — Primary key — NOT NULL — 배경 후보 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- share_banner_id — BIGINT — Foreign key → share_banner.share_banner_id — NOT NULL — 소속 공유배너 제작정보 / 공유배너 제작정보 FK / 물리 타입·NULL 표시는 초안
- file_key — VARCHAR(2048) — NOT NULL — 생성된 배경 파일 / 실제 파일이 생긴 후보만 저장 / 물리 타입·NULL 표시는 초안
- is_selected — TINYINT(1) — NOT NULL — 현재 선택 여부 / 공개 가능한 후보 중 최대 한 장 선택. 선택 자체는 공개 권한이 아님 / 물리 타입·NULL 표시는 초안
- sort_order — INT — NOT NULL — 배너 전체 후보의 누적 표시 순서 / 기존 후보를 보존하고 새 후보를 뒤에 추가. 첫 생성 1~3, 다음 새 생성 4~6(DEC-153). 생성 묶음 식별값과 구분 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 후보 생성 시각 / 생성 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 후보 수정 시각 / 선택 등 마지막 갱신 시각 / 물리 타입·NULL 표시는 초안
share_banner
- share_banner_id — BIGINT — Primary key — NOT NULL — 공유배너 제작정보 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- post_process_id — BIGINT — Foreign key → post_process.post_process_id — NOT NULL — 공유이미지 작업본 / 후작업 FK. 해당 작업본당 상세 최대 한 건 / 물리 타입·NULL 표시는 초안
- project_image_id — BIGINT — Foreign key → project_image.project_image_id — 배너에 사용할 원본 이미지 한 장 / 프로젝트 이미지 FK. 원본 없는 초안에서는 NULL 허용(DEC-152). 실제 생성 시작 시 이용 가능한 원본 한 장 필수(DEC-118·152) / 물리 타입·NULL 표…
- emoticon_name — VARCHAR(255) — 배너에 표시할 이모티콘 이름 / 제목 원문. 프로젝트 이름·회원 작가 이름과 구분 / 물리 타입·NULL 표시는 초안
- style_prompt — TEXT — 원하는 분위기·디자인 설명 / AI 배경 생성에 사용할 선택 입력(DEC-119). 수정만으로 기존 후보·완성 파일을 바꾸지 않고 다음 명시적 AI 생성 요청부터 적용(DEC-131). 길이·빈 값 저장 방식 후속…
- output_width — INT — 완성본 가로 크기 / 단위 px. 허용값·규격 고정 여부는 미결 / 물리 타입·NULL 표시는 초안
- output_height — INT — 완성본 세로 크기 / 단위 px. 허용값·규격 고정 여부는 미결 / 물리 타입·NULL 표시는 초안
- result_file_key — VARCHAR(2048) — 마지막으로 저장한 합성 완성본 / 첫 완성 전 NULL. 편집 후에는 이전 파일이 남아 있어도 최신 결과로 제공하지 않음. 합성 실패 시 보존(DEC-120) / 물리 타입·NULL 표시는 초안
- render_status — VARCHAR(64) — NOT NULL — 현재 편집에 대한 최종 배너 파일 합성 상태 / 저장 필요·저장 중·저장 완료·저장 실패(DEC-130). AI 배경 생성·최초 후보 공개·정산 상태와 구분. 영문 코드·타입·제약 후속 / 물리 타입·NULL 표시…
- created_at — DATETIME — NOT NULL — 상세 생성 시각 / 생성 시각 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 상세 수정 시각 / 마지막 갱신 시각 / 물리 타입·NULL 표시는 초안
subscription
- subscription_id — BIGINT — Primary key — NOT NULL — 구독 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- user_id — BIGINT — Foreign key → user.user_id — NOT NULL — 소유 회원 번호 / 회원.user_id 연결. 회원당 최대 한 행 / 물리 타입·NULL 표시는 초안
- current_period_start — DATETIME — 현재 결제된 이용기간 시작 시각 / 첫 결제 성공 확인 전 NULL. 검증된 결제로 갱신 / 물리 타입·NULL 표시는 초안
- current_period_end — DATETIME — 현재 결제된 이용기간 종료 시각 / 검증된 결제 회차의 종료 시각(DEC-146). 첫 결제 성공 확인 전 NULL. 종료 시각부터 만료로 판단 / 물리 타입·NULL 표시는 초안
- next_billing_date — DATE — 다음 결제 예정 날짜 / 확인된 그로블 일정 저장(DEC-147). 시간 없는 날짜이며 이용기간 종료·크레딧 만료 시각으로 사용하지 않음. 첫 결제 전·확인된 자동결제 중단 시 NULL. 정상 활성·재가입 때 확인…
- auto_renew — TINYINT(1) — NOT NULL — 다음 자동결제 진행 여부 / 최초 false. 정상 결제와 현재 외부 자동결제 활성 확인 시 true. 재시도 중 기존 설정 유지. 최종 실패·자동 갱신 중단 또는 실제 종료 확인 시 false. 이용기간 유효 여…
- cancel_requested_at — DATETIME — 자동결제 해지 신청 시각 / 최초 NULL. 확인된 신청 시각 기록. 이전 가입 종료 후 정상 재가입 확인 시 NULL로 초기화·과거 이력 보존(DEC-148). 갱신 실패·자동 종료만으로 신청 시각을 만들지 않음…
- created_at — DATETIME — NOT NULL — 구독 기록 생성 시각 / 최초 기록 생성 시 저장 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 구독 기록 변경 시각 / 현재 기간·설정 변경 시 갱신 / 물리 타입·NULL 표시는 초안
subscription_link
- subscription_link_id — BIGINT — Primary key — NOT NULL — 가입별 결제 연결 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- subscription_id — BIGINT — Foreign key → subscription.subscription_id — NOT NULL — 모캐 구독 번호 / 구독.subscription_id 연결. 소유 회원은 구독.user_id로 확인 / 물리 타입·NULL 표시는 초안
- subscription_product_id — BIGINT — Foreign key → subscription_product.subscription_product_id — NOT NULL — 가입 당시 상품 번호 / 구독 상품.subscription_product_id FK. 결제창 진입 전 고정하며 월 갱신 때 교체하지 않음(DEC-145) / 물리 타입·NULL 표시는 초안
- provider — VARCHAR(64) — NOT NULL — 결제 서비스 / 현재 GROBLE. 연결 상품의 provider와 일치 / 물리 타입·NULL 표시는 초안
- seller_reference — VARCHAR(255) — NOT NULL — 결제 링크로 전달할 가입 연결값 / 서버에서 생성한 추측하기 어려운 랜덤 문자열. 생성 후 변경·다른 회원에 재사용 금지. 중복 금지 / 물리 타입·NULL 표시는 초안
- link_status — VARCHAR(64) — NOT NULL — 가입 연결 상태 / 결제 대기·연결됨·종료됨. 결제 성공 여부나 현재 유료 이용 권한과 구분 / 물리 타입·NULL 표시는 초안
- activated_at — DATETIME — 외부 정기결제 가입 시각 / 검증된 외부 가입 정보에서 기록. 최초 연결 전 NULL, 월 갱신으로 덮어쓰지 않음 / 물리 타입·NULL 표시는 초안
- terminated_at — DATETIME — 외부 정기결제 종료 시각 / 확인된 실제 종료 시각. 해지 신청만으로 기록하지 않음 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 연결 기록 생성 시각 / 결제창으로 보내기 전 기록 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 연결 상태 변경 시각 / 확인된 상태 변경 시 갱신 / 물리 타입·NULL 표시는 초안
subscription_product
- subscription_product_id — BIGINT — Primary key — NOT NULL — 내부 구독 상품 번호 / 1부터 자동 증가 PK / 물리 타입·NULL 표시는 초안
- product_code — VARCHAR(64) — NOT NULL — 내부 상품 코드 / 예: MOCAE_MONTHLY_V1. 중복·재사용 금지. 기존 결제.product_code에 당시 코드 보존 / 물리 타입·NULL 표시는 초안
- name — VARCHAR(255) — NOT NULL — 상품 이름 / 예: 모캐 월 구독 / 물리 타입·NULL 표시는 초안
- price — DECIMAL(12, 2) — NOT NULL — 한 회차의 판매 가격 / 현재 기준 9,900원. 출시 전 원가 검토 대상 / 물리 타입·NULL 표시는 초안
- currency — CHAR(3) — NOT NULL — 가격 통화 / 현재 KRW / 물리 타입·NULL 표시는 초안
- credit_amount — BIGINT — NOT NULL — 결제 성공 회차마다 지급할 크레딧 / 현재 기준 30. 결제 검증 후 해당 결제당 한 번 지급 / 물리 타입·NULL 표시는 초안
- billing_cycle_months — INT — NOT NULL — 결제 주기 개월 수 / 현재 1. 연간 상품을 새로 승인한다는 의미는 아님 / 물리 타입·NULL 표시는 초안
- provider — VARCHAR(64) — NOT NULL — 결제 서비스 / 현재 GROBLE / 물리 타입·NULL 표시는 초안
- provider_product_id — VARCHAR(255) — 그로블 상품 번호 / 웹훅 content.id와 대조. 외부에서 발급한 문자열이며 내부 PK와 다름 / 물리 타입·NULL 표시는 초안
- provider_option_id — VARCHAR(255) — 그로블 옵션 번호 / 웹훅 options.optionId와 대조. 외부 문자열 / 물리 타입·NULL 표시는 초안
- checkout_url — VARCHAR(2048) — 해당 상품 결제창 주소 / 등록된 기본 주소. 회원별 ref는 저장하지 않고 가입 연결의 seller_reference를 이동 시 붙임 / 물리 타입·NULL 표시는 초안
- is_on_sale — TINYINT(1) — NOT NULL — 모캐에서 새 가입을 받을지 / false면 새 가입 연결 생성을 막음. 기존 가입 갱신·크레딧 지급을 중단하지 않음 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — NOT NULL — 상품 기록 생성 시각 / 최초 생성 시 기록 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — NOT NULL — 상품 기록 변경 시각 / 이름·판매 여부 등 허용 변경 시 갱신 / 물리 타입·NULL 표시는 초안
user
- user_id — BIGINT — Primary key — NOT NULL — 서비스 내부 회원 식별자. 1부터 시작하는 자동 증가 정수 PK / DEC-068·087·089, 정수 크기·DB 문법은 후속 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- login_provider — VARCHAR(64) — NOT NULL — Google·Kakao 등 로그인 제공자 / DEC-035·036 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- provider_user_id — VARCHAR(255) — NOT NULL — 해당 제공자의 회원 식별자 / DEC-036 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- author_name — VARCHAR(255) — NOT NULL — 서비스에서 사용하는 작가 이름. 다른 회원과 중복 불가 / DEC-036·073~077·152, 회원 생성 시 작가 이름 필수. 앞뒤 공백 제거·영문 대소문자 미구분. 가입 후 변경·이전 이름 즉시 재사용 허용,…
- account_status — VARCHAR(64) — NOT NULL — NORMAL(정상), BLOCKED(이용정지), CLOSED(탈퇴) / DEC-036·071, 정지·탈퇴의 상세 처리 조건은 후속 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- credit_balance — BIGINT — NOT NULL — 현재 사용 가능한 크레딧 수량 / DEC-062, 예약량 제외 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- credit_reserved — BIGINT — NOT NULL — 아직 정산·해제되지 않은 예약 크레딧 수량 / DEC-062, 이전 기간의 진행 중 예약도 보존 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- created_at — DATETIME — 회원 기록 생성 시각 / 설계 제안 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안
- updated_at — DATETIME — 회원 기록의 마지막 수정 시각 / 설계 제안 / 회원 후보: 개별 확정 범위는 원문 참조 / 물리 타입·NULL 표시는 초안