基于 .NET 的边缘接入与转发网关，面向独立部署和二次开发。
项目处于设计阶段，当前包含设计文档、开发准备、任务清单和品牌资源，不包含已经实现的网关程序，也不代表已完成设备兼容验证或性能测试。
- 接入、转发与平台联动设计方案 V1.6
- 开发阶段与任务清单：T0—T5、依赖与验收
- 后端工程实施规范：目录、Minimal API、生命周期与测试
- 前端实施基线：shadcn-admin 裁剪复用
- 功能需求
- 网页受控升级规划：GW-27 / G1 优先项
- 开发准备：结论、待确认事项与 T0 验证清单
- 架构评审记录（2026-09-28）
- 开发 Agent 阅读要求
后端工程细节由后端工程实施规范补充，保留四工程依赖方向和既有运行机制；其中第 7 节与开发准备清单共同用于 T0 验收，不新增进入 T0 的前置门槛。
前端选型以已确认的前端实施基线为准；它替代 V1.6 中“新建精简前端、沿用 TenonAdmin 工具链”和 React Router 的旧约定。后端架构、功能范围、安全要求和 T0—T5 顺序不变。
- 接入：Modbus TCP（含 RTU over TCP）、MQTT 订阅、HTTP 拉取。
- 处理：字段选择、重命名、JSON 提取和数值换算。
- 输出：MQTT、HTTP，以及可选的 TenonIoT 平台连接。
- 使用：产品内的可视化连线配置、数据预览和运行诊断。
- 部署：一个 .NET 服务，自带 Web 界面，本地配置和有限发送缓存。只支持 MQTT 的设备需要直连时，可在同一台机器上附带一个 Mosquitto。
- 后端：.NET 10、ASP.NET Core 分组 Minimal API；Host、Runtime、Adapters、Abstractions 四工程；SQLite 配置库与发送缓存分离，具体依赖仍须 T0 验证。
- 管理：本地账号与三种角色（管理员、配置人员、只读），首次访问时设置管理员；不依赖 TenonAdmin。
- 界面：裁剪复用 shadcn-admin，采用 React 19、shadcn/ui、Tailwind CSS 4、TanStack Router 与 TanStack Query；路线画布使用 React Flow。需要 Chrome/Edge 111 及以上的浏览器，其他浏览器边界见设计文档；实际兼容性在 T3 验证。
LoRa／LoRaWAN 优先接入现有无线网关或网络服务器已经处理好的应用数据，不自研无线协议栈。Node-RED 官方嵌入仅记录为待评估选项，首版不实施。
开源版、企业扩展和工控整机交付的边界以设计文档为准。本次不创建企业版工程、授权系统或其他应用代码。
任务清单 PLAN-01将首版拆为 54 个任务包，每项明确依赖、主要内容、交付物和验收；网页升级另列 7 项，仍属于 G1。任务尚未开始，数量不是工时承诺。
| 阶段 | 主要目标 | 任务数 |
|---|---|---|
| T0 | 工程、存储身份、认证、测试 CI 与依赖验证 | 13 |
| T1 | 模拟输入经持久化缓存到真实 MQTT 输出 | 8 |
| T2 | Modbus、MQTT 输入、HTTP、共享连接与映射 | 8 |
| T3 | 真实配置页面、点表、画布、应用与故障操作 | 11 |
| T4 | TenonIoT 契约、同步、上报与条件联调 | 6 |
| T5 | 备份恢复、部署、诊断、手动升级与首版交付 | 8 |
第一轮只安排 T0-A：T0-01—T0-03，交付可构建的最小后端、真实测试与 CI、健康检查和 OpenAPI；验收后再进入 T0-B（存储、身份和认证）及 T0-C（契约、协议验证与独立发布）。任务证据在 T0-01 建立的 docs/implementation-status.md 统一维护，不把最小原型通过当作完整功能通过。
GW-27 网页受控升级（G1，尚未实现）：管理员在“系统设置 → 软件升级”中上传离线升级包，或检查可信源并下载；完成预检、二次确认后执行，并查看重启结果与历史。优先验证 Linux 原生安装和整机交付，Docker 网页安装须有受限宿主机执行器，否则继续外部更新。不会自动安装新版本，也不开展平台批量升级。功能、失败恢复与验收见升级规划，实施拆分见任务清单第 9 节。
该规划补充总设计 G1 清单，不改变功能需求 §10.5、§10.7 中首版采用脚本/镜像升级的范围，也不阻塞当前 T0。
先按 AGENTS.md 阅读总设计、工程规范、功能需求、前端基线、升级规划和开发准备，再按 docs/development-plan.md 中获授权的任务 ID 执行。任务验收同时使用原 V/FS/AT 和 BE/FE 标准；T0-A 结束后提供实际证据，不自动执行后续批次。前端仍在 T3，网页升级仍在 G1；本次任务拆分不批准其他待确认决策。涉及第三方库与平台接口、真实设备能力时，先核实再实现。