01 / DECIDE
Architecture decision
最初の production call 前、または複数機能が同じ credential と reliability policy を共有するときに使う。
認証、request ID、timeout、error 正規化を server-owned adapter に集約し、UI から platform を直接呼ばない。 input、output、state、side effect を一つの観測可能な経路にしてから、API request を製品境界にする の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。最初の production call 前、または複数機能が同じ credential と reliability policy を共有するときに使う。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。認証、request ID、timeout、error 正規化を server-owned adapter に集約し、UI から platform を直接呼ばない。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。contract test で redaction、timeout、retry 分類、provider request identifier の伝播を確認する。
03 / BOUND
Production boundary
長期 API key は server に保持し、送信データを制限し、cancel と retry の意味を caller に公開する。
04 / PROVE
Acceptance evidence
contract test で redaction、timeout、retry 分類、provider request identifier の伝播を確認する。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://developers.openai.com/api/docs/quickstart' | sed -n '1,5p'