多视图联动

1. 页面概览

多视图联动是 LightGotham 的跨视图筛选联动演示页，路由 /gotham/views，对应源码 action/web/src/views/GothamViewsPage.vue。页面围绕视图会话（Session）与联动关系（Link）提供五块能力：创建视图会话（POST /views/sessions，类型 graph/map/timeline/list/entity）、会话列表（GET /views/sessions）、编辑视图会话（PUT /views/sessions/:id，仅 name/description/view_type/config 可改）、联动演示（对会话应用筛选 POST /views/sessions/:id/filter 并广播，展示 target_count 与 map/graph 联动结果 GET /views/sessions/:id/linked）、联动关系管理（POST /views/links，源 → 目标会话的 cross_filter 关系）。

核心语义：把一次筛选应用到源会话，沿启用的联动关系广播给目标会话，再由目标会话按同一条件联动过滤出命中数据（图节点 / 地图记录）。一句话总结：多视图联动是"会话化筛选 + cross_filter 广播 + 跨视图命中回显"的联动演示工作台。

2. 访问入口

• 路由与菜单：/gotham 布局子路由 path: 'views'，name GothamViews，标题「Gotham 多视图联动」，requiresAuth: true；侧边栏第四项「多视图联动」（{ path: '/gotham/views', label: '多视图联动' }）。
• 认证与权限：请求经 gothamClient.js（baseURL /gotham-api/v1）附 aip_token，401 自动 refresh 重放；/views/* 在 protected 组，无 admin 角色限制。
• 端口与 API 前缀：Gotham 后端 18083，前端前缀 /gotham-api。

3. 界面布局

+-------------------------------------------------------------+
| 页头：Gotham 多视图联动  [刷新]   alert                       |
+-------------------------------------------------------------+
| 创建视图会话（card）：名称* 类型▾(graph/map/timeline/list/      |
|   entity) 描述 [创建]                                        |
+-------------------------------------------------------------+
| 视图会话列表（card）：ID|名称|视图类型|当前筛选|创建人|操作     |
|   操作：[编辑][联动操作][联动地图][联动图][删除]                |
+-------------------------------------------------------------+
| 联动演示（card）                                              |
|   会话▾ field op▾(eq/ne/gt/gte/lt/lte/contains) value        |
|   [应用筛选并广播]                                            |
|   状态面板：会话/视图类型/广播联动目标 target_count/生效筛选     |
|   联动结果（图 graph）与（地图 map）：target_type/命中/节点或记录|
+-------------------------------------------------------------+
| 联动关系管理（card）：源会话▾ → 目标会话▾ [建立联动关系]        |
|   关系表：ID|源会话|目标会话|类型|启用|操作                    |
+-------------------------------------------------------------+
| 编辑会话弹窗（点行内「编辑」）：name / view_type / description  |
|   / config(JSON) + 不可改字段说明 [取消][保存]                  |
+-------------------------------------------------------------+

各板块职责：

• 创建视图会话：名称必填 + 视图类型 + 描述，创建后自动刷新列表。
• 视图会话列表：展示各会话当前生效筛选（fmtFilters 渲染为 field op value AND ...）与创建人，行内五个入口（编辑/联动操作/联动地图/联动图/删除）。
• 编辑视图会话：点行内「编辑」弹窗，只放后端 UpdateSessionRequest 真实接受的四个字段（name/view_type/description/config），并在弹窗内如实标注不可改字段。
• 联动演示：选会话后填 field/op/value，「应用筛选并广播」写筛选并返回 target_count（广播联动到的目标会话数）；下方两面板展示图/地图目标命中。
• 联动关系管理：建立源 → 目标的 cross_filter 关系并列表展示（含 enabled）。

4. 交互元素

5. 后端关联

API 客户端：gothamClient.js，axios.create({ baseURL: '/gotham-api/v1', timeout: 30000 })；请求拦截器注入 Bearer token，响应 401 自动 refresh 重放。

端点表：

关键机制：

• cross_filter 广播：applyFilter 带 publish: true，后端沿 enabled 的 cross_filter 关系向目标会话发布 cross_filter 事件（eventbus），target_count 即联动到的目标会话数；未建启用关系时为 0。
• 联动查询（QueryLinked）：GET /views/sessions/:id/linked?target=... 按会话当前 filters 过滤目标数据——graph 返回命中节点 nodes，map 返回命中记录 records。
• 筛选展示（fmtFilters）：把 filters（JSON 字符串或数组）解析渲染为 field op value AND ...，失败回退「（空）」。
• 会话操作流：创建/编辑/建关系成功后重新 loadAll（并行拉 sessions + links）；selectSession 仅选中，applyFilter 覆盖并回显新 viewState。
• 会话编辑契约（views.UpdateSessionRequest，products/gotham/views/service.go:89-95）：请求体仅 name / description / view_type / config 四个字段，语义统一为「空值保留原值」——name 改则查重（service.go:239-251，与其他会话重名返回 DUPLICATE）、description 空串保留原值（无法清空）、view_type 改则校验合法值（graph/map/timeline/list/entity，service.go:255-260）、config 传对象即整体替换（service.go:261-263）。filters 不在此 DTO 内（由筛选接口维护），created_by/id/时间戳不参与更新，故编辑弹窗不放这些字段并如实标注「不可改」。

6. 权限与安全

• 认证：全部请求走 aip_token Bearer，401 自动 refresh 换发重放；刷新失效清 token 跳 /login。
• 角色限制：/views/* 全部在 protected 组，无 admin 细分。
• 数据持久化与防呆：会话/筛选/联动关系均后端持久化；前端校验会话名称、field/value、源/目标必填；筛选表达式由后端合并写入。

7. 常见问题与排错

问题 1：点「应用筛选并广播」提示「请选择会话」

现象：被前端拦截。

原因：filterForm.sessionId 为空。

处理：先点会话行「联动操作」选中，或在下拉选会话后重试。

问题 2：广播成功但「广播联动目标」为 0

现象：target_count 显示 0。

原因：当前会话没有 enabled 的 cross_filter 联动关系。

处理：在「联动关系管理」建立源 → 目标关系后重新应用筛选。

问题 3：联动结果提示「无命中节点 / 无命中记录」

现象：GET /views/sessions/:id/linked 返回 count=0。

原因：当前筛选在目标数据中无命中。

处理：放宽 field/op/value 重新广播；或新建空筛选会话再查。

问题 4：提示「联动查询失败」

现象：点「联动地图 / 联动图」后红色 alert。

原因：/views/sessions/:id/linked 报错（会话无效、target 非法、后端未启动）。

处理：确认会话存在、target 传 map 或 graph；检查 Network 状态码。

问题 5：编辑会话保存后描述没被清空

现象：把描述删成空串保存，列表里描述仍在。

原因：后端 UpdateSessionRequest 为「空值保留原值」语义（views/service.go:252-254），空串不会覆盖。

处理：属后端既定语义，无法清空描述；如需重置只能删除重建会话。

问题 6：编辑会话保存提示重名

现象：弹窗内红色 alert，提示视图会话已存在。

原因：后端对 name 做跨会话唯一性校验（views/service.go:242-248）。

处理：换一个未被占用的名称再保存。

8. 已知缺陷与边界

注：会话编辑入口已于 2026-09-13 补齐（弹窗只放后端真实接受的 4 个字段并标注不可改项）；会话/联动删除按钮已于 2026-09-06 修复。