rack：「固件」页 —— 上传 .bin、选板推送 OTA、实时看进度 / 待验证 / 回滚

- firmware.py：固件库。上传时核 ESP 镜像头（0xE9 + app 描述 + project_name == phonerail + ≤3 MB），
  存成 /root/phonerail/fw/<sha 前 16 位>.bin（nginx 7765 放出去），库里记版本 / 编译时间 / 上传人
- api：GET/POST/DELETE /api/firmware（请求体即 .bin，不引 multipart）、POST /api/boards/{id}/ota（进审计）；
  通用 /cmd 不放行 ota —— URL 与哈希只能由固件库生成；OTA 事件按 arg 显示中文、失败 / 回滚标红
- 前端：Firmware.vue + OtaState.vue；推送对话框默认不重启，勾「立刻重启」时列出每块板会断电的路并二次确认；
  单板页显示 OTA 状态
- simboard 模拟 ota（下载进度 / 就绪 / 重启 / 自证）；test_firmware.py 13 例，后端共 39 例（本机 + 服务器 3.8）
- service 加 --fw-dir；已部署。板 B 实测：上传 → 推送 → 就绪 → 同镜像带重启 → 不重下直接重启 → 自证健康

Co-Authored-By: Claude Opus 5.5 <[email protected]>

rack/README.md

@@ -11,8 +11,8 @@
 
 | 目录 | 内容 |
 |---|---|
-| `backend/prrack/` | `protocol.py` 板侧协议镜像（命令白名单 / 事件表 / seq）· `bus.py` MQTT 抽象（paho / 进程内假 broker）· `hub.py` 核心 · `recovery.py` 自动恢复 · `db.py` 存储 · `api.py` HTTP+WS · `simboard.py` 模拟板子 · `main.py` 入口 |
-| `backend/tests/` | 25 例（pytest），本机与服务器（Python 3.8）都跑 |
+| `backend/prrack/` | `protocol.py` 板侧协议镜像（命令白名单 / 事件表 / seq）· `bus.py` MQTT 抽象（paho / 进程内假 broker）· `hub.py` 核心 · `recovery.py` 自动恢复 · `db.py` 存储 · `firmware.py` 固件库 + OTA 命令 · `api.py` HTTP+WS · `simboard.py` 模拟板子 · `main.py` 入口 |
+| `backend/tests/` | 39 例（pytest），本机与服务器（Python 3.8）都跑 |
 | `frontend/` | Vue3 + Vite + Element Plus + ECharts（按需引入） |
 | `deploy/` | `deploy.sh` 一键部署 · systemd unit · 每日备份 |
 
@@ -24,10 +24,23 @@
 4. **只绑 127.0.0.1**：`X-Auth-User`（门户覆盖式注入）按 L2 信任，只用于审计「谁按的」；`main.py` 拒绝非回环绑定。
 5. **命令白名单在 `protocol.build_command`**：`wifi` / `mqtt`（只收 USB）与 `events`（服务器自己同步）不给界面。板子的校验仍是唯一权威。
 
+## 推固件（OTA，板侧 C2）
+
+界面「固件」页：上传 `firmware/build/phonerail.bin` → 选板子推送。进度、待验证、回滚都直接显示遥测里的 `ota` 一块。
+
+- 上传时后端核镜像头：首字节 0xE9、有 app 描述、`project_name == phonerail`、≤3 MB，不合格直接拒（不用等板子下完 1 MB 再报错）。
+  存成 `/root/phonerail/fw/<sha256 前 16 位>.bin`，由 nginx 7765 放出去（`deploy/nginx-phonerail-fw.conf`，**故意不过门户**：
+  板子过不了门禁；完整性靠命令里的 sha256，镜像里没有机密）。
+- 推送 = `POST /api/boards/{id}/ota {"sha256","reboot"}`，进审计。通用 `/cmd` **不放行** `ota`：URL / 哈希只能由固件库生成。
+- ⚠️ **勾「立刻重启」= 这块板上开着的手机全部硬断电一次**（ESP 复位时 EN 下拉），界面会列出哪几路并二次确认。
+  不勾就只下载 + 切分区，下次复位生效；同一个镜像已就绪时再推一次并勾重启，不重下。
+- 新固件 120 s 内连不上 broker 板子自己回滚，界面显示「回滚过：版本号」，事件里有「固件升级（回滚）」。
+- 命令行等价物：`firmware/tools/ota_push.py`（不经过后端，直接用 broker 后端账号）。
+
 ## 本机开发
 
 ```bash
-cd backend && python -m prrack.main --sim 2 --db dev.db --static ../frontend/dist   # 两块模拟板，第 1 块第 2 路「卡死」
+cd backend && python -m prrack.main --sim 2 --db dev.db --static ../frontend/dist --fw-dir ./fwdev   # 两块模拟板，第 1 块第 2 路「卡死」；--fw-dir 打开固件页
 cd frontend && pnpm dev                                                             # http://localhost:5173，/api 反代到 7764
 cd backend && python -m pytest -q tests
 ```