멩

테이블 (20)

claim_consents

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • claim_id — BIGINT — 외래 키 → claims.id — NOT NULL — 청구
  • type — VARCHAR(30) — NOT NULL — 동의 종류 — 필수 4종 (COLLECT_USE 수집·이용 / UNIQUE_ID_INFO 고유식별정보=신분증 / THIRD_PARTY_INSURER 보험사 제3자 제공 / THIRD_PARTY_HOSPITAL 병원…
  • agreed — BOOLEAN — NOT NULL — 동의 여부 (거부도 기록)
  • terms_version — VARCHAR(20) — NOT NULL — 동의 시점 약관 버전 (없으면 입증 불가)
  • agreed_at — DATETIME — NOT NULL — 동의 시각
  • revoked_at — DATETIME — 철회 시각 (법 37조 철회권 — NULL이면 유효)
  • created_at — DATETIME — NOT NULL — 생성일시

claim_status_histories

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • claim_id — BIGINT — 외래 키 → claims.id — NOT NULL — 청구
  • from_status — VARCHAR(20) — 이전 상태 (최초 생성은 NULL)
  • to_status — VARCHAR(20) — NOT NULL — 변경된 상태
  • changed_by — VARCHAR(50) — NOT NULL — 변경 주체 (SYSTEM / admin:이름)
  • occurred_at — DATETIME — NOT NULL — 변경 시각
  • memo — VARCHAR(500) — 메모
  • created_at — DATETIME — NOT NULL — 생성일시

claims

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 청구인(보호자) — 서버가 채움, 불변
  • treatment_record_id — BIGINT — 외래 키 → treatment_records.id — NOT NULL — 대상 진료내역
  • pet_insurance_id — BIGINT — 외래 키 → pet_insurances.id — NOT NULL — 대상 가입보험 (서버가 찾아 넣음, 신청 시점 고정)
  • status — VARCHAR(20) — NOT NULL — 진행 상태 6값 (VERIFYING 진료확인중 / ACCEPTED 서류준비중 / FILING 보험심사중 / PAID 지급완료 / VERIFY_REJECTED 진료확인반려 / INSURER_REJECTED 보험사반려…
  • payout_amount — INT — 지급 보험금(원) — status=PAID일 때
  • paid_at — DATETIME — 지급일시 — status=PAID일 때
  • reject_reason — VARCHAR(500) — 반려 사유 — status가 *_REJECTED일 때
  • created_at — DATETIME — NOT NULL — 접수일시
  • updated_at — DATETIME — NOT NULL — 수정일시

devices

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 사용자
  • fcm_token — VARCHAR(255) — NOT NULL — FCM 등록 토큰
  • platform — VARCHAR(10) — NOT NULL — 플랫폼 (IOS / ANDROID)
  • created_at — DATETIME — NOT NULL — 등록일시
  • updated_at — DATETIME — NOT NULL — 갱신일시

document_rules

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • insurance_product_id — BIGINT — 외래 키 → insurance_products.id — NOT NULL — 보험상품
  • condition — JSON — NOT NULL — 조건 (예: {"amount_gte":300000}). 무조건이면 {}
  • document_type — VARCHAR(100) — NOT NULL — 서류 유형
  • owner — VARCHAR(20) — NOT NULL — 확보 주체 (US / HOSPITAL / USER)
  • is_active — BOOLEAN — NOT NULL — 사용 여부
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

hospitals

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • name — VARCHAR(255) — NOT NULL — 병원명
  • address — VARCHAR(500) — NOT NULL — 주소 (동명 병원 구분용)
  • created_at — DATETIME — NOT NULL — 적재일시
  • updated_at — DATETIME — NOT NULL — 수정일시

insurance_products

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • insurer_id — BIGINT — 외래 키 → insurers.id — NOT NULL — 보험사
  • name — VARCHAR(100) — NOT NULL — 상품명(브랜드 단위)
  • is_active — BOOLEAN — NOT NULL — 목록 노출 여부
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

insurers

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • name — VARCHAR(50) — NOT NULL — 보험사명
  • is_active — BOOLEAN — NOT NULL — 목록 노출 여부
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

pet_insurances

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • pet_id — BIGINT — 외래 키 → pets.id — NOT NULL — 반려동물
  • insurance_product_id — BIGINT — 외래 키 → insurance_products.id — NOT NULL — 보험상품
  • created_at — DATETIME — NOT NULL — 등록일시
  • updated_at — DATETIME — NOT NULL — 수정일시

pets

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 보호자
  • name — VARCHAR(50) — NOT NULL — 이름
  • species — VARCHAR(10) — NOT NULL — 축종 (DOG / CAT)
  • breed — VARCHAR(50) — 품종
  • birth_date — DATE — 생년월일
  • gender — VARCHAR(10) — 성별 (MALE / FEMALE)
  • created_at — DATETIME — NOT NULL — 등록일시
  • updated_at — DATETIME — NOT NULL — 수정일시

power_of_attorneys

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • claim_id — BIGINT — 외래 키 → claims.id — NOT NULL — 청구 (1:1)
  • signer_name — VARCHAR(100) — NOT NULL — 서명 시점 보호자 실명 (스냅샷) 🔒암호화 대상
  • signer_ip — VARCHAR(45) — 서명 IP (IPv6 대비 45자) — 감사 목적, 보관 짧게
  • signature_image_url — VARCHAR(1024) — NOT NULL — 서명 이미지 URL
  • terms_version — VARCHAR(20) — NOT NULL — 위임장 양식 버전
  • signed_at — DATETIME — NOT NULL — 서명 시각
  • created_at — DATETIME — NOT NULL — 생성일시

receipts

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • treatment_record_id — BIGINT — 외래 키 → treatment_records.id — NOT NULL — 진료내역 (1:0..1)
  • image_url — VARCHAR(1024) — NOT NULL — 영수증 이미지 URL
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

refresh_tokens

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 사용자
  • token_hash — VARCHAR(64) — NOT NULL — 토큰 해시 (SHA-256 — 원문 저장 금지)
  • expires_at — DATETIME — NOT NULL — 만료 시각 (발급 + 1개월)
  • revoked_at — DATETIME — 폐기 시각 (회전·로그아웃·탈퇴 시. NULL이면 유효)
  • created_at — DATETIME — NOT NULL — 발급일시
  • updated_at — DATETIME — NOT NULL — 수정일시

required_documents

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • claim_id — BIGINT — 외래 키 → claims.id — NOT NULL — 청구
  • document_rule_id — BIGINT — 외래 키 → document_rules.id — 근거 룰 (NULL이면 매칭 실패 폴백)
  • document_type — VARCHAR(100) — NOT NULL — 서류 유형 (생성 시점 스냅샷)
  • owner — VARCHAR(20) — NOT NULL — 확보 주체 (US / HOSPITAL / USER)
  • secured_status — VARCHAR(20) — NOT NULL — 확보 여부 (NOT_SECURED / SECURED)
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

social_accounts

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 사용자
  • provider — VARCHAR(20) — NOT NULL — 로그인 제공자 (KAKAO / APPLE)
  • provider_user_id — VARCHAR(255) — NOT NULL — 제공자측 사용자 ID (애플은 sub)
  • created_at — DATETIME — NOT NULL — 연결일시
  • updated_at — DATETIME — NOT NULL — 수정일시

treatment_items

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • treatment_record_id — BIGINT — 외래 키 → treatment_records.id — NOT NULL — 진료내역
  • item_name — VARCHAR(255) — NOT NULL — 항목명
  • amount — INT — NOT NULL — 라인 합계(원)
  • quantity — INT — 수량(참고값)
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시

treatment_records

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • pet_id — BIGINT — 외래 키 → pets.id — NOT NULL — 반려동물
  • hospital_name — VARCHAR(255) — NOT NULL — 병원명 (병원 검색 또는 직접 입력 — 스냅샷)
  • hospital_address — VARCHAR(500) — 병원 주소 (병원 검색으로 자동 입력 — 스냅샷)
  • treatment_date — DATE — NOT NULL — 진료일
  • total_amount — INT — NOT NULL — 총 결제금액(원)
  • diagnosis — VARCHAR(255) — 진단명
  • source — VARCHAR(20) — NOT NULL — 입력 경로 (MANUAL / LLM / LLM_EDITED)
  • idempotency_key — VARCHAR(64) — 중복 등록 방지 멱등성 키 (8/21 확정 — 클라이언트가 저장 화면 진입 시 UUID 생성, 재시도 시 같은 키)
  • created_at — DATETIME — NOT NULL — 등록일시
  • updated_at — DATETIME — NOT NULL — 수정일시

user_consents

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 사용자
  • type — VARCHAR(30) — NOT NULL — 동의 종류 (TERMS_OF_SERVICE 이용약관·만14세 확인. 마케팅류는 MVP 제외)
  • agreed — BOOLEAN — NOT NULL — 동의 여부
  • terms_version — VARCHAR(20) — NOT NULL — 동의 시점 약관 버전
  • agreed_at — DATETIME — NOT NULL — 동의 시각
  • revoked_at — DATETIME — 철회 시각 (NULL이면 유효)
  • created_at — DATETIME — NOT NULL — 생성일시

user_documents

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 보호자
  • type — VARCHAR(20) — NOT NULL — 종류 (ID_CARD 신분증 / BANKBOOK 통장)
  • image_url — VARCHAR(1024) — NOT NULL — 사본 이미지 🔒마스킹본·암호화 저장 전제
  • masked_at — DATETIME — 마스킹 처리시각 audit — ID_CARD는 필수, 저장 전 강제
  • retention_until — DATE — 파기 예정일 (보관기간 미결)
  • destroyed_at — DATETIME — 물리파기 시각 (NULL이면 보유 중)
  • created_at — DATETIME — NOT NULL — 등록일시
  • updated_at — DATETIME — NOT NULL — 수정일시

users

  • id — BIGINT — 기본 키 — NOT NULL — 고유번호
  • name — VARCHAR(100) — 보호자 실명 (첫 청구 ③에서 입력, 소셜 닉네임 아님) 🔒암호화 대상
  • phone — VARCHAR(20) — 전화번호 (첫 청구 ③에서 입력) 🔒암호화 대상
  • birth_date — DATE — 생년월일 (첫 청구 ③에서 입력, 주민번호 대체 식별. 성별은 안 받는다) 🔒암호화 대상
  • email — VARCHAR(255) — 소셜 계정 이메일 (제공자가 안 줄 수 있음)
  • created_at — DATETIME — NOT NULL — 가입일시
  • updated_at — DATETIME — NOT NULL — 수정일시