마이샵

테이블 (20)

ai_consultations

  • id — BIGINT — 기본 키 — NOT NULL
  • member_id — BIGINT — 비로그인 임시 상담은 NULL - 논리 참조(FK 없음)
  • symptom_text — TEXT — 개인정보 마스킹 후 저장. 30일 후 삭제
  • structured_result — JSON — NOT NULL — AI 구조화 출력 5필드 원본
  • required_capabilities — JSON — structured_result와 중복 저장(검색 편의)
  • urgency_level — ENUM('LOW', 'MODERATE', 'HIGH') — NOT NULL
  • model — VARCHAR(50) — LLM 미호출은 NULL
  • prompt_version — VARCHAR(30)
  • prompt_tokens — INT
  • completion_tokens — INT
  • latency_ms — INT — NOT NULL
  • status — ENUM('SUCCESS', 'FAILED') — NOT NULL
  • error_type — ENUM('TIMEOUT', 'TEMPORARY_UNAVAILABLE', 'INVALID_RESPONSE')
  • fallback_used — BOOLEAN — NOT NULL — 규칙기반 대체 여부
  • tool_call_status — VARCHAR(20) — NOT NULL — 검색 Tool 호출 성공/실패
  • schema_parse_success — BOOLEAN — NOT NULL
  • created_at — DATETIME — NOT NULL

chat_messages

  • id — BIGINT — 기본 키 — NOT NULL
  • reservation_id — BIGINT — NOT NULL — 예약당 1개 스레드 - 논리 참조(FK 없음)
  • sender_type — ENUM('GUARDIAN', 'HOSPITAL') — NOT NULL
  • hospital_id — BIGINT — NOT NULL — 병원 단위 접근/읽음/감사용 - 논리 참조(FK 없음)
  • member_id — BIGINT — NOT NULL — 실제 발신자(보호자 또는 스태프) - 논리 참조(FK 없음)
  • body — VARCHAR(1000) — NOT NULL
  • client_message_id — VARCHAR(36) — NOT NULL — 클라이언트 재전송 UUID
  • created_at — DATETIME — NOT NULL
  • read_at — DATETIME — 상대측이 읽은 시각

hospital_capabilities

  • id — BIGINT — 기본 키 — NOT NULL
  • hospital_id — BIGINT — 외래 키 → hospitals.id — NOT NULL — 도메인 내부 FK
  • capability_type — ENUM('SPECIES', 'EXAM', 'TREATMENT', 'EQUIPMENT') — NOT NULL
  • capability_value — ENUM( 'DOG', 'CAT', 'BIRD', 'RABBIT', 'HAMSTER', 'GUINEA_PIG', 'FERRET', 'REPTILE', 'BLOOD_TEST', 'XRAY', 'ULTRASOUND', 'ORTHOPEDIC_CARE', 'DENTAL_CARE', 'OPHTHALMIC_CARE', 'REHABILITATION', 'ONCOLOGY_CARE', 'CT', 'MRI', 'ENDOSCOPE' ) — NOT NULL — 19개 확정 화이트리스트

hospital_details

  • id — BIGINT — 기본 키 — NOT NULL
  • hospital_id — BIGINT — 외래 키 → hospitals.id — NOT NULL — 도메인 내부 FK, 1:1
  • open_hours — JSON — 요일별 영업시간
  • surgery_available — BOOLEAN — NOT NULL
  • hospitalization_available — BOOLEAN — NOT NULL
  • night_care — BOOLEAN — NOT NULL
  • emergency — BOOLEAN — NOT NULL

hospital_favorites

  • id — BIGINT — 기본 키 — NOT NULL
  • member_id — BIGINT — NOT NULL — 인증된 보호자 ID - 회원 도메인 논리 참조(FK 없음)
  • hospital_id — BIGINT — 외래 키 → hospitals.id — NOT NULL — 병원 도메인 내부 FK
  • created_at — DATETIME — NOT NULL

hospitals

  • id — BIGINT — 기본 키 — NOT NULL
  • mgmt_no — VARCHAR(50) — NOT NULL — 관리번호(공공데이터 조인 키)
  • local_gov_code — VARCHAR(20) — NOT NULL — 지자체 코드
  • name — VARCHAR(200) — NOT NULL
  • phone — VARCHAR(30)
  • address_jibun — VARCHAR(255)
  • address_road — VARCHAR(255)
  • zipcode — VARCHAR(10)
  • coord_x — DECIMAL(15, 10)
  • coord_y — DECIMAL(15, 10)
  • license_date — DATE — 인허가일자
  • business_status — ENUM('OPEN', 'CLOSED_TEMP', 'CLOSED') — NOT NULL
  • close_date — DATE — 휴/폐업일
  • area — DECIMAL(10, 2) — 사업장 면적
  • source_modified_at — DATETIME — 공공데이터 최종 수정일
  • partnership_status — ENUM('PARTNER', 'NON_PARTNER') — NOT NULL

