WooCommerce Webhook 配置契约

适用场景与前置条件

适用于从 WooCommerce 后台或授权系统导出脱敏 Webhook 配置，先确认端点、主题、状态、签名存在性和失败计数，再进入日志核验。前置条件：Python 3.10+、有权使用的 JSON 导出；平台真实状态优先。

输入与输出

输入：Webhook 配置 JSON。输出：woocommerce_webhook_contract.json，含统一字段、缺失项、URL/状态校验和进入日志审计的条件。

安装与执行

无第三方依赖。运行 python scripts/normalize_webhook_contract.py --config examples/webhooks.json --output examples/woocommerce_webhook_contract.json。

错误恢复

缺少 ID、主题、URL、状态、签名存在性或失败计数时进入 REVIEW_REQUIRED，不猜测密钥是否有效；补齐脱敏导出后重跑。

权限与隐私边界

只处理本地脱敏配置，不读取 WooCommerce API key、secret、Webhook secret、客户数据、订单载荷或 Cookie。

验收

样例应识别有效配置、URL 不合法、状态异常和连续失败阈值复核，并保留 external_write_executed=false。