Files
shaguabijia-app-server/docs/api/savings-battle.md
T
OuYingJun1024 4faf0b8e16 feat(savings): 省钱战绩卡比价口径 + 关停 savings demo 兜底
- 新增 GET /api/v1/compare/stats(comparison_record: status=success 计数 + saved_amount_cents 求和),供「我的」页省钱战绩卡比价口径(完成比价 + 累计发现可省),不要求下单
- savings.py 停用 demo seeder(ensure_seeded 等移除),只计真实 source='compare';简化 beat_percent 为 compare-only
- 测试: compare/stats 用例 + savings/welfare 改纯真实语义
- 文档: 新增 compare-stats.md;更新 savings-battle.md / savings_record.md / comparison_record.md / API README

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-07 20:36:44 +08:00

1.3 KiB
Raw Blame History

GET /api/v1/savings/battle — 省钱战绩

所属:Savings 组(前缀 /api/v1/savings | 鉴权:Bearer | ← 返回 API 索引

入参

无(用户由 token 确定)。

出参

响应 200:SavingsBattleOut

字段 类型 说明
week_saved_cents int 本周已省(分)
beat_percent int 超过百分之多少用户
streak_days int 连续省钱天数
compare_count int 累计完成比价次数(= 真实 compare 上报记录数;无记录为 0

说明

下单成交口径(savings_record 源)的战绩字段。compare_count/summaryorder_count 同源(均 = 真实下单上报记录数)。

⚠️ 2026-06 起停用 demo 兜底:只计真实比价下单上报(source='compare')。下单上报链路已通(Android PriceBotServicePOST /api/v1/order/report)。

⚠️ 「我的」页省钱战绩卡已不读本接口#23 起卡改为比价口径,「完成比价 / 累计发现可省」走 GET /api/v1/compare/statscomparison_record,比过价就计、不要求下单),「赚取金币」走 /wallet/account.total_coin_earned。本 /battle(及 compare_count/week_saved_cents/beat_percent/streak_days)现仅供订单口径/历史用途,不上战绩卡。