999885c38f
协议（唯一权威文档：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 通过
1 line
11 KiB
XML
1 line
11 KiB
XML
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 879.14 993.17"><defs><style>.cls-1{fill:#0365e5;}</style></defs><g id="图层_2" data-name="图层 2"><g id="图层_1-2" data-name="图层 1"><path class="cls-1" d="M561.75,168.51H338.26a12,12,0,0,0-12,12V571.66a12,12,0,0,0,12,12H561.75a12,12,0,0,0,12-12V180.51A12,12,0,0,0,561.75,168.51ZM435.54,542.63a17.89,17.89,0,0,1-17.88,17.87H370a17.87,17.87,0,0,1-17.87-17.87V499.11A17.86,17.86,0,0,1,370,481.23h47.66a17.89,17.89,0,0,1,17.88,17.88Zm0-109.42a17.89,17.89,0,0,1-17.88,17.87H370a17.87,17.87,0,0,1-17.87-17.87V356.28A17.88,17.88,0,0,1,370,338.4h47.66a17.89,17.89,0,0,1,17.88,17.88Zm0-143.17a17.87,17.87,0,0,1-17.88,17.87H370A17.87,17.87,0,0,1,352.13,290V213.11A17.86,17.86,0,0,1,370,195.23h47.66a17.88,17.88,0,0,1,17.88,17.88ZM550.26,542.63a17.87,17.87,0,0,1-17.87,17.87H484.73a17.87,17.87,0,0,1-17.87-17.87V499.11a17.86,17.86,0,0,1,17.87-17.88h47.66a17.88,17.88,0,0,1,17.87,17.88Zm0-109.42a17.87,17.87,0,0,1-17.87,17.87H484.73a17.87,17.87,0,0,1-17.87-17.87V356.28a17.88,17.88,0,0,1,17.87-17.88h47.66a17.88,17.88,0,0,1,17.87,17.88Zm0-143.17a17.87,17.87,0,0,1-17.87,17.87H484.73A17.87,17.87,0,0,1,466.86,290V213.11a17.86,17.86,0,0,1,17.87-17.88h47.66a17.87,17.87,0,0,1,17.87,17.88Z"/><path class="cls-1" d="M866,213.59C843.57,140.24,789.75,49.54,636.74,7a16.32,16.32,0,0,0-3.48-.57c-6.81-.37-33.77-2.87-69.44-5.12-6.34-.4-13-.79-19.77-1.16L540.86,0H354.69a79.36,79.36,0,0,0-55.94,23C279.25,35.39,261.7,54.74,249,81.19L.81,597.45s-3.91,7.15,5.45,8.17h86.3s7,1.7,11.57-11.41L275,229.91V575.07a45.72,45.72,0,0,0,1.23,10.54c1,7.07,6.52,31.19,34.89,35.33H334.9v17.48s.51,2.43,4.59,2.69h35.88s2.29.76,4.08-3.83V621.06H525.37V638.3s-.9,2.14,3.19,2.85h38.17s2.42.47,2.81-5.15V621.06h23.87s10.91-2.1,14.17-4.59c28.47-2,80.58-18.68,126.8-48.7C763,549.18,793,524.06,814.09,497.53c13-16.3,32-49.53,39.23-65.28,0,0,16.85-29.36,25.54-98.8C877.59,325,884.58,274.32,866,213.59ZM599.79,563.74A39.83,39.83,0,0,1,560,603.57H344a39.83,39.83,0,0,1-39.83-39.83V179.23A39.83,39.83,0,0,1,344,139.4H448.14v-38H418c-8.68.51-2.05-7.15-2.05-7.15l42.9-69.7c3.32-1.79,4.34,3.32,4.34,3.32V81.44h30.64c5.87,1.79,3.06,6.13,3.06,6.13s-19.68,31.76-32.21,51.83H560a39.83,39.83,0,0,1,39.83,39.83Zm29.11-29V125.61c23.33,5.11,145.38,39.16,144,192.26C762.71,459.89,674.37,515.39,628.9,534.7Z"/><path class="cls-1" d="M833.67,503.48s-67.41,88.35-190.51,131.39C572,659.73,484.65,680,379.2,666.38c0,0-120-7.92-251.23-100.81-.68,2.88,97,137.43,314.8,144.21C442.77,709.78,683,731.74,833.67,503.48Z"/><path class="cls-1" d="M12.16,809q-9-.68-9,6.53v7.43a5.62,5.62,0,0,0,2,4.73c1.35,1.05,3.67,1.5,7,1.35q9.45-.21,19.25-.33T52,828.55c0,3.46,0,6.57-.12,9.35s-.19,5.44-.33,8q-.47,4.51,1.35,6.31t6.53,1.8H74.31q4.72,0,6.53-1.8t1.35-6.31a68.35,68.35,0,0,1-.45-8v-9.35h40.31q0,5-.11,9.12t-.34,8q-.45,4.5,1.35,6.3c1.2,1.21,3.38,1.8,6.53,1.8h14.87c3.15,0,5.32-.59,6.53-1.8s1.65-3.3,1.35-6.3a66.41,66.41,0,0,1-.45-8v-9.12q10.8,0,20.49.12t19.14.33q5,.22,7-1.35a5.62,5.62,0,0,0,2-4.73v-7.43q0-7.2-9-6.53-9.45.67-19,1t-20.6.57c0-3,.07-5.71.22-8.11s.38-4.8.68-7.21c.45-3.15.18-5.4-.79-6.75s-2.82-2.18-5.52-2.48l-17.56-1.8q-8.34-.68-7.66,8.11l.9,18.24H81.74q0-3.82.23-7.32t.67-6.87q.67-5-.79-7t-5.51-2.48l-17.57-1.57q-8.33-.9-7.65,8.1l.9,17.12q-11-.22-20.72-.57T12.16,809Z"/><path class="cls-1" d="M196.82,959.39a347,347,0,0,1-39.19-11,207.1,207.1,0,0,1-33.55-15.08,150.81,150.81,0,0,0,20.83-25,214.16,214.16,0,0,0,17.45-32.2q2.92-9.92-4.5-12.39l-16-5.4q-8.34-2.92-10.36,6.3a136.31,136.31,0,0,1-13.06,29.5,141.89,141.89,0,0,1-17.79,23.65,184.38,184.38,0,0,1-25-23.65,252.67,252.67,0,0,1-22.74-30.4q-1.81-4-4.06-4A12,12,0,0,0,45,860.76l-2.93,1.35c-2,.9-3.15,1.88-3.6,2.92s-.31,2.56.45,4.51A333.49,333.49,0,0,0,61,906.47a228.65,228.65,0,0,0,22.3,27.47,193.09,193.09,0,0,1-19.14,13.18q-9.92,6-19.93,10.81t-19.93,9Q14.41,971.1,5.4,974.7q-2.92,1.35-3.49,2.82c-.37,1-.11,2.44.79,4.39l1.13,3.15q1.35,2.93,2.92,3.6t4.51-.22q28.59-8.34,50.78-17a208.29,208.29,0,0,0,39.74-20.38,173.79,173.79,0,0,0,18.81,13q9.34,5.5,18.46,9.79t18.13,7.66q9,3.38,17.57,6.75a16.18,16.18,0,0,0,5.85,1.35q4.72,0,7.88-5.4a44.9,44.9,0,0,1,10.14-13.06c2.4-2,3.52-4.2,3.38-6.76S200.12,960.14,196.82,959.39Z"/><path class="cls-1" d="M416.15,829.45c-5.25.31-10.77.49-16.55.57s-12.42.11-19.93.11q.22-7.87.34-16.21t.11-17.57q0-4.5-1.46-6.42t-5.29-2.36l-14.64-1.13q-4.29-.45-5.86,1.35t-1.35,6.31q.23,19.59,0,36-4.5-.23-8.56-.34t-8.1-.56c-2.41-.15-4.13.19-5.18,1s-1.58,2.37-1.58,4.62v7.43c0,2.1.53,3.53,1.58,4.28s2.77,1,5.18.9,5.21,0,8-.11,5.59-.12,8.45-.12q-.68,27-3.16,46.62A205.54,205.54,0,0,1,340.83,929a134.64,134.64,0,0,1-12.5,28.49,230.7,230.7,0,0,1-18.47,26.46,5.09,5.09,0,0,0-1.24,2.92,3,3,0,0,0,1.47,2.7L313,992a4.38,4.38,0,0,0,5.86,0,187.69,187.69,0,0,0,25.9-25,116.16,116.16,0,0,0,17.9-29.5,179.68,179.68,0,0,0,11-38.51q3.94-21.84,5.3-51.8h17.34q-.46,25.9-1.13,51.35t-2.48,51.34c-.3,4.36-1.12,7.36-2.48,9s-3.82,2.63-7.43,2.93a49.49,49.49,0,0,1-7.43.33q-3.6-.11-7.43-.56-3.6-.23-4,3.6l-.45,5a5.65,5.65,0,0,0,2.25,5.63q13.29,10.35,31.75,10.36,22.07,0,23.65-23.2.45-7.2.45-14.18t.22-14.19l.9-38.06q.45-18.46,1.24-31.64t1.92-25.56Q426.73,828.78,416.15,829.45Z"/><path class="cls-1" d="M312.79,960.06,331,949a7,7,0,0,0,2.48-3.26,4.53,4.53,0,0,0-.9-4.17,313.08,313.08,0,0,0-30.86-50.44q-2-2.48-5.17-.9l-4.51,2.92q-3.15,1.58-2.48,5.63,2.71,8.34,5.07,16.67t4.84,16.89q-10.12,1.8-20.15,2.92t-20.16,1.81a256.22,256.22,0,0,0,17-28.49,268.05,268.05,0,0,0,13.39-31,.43.43,0,0,1,.12-.33.5.5,0,0,0,.11-.34q9.45,0,17,.11t14.53.34q7,.23,7-5.41v-7.43q0-6.3-7-5.63-8.57.46-17.57.68t-21.62.22H270.9q-12.61,0-21.61-.22T231.72,859q-7-.68-7,5.63V872q0,5.64,7,5.41,6.08-.23,12.72-.34T259,877v.22a242.06,242.06,0,0,1-5.07,26.91,247.54,247.54,0,0,1-8,26q-2,5-4.17,6.42c-1.43,1-3.71,1.54-6.87,1.69s-5.59,1.2-6.87,3.15-1.23,4.66.12,8.11L233.3,963c1.2,3.16,2.77,5.22,4.73,6.2s4.57,1,7.88.11a289.53,289.53,0,0,0,28.71-9.91q14.52-5.85,28.71-13.29l2.7,10.14a5.71,5.71,0,0,0,1.69,3.49,4.08,4.08,0,0,0,2.59,1A4.65,4.65,0,0,0,312.79,960.06Z"/><path class="cls-1" d="M244.56,823.15q6.75-.23,13.85-.23h41.66q7.08,0,13.84.23,3.6.23,5.07-.9c1-.75,1.47-2.18,1.47-4.28v-7.43q0-3.37-1.58-4.62t-5-1q-6.75.45-13.84.67t-17,.23h-7.65q-9.92,0-17-.23t-13.85-.67q-3.39-.23-5,1T238,810.54V818c0,2.1.48,3.53,1.46,4.28S242.15,823.3,244.56,823.15Z"/><path class="cls-1" d="M644.38,871.68c-.07-2.93-.11-6-.11-9.35V824.16c0-4.42.15-8.37.45-11.82q.22-9.47-9-8.78-7.87.45-16.21.56t-20,.11H580.09c-.9,0-1.84,0-2.81-.11s-2.74-.19-5.3-.34c-3.15-.3-5.4.27-6.75,1.69s-2,3.72-1.8,6.87c.15,3.45.22,7.36.22,11.71v38.28c0,3.31,0,6.42-.11,9.35s-.11,5.29-.11,7.09q-.23,4.05,1.8,6t6.75,1.69c2.56,0,4.32,0,5.3-.12s1.91-.11,2.81-.11H619.5q8.32,0,16.21.23,5.19.23,7.21-1.69t1.8-6C644.57,877,644.46,874.6,644.38,871.68Zm-26.68-2.14H590.23V820.9H617.7Z"/><path class="cls-1" d="M626.14,976.28q-.1-2.92-.11-6V916.72c0-1.58,0-3.12.11-4.62s.19-3.45.34-5.86q.67-9-8.78-8.78-6.76.45-15,.56t-18.12.12H545.41a4.23,4.23,0,0,0,2-1.8l11.48-16c1.2-2.71.68-4.65-1.57-5.86a137.6,137.6,0,0,0-18.58-9.79q-10.47-4.62-20.61-8.22l.45-.9h34.68c3.3.15,5-1.36,5-4.51v-6.3c0-2.1-.38-3.49-1.13-4.17s-2-.94-3.83-.79q-5.17.47-13.17.68t-16.33.22a81.45,81.45,0,0,0,2-10.69q.67-5.52.9-11.38v-.45q5.85,0,11.15.12c3.52.07,6.49.11,8.89.11s4.32-.37,5.3-1.13a4.27,4.27,0,0,0,1.46-3.6v-6.76q0-5.62-6.76-4.95-4.05.45-9.91.56t-12.72.34q-6.87.23-14.19.23H495.87c.45-.9.94-1.81,1.46-2.71a25.66,25.66,0,0,0,1.47-2.92q1.8-3.15.9-5.63a4.93,4.93,0,0,0-3.83-3.16l-13.51-4.27a5.43,5.43,0,0,0-5.07.22c-1.43.9-2.36,2.63-2.81,5.18-1.21,4.2-2.25,7.92-3.16,11.15s-1.91,6.34-3,9.34-2.4,6.12-3.82,9.35-3.2,6.87-5.3,10.92q-2.25,3.15.68,4.95l2.7,1.13a5.69,5.69,0,0,0,2.7.9,5.46,5.46,0,0,0,2.93-1.35,71.48,71.48,0,0,0,9.91-8.45,93.62,93.62,0,0,0,8.33-9.79h13.51A123.94,123.94,0,0,1,497,840.71h-1.58q-10.59,0-20.15-.11t-16.78-.79a4.59,4.59,0,0,0-3.6.79c-.76.68-1.13,2.07-1.13,4.17v6.3c0,3.15,1.58,4.66,4.73,4.51h33.33a68.64,68.64,0,0,1-15,21,200.23,200.23,0,0,1-22.41,18.13,13.58,13.58,0,0,0-2,1.58c-.45.45-.53,1.27-.23,2.47l1.13,2.71c.6.9,1.09,1.57,1.46,2s1.16.6,2.37.45A111.72,111.72,0,0,0,489,889.92a81.84,81.84,0,0,0,22-21.06q7.43,6.54,15.31,13.74t14.41,13.74a4,4,0,0,0,2.25,1.8H505.1q-8.33,0-14.86-.45-8.78-.68-8.56,8.78.22,3.6.23,6.08v59.11c0,1.73,0,3.38-.11,5s-.19,3.71-.34,6.41c-.3,3,.15,5.14,1.35,6.42s3.38,1.92,6.53,1.92H504.2q4.5,0,6.08-1.92c1.05-1.28,1.58-3.41,1.58-6.42v-4.5h84.22V983c0,3,.52,5.14,1.58,6.42s3.07,1.92,6.08,1.92h15.08q4.51,0,6.31-1.92c1.2-1.28,1.65-3.41,1.35-6.42Q626.26,979.21,626.14,976.28Zm-30.06-13.51H511.86V946.1h84.22Zm0-32.21H511.86V913.9h84.22Z"/><path class="cls-1" d="M787.72,854q0,29.06,29,29h31.3q7.65,0,11.26-2.25a20.44,20.44,0,0,0,6.08-5.86,30.36,30.36,0,0,0,3.6-7.54,71.22,71.22,0,0,0,2.14-8.22,58.73,58.73,0,0,0,1-7.66c.15-2.4.23-4.28.23-5.63q0-4.5-4-5.18l-3.83-.9q-3.84-.9-5.41,3.83c-1.5,5.56-3.26,9.38-5.29,11.49a10.31,10.31,0,0,1-7.77,3.15H822q-6.32,0-6.31-6.31V832.83h.23a159,159,0,0,0,53.37-15.09c2.55-1.2,4-2.62,4.39-4.28s-.34-3.3-2.14-5l-10.81-11A7.33,7.33,0,0,0,855.5,795q-2.93,0-6.08,2.93a134.92,134.92,0,0,1-33.78,21.39q0-7.87.23-14.19t.67-12.16q.68-4.5-.79-6.64c-1-1.43-2.74-2.29-5.29-2.59l-16.21-1.58q-8.12-.88-7.43,7.66.67,9.24.79,17t.11,17.9v25l-1.13-2.25A162.06,162.06,0,0,0,755.74,809a3.44,3.44,0,0,0-2.48-1,9.68,9.68,0,0,0-2.7.79l-4.95,2.47c-2.11,1.06-2.7,2.86-1.8,5.41q2.24,4.95,4.27,9.79t3.83,10q-10.12.47-20.26.23t-20.5-.68a158.87,158.87,0,0,0,17.12-17,236.53,236.53,0,0,0,15.09-19.48q2.48-3.15,1.8-6c-.45-1.88-1.8-3.19-4.06-3.95l-16-6.08a9.6,9.6,0,0,0-3.37-.67q-4.29,0-6.53,6.3a177,177,0,0,1-24.1,45.72l-7.43-.68c-3-.45-5.18,0-6.53,1.35a4.92,4.92,0,0,0-1.13,5.18l3.38,14.19q1.13,7,9,6.08a360.43,360.43,0,0,0,67.78-11.26c.6,1.65,1.13,3.27,1.58,4.84s.9,3.19,1.35,4.84c.3,2.11,1.09,3.49,2.36,4.17a4.33,4.33,0,0,0,4.17-.11L785,854.22a5.69,5.69,0,0,0,2.7-2.92Z"/><path class="cls-1" d="M870.81,941.15l-4-.9c-2.7-.6-4.5.67-5.4,3.83q-2.49,10.35-6.08,14.18a11.61,11.61,0,0,1-8.79,3.83H824.2q-8.34,0-8.33-8.33V933.27a161.62,161.62,0,0,0,26-5.18A159.1,159.1,0,0,0,867,918.4q3.82-1.8,4.39-4.27t-2.14-5l-10.81-11a7.35,7.35,0,0,0-5.18-2.48q-2.93,0-6.08,2.93a145.21,145.21,0,0,1-15.09,11.14,157.06,157.06,0,0,1-16.21,9.12q0-6.3.22-11.37t.68-10.24c.45-3.16.18-5.41-.79-6.76s-2.74-2.17-5.29-2.48l-16.22-1.57q-8.1-.9-7.43,7.65.23,4.51.45,8.56c.15,2.7.26,5.41.34,8.11s.11,5.48.11,8.33V956q0,31.31,31.31,31.3h29q8.34,0,12.28-2.47a20.9,20.9,0,0,0,6.42-6.31,35.11,35.11,0,0,0,3.94-8.44,87.52,87.52,0,0,0,2.36-9.12,61.21,61.21,0,0,0,1.13-8.45c.14-2.62.22-4.69.22-6.19Q874.64,941.83,870.81,941.15Z"/><path class="cls-1" d="M768.13,868q-7.21.45-14.75.56t-18.13.12H710.82c-5,0-10-.15-14.76-.45q-9.22-.68-8.55,9,.22,9.69.22,19.82v37.38q0,15.32-.11,26.24t-.56,21.28q-.22,5,1.57,6.87c1.2,1.27,3.46,1.91,6.76,1.91h11.48c3.3,0,5.56-.64,6.76-1.91s1.72-3.57,1.58-6.87c-.31-5.11-.49-10.33-.57-15.65s-.11-11.15-.11-17.45h35.13v13.51q0,5.63-1.69,7.2c-1.12,1.05-3.57,1.58-7.32,1.58a7.31,7.31,0,0,1-3.6,0q-3.15,0-3.38,3.38v4.95a6.43,6.43,0,0,0,2.82,5.29,23.59,23.59,0,0,0,6.75,3.49,43.69,43.69,0,0,0,7.88,1.92,47.37,47.37,0,0,0,6.2.56q20.26,0,19.59-17.79-.23-6.07-.34-12.16t-.11-12.16V919.76q0-13.51.11-23.31t.79-19c.15-3.45-.49-6-1.91-7.54S771.58,867.66,768.13,868Zm-18.47,66.88H714.53V916.38h35.13Zm0-32.42H714.53v-18h35.13Z"/><path class="cls-1" d="M410.51,212.25H377.15a8,8,0,0,0,0,16h33.36a8,8,0,0,0,0-16Z"/><path class="cls-1" d="M525.24,212.25H491.88a8,8,0,0,0,0,16h33.36a8,8,0,0,0,0-16Z"/><rect class="cls-1" x="369.16" y="355.42" width="49.36" height="16" rx="8"/><path class="cls-1" d="M525.24,355.42H491.88a8,8,0,0,0,0,16h33.36a8,8,0,0,0,0-16Z"/><path class="cls-1" d="M410.52,498.4H377.16a8,8,0,1,0,0,16h33.36a8,8,0,0,0,0-16Z"/><path class="cls-1" d="M525.24,498.4H491.88a8,8,0,0,0,0,16h33.36a8,8,0,0,0,0-16Z"/></g></g></svg> |