已完成用户APP首期功能开发

交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过;完整测试仍有2项失败,后端模型注释检查未通过,详见交付记录。
This commit is contained in:
czl231
2026-09-13 00:57:32 +08:00
parent a0a4bb1218
commit 3ef33b531d
793 changed files with 40959 additions and 1204 deletions

View File

@@ -0,0 +1,27 @@
# 开发日志:退瓶退押金首期闭环
操作时间: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组视觉变体通过。
- 总后台资源合同、类型检查和生产构建通过。
- 远程账号当前无押金记录,因此内置浏览器只能验证真实空态,没有写入伪造押金或退款记录。
## 风险评估
最近安检合格日期尚无用户端权威查询接口,页面保留位置并标明“暂未开放”。真实资金闭环已实现,但上线前仍需用业务押金数据完成实际端到端演练。