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

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

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

// 課金時間の定義（第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