platforms/docs/开发日志_退瓶退押金首期闭环_20260911.md

开发日志：退瓶退押金首期闭环

操作时间：2026-09-11 22:50

操作类型：新增/扩展

影响模块：用户端 App、Client API、平台总后台、远程 PostgreSQL 增量表

具体操作

• App 新增 /deposits/return，只列出服务端允许退瓶的本人押金记录。
• 地址只能选本人有效地址；预约须晚于30分钟后、时段不超过4小时且不超过31天。
• 用户需逐项确认瓶体、阀门、停止使用和规则，并通过最终确认对话框后才提交。
• Client API 新增幂等创建、本人查询和未上门取消；取消后可用新请求号重新申请。
• 总后台新增“退瓶处理”，状态严格按待上门、待验收、待退款、已完成流转。
• 验收扣减不得超过原押金；退款与钱包余额、押金状态、退瓶状态及 deposit_refund 流水同事务提交。

验证结果

• Go 预约边界、路由、客户逻辑和平台逻辑测试通过，go vet 及构建通过。
• Flutter analyze、押金页和退瓶页定向测试通过；320/360/390/430 与 1.0/1.3 文字缩放共8组视觉变体通过。
• 总后台资源合同、类型检查和生产构建通过。
• 远程账号当前无押金记录，因此内置浏览器只能验证真实空态，没有写入伪造押金或退款记录。

风险评估

最近安检合格日期尚无用户端权威查询接口，页面保留位置并标明“暂未开放”。真实资金闭环已实现，但上线前仍需用业务押金数据完成实际端到端演练。