01 / DECIDE
Architecture decision
document や media を後続 API operation で参照する場合に使う。
owner、purpose、content type、processing state、retention、expiry、derived index、deletion を追跡する。 input、output、state、tool、side effect を一つの観測可能な経路にし、uploaded file に lifecycle を与える の owner を決めます。
02 / OPERATE
3段階の field procedure
- 01
contract を lock
caller、data classification、success condition、timeout、cancel、ownership を記述します。document や media を後続 API operation で参照する場合に使う。
- 02
bounded path を実行
correlation、typed state、reversible failure を持つ一つの end-to-end path を作ります。owner、purpose、content type、processing state、retention、expiry、derived index、deletion を追跡する。
- 03
signal を検証
acceptance を再実行可能な fixture、contract test、browser test にします。lifecycle test で upload、processing、reject、expire、delete、unauthorized access、orphan cleanup を確認する。
03 / BOUND
Operational boundary
type/size を検証し public exposure を避け、deletion を全 dependent resource に伝播させる。
04 / PROVE
Acceptance evidence
lifecycle test で upload、processing、reject、expire、delete、unauthorized access、orphan cleanup を確認する。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://docs.x.ai/developers/advanced-api-usage/files' | sed -n '1,5p'