From cfdfa7eb61d5e906ec6350f3141aac714a9b2bd8 Mon Sep 17 00:00:00 2001 From: yeg <1347747024@qq.com> Date: 星期三, 02 九月 2026 13:49:35 +0800 Subject: [PATCH] 更新文档 --- AGENTS.md | 12 ++++++------ 1 files changed, 6 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 477fdc3..04d4d16 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,23 +11,23 @@ ## 测试与监测界面 -- 正式测试状态只展示：`待测试`、`检测中`、`暂停`、`检测中（异常）`、`检测完成`、`已终止`。“完成确认中”是后端内部阶段，前端可用进度文案表达但不新增正式测试状态。 +- 正式测试状态只展示：`待测试`、`检测中`、`暂停`、`检测完成`。`完成确认中`、`检测中（异常）`和`已终止`不属于新流程状态，历史值仅作兼容展示。 - 设备状态和接收状态单独并列展示。接收状态使用：`未开始接收`、`接收中`、`暂停接收`、`已结束接收`；不要把设备、接收和测试三套状态合并到一个字段或筛选项。 -- 开始、暂停、继续和停止测试的页面动作只改变系统数据请求，不表示控制 BTS 或采集器。确认文案必须明确不控制设备；暂停期间停止实时请求、保留最后快照并标记“不纳入结果”，停止后进入“已终止”。 -- 实时快照与历史结果在类型、接口和页面文案上分开；实时点不能加入最终原始数据列表。 +- 开始、暂停、继续和停止测试的页面动作只改变系统数据请求，不表示控制 BTS 或采集器。确认文案必须明确不控制设备；暂停期间停止实时请求、保留最后快照，停止后进入“检测完成”。 +- 实时快照与成功接收数据在类型、接口和页面文案上分开；数据列表和图表使用当前有效数据。 - 第一版每个测试电池号必须选择一个已登记采集器，以及主温度、正电位和负电位通道；可选次要通道和动态测量项保持现有交互。`S-01...S-N` 仅属于演示合同。 ## API 与 SSE - HTTP 请求复用 `src/api/request.ts` 的鉴权和错误处理；按业务域在 `src/api` 中维护带类型的接口，不在视图内散落 URL。 - SSE 使用 `fetch` 流式读取 `text/event-stream` 并携带 `Authorization` 请求头。JWT 不放入 URL，不使用原生 `EventSource` 绕开现有鉴权。 -- SSE 重连后用服务端当前快照替换本地快照；历史数据按测试动作时间由后端查询。不要把 SSE 当作可靠消息队列或在浏览器累积所有采样点。 +- SSE 重连后用服务端当前快照替换本地快照；成功接收数据和当前有效数据按测试查询接口读取。不要把 SSE 当作可靠消息队列或在浏览器累积所有采样点。 - API 时间按 ISO 8601 解析并以用户本地时区展示；单位换算只发生在展示或导入边界，并保留接口返回的原始单位。 ## 交互与数据安全 -- 运行中测试禁用导入。导入结果逐行展示校验信息，并明确分组成功与失败记录；不能用导入覆盖原始采样。 -- 终态测试不提供重启入口。修订和认领纠正以新操作提交并展示审计结果，不提供静默撤销。 +- 运行中测试禁用导入。导入结果逐行展示校验信息，并明确分组成功与失败记录；导入、编辑和删除统一生成数据修订，不能覆盖原始设备数据。 +- 终态测试不提供重启入口。修订和删除以新操作提交并展示审计结果；当前有效数据使用修订后的值，原始设备数据保留追溯。 - SSE 断开、REST 失败和权限拒绝要有可见错误状态；不得乐观地把正式测试状态改为成功。 - 延续现有 Element Plus 布局与组件习惯，确保桌面和常用窄屏下按钮、状态文本和表格操作不重叠。 -- Gitblit v1.7.1