members

  • id — BIGINT — 기본 키 — NOT NULL
  • email — VARCHAR(255) — NOT NULL — 로그인 식별자. 활성 회원 기준 UNIQUE
  • password — VARCHAR(255) — NOT NULL — 해시
  • nickname — VARCHAR(100) — NOT NULL
  • phone — VARCHAR(30) — 연락처. 신규가입 필수, 기존 회원은 NULL 허용
  • role — ENUM('GUARDIAN', 'HOSPITAL_STAFF') — NOT NULL
  • hospital_id — BIGINT — 스태프 소속 병원(보호자는 NULL) - 논리 참조(FK 없음)
  • email_verified — BOOLEAN — NOT NULL — false인 동안 로그인 차단
  • failed_login_attempts — INT — NOT NULL
  • locked_until — DATETIME — NULL이면 잠금 아님
  • created_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — Soft Delete

notifications

  • id — BIGINT — 기본 키 — NOT NULL
  • recipient_type — ENUM('MEMBER', 'HOSPITAL') — NOT NULL — 고도화 3.10
  • recipient_id — BIGINT — NOT NULL — MEMBER면 memberId, HOSPITAL면 hospitalId(논리 참조)
  • member_id — BIGINT — 하위호환/백필용. MEMBER 행만 채움
  • type — ENUM( 'RESERVATION_REQUESTED', 'RESERVATION_CONFIRMED', 'RESERVATION_REJECTED', 'RESERVATION_HOSPITAL_CANCELED', 'RESERVATION_WAITLIST_OFFERED', 'PAYMENT_RESULT', 'PAYMENT_PENDING', 'NO_SHOW' ) — NOT NULL
  • content — VARCHAR(500) — NOT NULL — 알림 문구 스냅샷
  • resource_type — ENUM('RESERVATION', 'PAYMENT') — generic 참조
  • resource_id — BIGINT — 연결 리소스 id(논리 참조)
  • dedup_key — VARCHAR(150) — 멱등 발행 전용 - type:resource_type:resource_id:member_id
  • read_at — DATETIME — NULL = 미읽음. is_read는 파생값
  • created_at — DATETIME — NOT NULL

payment_items

  • id — BIGINT — 기본 키 — NOT NULL
  • reservation_id — BIGINT — NOT NULL — 항목이 매달린 예약 - 예약 도메인 논리 참조(FK 없음)
  • payment_id — BIGINT — 외래 키 → payments.id — NULL = 아직 청구되지 않은 초안. 도메인 내부 FK
  • name — VARCHAR(100) — NOT NULL — 항목 명칭(진료/검사/처치/할인 등)
  • quantity — INT — NOT NULL — 항상 양수
  • unit_price — INT — NOT NULL — signed - 할인/조정은 음수. UNSIGNED 금지
  • amount — INT — NOT NULL — signed = quantity * unit_price, 서버 산출값
  • created_at — DATETIME — NOT NULL

payment_methods

  • id — BIGINT — 기본 키 — NOT NULL
  • member_id — BIGINT — NOT NULL — 논리 참조(FK 없음)
  • billing_key_enc — VARBINARY(512) — NOT NULL — 암호화 저장
  • card_brand — VARCHAR(30) — 표시용
  • card_last4 — VARCHAR(4) — 표시용 뒷 4자리
  • status — ENUM('ACTIVE', 'EXPIRED', 'DELETED') — NOT NULL
  • is_default — BOOLEAN — NOT NULL — 보호자가 지정한 기본 결제수단
  • active_default_member_id — BIGINT — 활성+기본일 때만 member_id, 아니면 NULL(생성 컬럼)
  • created_at — DATETIME — NOT NULL

