docs: add event list export design

docs/superpowers/specs/2026-05-15-event-list-export-design.md

@@ -0,0 +1,95 @@
+# eventList 事件导出与波形导出设计
+
+## 背景
+
+`frontend/src/views/event/eventList/index.vue` 当前只有一个“导出”按钮，导出接口为
+`/event/list/transient/export`，按当前查询条件导出事件列表。页面已有波形状态字段
+`fileFlag` 和波形路径 `wavePath`，行操作根据波形是否存在切换“查看波形”和“波形补招”。
+
+本次需要：
+
+- 将现有“导出”更名为“事件导出”。
+- 新增“波形导出”。
+- 波形导出支持单条或多条。
+- 表格增加用于波形导出的多选能力。
+- 有波形的行可选，无波形的行不可选。
+- 表头增加全选复选框。
+- 事件导出不受波形是否存在影响。
+
+## 推荐方案
+
+采用独立的“波形选择”列，不复用 `ProTable` 原生 `selection` 列。
+
+原因是原生 `selection` 列只能表达一套选择状态。如果用 `selectable(row)` 按波形是否存在控制行是否可选，那么没有波形的事件也无法被选中用于事件导出，这与“事件导出不存在波形控制多选框是否可选的逻辑”冲突。
+
+独立“波形选择”列只服务波形导出：
+
+- 表头复选框控制当前页所有可导出波形行。
+- 行复选框只在 `fileFlag === 1 && wavePath` 时可选。
+- 无波形行禁用，且不参与全选、半选、导出参数。
+- 事件导出继续按当前查询条件导出，不读取波形选择状态。
+
+## UI 行为
+
+表格头部按钮按现有业务页面按钮风格：
+
+- “事件导出”：`type="primary" plain`，图标继续使用 `Download`。
+- “波形导出”：`type="primary" plain`，图标继续使用 `Download`，没有选中波形时禁用。
+
+表格左侧新增“波形选择”列，放在序号列之前或之后均可，优先靠近序号列：
+
+- 表头为一个复选框。
+- 表头复选框仅统计当前页可导出波形行。
+- 当前页可导出波形行全部选中时为选中态。
+- 当前页可导出波形行部分选中时为半选态。
+- 当前页没有可导出波形行时禁用。
+- 切换页码、查询、重置后，应清理不在当前页的数据选择，避免旧页选中项误参与导出。
+
+## 数据与接口
+
+事件导出沿用现有接口：
+
+```ts
+exportTransientEvents(params: EventList.TransientPageParams)
+```
+
+波形导出新增接口方法，前端按 `eventIds` 传参：
+
+```ts
+exportTransientWaveforms(params: EventList.TransientWaveformExportParams)
+```
+
+参数类型：
+
+```ts
+interface TransientWaveformExportParams {
+    eventIds: string[]
+}
+```
+
+接口路径按以下命名实现；如果后端最终提供不同路径，实施时只替换 API 方法中的路径：
+
+```text
+POST /event/list/transient/waveform/export
+```
+
+后端负责根据事件 ID 校验波形文件并打包导出。前端不直接拼装本地波形文件路径。
+
+## 边界处理
+
+- 行没有 `eventId` 时，不允许加入波形导出选择。
+- 行 `fileFlag` 不为 `1` 时，不允许加入波形导出选择。
+- 行 `wavePath` 为空时，不允许加入波形导出选择。
+- 点击“波形导出”时再次过滤可导出行，避免页面状态残留导致传入非法数据。
+- 如果过滤后没有可导出事件，提示用户先选择存在波形的事件。
+- 事件导出仍使用当前搜索条件，并保持原有时间范围构造逻辑。
+
+## 验证方式
+
+- 静态检查“事件导出”按钮文案已更新，且仍调用 `exportTransientEvents`。
+- 静态检查事件导出参数仍来自 `buildEventQueryParams(resolveCurrentSearchParams(searchParam))`。
+- 静态检查“波形导出”调用新增接口，并传入 `eventIds`。
+- 静态检查波形选择判断同时包含 `fileFlag === 1`、`wavePath` 和 `eventId`。
+- 手动验证当前页中无波形行复选框禁用，有波形行可选。
+- 手动验证表头全选只选择当前页有波形的行。
+- 手动验证查询、重置、翻页后旧选择不会误参与波形导出。