料金計算エンジン 設計壁打ち

// 1件（＝連続して飛ぶ日の塊 ひとかたまり）あたり・税抜
合計税抜 =
    基本料金                                       // 件に1回
  + Σ日 [ 飛行料金(その日) + max(0, 貸切料金/日 − 飛行料金(その日)) ]   // ← 明細の「貸切料金」
  + Σ使用空港 空港内送迎料金 × 立ち寄り回数
  + 遠域発着料金(発地) + 遠域発着料金(最終着陸地)        // 実質フェリー料金。同じ空港でも重複排除しない
  + 海外運航料金（国際運航なら件に1回）
  + Σ海外空港 海外空港施設利用料金            // HPは空港内送迎に含めて表示する（v0も同じ扱い）
  + 早朝出発料金 + 深夜到着料金

// 立ち寄り回数（2026-09-08 実測）
立ち寄り回数(空港) = その空港への到着回数 + (発地 かつ 最終着陸地ではない なら 1)
    // 羽田→大島→羽田      = 羽田1回（行って戻るだけ。発地と最終着陸地が同じなら1回に数える）
    // 羽田→大島→羽田→大島 = 羽田2回
    // 降りずに出るだけの空港は0回（到着していないので送迎が発生しない）
    // 回送（機体移動）レグも到着として数える

// 回送（機体移動）レグ … 日をまたいで空港がつながっていないときにHPが自動で挟む
    // 飛行時間には入るが飛行料金には入らない。ただし到着として送迎の回数には数える
    前日の最終地によっては挟まれない（2026-09-08 実測）。挟まれないと翌日の出発空港には送迎料金がかからない。
    //   [大島→八丈島][成田→八丈島] → 回送 八丈島→成田 が入り 成田に送迎 120,000 がかかる
    //   [大島→香港][台湾松山→大島] → 回送が入らず 台湾松山の 650,000 はかからない
    // 挟まれない空港（全98空港を実測）= 海外17空港 ＋ 北大東 ＋ 山口宇部 の19。規則ではなく表で持つ
    // （hp-ferry-origins.json）。つまり同じレグ構成でも「日の切り方」で送迎料金が変わる。

// その日の飛行料金（★LEGごとに丸めてから足し、その値で貸切に充当する。丸める単位と順序が金額に効く）
飛行料金(日) = Σその日のLEG floorN( 課金時間(LEG)[分] ÷ 60 × 飛行単価 )
             飛行単価 = 出発地か到着地が海外なら hourly_intl（単価2） / それ以外は hourly_domestic（単価1）
                        // 判定はLEG単位（羽田→那覇は単価1・那覇→台北は単価2）
             floorN   = 1,000円未満切り捨て（HPの実挙動に合わせる。単位はパラメータで変更可）
                        // 日合計を丸めるのではない。C510 5レグの日で1,000円ずれる（決定ログJ）

// 課金時間の定義（第2版で確定）
課金時間(LEG) = ceil5( 空中ETE(直行・風補正込み) )
    空中ETE = 大圏距離 ÷ 巡航速度 × 60 + 固定分 + 風補正
              固定分   = 20分（羽田・成田の発着は30分）
              風補正   = α(季節,型式) × 東西成分 ÷ 100     // 東向きは短縮・西向きは延長
    ceil5(x) = 5分単位で切り上げ                            // 1:02 → 1:05 / 0:58 → 1:00
    // taxi は含めない（ブロックタイムは使わない）
    // テクランは考慮しない（燃料度外視で直行したときの値）

// 早朝・深夜は時刻が入力されているときだけ判定する（未入力なら加算しない）
// 風補正の季節αは各LEGの運航日の月。運航日未定の問い合わせでは当月を使う

合計税込 = 合計税抜 × (1 + 税率)

