Consumer contract から始める
次のシステムが本当に必要とする最小 object を定義します。公式ガイドは対応 JSON Schema 機能による制約と、より緩い JSON mode を説明しています。下流コードが field に依存するなら正確な schema を選びます。
description で意味を、constraint で形を示します。深すぎて説明の弱い object は評価と移行を難しくするため、schema を小さく保ちます。
形と意味の両方を検証
Schema conformance は required key や type が対応 constraint に合うことを保証できますが、日付の実在、citation の裏付け、業務上の許可までは証明しません。
runtime validator で parse した後に domain rule を適用します。意味が不正なら制限された経路で拒否または修復し、影響の大きい値を暗黙変換しません。
- Schema check：型、必須 key、許容値。
- Domain check：範囲、参照整合性、authorization。
- Evidence check：citation が field を本当に裏付けるか。
境界を version 管理する
出力を保存または service 間で渡すなら schema version を含めます。追加変更は互換にできますが、field 名や意味の変更には migration が必要です。
valid、boundary、意図的に不可能な fixture を作ります。モデル設定変更時は conformance rate と semantic accuracy の両方を比較します。