ai
Tables (14)
artwork_copy
- artwork_id — BIGINT — Primary key — NOT NULL — 작품 식별자(작품 서비스)
- artist_id — BIGINT — NOT NULL — 작가 회원 식별자. 같은 작가 연속 노출 제한, 본인 작품 제외. 검사 비교에서는 같은 작가를 빼지 않음
- status — VARCHAR(20) — NOT NULL — 작품 상태 사본: PUBLISHED, HIDDEN, CLOSED(최종 반려). 검사 요청으로 먼저 만든 사본은 PENDING
- is_public — BOOLEAN — NOT NULL — 공개 여부(PUBLISHED만 참). 거짓이면 추천 후보 제외. 검사 비교 대상에는 상태와 관계없이 남김(숨김·CLOSED 포함)
- hidden_reason — VARCHAR(40) — 숨김 사유 사본: MODERATION, PHYSICAL_INSPECTION_FAILED. 공개면 NULL
- material_category — VARCHAR(30) — 재료 분류 코드(작품 계약): PENCIL_CHARCOAL, PEN_INK, WATERCOLOR_GOUACHE, ACRYLIC_OIL, MIXED_MEDIA. 온보딩 관심 재료 일치
- current_revision — BIGINT — 공개된 작품 버전(contentRevision). 이 버전의 임베딩만 비교에 사용. 검사 요청으로 먼저 만든 사본은 NULL
- source_version — BIGINT — NOT NULL — 마지막으로 반영한 ArtworkStatusChanged.aggregateVersion. 작거나 같으면 무시. 검사 요청으로 만든 사본은 0
- published_at — TIMESTAMPTZ — 처음 PUBLISHED가 된 상태 이벤트의 occurredAt(V3). LATEST 탭·기본 피드의 최근 공개순 기준. 재공개해도 바뀌지 않음. 부분 인덱스 (published_at DESC) WHERE is_pu…
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
feed_batch
- batch_no — INTEGER — Primary key — NOT NULL — 묶음 번호 1~
- session_id — UUID — Foreign key → feed_session.session_id — NOT NULL — 세션 식별자. 세션 삭제 시 함께 삭제(ON DELETE CASCADE)
- items — JSONB — NOT NULL — 계약 FeedItem 배열: {artworkId, reason: {code, seedArtworkId?, artistId?}}
- has_next — BOOLEAN — NOT NULL — 다음 묶음이 있는지. 거짓이면 응답 nextCursor가 null
- created_at — TIMESTAMPTZ — NOT NULL — 생성 시각' ) COMMENT='피드 묶음(V
feed_exposure
- member_id — BIGINT — Primary key — NOT NULL — 회원 식별자
- artwork_id — BIGINT — Primary key — NOT NULL — 작품 식별자
- exposure_count — INTEGER — NOT NULL — 반응 없이 노출된 횟수
- reacted — BOOLEAN — NOT NULL — 노출 뒤 반응(시청·좋아요 등) 여부
- last_exposed_at — TIMESTAMPTZ — NOT NULL — 마지막 노출 시각. 반응 없으면 24시간 제외, 이후 감점
feed_exposure_daily
- artwork_id — BIGINT — Primary key — NOT NULL — 작품 식별자
- exposure_date — DATE — Primary key — NOT NULL — KST 날짜. 앱이 occurredAt을 Asia/Seoul로 바꿔 계산
- impressions — INTEGER — NOT NULL — 그날 피드 노출 수' ) COMMENT='작품별 일별 피드 노출 수. 작가 통계 API GET /api/ai/exposures(작품 W10과 같은
feed_session
- session_id — UUID — Primary key — NOT NULL — 세션 식별자. 커서가 가리킨다
- member_id — BIGINT — 회원 식별자. 비로그인이면 NULL
- tab — VARCHAR(20) — NOT NULL — 피드 탭: RECOMMENDED, FOLLOWING, NEW_ARTISTS, LATEST. 커서와 탭이 다르면 400
- seed_artwork_id — BIGINT — 비로그인 유입 작품(seedArtworkId). 세션 동안 기준 작품으로 사용
- created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
- last_request_at — TIMESTAMPTZ — NOT NULL — 마지막 요청 시각(인덱스). 30분 지나면 새 세션' ) COMMENT='숏폼 피드 세션(V3). 마지막 요청 후 30분(FEED_SESSION_MINUTE
followed_artist
- member_id — BIGINT — Primary key — NOT NULL — 회원 식별자
- artist_id — BIGINT — Primary key — NOT NULL — 관심 작가 회원 식별자
- followed_at — TIMESTAMPTZ — NOT NULL — 등록 시각
image_embedding
- id — BIGINT — Primary key — NOT NULL — 임베딩 식별자
- artwork_id — BIGINT — Foreign key → artwork_copy.artwork_id — 작가 작품이면 작품 식별자. reference_image_id와 둘 중 하나만 값이 있음
- reference_image_id — BIGINT — Foreign key → reference_image.id — 참조 이미지면 참조 이미지 식별자
- content_revision — BIGINT — 작품 콘텐츠 버전. 참조 이미지는 NULL
- image_hash — VARCHAR(64) — NOT NULL — 임베딩한 원본 이미지 SHA-256
- model_version — VARCHAR(100) — NOT NULL — <모델 이름>@<Hugging Face 리비전 앞 12자>. 예: openai-clip-vit-b32@3d74acf9a28c. 다른 모델 버전의 벡터끼리 비교하지 않는다
- dimension — INTEGER — NOT NULL — 벡터 차원(512)
- embedding — VECTOR(512) — NOT NULL — 실제 타입 vector(512). L2 정규화, 코사인 거리로 비교
- crop_result — VARCHAR(20) — NOT NULL — CROPPED(작품 영역 크롭)·NO_QUAD(사각형 못 찾아 원본 사용)·NOT_APPLIED(참조 이미지)
- crop_area_ratio — NUMERIC(4, 3) — 찾은 사각형이 사진 면적에서 차지한 비율(0~1). 크롭하지 않았으면 NULL
- created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
outbox_event
- event_id — UUID — Primary key — NOT NULL — 이벤트 식별자
- event_type — VARCHAR(100) — NOT NULL — 이벤트 종류
- aggregate_id — VARCHAR(100) — NOT NULL — 집합 식별자
- aggregate_version — BIGINT — NOT NULL — 집합 버전
- idempotency_key — VARCHAR(200) — NOT NULL — 멱등키. UNIQUE(event_type, idempotency_key)
- schema_version — VARCHAR(20) — NOT NULL — 스키마 버전
- payload — JSONB — NOT NULL — 본문
- occurred_at — TIMESTAMPTZ — NOT NULL — 발생 시각
- traceparent — VARCHAR(100) — 추적 문맥
- attempts — INTEGER — NOT NULL — 전송 시도 횟수
- last_attempted_at — TIMESTAMPTZ — 마지막 전송 시도 시각
- published_at — TIMESTAMPTZ — 발행 완료 시각. 미발행 행은 부분 인덱스 (occurred_at) WHERE published_at IS NULL로 폴링' ) COMMENT='발행 이벤트(ArtworkInspectionCompleted
processed_event
- consumer — VARCHAR(100) — Primary key — NOT NULL — 소비자 이름
- event_id — UUID — Primary key — NOT NULL — 처리한 이벤트 식별자
- processed_at — TIMESTAMPTZ — NOT NULL — 처리 시각' ) COMMENT='수신 이벤트 중복 처리 기록(소비자
reference_image
- id — BIGINT — Primary key — NOT NULL — 참조 이미지 식별자
- source — VARCHAR(20) — NOT NULL — 출처: MET
- source_object_id — VARCHAR(50) — NOT NULL — 출처의 작품 ID(Met objectID). UNIQUE(source, source_object_id, variant_no)
- variant_no — INTEGER — NOT NULL — 0은 대표 이미지, 1 이상은 추가 이미지. 같은 객체의 변형끼리 정답셋의 같은 그림 쌍이 된다
- title — VARCHAR(500) — 작품명 사본
- artist_name — VARCHAR(300) — 작가명 사본
- object_date — VARCHAR(100) — 제작 시기 사본
- medium — VARCHAR(500) — 재료 사본
- classification — VARCHAR(100) — Met 분류
- department — VARCHAR(100) — Met 부서
- is_highlight — BOOLEAN — NOT NULL — Met 하이라이트 여부(선정 비율 기준)
- image_object_key — VARCHAR(1024) — NOT NULL — AI 참조 이미지 버킷의 객체 키. 표시용 서명 URL 발급 주체는 인프라와 합의
- image_hash — VARCHAR(64) — NOT NULL — 원본 파일 SHA-256
- source_url — VARCHAR(1024) — NOT NULL — 출처 원본 URL(출처 표기)
- collected_at — TIMESTAMPTZ — NOT NULL — 수집 시각
- image_url — VARCHAR(1024) — 출처가 공개로 제공하는 이미지 주소(Met: images.metmuseum.org web-large). 운영 검수 화면의 근거 표시용. 비공개로 바뀌었거나 아직 채우지 못했으면 NULL
similarity_inspection
- id — BIGINT — Primary key — NOT NULL — 검사 식별자
- request_id — BIGINT — NOT NULL — 작품 서비스 검사 작업 ID(artwork_inspection.id). UNIQUE, 같은 요청은 한 번만 처리
- artwork_id — BIGINT — Foreign key → artwork_copy.artwork_id — NOT NULL — 작품 식별자
- content_revision — BIGINT — NOT NULL — 검사 대상 작품 버전. UNIQUE(artwork_id, content_revision)
- status — VARCHAR(20) — NOT NULL — 상태: REQUESTED, COMPLETED, FAILED, SUPERSEDED(더 새 버전 요청이 옴)
- outcome — VARCHAR(20) — 판정: CLEAR, SUSPECTED, RETAKE_REQUIRED. 완료일 때만 값이 있음
- embedding_id — BIGINT — Foreign key → image_embedding.id — 검사에 쓴 임베딩. 재촬영 필요면 NULL
- max_similarity — NUMERIC(5, 4) — 상위 1개 코사인 유사도
- threshold — NUMERIC(5, 4) — 판정에 쓴 기준값(정답셋 측정 후 확정)
- model_version — VARCHAR(100) — 모델 버전 문자열
- last_request_attempt — INTEGER — NOT NULL — 작품이 보낸 마지막 요청 회차(ArtworkInspectionRequested.attempt). 결과 이벤트의 attempt로 돌려줌
- attempts — INTEGER — NOT NULL — AI 내부 처리 시도 횟수(재시도 예산 판단). 요청 회차와 다름
- last_error_code — VARCHAR(100) — FAILED일 때 결과 이벤트의 errorCode
- requested_at — TIMESTAMPTZ — NOT NULL — 요청 수신 시각
- completed_at — TIMESTAMPTZ — 완료·실패 시각
similarity_match
- rank — INTEGER — Primary key — NOT NULL — 순위 1~5(운영 검수 화면 근거 5칸)
- inspection_id — BIGINT — Foreign key → similarity_inspection.id — NOT NULL — 검사 식별자
- matched_artwork_id — BIGINT — 비교된 다른 작품 식별자(같은 작가 포함, 숨김·CLOSED 포함). matched_reference_id와 둘 중 하나. 같은 artworkId의 이전 버전만 제외
- matched_reference_id — BIGINT — Foreign key → reference_image.id — 비슷한 참조 이미지 식별자
- similarity — NUMERIC(5, 4) — NOT NULL — 코사인 유사도
user_artwork_interest
- member_id — BIGINT — Primary key — NOT NULL — 회원 식별자(회원 서비스)
- artwork_id — BIGINT — Primary key — NOT NULL — 작품 식별자
- watch_score_sum — NUMERIC(6, 3) — NOT NULL — 시청 점수 누적(시청마다 0~1). 상한은 조회 시 적용
- loop_count — INTEGER — NOT NULL — 반복 시청 추정 횟수
- skip_count — INTEGER — NOT NULL — 스킵 횟수
- liked — BOOLEAN — NOT NULL — 좋아요
- like_version — BIGINT — NOT NULL — 반영한 ArtworkLikeChanged.likeVersion. 더 작은 버전은 버림
- watchlisted — BOOLEAN — NOT NULL — 관심 경매 등록
- bid_placed — BOOLEAN — NOT NULL — 입찰 여부
- onboarding_picked — BOOLEAN — NOT NULL — 온보딩에서 고름
- last_positive_at — TIMESTAMPTZ — 마지막 긍정 행동(부분·완주 시청, 좋아요, 관심 경매, 입찰, 온보딩 선택) 시각. 스킵은 갱신하지 않음. 14일 반감기 기준
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
user_preference
- member_id — BIGINT — Primary key — NOT NULL — 회원 식별자
- material_categories — JSONB — NOT NULL — 온보딩 관심 재료 분류 코드 배열(기본 ). 비어 있으면 미선택
- picked_artwork_ids — JSONB — NOT NULL — 온보딩에서 고른 작품 ID 배열(최대 3, 기본 ). user_artwork_interest.onboarding_picked와 같은 내용을 GET /api/ai/taste 응답용으로 보관
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각