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/backend/prrack/main.py

@@ -2,7 +2,8 @@
 
 生产（服务器上，systemd 起）：
     python -m prrack.main --db /root/phonerail-rack/data/rack.db \\
-        --mqtt-env /root/phonerail/mqtt.env --static /root/phonerail-rack/frontend/dist
+        --mqtt-env /root/phonerail/mqtt.env --static /root/phonerail-rack/frontend/dist \\
+        --fw-dir /root/phonerail/fw
 本机开发（不连 broker，起 N 块模拟板子，每秒一条遥测）：
     python -m prrack.main --sim 2 --db dev.db --static ../frontend/dist
 
@@ -20,6 +21,7 @@ import uvicorn
 from .api import create_app
 from .bus import MemBroker, MemBus, PahoBus
 from .db import Db, now_ms
+from .firmware import FwStore
 from .hub import Hub
 from .recovery import RecoveryManager
 from .simboard import HUNG, SimBoard
@@ -74,7 +76,8 @@ def build(args):
         db.close()
 
     static = args.static if args.static and os.path.isdir(args.static) else None
-    app = create_app(hub, rec, static, startup=[up], shutdown=[down])
+    fw = FwStore(db, args.fw_dir, args.fw_base) if args.fw_dir else None
+    app = create_app(hub, rec, static, startup=[up], shutdown=[down], fw=fw)
     return app
 
 
@@ -97,6 +100,10 @@ def main(argv=None):
     ap.add_argument("--mqtt-host", default="127.0.0.1")
     ap.add_argument("--mqtt-port", type=int, default=1884)
     ap.add_argument("--mqtt-env", default="/root/phonerail/mqtt.env")
+    ap.add_argument("--fw-dir", default=None,
+                    help="固件下载目录（nginx 7765 的 /fw/，生产是 /root/phonerail/fw）；不给就没有 OTA")
+    ap.add_argument("--fw-base", default="http://home.example:7765/fw",
+                    help="板子下载固件用的 URL 前缀（板子只能走公网）")
     ap.add_argument("--sim", type=int, default=0, help="不连 broker，起 N 块模拟板子")
     args = ap.parse_args(argv)
     if not ipaddress.ip_address(args.bind).is_loopback: