cat-my-town
테이블 (7)
AI 매칭 로그 (match_logs)
- 매칭 로그 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 매칭 로그 고유 번호 (PK, 자동 증가)
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 매칭을 수행한 사용자 (FK → users)
- 목격 ID (sighting_id) — BIGINT — 외래 키 → 목격 기록.목격 ID — 이 매칭의 대상이 된 촬영(목격) 기록 (FK → sightings). 없을 수 있음
- 선택 고양이 ID (selected_cat_id) — BIGINT — 외래 키 → 고양이.고양이 ID — 사용자가 최종 선택한 기존 고양이 (FK → cats). 새 고양이로 등록했거나 후보가 없으면 NULL
- 일치율 (score) — NUMERIC(5,2) — 선택한 후보의 보정된 일치율(0~100). 선택 없음이면 NULL. 후보별 점수는 match_candidates 참고
- 결과 (result) — VARCHAR(20) — NOT NULL — CONFIRMED(후보 중 하나를 같은 고양이로 확정) / CORRECTED_NEW(후보가 있었지만 새 고양이로 등록) / NEW(일치율 기준 미만이라 후보 없이 신규 등록)
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 매칭 결과가 기록된 일시
AI 매칭 후보 (match_candidates)
- 매칭 후보 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 매칭 후보 고유 번호 (PK, 자동 증가)
- 순위 (rank_no) — SMALLINT — NOT NULL — 일치율 높은 순 순위(1~3, 후보는 최대 3명). 같은 매칭 로그에서 순위 중복 불가 (match_log_id, rank_no UNIQUE)
- 일치율 (score) — NUMERIC(5,2) — NOT NULL — 이 후보의 보정된 일치율(0~100). 기준(현재 40%) 이상인 후보만 저장
- 매칭 로그 ID (match_log_id) — BIGINT — 외래 키 → AI 매칭 로그.매칭 로그 ID — NOT NULL — 이 후보가 나온 매칭 로그 (FK → match_logs). 매칭 로그가 지워지면 함께 삭제
- 고양이 ID (cat_id) — BIGINT — 외래 키 → 고양이.고양이 ID — NOT NULL — 후보로 제안된 고양이 (FK → cats). 고양이가 지워지면 함께 삭제
고양이 (cats)
- 고양이 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 고양이 개체 고유 번호 (PK, 자동 증가)
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 이 고양이를 등록한 사용자 (FK → users). 도감은 사용자별로 분리
- 이름 (name) — VARCHAR(50) — NOT NULL — 사용자가 지어준 고양이 이름
- 대표 임베딩 (representative_embedding) — VECTOR(1024) — 대표 이미지 임베딩 (Voyage AI voyage-multimodal-3.5, 1024차원). 유사도 검색용
- 등록일시 (created_at) — TIMESTAMPTZ — NOT NULL — 첫 만남(최초 등록) 일시
- 대표 사진 URL (photo_url) — VARCHAR(500) — NOT NULL — 도감 카드에 보여줄 대표 사진 저장 경로 (MinIO 또는 로컬 디스크). 새 고양이 등록 시 첫 목격 사진으로 저장
고양이 특징 태그 (cat_tags)
- 태그 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 태그 고유 번호 (PK, 자동 증가)
- 고양이 ID (cat_id) — BIGINT — 외래 키 → 고양이.고양이 ID — NOT NULL — 태그가 붙은 고양이 (FK → cats)
- 태그 (tag) — VARCHAR(30) — NOT NULL — 특징 태그(자유 텍스트, 예: 턱시도, 코 옆 흰 점). 같은 고양이에 동일 태그 중복 불가 (cat_id, tag UNIQUE)
관리자 (admin_users)
- 관리자 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 관리자 계정 고유 번호 (PK, 자동 증가)
- 이메일 (email) — VARCHAR(255) — NOT NULL — 로그인 이메일. 중복 불가(UNIQUE)
- 비밀번호 해시 (password_hash) — VARCHAR(255) — NOT NULL — 해시 처리된 비밀번호. 원문은 저장하지 않음
- 이름 (name) — VARCHAR(50) — NOT NULL — 운영자 이름
- 역할 (role) — VARCHAR(30) — NOT NULL — 권한 등급. 예: OPERATOR(운영 관리자). 기본값 OPERATOR
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 계정 발급 일시
목격 기록 (sightings)
- 목격 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 목격 기록 고유 번호 (PK, 자동 증가)
- 고양이 ID (cat_id) — BIGINT — 외래 키 → 고양이.고양이 ID — NOT NULL — 목격된 고양이 (FK → cats)
- 사진 URL (photo_url) — VARCHAR(500) — NOT NULL — 촬영 사진 저장 경로 (MinIO 또는 로컬 디스크)
- 메모 (memo) — VARCHAR(200) — 목격 메모. 예: 놀이터 미끄럼틀 밑
- 위도 (latitude) — NUMERIC(8,5) — 뭉갠 위도. 정밀 좌표는 저장하지 않음
- 경도 (longitude) — NUMERIC(8,5) — 뭉갠 경도. 정밀 좌표는 저장하지 않음
- 촬영일시 (taken_at) — TIMESTAMPTZ — NOT NULL — 사진을 촬영한 일시
사용자 (users)
- 사용자 ID (id) — BIGSERIAL — 기본 키 — NOT NULL — 사용자 고유 번호 (PK, 자동 증가)
- 구글 UID (google_uid) — VARCHAR(128) — NOT NULL — Firebase Auth(Google) 계정 고유 ID. 중복 불가(UNIQUE)
- 표시 이름 (display_name) — VARCHAR(50) — 앱에서 보여줄 이름(닉네임)
- 레벨 (level) — SMALLINT — NOT NULL — 캐싱된 레벨. 신규 고양이 등록 시점마다 갱신 (등록 개체 수 기준 Lv1~5: 1·5·12·16·30마리 이상, 0은 미등록)
- 가입일시 (created_at) — TIMESTAMPTZ — NOT NULL — 최초 로그인(가입) 일시