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

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