admin/charging-cabinet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
charging-cabinet/.workbuddy/memory/2026-07-07.md
12451 999885c38f feat(protocol): TCP v1.1 协议对齐 + 平台侧兜底 + 生产部署修复 
协议（唯一权威文档：docs/柜控板固件对接文档.md）
- 应答必带 act（与请求一致）、msg_id 与请求一致；判"应答 vs 指令"只看有没有 suc
- dev_id 只在 auth_str/login 携带；其余报文用内部字段 _dev_id 路由（下发前由 device-server 摘除）
- id 只表示动作目标（柜级省略 / 一段=单板 / 两段=仓体级），不再含 IMEI
- msg_id 每连接从 1 起自增；60 秒交互超时；status_post 每通道 18 字符 hex 全量上报
- 未登录连接 30 秒内未 login 即断开；未登录只放行 auth_str/login

平台侧实现
- 上行解析按新结构重写（cabinet/boards/battery），删除废弃的 status/parsed_status
- 订单：唯一入口 = on；bat_in 只登记电池台账；4 条结束路径统一走 finalize_order（含充电记录落库）
- 新增设备日志保留策略（90 天，分批删除）；未登记 IMEI 静默丢弃；停电标记按 status1 bit0 恢复清除
- 待确认第 13 项兜底：平台侧按 电压 × 电流 × 时间 积分计算订单电量（workers/energy.rs）
- 待确认第 18 项兜底：status_post bit7 连续 2 次无电池 → 判定电池被拔走并提前结单

修复（均为部署后才暴露的问题）
- 队列消费禁用 BRPOP：无限阻塞会因代理掐连接永久卡死（零错误日志）；有限超时也只是
  "超时才醒"，下行指令延迟 15~45 秒 → 改为 RPOP 非阻塞轮询，延迟降到 0.1~0.2 秒
- sync_iccid 把可空列 iccid 按 Option<String> 解码 → 整条 login 失败（ICCID 未上报的新柜子永远登录不上）
- 迁移读 information_schema.COLUMN_COMMENT 需 CAST(... AS CHAR)（MySQL 8 驱动报 VARBINARY，否则迁移 panic）
- 部署注意事项：.env 不支持行内注释；pscp 上传需 chmod +x；运行中二进制需 .new + mv 原子替换

部署
- 生产迁到 API 9000 / TCP 9001（systemd 单元补 EnvironmentFile、nginx 同步指向）
- 新增 deploy/deploy-prod.ps1（本地一键：构建→校验→备份→原子替换→重启→验收→无副作用探测）
- 废弃 deploy-prod.sh / deploy-test.sh（原脚本会在 target/release 找产物、装重复 systemd 单元、
  并用本地 .env 覆盖线上 .env）

质量
- 单测：api-server 39 个 / device-server 13 个（含协议示例逐值断言、跨模块 Redis key 契约）
- 两服务 cargo check 零错误零告警；web tsc --noEmit 通过
- test/tcp_e2e_smoke.py 端到端联调 13/13 通过
2026-09-19 23:41:09 +08:00

2.4 KiB
Raw Blame History

2026-07-07 Session Notes

完成工作：安知充H5应用设计稿 — 修复全部7屏填充色问题

问题诊断

  • 用户反馈"位置都是乱的"，截图验证发现所有7屏几乎全白/空白
  • 根因：上一轮重建时所有frame节点的 fills: [] 为空（容器无背景色），只有text节点有fills所以能看到零星文字
  • batch_read 确认：用户卡片、菜单卡片、设备卡片、订单卡片、通道卡片等所有容器的 fills 均为空数组

修复操作（共6个batch_edit批次，约120+个U()操作）

  1. Batch 1 (23 ops): 7屏背景色(登录渐变+其余#f5f5f5) + 登录表单元素(输入框白底边框+渐变按钮) + 首页卡片(组织切换/筛选标签/统计行/设备卡×2) + TabBar×2
  2. Batch 2 (10 ops): 设备列表卡×3 + 仓体详情卡片×3(状态/参数/记录) + 操作按钮×2(停止橙色/开门线框) + 订单卡×3
  3. Batch 3 (8 ops): 设备详情-信息卡白色 + 开门按钮蓝色 + 板头×6(灰蓝色调)
  4. Batch 4 (22 ops): 通道卡1-12(板1-2): 白底圆角6px + 彩色状态条(绿/蓝/红/紫)
  5. Batch 5 (22 ops): 通道卡13-24(板3离线灰色 + 板4混合状态)
  6. Batch 6 (22 ops): 通道卡25-36(板5-6混合状态)
  7. 我的页补完: 用户卡片白底 + 头像蓝底#dbeafe + 菜单卡片白底 + 退出登录按钮(红字红边框) + 底部TabBar(SVG图标)

关键技术发现

  • ardot batch_edit 中 Update 已有节点：fills 必须用 [{type:"SOLID", color:{r,g,b}}] 数组格式
  • strokes 必须用数组格式 [{type:"SOLID", color:{r,g,b}, width:N}]
  • Insert 新节点时 fill:"#FFF" 简写可用，但 Update 时不可靠

颜色修正（用户反馈"颜色不对"后修复）

  • 对照全部7个源文件的CSS，逐一修正了所有颜色
  • 登录页: 输入框背景 #f8fafc(更正白色), 边框 #e2e8f0(更正#e5e7eb)
  • 首页: 组织切换器背景 #f3f4f6(更正白色), 筛选标签激活态 #2563eb蓝(更正#dbeafe浅蓝)
  • 设备列表: 状态徽章添加背景圆角#f0fdf4/#f9fafb
  • 设备详情: 在线状态徽章/DC/AC标签添加圆角背景#f0fdf4, 导航栏添加底部边框
  • 仓体详情: 状态徽章添加圆角背景#eff6ff, 记录项添加底部边框
  • 订单: 状态徽章添加圆角背景(正常#f0fdf4/异常#fef2f2/停止#fffbeb), 订单体添加顶部边框
  • 均用 strokes: [{type:"SOLID", color:{r,g,b}, width:N}] 数组格式设置边框