広告・アフィリエイトによる運営を予定していますが、本稿に成果リンクはありません。証拠の閲覧を購入・申込・メール登録の条件にしません。
1. 何を測ろうとしたか
中断した予備検証レポートの対象は、合成問い合わせをWordPressの独自bridgeからHubSpot Contacts APIへ送り、READ照合する構成です。実サービスへの試行(actual)と、ローカルの模擬試験(mock/offline)は分離します。模擬結果でactualの欠測を補いません。
fixtureは合成データです。実顧客の本番運用、問い合わせ別履歴、フォーム送信イベント、流入帰属、同意の取得を、Contact作成だけで確認済みとはしません。
2. 試験条件と識別の考え方
fixtureは入力と期待結果の固定定義、caseはその1ケース、runは1回の試行、stageはCanary/Smoke5/Pilot20などの試験段階を表します。同じcase番号でも、異なるstageの結果は別物です。
この公開候補では公開用case番号001〜020を用います。内部の実行識別子、認証情報、非公開保管先は掲載しません。番号と原証拠の対応は編集管理で保持し、別試行の証拠を同じケースの結果へ混ぜません。
| 条件 | 確認範囲と限界 |
|---|---|
| 対象経路 | WordPress受付 → 独自bridge → Contacts API → READ照合 |
| fixture | b01-inquiries-v2、合成入力の固定20ケース |
| API固定版 | 2026-03。現在の別版や別APIで実行した結果へ置き換えない |
| 実行環境・時刻 | software version、利用plan、実行UTC日時等の公開用条件表は未整備 |
| 文書の確認日 | 2026-09-12。実行日時・公式仕様の改定日を意味しない |
再現用の固定時計は実際の実行時刻ではありません。記録名に含まれる時刻や事前検証の時刻で、実行UTC日時や実遅延を補完しません。
3. 固定ケースの期待と、今回の実績は別
各case最大1 POST、合計上限20という安全上限とは別に、正常時は17 POSTと0 POSTの3ケースを期待する定義です。予定20ケースは、Contactを20件作成する計画ではありません。
| 区分 | 事前に定義した正常期待 |
|---|---|
| 006/013/017以外の17ケース | 各1 POST、新規作成、固有のCRM照合証拠、必要項目一致 |
| 006 | 送信前の中断を観測、0 POST、CRMに該当Contactがない |
| 013 | 必須項目の検証拒否、0 POST、CRMに該当Contactがない |
| 017 | 016と同じレコードへの冪等一致、0 POST、更新なし、元の項目維持 |
006・013でContactが見つからないだけでは、期待した中断・拒否が動いたとは分かりません。017も「新しいContactなし」だけでは冪等処理を証明できません。case別の確認範囲で、期待と観測を並べています。
4. outcomeと状態の読み分け
4指標の分母は投入したfixture件数です。期待どおりの入力検証拒否や冪等処理を、想定外失敗と同じものにしません。
| 指標 | 定義 |
|---|---|
| expected_outcome_match_rate | 事前に定めた期待と終端結果が一致した割合 |
| accepted_or_idempotent_rate | 受付を期待し、新規受付または安全な冪等処理になった割合 |
| expected_validation_rejection_rate | fixtureの期待どおり入力検証で拒否した割合 |
| unexpected_failure_rate | 想定外エラー、未終端、期待と異なる終端の割合 |
既存集計は、計画全体の終端分類にunknownが残れば4率をnullにします。今回の率は未算出です。残存した6件へ分母を縮めたり、前段試験を足したりしません。中断の原因が未確定なので、想定外失敗のケース内訳も推定しません。
| 表示 | 意味 |
|---|---|
| confirmed/確認済み | 特定の根拠で確認した事実だけ。Contact存在の人間照合は、全項目やcase全体の合格を意味しない |
| not measured/測定なし・欠測 | 利用できる測定値がない。Pilotではhost sample未保存で、計測処理自体が始まらなかったとまでは断定しない |
| not executed/未実行 | 未実行を示す証拠がある場合だけ。記録欠如から今回の後続caseへ付けない |
| indeterminate/判定不能 | 必要な証拠が揃わず、結果を確定できない |
| unavailable/証拠未提供・未生成 | 保存資料や配布資料を利用できない。数値0ではない |
| not applicable/対象外 | 指標の対象ではない。006/013/017のcreate latencyなど |
これらは読者向けの表示区分であり、測定の合否規則を後から増設したものではありません。
5. CRM照合と人間のreconciliation
新規作成ケースは、存在、対象との一致、required property、レコード識別の証拠を必要とします。017ではさらに016との同一性、006/013では定義された不存在の確認が必要です。propertyの定義を取得する操作は、Contactに保存された値の全項目照合とは異なります。
ケース・stage全体の完了には、送信・終端・照合・latency等の証拠も必要です。人間の事後reconciliationは、停止後に追加送信せず確認した別の証拠です。今回は6 Contactの存在と対象caseへの帰属を確認した申告として扱い、APIによる全項目一致の代替にはしません。
6. latencyの定義と欠測
正式指標はsubmission_to_verified_crmです。正常完走時は新規作成17ケースのsampleを必要とします。
| 要素 | 既存の定義 |
|---|---|
| 起点 | caseのbrowser処理を開始する直前。必要なcontext準備、ページ表示・入力・送信・case後処理を区間に含む。case間の待機は起点より前 |
| 終点 | CRM照合で存在と項目一致の両方を確認した時点。READ照合を含む |
| 時計 | 同一host processの単調時計performance.now() |
| 値 | 終点−起点をMath.roundで整数msへ丸める |
| 中央値 | 昇順の中央値。偶数sampleなら中央2値の平均 |
| p95 | 昇順のceil(n×0.95)番目、1始まり。nは利用できるsample数。空なら中央値・p95ともnull |
送信ボタンのクリックからの時間、POST応答時間、CRM内部の正確な作成時間とは異なります。小標本のp95は将来の95%保証やSLAではありません。
Pilotには利用できるhost実測sampleが保存されておらず、各値・中央値・p95は欠測です。0 ms、timeout設定値、固定時計、UI事後確認時刻、他stageの値で埋めません。006/013/017はこのcreate latencyの対象外で、欠測の新規作成ケースとは区別します。
7. 読者が確認できるEvidenceと、確認できないこと
Evidence要約には、stage別の状態、全20ケースの事前期待、保存記録と人間申告の範囲、欠測・判定不能を記載しています。これは新しいactual datasetではなく、既存証拠から作った編集上の派生資料です。
読者は要約間の整合性や定義を確認できますが、原証拠は非公開であり、全POST数・全項目・各率を第三者が独立に再計算できる状態ではありません。公開用の環境表、検査済みraw抜粋、配布datasetは未整備です。Pilotのcompleted raw/processed/report/manifestは未生成で、残存記録を代わりのpassed artifactにしません。
Canary/Smoke5の正式完了は別stageとして保持します。Canaryの保存された12比較は標準4項目と検証用8項目で、現行Pilotの必須12項目集合と同一ではありません。別stageの証拠でこのPilotの不足を埋めません。
8. 非公開にする情報
認証情報、実顧客の個人情報、アカウント情報、内部管理用の識別子・リンク、合成データに含まれる不要な本文を掲載しません。秘密情報を消したという理由だけで、未完成の証拠を完成datasetに扱うこともありません。
安全策は法令適合や安全性認証の保証ではありません。媒体の公開方針・データ取扱方針は、実際の運用に照らした別の公開レビューを必要とします。
9. 再試行・訂正・履歴
このPilotは再試行しません。追加POSTや別の試行、mockの結果で欠測を補わず、元のindeterminateと原証拠を保持します。Full100もHOLDです。
後から確認できた事実は、対象の主張、確認方法、確認日、以前の記述、変更理由を分けて追記します。人間照合を理由に元の実行記録をpassedへ書き換えません。訂正後も「当時何を確認できなかったか」が残るようにします。
2026-09-12:内部方法論初稿を再利用し、読者向け公開候補を作成。説明の版の変更であり、測定定義・dataset版・元の合否は変更していません。新しい実測・Web取得・公開はありません。