前端开发规则

本文件适用于 batteryDetection-web。同时遵守父目录 AGENTS.md 的项目不变量。

状态所有权

• 后端响应是测试、通道、监测、异常、采样、用户、权限和审计的正式状态。前端 store 只保存当前会话的展示缓存和临时表单。
• 新代码不使用 localStorage 保存业务记录。触及已有本地模拟 store 时，将当前流程迁移到后端 API；不要求顺带重写无关页面。
• localStorage 可保存认证令牌、记住的用户名和纯展示偏好。可恢复表单草稿必须明确是草稿，提交成功后清除，且不能参与权限或状态判断。
• 页面按钮可按权限改善体验，但每个受限操作都以服务端授权结果为准。

测试与监测界面

• 正式测试状态只展示：待测试、检测中、暂停、检测中（异常）、检测完成、已终止。“完成确认中”是后端内部阶段，前端可用进度文案表达但不新增正式测试状态。
• 监测状态单独展示：未监测、等待设备启动、监测中、补采中、监测结束、已取消。不要把两套状态合并到一个字段或筛选项。
• “开始监测”表示开始观察和认领，不表示启动 BTS。暂停、继续、结束等入口在第一里程碑保持禁用或明确为未启用设备控制，不能伪造成功状态。
• 实时快照与历史结果在类型、接口和页面文案上分开；实时点不能加入最终原始数据列表。
• 采集器是可选辅助设备。创建测试允许只选择检测柜通道，不把采集器做成必填项。

API 与 SSE

• HTTP 请求复用 src/api/request.ts 的鉴权和错误处理；按业务域在 src/api 中维护带类型的接口，不在视图内散落 URL。
• SSE 使用 fetch 流式读取 text/event-stream 并携带 Authorization 请求头。JWT 不放入 URL，不使用原生 EventSource 绕开现有鉴权。
• SSE 重连后用服务端当前快照替换本地快照；历史区间通过 REST 查询。不要把 SSE 当作可靠消息队列或在浏览器累积所有采样点。
• API 时间按 ISO 8601 解析并以用户本地时区展示；单位换算只发生在展示或导入边界，并保留接口返回的原始单位。

交互与数据安全

• 运行中测试禁用导入。导入结果逐行展示校验信息，并明确分组成功与失败记录；不能用导入覆盖原始采样。
• 终态测试不提供重启入口。修订和认领纠正以新操作提交并展示审计结果，不提供静默撤销。
• SSE 断开、REST 失败和权限拒绝要有可见错误状态；不得乐观地把正式测试状态改为成功。
• 延续现有 Element Plus 布局与组件习惯，确保桌面和常用窄屏下按钮、状态文本和表格操作不重叠。

验证

• 修改 API 类型、状态映射或实时流时，检查加载、空数据、断线、重连、无权限和后端异常状态。
• 完成前运行 npm run build。若新增测试脚本，再同时运行受影响测试。
• 需要浏览器交互验证时启动 npm run dev，检查控制台和网络请求；完成后说明仍依赖模拟数据的页面。