淘宝价保窗口核算

适用场景与前置条件

适用于淘宝/天猫消费者已经有订单和降价线索，需要先核对付款时间、数量、实付款口径和差价上限的场景。前置条件：Python 3.10 或更高版本；买家有权使用且已脱敏的订单 JSON 和政策配置。不连接淘宝、不代替保险或法律判断。

输入与输出

输入：订单引用、SKU引用、付款时间、数量、扣除运费后的实付款和举证订单单价；policy.json 提供窗口天数。输出：taobao_price_window.json，包含截止时间、WITHINWINDOW/OUTSIDEWINDOWREVIEWREQUIRED/NEEDSPAYMENTTIME、差价和上限。

安装与执行

无需第三方依赖。运行 python scripts/calculate_window.py --order examples/order.json --policy examples/policy.json --as-of 2026-08-25T10:00:00 --output examples/taobao_price_window.json。

错误恢复

付款时间、数量或价格口径缺失时停止，不猜测、不把运费、红包或积分抵扣混入实付款。窗口过期时交给负责人核对订单内当前入口和保单条件。

权限与隐私边界

只处理买家有权使用且已脱敏的本地索引，不读取账号、密码、Cookie或客户信息，不下举证订单、不申请理赔、不改写原订单。

验收

用 examples 中的脱敏样例运行，核对15天窗口、数量乘法、差价上限、两位小数和 claim_submitted=false，且原始订单 JSON 未被覆盖。