// KV: key = pricing-params  （本体化後は上のテーブルに1:1で写る）
{
  "book": { "id": "2026-04", "name": "2026年度 標準", "currency": "JPY",
            "effective_from": "2026-04-01", "is_active": true, "status": "active" },
  "rules": { "tax_rate": 0.10,
             "time_basis": "air",          // 空中ETE（ブロックではない）
             "rounding_unit_min": 5,        // 5分
             "rounding_scope": "leg",       // LEGごと
             "rounding_mode": "ceil",       // 切り上げ
             "techran": "ignore",           // 燃料度外視の直行で計算
             "amount_round_unit": 1000,     // 飛行料金の丸め単位＝1,000円（HP準拠）
             "amount_round_mode": "floor",  // 切り捨て。丸めてから貸切に充当する
             "early_before": "08:59", "late_after": "21:00" },
  "types": {
    "C510": { "label": "Mustang", "base_fee": 700000, "charter_per_day": 600000,
              "hourly_domestic": 400000, "hourly_intl": 500000,
              "overseas_ops_fee": 250000, "early_fee": 280000, "late_fee": 280000,
              "is_internal": true, "is_public": true },
    "C25C": { "label": "CJ4", "base_fee": 1050000, "charter_per_day": 750000,
              "hourly_domestic": 600000, "hourly_intl": 700000,
              "overseas_ops_fee": null, "early_fee": 280000, "late_fee": 280000,
              "is_internal": true, "is_public": true }
    // 事業機化が未定の型式を足すときは is_internal:true / is_public:false で入れる
  },
  "zones": [
    { "code": "HKD",  "name": "北海道",         "rates": { "C510": {"remote":120000}, "C25C": {"remote":200000} } },
    { "code": "AMAMI","name": "奄美以南",       "rates": { "C510": {"remote":200000}, "C25C": {"remote":320000} } },
    { "code": "OKA_S","name": "那覇以南",       "rates": { "C510": {"remote":350000}, "C25C": {"remote":520000} } },
    { "code": "TW",   "name": "台湾",           "rates": { "C510": {"remote":500000,"facility":650000},
                                                          "C25C": {"remote":750000,"facility":650000} } },
    { "code": "KR",   "name": "韓国",           "rates": { "C510": {"remote":250000,"facility":500000},
                                                          "C25C": {"remote":350000,"facility":500000} } },
    { "code": "GUM",  "name": "グアム・サイパン","rates": { "C25C": {"remote":750000,"facility":500000} } },
    { "code": "HKG",  "name": "香港",           "rates": { "C25C": {"remote":1300000,"facility":1500000} } },
    { "code": "MFM",  "name": "マカオ",         "rates": { "C25C": {"remote":1300000,"facility":550000} } }
  ],
  "airports": {
    "RJCC": { "transfer": 120000, "zone": "HKD" },
    "RJTT": { "transfer": 120000 },
    "RJGG": { "transfer": 150000 },
    "ROAH": { "transfer": 120000, "zone": "OKA_S" }
  }
}

// 見積（本体。将来HP・予約管理・各ポータルが叩く）
POST /api/pricing/quote
{
  "type_code": "C510",
  "legs": [
    { "date": "2026-08-20", "from": "RJTT", "to": "RJOO", "dep_time": "09:00" },
    { "date": "2026-08-22", "from": "RJOO", "to": "RJTT", "arr_time": "17:00" }
  ],
  "days": ["2026-08-20","2026-08-21","2026-08-22"],   // 省略時はLEGの初日〜最終日
  "options": { "early_departure": null, "late_arrival": null },  // null=時刻から自動判定
  "price_book": null,        // null=いま有効な版
  "flight_minutes": null     // 指定すればコアを呼ばずその値で計算（版比較・実績精算用）
}
→
{
  "price_book": "2026-04", "currency": "JPY",
  "lines": [
    { "code":"base",     "label":"基本料金",   "qty":1,     "unit":700000, "amount":700000, "src":"types.C510.base_fee" },
    { "code":"flight",   "label":"飛行料金",   "qty":2.083, "unit":400000, "amount":833000, "src":"types.C510.hourly_domestic" },
    { "code":"charter",  "label":"貸切料金",   "qty":3,     "unit":600000, "amount":967000, "src":"types.C510.charter_per_day" },
    { "code":"transfer", "label":"空港内送迎", "qty":1,     "unit":120000, "amount":120000, "src":"airports.RJTT.transfer" }
  ],
  "subtotal": 2620000, "tax": 262000, "total": 2882000,
  "meta": { "legs":[{"from":"RJTT","to":"RJOO","air_min":62,"billed_min":65}],
            "warnings": [] }
}

// パラメータ（設定ページが使う。書き込みは将来 社内認証必須）
GET  /api/pricing/params            // いま有効な版
GET  /api/pricing/params?book=2025-04
PUT  /api/pricing/params            // 版ごと差し替え（版を切らずに上書きはさせない）
POST /api/pricing/books/:id/activate // 有効化（他の版の is_active を落とす）
GET  /api/pricing/books

// price_books（6章の定義からの差分）
  id              // 'v0' | '2026-04' | '2026-11' ...
  label           // 表示名
  currency
- is_active       // ← 捨てる
+ effective_from   // '2026-11-01'（その日の 00:00 JST から）。null = 下書き
  note

// 有効版の決め方（as_of 省略時は「いま」）
有効版 = effective_from IS NOT NULL AND effective_from <= :as_of の中で最新のもの

// 見積（8章の /api/pricing/quote の公開版。割引は受け付けない・src は落とす）
POST /v1/quote
{ "type_code":"C510", "currency":"JPY",
  "legs":[{ "date":"2026-11-05", "from":"RJTT", "to":"RJOO", "dep_time":"09:00" }],
  "options":{ "early_departure":null, "late_arrival":null } }
// price_book は受け付けない（公開は常に「いま有効な版」）
→ { "price_book":"2026-11", "currency":"JPY", "lines":[...], "subtotal":..., "tax":..., "total":... }

GET /v1/airports          // 有効版で見積できる空港。HP側の静的一覧を捨てる
GET /v1/books             // 版の一覧と改訂日（社内画面用）
POST /v1/quote?as_of=...  // 過去時点の再現。社内のみ・公開口には出さない