platforms/docs/开发日志_押金管理首期底座与真实空态_20260911.md

开发日志：押金管理首期底座与真实空态

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

操作类型：新增/扩展

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

操作前状态

个人中心的押金入口只能提示缺失，没有独立页、用户端接口、押金规则或押金记录后台入口。

具体操作

• 新增 deposit_policy 和 deposit_record 模型及增量迁移，迁移为表和每个字段添加中文注释。
• 新增登录用户的 GET /heqi/client/v1/user/deposits，只按 JWT 当前账号返回可退金额、在押数量、状态明细和规则。
• 新增 /deposits 页面，按最新图16实现汇总、四筛选项、明细卡和规则查看。
• 总后台新增“押金规则”和“押金记录”菜单；规则可新建编辑，记录只读。
• 修复后台新资源的字段中文名和显式编辑规则，消除启动时空白页。

操作后状态

内置浏览器可见后台押金规则空列表，App 真实账号显示 ¥0.00、0个和“暂无押金记录”。没有伪造产品稿的示例金额或记录。

验证结果

• Flutter analyze、押金页定向测试、8组视觉尺寸和 Web release 构建通过。
• Go 客户逻辑、路由和平台资源测试通过，真实登录读取返回空列表。
• 后台资源合同检查、类型检查和生产构建通过；既有 lint 仍有2个旧错误和203个旧警告。

风险评估

后续图17批次已建立退瓶申请、上门回收、验收扣减、余额退款和不可变资金流水，本日志中的初始缺口已关闭。当前剩余风险为远程账号没有真实押金数据，尚不能进行一次不伪造数据的端到端演练。