payment_refunds

  • id — BIGINT — 기본 키 — NOT NULL
  • payment_id — BIGINT — 외래 키 → payments.id — NOT NULL — UNIQUE = 환불 선점(claim). 도메인 내부 FK
  • merchant_refund_id — VARCHAR(80) — NOT NULL — PG 취소 멱등키. 재시도에도 재사용
  • amount — INT — NOT NULL — 전액 환불만 지원 - payments.amount와 동일
  • reason — VARCHAR(200) — NOT NULL — 스태프 입력 사유(감사용)
  • status — ENUM('REQUESTED', 'COMPLETED', 'FAILED') — NOT NULL
  • pg_cancel_id — VARCHAR(100) — PG 취소 식별자
  • failure_reason — VARCHAR(100) — 실패 사유 분류값(민감정보/PG 원문 금지)
  • refunded_by — BIGINT — NOT NULL — 환불 실행 스태프 member_id(논리 참조)
  • claimed_at — DATETIME — NOT NULL — 선점 시각
  • claim_token — VARCHAR(40) — NOT NULL — 선점 소유권 펜스
  • refunded_at — DATETIME — COMPLETED에서만 채워짐
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

payment_webhooks

  • id — BIGINT — 기본 키 — NOT NULL
  • webhook_id — VARCHAR(100) — NOT NULL — PortOne 이벤트 식별자(Standard Webhooks). 멱등키
  • payment_id — BIGINT — 외래 키 → payments.id — NOT NULL — 도메인 내부 FK
  • event_type — VARCHAR(50) — NOT NULL — 감사/처리 분기용(멱등키는 webhook_id)
  • received_at — DATETIME — NOT NULL
  • processed_at — DATETIME — NULL이면 미처리(재전송 시 재구동 대상)
  • reconcile_started_at — DATETIME — 재조회 선점 시각. NOT NULL이면 진행 중

