#跨平台边缘节点 (Go) 开发 TODO 计划与差异分析

基于对遗留 C# 色谱工作站项目（IBrainChrom2018）的全面代码检索与功能分析，现将旧系统中的所有功能模块与新重构的 Go 边缘节点（src/edge/）目前已实现的功能进行对比，并整理出后续开发的 TODO 计划。

#1. 核心状态评估

• 当前 Go 项目定位：目前 edge 节点主要作为轻量级数据采集与简单在线分析网关。目前已经跑通了底层 TCP 通讯、基础 Modbus/MQTT 上报、前端 Canvas 实时波形展示、非甲烷总烃/BTEX的分析计算逻辑、断点续传（虚拟屏幕架构）、以及硬件控制下发。
• 与 C# 的差距：C# 版本是一个功能大而全的实验室级别色谱工作站 (CDS)，包含了复杂的多阶程序升温、自动校准序列表、DevExpress 复杂富文本报表、手动拖拽基线切割以及合规的审计追踪。

---

#2. 功能模块对比与 TODO 清单

#2.1 基础通讯与采集 (Collector)

#2.2 硬件反控 (Control)

#2.3 分析内核 (Analyzer)

#2.4 数据存储与报表 (Storage & Report)

#2.5 边缘网关 (Edge Gateway)

---

#3. 遗留任务与优先级建议 (Remaining Tasks)

目前系统已经完成了从底层通信到前端交互、从数据采集到结果出数的全流程 MVP 闭环。以下为针对后续完善和商用化的开发建议：

1. P2 (业务刚需 - 紧随其后)

   • 完善 MQTT 断网续传：优化 MQTT 发布失败时的本地队列缓存逻辑，确保边缘侧网络异常恢复后历史数据能完整上报至云端。
   • 多检测器独立通道处理：如果同一设备外接多通道（如 TCD 和 FID 同时进样），需要完善后端的通道切分（Channel 1/2/3）与独立分析处理。

2. P3 (完善体验 - 后期迭代)

   • 高级程序升温下发：补充 Cmd 报文解析与前端界面交互，下发复杂的柱温箱多阶程序升温指令。
   • 手动基线积分交互：在前端“谱图处理”页面引入交互操作，允许用户手动切分重叠峰、拉基线，重算结果。
   • PDF/打印报表：开发原生前端网页打印功能（window.print 结合 @media print），代替旧版的 DevExpress 报表。
   • 合规与权限系统：如有环保合规或 GXP 需求，引入用户登录鉴权和操作审计日志追踪。

---

#4. 高级项目管理与文档同步规范 (过程裁剪)

为了保证项目的可持续迭代，并在每个里程碑后能够进行有效的项目复盘 (Retrospective)，我们将采用裁剪后的高级项目管理流程，确保核心过程文档与代码同步输出：

#4.1 必需的过程文档清单 (存放于 docs/ 目录)

1. API 接口契约文档 (API_DESIGN.md)：
   • 记录前后端交互的 RESTful API 和 SSE 数据结构规范。
2. 核心数据结构设计 (DATA_SCHEMA.md)：
   • 记录存储于 SQLite 或 JSON 中的核心模型，如 Method (分析方法)、Calibration (校准曲线)、Result (分析结果) 的实体关系。
3. 测试报告与复盘记录 (SPRINT_RETROSPECTIVE.md)：
   • 记录每个阶段完成后的测试通过情况、硬件联调问题（如通讯延时、状态机死锁）以及架构演进心得。