charging-cabinet/logo/纯色横向.svg

1 line
12 KiB
XML
Raw Normal View History

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:40:46 +08:00
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1511.75 413.59"><defs><style>.cls-1{fill:#0366e6;}.cls-2{fill:#fcfcfc;}.cls-3{fill:#0365e5;}</style></defs><g id="图层_2" data-name="图层 2"><g id="图层_1-2" data-name="图层 1"><path class="cls-1" d="M602.66,187.12q-1.23-3.18-.49-4.9t3.92-3.18l3.19-1.47a12.93,12.93,0,0,1,4.16-1.23q2.44,0,4.41,4.41a275.56,275.56,0,0,0,24.74,33.07,200.12,200.12,0,0,0,27.19,25.72,153,153,0,0,0,19.36-25.72,147.62,147.62,0,0,0,14.2-32.09q2.2-10,11.27-6.86l17.4,5.88q8.09,2.7,4.9,13.48a233.77,233.77,0,0,1-19,35,164.34,164.34,0,0,1-22.66,27.19,224.71,224.71,0,0,0,36.5,16.41,378.39,378.39,0,0,0,42.63,12q5.39,1.23,5.63,5.39t-3.67,7.35a48.89,48.89,0,0,0-11,14.21q-3.44,5.88-8.57,5.88a17.6,17.6,0,0,1-6.37-1.47q-9.32-3.68-19.11-7.35t-19.72-8.33q-9.91-4.65-20.09-10.65A187.1,187.1,0,0,1,671,275.8,225.94,225.94,0,0,1,627.77,298q-24.13,9.43-55.24,18.5c-2.12.65-3.76.73-4.9.24s-2.2-1.8-3.18-3.92l-1.23-3.43q-1.47-3.18-.86-4.78t3.8-3.06q9.8-3.91,20.58-8.45t21.68-9.8q10.89-5.26,21.68-11.76a208.6,208.6,0,0,0,20.82-14.33,248.64,248.64,0,0,1-24.25-29.88A361,361,0,0,1,602.66,187.12Zm89.42-84q-.74-9.55,8.32-8.82l19.11,2c2.94.33,4.94,1.22,6,2.69s1.35,3.92.86,7.35q-.5,3.93-.73,7.84t-.25,8.82q12-.24,22.42-.61t20.7-1.11q9.79-.73,9.8,7.11v8.08a6.12,6.12,0,0,1-2.21,5.15q-2.21,1.71-7.59,1.47-10.29-.24-20.83-.37t-22.29-.12v9.92a73.54,73.54,0,0,0,.49,8.69q.5,4.9-1.47,6.86c-1.31,1.31-3.67,2-7.1,2H701.14q-5.14,0-7.1-2t-1.47-6.86q.24-4.16.36-8.69c.08-3,.13-6.33.13-9.92H649.21V152.7a73.71,73.71,0,0,0,.49,8.7c.32,3.27-.17,5.55-1.47,6.86s-3.68,2-7.11,2H625q-5.15,0-7.1-2c-1.31-1.31-1.8-3.59-1.47-6.86.16-2.78.28-5.67.37-8.7s.12-6.4.12-10.16q-11.76,0-22.42.12t-20.94.37q-5.38.24-7.59-1.47a6.12,6.12,0,0,1-2.21-5.15v-8.08q0-7.85,9.8-7.11,10.29.73,20.82,1.11t22.54.61l-1-18.62q-.74-9.79,8.33-8.82l19.11,1.72c2.94.33,4.93,1.22,6,2.69s1.35,4,.86,7.6q-.5,3.67-.74,7.47t-.24,8h43.85Z"/><path class="cls-1" d="M890.26,270.41A344,344,0,0,1,859,284.86a313.81,313.81,0,0,1-31.23,10.78q-5.38,1.47-8.57-.12c-2.13-1.06-3.84-3.31-5.15-6.74l-5.63-14.69q-2.21-5.64-.13-8.82c1.39-2.12,3.88-3.27,7.48-3.43,3.43-.16,5.91-.78,7.47-1.84s3.06-3.39,4.53-7A264.85,264.85,0,0,0,842,195.45v-.24q-8.58,0-15.8.12t-13.84.37q-7.61.24-7.6-5.88v-8.09q0-6.85,7.6-6.12,9.3.49,19.1.73t23.52.25h12.25q13.71,0,23.52-.25t19.11-.73q7.59-.74,7.59,6.12v8.09q0,6.12-7.59,5.88t-15.81-.37q-8.2-.12-18.49-.12a.49.49,0,0,1-.12.36.49.49,0,0,0-.13.37,289.16,289.16,0,0,1-14.57,33.68,277.88,277.88,0,0,1-18.5,31q11-.74,21.93-2t21.92-3.18q-2.7-9.32-5.26-18.37T875.31,219q-.73-4.41,2.7-6.13l4.9-3.18c2.28-1.14,4.16-.82,5.63,1a340.56,340.56,0,0,1,33.56,54.87q1.71,2.46,1,4.53a7.59,7.59,0,0,1-2.69,3.56l-19.84,12a5.16,5.16,0,0,1-2.7.73,4.38,4.38,0,0,1-2.82-1.1,6.15,6.15,0,0,1-1.83-3.8Zm-30.38-134H841.39q-7.73,0-15.07.25c-2.61.16-4.45-.16-5.51-1s-1.59-2.37-1.59-4.66v-8.08q0-3.68,1.71-5t5.39-1.11q7.35.5,15.07.74t18.49.24h8.33q10.77,0,18.5-.24t15.06-.74q3.68-.24,5.39,1.11c1.14.9,1.72,2.57,1.72,5V131c0,2.29-.54,3.84-1.6,4.66s-2.9,1.14-5.51,1q-7.35-.24-15.06-.25H859.88Zm82.8-31.35c-.16-3.27.33-5.55,1.47-6.86s3.27-1.8,6.37-1.47L966.44,98q4.17.49,5.76,2.57t1.59,7q0,10-.12,19.1t-.37,17.64q12.26,0,21.68-.12t18-.61q11.5-.74,10.53,10.77-1.23,13.49-2.08,27.81t-1.35,34.42l-1,41.4q-.24,7.84-.24,15.43t-.49,15.43Q1016.66,314,992.66,314q-20.1,0-34.55-11.27a6.19,6.19,0,0,1-2.45-6.13l.49-5.39q.5-4.16,4.41-3.92c2.78.33,5.47.54,8.09.62a54.33,54.33,0,0,0,8.08-.37q5.88-.49,8.09-3.19t2.69-9.79q2-28.17,2.7-55.86t1.22-55.85H972.57q-1.47,32.58-5.76,56.34a196,196,0,0,1-12,41.89,126.19,126.19,0,0,1-19.48,32.09,204.18,204.18,0,0,1-28.17,27.2,4.76,4.76,0,0,1-6.37,0l-3.18-2.7a3.25,3.25,0,0,1-1.6-2.94,5.48,5.48,0,0,1,1.35-3.18,249.13,249.13,0,0,0,20.09-28.79,146.46,146.46,0,0,0,13.6-31,223.24,223.24,0,0,0,8-38.21q2.68-21.32,3.43-50.71-4.66,0-9.19.12c-3,.09-5.92.12-8.7.12q-3.91.25-5.63-1t-1.72-4.65V149.4q0-3.68,1.72-5t5.63-1.1q4.41.49,8.82.61t9.31.37Q942.92,126.37,942.68,105.06Z"/><path class="cls-1" d="M1148.46,216.27q-7.11-7.1-15.68-14.94t-16.66-14.94a89,89,0,0,1-23.88,22.9q-14.58,9.68-34.67,15.31c-1.31.17-2.16,0-2.57-.49a26,2