寄当家 2.2.0 界面与业务调整

本次对应 2026-10-03 提供的 18 张批注截图。暖黑、香槟金、暖米白主题及首页五项横向指标保留，服务器地址仍由代码中的 ServerSettings.BaseUrl 固定。

截图要求对应

图片	对应修改
1	回收选择客户改为搜索页，支持姓名、电话、客户编号及加载更多。
2	回收或铺货直接填姓名、电话时，在入库事务中自动建档；已有相同电话关联原档案。同电话对应多个客户时提示先搜索选择，黑名单不能通过直接填写绕过。
3、4、5	原黄金、白银、铂金等整合为贵金属大类，下设黄金、白银、铂金、其他材质；表单依次显示名称、类型、材质、克重、成色、单价、品牌、序列号、附件、金额、客户报价及照片。金额自动计算，支持手动改价和重新计算。
6	付款方式依次为银行转账、微信、支付宝、现金、其他，入库默认银行转账。
7	移除首页行情卡片右下角的融通金跳转，报价连接及实时更新保留。
8	回收和铺货大类为贵金属、奢侈品、珠宝/饰品、名表、电子产品、其他；不显示车辆或房产。
9	当单收费方式显示开当收取、按期结算，保留原收费和续赎业务逻辑。
10	寄卖大类依次为贵金属、奢侈品、名表、珠宝/饰品、电子产品、车辆、其他。
11、13	租赁移除寄卖佣金；每件租赁物品按类别填写完整资料，包括具体物品编码、型号、序列号和照片，详情中显示租出的物品。
12	寄卖移除押金，增加客户期望金额或区间、百分比/固定服务费、默认零保管费、实际成交金额及自动计算的实收服务费；未成交可先保存，成交后在详情录入并结算。
14、15、16	回收、铺货库存均可切换大类及贵金属材质，显示所选库存成本；黄金、白银、铂金展示总克重、总成本、平均克价、实时价值、估值收益及收益率。
17	当物字段随类别切换；房产使用原 APK 中的坐落/地址、面积、产权证号，车辆使用车牌号、车架号、里程。名表、电子产品、奢侈品等显示相应品牌、型号、序列号和扩展资料。
18	普通设置移除广告管理与社群链接编辑。服务器管理员在 APP 管理后台统一发布；服务端管理接口校验真实管理员角色，普通账户无法写入。使用帮助仍对所有账户开放。

计算与数据保存

贵金属入库金额 = 克重 × 入库单价，自动计算保留两位小数。手动改价后继续调整克重/单价不会覆盖手动金额；点击「按克重和单价重算」恢复计算。
平均克价 = 所选材质的总成本 ÷ 总克重，采用加权平均。回收库存和铺货库存分别计算；在库、在售、已售也分别筛选。
当前库存价值 = 每件物品克重 × 对应融通金回收报价之和；估值收益 = 当前价值 − 总成本，收益率 = 估值收益 ÷ 总成本 × 100%。估值收益不生成经营财务流水。没有有效克重或报价时显示等待数据；断线显示最近报价时间。
百分比寄卖服务费 = 实际成交金额 × 比例 ÷ 100；固定金额方式按填写金额收取。支付客户 = 实际成交金额 − 实收服务费 − 保管费。例如成交 4,800 元、服务费 10%、保管费 20 元，实收服务费 480 元，支付客户 4,300 元。
寄卖结算在同一个事务中保存成交金额与费用、生成收款及客户净款支出，并关闭业务。拒绝重复结算、费用超过成交款等情况。租赁归还仍按租金和押金结算。

原 SQLite 表及旧类型代码保留，升级只增加材质、单价、物品编码、详细业务物品及寄卖费用字段。旧 GOLD/SILVER/PLATINUM/PALLADIUM 库存继续按材质筛选，旧寄卖佣金按固定金额兼容。新增资料一并参与备份和恢复。

服务器广告

入口为「设置 → 管理员工具 → 进入管理后台 → 全局广告与社群管理」。支持广告图片、文字、HTTPS 链接、排序、启停、删除以及官方社群地址。普通账户只读取服务器启用的内容，旧门店本地广告配置不再影响首页。

门店首页联网同步后，每分钟检查更新；离线显示最近发布内容。所有广告停用或删除后，联网首页隐藏广告区域。多位管理员同时编辑时校验内容版本，修改冲突需刷新重试。

APP 和服务器均须升级到 2.2.0。 服务端保留原数据目录，启动时增加内容表；原账户、卡密、授权及社群记录保留。部署步骤见服务器部署。

验证

业务、备份、授权及内容存储检查记录见 business-checks.txt，全局内容 HTTP 权限、发布和冲突检查见 content-checks.txt。模拟器检查使用 Pixel 7 / API 36、独立测试应用和本机服务器，与正式安装应用的数据隔离。

Pixel 7 / API 36 已通过 15 项界面检查及 18 项保存数据核验，记录见界面检查和数据核验。模拟器实际完成回收自动建档、搜索选客、房产典当、详细租赁、寄卖成交结算、两类黄金库存入库，以及管理员发布广告和普通账户同步查看。另已复查 24 项登录管理 HTTP、60 项实际登录卡密及 202 项私聊与帖子 HTTP 检查，行情连接收到 4 个品种的真实报价。

界面	验证截图
客户搜索	回收客户搜索
分类字段	房产字段、租赁物品编码
寄卖结算	成交金额及服务费
库存	回收黄金、铺货黄金
管理员内容发布	管理后台、首页同步广告
普通账户权限	普通账户设置

2.2.0 正式 APK 已通过签名和版本信息核验，继续使用本项目原签名证书；正式包保持公网服务器地址，本机测试使用独立包名与本机地址。相机拍照、文件选取、实际系统打印和分享仍按设备验收在使用设备上验证。