payments

  • id — BIGINT — 기본 키 — NOT NULL
  • reservation_id — BIGINT — NOT NULL — 예약 도메인 논리 참조(FK 없음). 예약당 1:N(정정/복구 이력)
  • merchant_payment_id — VARCHAR(80) — NOT NULL — 외부 요청 전 서버 생성 멱등키(PortOne)
  • payment_method_id — BIGINT — 외래 키 → payment_methods.id — NOT NULL — 결제 도메인 내부 FK
  • card_brand_snapshot — VARCHAR(30)
  • card_last4_snapshot — VARCHAR(4)
  • amount — INT — NOT NULL — 0 초과, 절대 상한 300만원 이하
  • status — ENUM('PENDING', 'PAID', 'OFFLINE_REQUIRED', 'OFFLINE_PAID', 'REFUNDED') — NOT NULL
  • payment_channel — ENUM('BILLING_KEY', 'OFFLINE') — NOT NULL
  • retry_count — INT — NOT NULL
  • failure_reason — VARCHAR(200)
  • pg_payment_id — VARCHAR(100) — PortOne 결제 식별자(단건조회용)
  • offline_required_at — DATETIME
  • offline_settled_at — DATETIME
  • offline_settled_by — BIGINT — 오프라인 수납 스태프 member_id(논리 참조)
  • created_at — DATETIME — NOT NULL
  • paid_at — DATETIME
  • refunded_at — DATETIME — 전액 환불 확정 시각(#37)
  • superseded_at — DATETIME — 재청구로 대체된 시각. NULL이면 활성
  • correction_of — BIGINT — 정정 재청구 원본 payments.id(도메인 내부, FK 미설정 - 자기참조 이력)
  • recovery_of — BIGINT — 셀프 복구 원본 payments.id(도메인 내부, FK 미설정 - 자기참조 이력)
  • active_reservation_id — BIGINT — 활성일 때만 reservation_id, 아니면 NULL(생성 컬럼)

pet_profiles

  • id — BIGINT — 기본 키 — NOT NULL
  • member_id — BIGINT — 외래 키 → members.id — NOT NULL — 소유 보호자 - 도메인 내부 FK
  • name — VARCHAR(50) — NOT NULL
  • species — ENUM('DOG', 'CAT', 'BIRD', 'RABBIT', 'HAMSTER', 'GUINEA_PIG', 'FERRET', 'REPTILE') — NOT NULL
  • age — INT
  • weight — DECIMAL(6, 2)
  • neutered — BOOLEAN
  • image_url — VARCHAR(2048) — S3 presigned 업로드 후 URL만 저장
  • created_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — Soft Delete(예약이 pet_id 참조)

reservation_events

  • id — BIGINT — 기본 키 — NOT NULL
  • reservation_id — BIGINT — 외래 키 → reservations.id — NOT NULL — 도메인 내부 FK
  • event_type — ENUM( 'CHECKED_IN', 'AUTO_NO_SHOW_PENDING', 'AUTO_NO_SHOW', 'MANUAL_NO_SHOW', 'HOSPITAL_CANCELED', 'NO_SHOW_CORRECTED', 'TIMEOUT_REJECTED' ) — NOT NULL
  • memo — VARCHAR(255)
  • processed_by — BIGINT — 수동 처리자 회원 ID. 자동 처리면 NULL(논리 참조)
  • occurred_at — DATETIME — NOT NULL

reservation_slots

  • id — BIGINT — 기본 키 — NOT NULL
  • hospital_id — BIGINT — NOT NULL — 병원 도메인 논리 참조(FK 없음)
  • start_at — DATETIME — NOT NULL
  • end_at — DATETIME — NOT NULL
  • business_date — DATE — NOT NULL — 운영 구간이 시작된 영업 기준일(야간 슬롯은 전날)
  • status — ENUM('OPEN', 'RESERVED') — NOT NULL
  • version — BIGINT — NOT NULL — 낙관적 락(@Version)

reservation_waitlists

  • id — BIGINT — 기본 키 — NOT NULL
  • member_id — BIGINT — NOT NULL — 논리 참조(FK 없음)
  • slot_id — BIGINT — 외래 키 → reservation_slots.id — NOT NULL — 예약 도메인 내부 FK
  • status — ENUM('WAITING', 'OFFERED', 'ACCEPTED', 'REJECTED', 'EXPIRED', 'CANCELED') — NOT NULL
  • offered_at — DATETIME
  • offer_expires_at — DATETIME
  • responded_at — DATETIME
  • canceled_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • version — BIGINT — NOT NULL — @Version 낙관적 락

reservations

  • id — BIGINT — 기본 키 — NOT NULL
  • member_id — BIGINT — NOT NULL — 요청 보호자 - 논리 참조(FK 없음)
  • pet_id — BIGINT — NOT NULL — 대상 반려동물 - 논리 참조(FK 없음)
  • pet_name_snapshot — VARCHAR(50) — NOT NULL — 예약 시점 이름 스냅샷
  • pet_species_snapshot — VARCHAR(30) — NOT NULL — 예약 시점 종 스냅샷
  • hospital_id — BIGINT — NOT NULL — 병원 도메인 논리 참조(FK 없음)
  • slot_id — BIGINT — 외래 키 → reservation_slots.id — NOT NULL — 점유 슬롯 - 예약 도메인 내부 FK
  • payment_method_id — BIGINT — NOT NULL — 결제수단 - 결제 도메인 논리 참조(FK 없음)
  • status — ENUM( 'REQUESTED', 'CONFIRMED', 'REJECTED', 'CANCELED', 'CHECKED_IN', 'HOSPITAL_CANCELED', 'NO_SHOW_PENDING', 'NO_SHOW', 'IN_TREATMENT', 'TREATMENT_COMPLETED' ) — NOT NULL
  • reject_reason — VARCHAR(255)
  • requested_at — DATETIME — NOT NULL
  • approval_deadline_at — DATETIME — NOT NULL — 생성 시 계산한 병원 승인 마감
  • approval_timeout_next_retry_at — DATETIME
  • confirmed_at — DATETIME
  • canceled_at — DATETIME — 보호자 취소 시각
  • hospital_cancel_reason — VARCHAR(255) — 병원 확정 예약 취소 사유
  • hospital_canceled_at — DATETIME(6) — 병원 확정 예약 취소 시각
  • no_show_pending_at — DATETIME
  • no_show_at — DATETIME
  • reviewed_at — DATETIME — 현재 리뷰 작성권 사용 시각. 환불 확정 시 NULL로 초기화

reviews

  • id — BIGINT — 기본 키 — NOT NULL
  • reservation_id — BIGINT — NOT NULL — 예약당 활성 리뷰 1개 - 논리 참조(FK 없음)
  • hospital_id — BIGINT — NOT NULL — 논리 참조(FK 없음)
  • member_id — BIGINT — NOT NULL — 작성자 - 논리 참조(FK 없음)
  • rating — DECIMAL(2, 1) — NOT NULL — 1.0~5.0, 0.5 단위
  • content — TEXT — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

schema_migrations

  • migration_key — VARCHAR(100) — 기본 키 — NOT NULL — 예: email_verified_backfill_v1
  • applied_at — DATETIME — NOT NULL