feat(compare): comparison_results 增加 coupon_saved(平台红包优惠额)

- schema ComparisonResultIn 显式声明 coupon_saved(否则 model_dump 丢字段)
- 上报→落库→读出贯通, 加 passthrough 测试(目标带值/源平台 null)
- 更新 api/database 文档

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/api/compare-record-report.md

@@ -31,7 +31,9 @@
 
 **Item**：`{ name: string, qty: int=1, specs: string[]\|null }`
 
-**Result（comparison_results 元素）**：`{ platform_id, platform_name, package, price(元,float\|null), is_source(bool), rank(int\|null) }`
+**Result（comparison_results 元素）**：`{ platform_id, platform_name, package, price(元,float\|null), is_source(bool), rank(int\|null), coupon_saved(元,float\|null) }`
+
+- `coupon_saved`：该平台本单**平台主优惠额**（元）——美团红包 / 淘宝平台红包 / 京东优惠券·百亿补贴，**只取那一笔**，不含配送费减免/共减总额。仅外卖目标平台带值，源平台/没用为 `null`，前端记录页据此展示**「已优惠 ¥X」**（null 不展示）。
 
 ## 服务端派生（客户端不用算）