마이샵
테이블 (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