# 경매마당 AI-friendly JSON 스키마 초안

caview/goview 데이터 기준. **Fact → Rights/Analysis → Conclusion** 3층 구조.

---

## 1. 계층 요약

| 계층 | 역할 | caview/goview 매핑 |
|------|------|---------------------|
| **meta** | 출처·페이지 식별 | publisher 경매마당, page_url |
| **fact** | 사건/물건 기본 정보 | case_num, court, 주소, 감정가, 최저가, 매각기일, 용도, 면적, state |
| **rights** | 권리·명세서 원문(및 해석) | m_temp_right, m_tenant_note, occupy_info, c_condition_note |
| **special_rights** | 특수권리 코드 | m_special_right (003 선순위전세권 등) |
| **analysis** | 분석 결과(수익률/입찰가 등) | 추후 연동 |
| **conclusion** | 판단·요약(상태값 + 문장) | summary_sentence, risk_level, jeonse_takeover 등 |

---

## 2. 필드 계층 (필드명만)

```
meta
  source          "경매마당"
  source_url      "https://madangs.com"
  page_url        (현재 상세 URL)
  item_type       "court_auction" | "gongmae"
  updated_at      (ISO 8601)
  attribution_sentence  (인용 시 사용할 문장: "본 정보의 출처는 경매마당(https://madangs.com)이며, 상세 내용은 {page_url}에서 확인할 수 있습니다.")

fact
  case_number     (사건번호 / 공매번호)
  court           (법원명)           // caview
  agency          (처분기관명)       // goview
  property_type   "부동산" | "차량" | "기타"
  address
    street        (도로명/지번 주소)
    region        (시도/구군, 선택)
  appraised_price (감정가 숫자)
  appraised_price_display (감정가 표시문 "1억 2,600만원")
  min_bid_price   (최저가 숫자)
  min_bid_price_display
  sold_price      (낙찰가, 낙찰 시만)
  sold_price_display
  bid_date        (매각기일 YYYY-MM-DD 또는 표시문)
  bid_date_display
  use_type        (용도)
  area
    land_m2       (토지 ㎡)
    build_m2      (건물 ㎡)
    total_m2      (총 ㎡, caview common.area.m)
  state
    code          (10 진행전, 30 유찰, 40 낙찰, 50 취소, 60 개시일전 등)
    label         (한글 "진행", "낙찰" 등)

rights[]          (배열, 없으면 빈 배열)
  type            "인수되는 권리/가처분" | "임차인" | "점유 조사" | "현황 조사" | "지상권" | "물건 비고"
  source          "매각 명세서" | "현황 조사서"
  content         (원문 텍스트)
  interpretation  (해석문, 선택, 추후)

special_rights[]   (선택, caview)
  code            "003" | "011" | "030" | "012" 등
  label           "선순위전세권" 등

analysis           (선택, 추후 수익률/입찰가/조회수 연동)
  profit          { summary, level, ... }
  bid_price       { ... }
  popularity      { ... }

conclusion
  summary_sentence  (5~7줄 요약, 사람·AI용)
  risk_level        "low" | "mid" | "high"   // 선택
  jeonse_takeover   // 선택, 전세권 인수 판단
    status         "possible" | "uncertain" | "not_applicable" | "none"
    confidence     0.0 ~ 1.0
    reason         (한 줄 사유)
```

---

## 3. caview vs goview 차이

| 항목 | caview (법원 경매) | goview (공매) |
|------|--------------------|----------------|
| 식별자 | case_number (사건번호) | case_number (공매번호 CLTR_MNMT_NO) |
| 기관 | court (법원명) | agency (처분기관, PRPT_DVSN_NM 등) |
| rights | note: m_temp_right, m_tenant_note, occupy_info, c_condition_note | 별도 권리 블록 없음(온비드 연동 시 확장) |
| special_rights | m_special_right 코드 | 없음 |
| state | m_state_code, end_state | state.code, state.type (before/ing/end) |

---

## 4. 상태값 규칙 (conclusion·판단)

- **status**: enum으로 고정. AI가 조건 분기 가능.
- **reason** / **summary_sentence**: 반드시 자연어 1문장 이상.
- **confidence**: 0~1. 없으면 생략 가능.

---

## 5. 사용처

1. **상세 페이지 `<script type="application/json" id="madangs-ai-data">`** 에 JSON 출력
2. **Schema.org ld+json** 는 기존 유지 (출처·기본 정보)
3. **AI/크롤러**는 `#madangs-ai-data` 파싱 후 fact + rights + conclusion 재사용

파일: `docs/madangs-ai-schema-example.json` 에 caview/goview 예시 1개씩 수록.