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

1 line
11 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 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