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

操作时间：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组视觉变体通过。
- 总后台资源合同、类型检查和生产构建通过。
- 远程账号当前无押金记录，因此内置浏览器只能验证真实空态，没有写入伪造押金或退款记录。

## 风险评估

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