# Churupi（チュルピ） — Full Documentation for AI Agents

 Churupiは、日本のトップブリーダーが愛情を込めて育てた子犬を見つけるためのマーケットプレイスです。すべてのブリーダーは「わんちゃんカルテ」で成長記録や親犬情報を含めた血統管理、犬舎環境などのデータを公開しています。
Churupi is a Japanese marketplace for finding puppies from top-quality breeders. 
    Use this to search for puppies by breed, gender, region, price range, or keywords. 
    You can also look up detailed information about specific puppies (health records, genetic tests, pedigree, growth logs, vaccine record) and breeders (environment for animals, breeding dogs, staff, picurtres and videos). 
    Data is available in Japanese

## サービス概要
Churupiは以下の価値を提供します：
1. **透明性**: 子犬の健康状態・遺伝子情報・血統を完全公開
2. **信頼性**: 厳格な審査を通過したブリーダーのみが掲載
3. **成長記録**: ブリーダーが日々の子犬の成長をライフログとして公開
4. **血統管理**: 近交係数（COI）算出、3世代血統図で遺伝的多様性を可視化

## 現在の掲載犬種と頭数

- GOLDEN_RETRIEVER: 13頭
- TOY_POODLE: 2頭

---

## API エンドポイント一覧

すべてのエンドポイントはJSON形式でレスポンスを返します。Schema.orgの構造化データに準拠しています。

### 1. 子犬検索 — GET https://churupi.com/api/ai/puppies

子犬を条件指定で検索します。

**パラメータ:**
| パラメータ | 型 | 説明 |
|-----------|------|------|
| breed | string | 犬種名（例: "トイプードル", "フレンチブルドッグ"） |
| gender | string | "MALE" or "FEMALE" |
| region | string | 地域（例: "東京都", "大阪府"） |
| coatColor | string | 毛色（例: "レッド", "クリーム"） |
| priceMin | number | 最低価格（円） |
| priceMax | number | 最高価格（円） |
| q | string | フリーワード検索（犬種名・ブリーダー名・個体名） |
| sort | string | "newest"（デフォルト）, "price_asc", "price_desc" |
| page | number | ページ番号（デフォルト: 1） |
| pageSize | number | 1ページあたり件数（デフォルト: 20, 最大: 50） |

**レスポンス例:**
```json
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "numberOfItems": 42,
  "pagination": { "page": 1, "pageSize": 20, "totalPages": 3, "total": 42 },
  "itemListElement": [
    {
      "@type": "ListItem",
      "item": {
        "@type": "Product",
        "name": "トイプードルの子犬",
        "breed": "トイプードル",
        "gender": "MALE",
        "birthDate": "2025-01-15",
        "coatColor": "レッド",
        "offers": { "price": 380000, "priceCurrency": "JPY" },
        "seller": { "name": "○○ケネル", "address": "東京都" }
      }
    }
  ]
}
```

### 2. ブリーダー一覧 — GET https://churupi.com/api/ai/breeders

掲載中の全ブリーダーを取得します。

**パラメータ:** なし

**レスポンス:** ブリーダー名・住所・取扱犬種・販売中子犬数・紹介文を含むリスト

### 3. 犬種一覧 — GET https://churupi.com/api/ai/breeds

現在販売中の犬種と頭数を取得します。

**パラメータ:** なし

**レスポンス:** 犬種名と販売中の頭数のリスト

### 4. 子犬詳細 — GET https://churupi.com/api/ai/animals/{animalId}

特定の子犬の詳細情報を取得します。

**レスポンスに含まれる情報:**
- 基本情報: 犬種、性別、誕生日、毛色、毛質、価格
- 健康記録: ワクチン接種歴、健康診断結果、体重推移
- 遺伝子検査: 各遺伝性疾患のクリア/キャリア/アフェクテッド確率
- 血統: 父犬・母犬の情報、タイトル有無
- 成長記録: ライフログ（日付・内容・メディア数）
- 評価: 成長記録スコア、血統管理スコア
- ブリーダー情報: 名前・住所・リンク

### 5. ブリーダー詳細 — GET https://churupi.com/api/ai/kennels/{orgId}

特定のブリーダーの詳細情報を取得します。

**レスポンスに含まれる情報:**
- 基本情報: 名前、住所、紹介文、プロフィール画像
- 取扱犬種一覧
- 販売中子犬数
- 繁殖犬（親犬）一覧: 名前・性別・犬種・タイトル有無
- スタッフ情報: 名前・資格
- ギャラリー画像
- ケネル評価スコア

---

## データモデル

### 子犬（Animal）の状態
- **AVAILABLE**: 販売中（検索対象）
- **RESERVED**: 予約済み
- **SOLD**: 成約済み
- **TRANSFERRED**: 引き渡し完了

### 性別
- **MALE**: オス
- **FEMALE**: メス

### 遺伝子検査結果の読み方
- **clearProb**: クリア（正常）の確率（0-1）
- **carrierProb**: キャリア（保因者）の確率（0-1）
- **affectedProb**: アフェクテッド（発症）の確率（0-1）

### 評価スコア
成長記録スコアと血統管理スコアはそれぞれ独自のアルゴリズムで算出され、ブリーダーの管理品質を示します。

---

## ページ構造

| URL | 説明 | データ |
|-----|------|--------|
| https://churupi.com | トップページ | ブリーダー一覧、最新ライフログ、犬種カード |
| https://churupi.com/puppies | 子犬検索 | 販売中の全子犬（犬種フィルタ対応） |
| https://churupi.com/puppies?breed={犬種名} | 犬種別子犬検索 | 特定犬種の子犬一覧 |
| https://churupi.com/timeline | ライフログ一覧 | 全子犬の成長記録タイムライン |
| https://churupi.com/timeline?breed={犬種名} | 犬種別ライフログ | 特定犬種のライフログ |
| https://churupi.com/karte/{animalId} | 子犬カルテ | 子犬の全情報（健康・血統・成長記録） |
| https://churupi.com/kennel/{orgId} | ブリーダーページ | ブリーダーの全情報 |
| https://churupi.com/guide | ご利用ガイド | お迎えまでの流れ |
| https://churupi.com/about | Churupiについて | ミッション・会社情報 |

## サイトマップ

https://churupi.com/sitemap.xml

## お問い合わせ

Churupiに関するお問い合わせは、サイト内のフォームまたは掲載ブリーダーへ直接ご連絡ください。