멩
테이블 (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 — 수정일시