docs(spec): 回填进度现状 — async 仅 DatasetDetail 试点已完成(导航/登录待铺开);详情图仅 dd_inversion_data 完成(QwtPlot 落地, 余 dd 类型待样本)

This commit is contained in:
gaozheng 2026-06-11 21:24:28 +08:00
parent 8b3bc50f58
commit 6d0ec909ec
2 changed files with 25 additions and 1 deletions

View File

@ -3,6 +3,19 @@
> 日期 2026-06-11。范围把数据集详情路径从同步阻塞改为异步非阻塞作为全 App 异步化的模式样板。 > 日期 2026-06-11。范围把数据集详情路径从同步阻塞改为异步非阻塞作为全 App 异步化的模式样板。
> 后续会按此模式铺开到导航/登录路径(本期不做)。 > 后续会按此模式铺开到导航/登录路径(本期不做)。
## 状态更新2026-06-11
**DatasetDetail 试点:✅ 已完成并通过评审。** 实现计划 `plans/2026-06-11-apiclient-async-datasetdetail.md`8 任务,逐任务 spec+质量双评审 + 整体评审)。测试 75 → 89+14 离线用例)全绿。落地原语:`IApiCall`/`ApiCall`/`ApiBatch`net、`ChartLoad`/`GridLoad`/`IAsyncDatasetRepository`data、控制器 abort-and-replace + 句柄身份比对 + 退出契约、`LoadingOverlay` 网格懒加载遮罩。核心收益落地:详情路径不冻 UI、慢请求可 abort 不回灌、多请求并发 + fail-fast。
**未完成(本期非目标,待后续铺开):**
- **导航路径**`ApiProjectRepository`:空间/项目/结构树/数据集列表/异常树/动态表单)仍同步阻塞。
- **登录路径**`AuthService`验证码→校验→login2仍同步阻塞。
- `ApiClient` 同步 `get/postJson` 保留供上述路径使用,尚未移除。
可选 follow-up评审建议非阻断`DatasetDetailController::ChartData.grid/gridScale` 死字段;补 `qRegisterMetaType<QList<ApiResponse>>()`(为 cross-thread 铺开准备)。
> 全 App 异步化铺开的实现计划另见:`plans/2026-06-11-apiclient-async-rollout.md`(如已生成)。
## 1. 背景 ## 1. 背景
geopro 现网络栈三层全同步阻塞: geopro 现网络栈三层全同步阻塞:

View File

@ -2,7 +2,18 @@
- 日期2026-06-11 - 日期2026-06-11
- 分支建议:`feat/dataset-detail-chart` - 分支建议:`feat/dataset-detail-chart`
- 状态:设计(待评审) - 状态:**ERT 反演dd_inversion_data展示功能已落地并经用户验收**;其余 dd 类型 + 工具条编辑功能待后续
## 状态更新2026-06-11
**架构偏离(重要):** spec 原定渲染器为 **QGraphicsView**,实际落地改用 **QwtPlot轴/交互/图例)+ VTK 算法层(等值线几何)+ 连续/离散色阶**(见返工方案 `plans/2026-06-11-dataset-detail-chart-v2-qwt.md`,权威)。展示结果视觉等价,下文 §5.2/§8 的 QGraphicsView 细节已被 QwtPlot 方案取代,保留作背景参考。
**已完成(仅 `dd_inversion_data` ERT 反演§2.2 展示范围内):** 原数据散点(方形点/白描边/连续色阶/x 轴顶部)+ 网格等值面(填充栅格 + 黑色等值线 + 沿线数值标注 + NaN 白边裁剪)+ 色阶图例 + 异常叠加 + 底部异常表/描述 + 多 Tab + 网格数据懒加载 + 页签内滚动/分割条 + 实时平移/滚轮缩放。数据加载已异步化(见 `specs/2026-06-11-apiclient-async-design.md`)。
**未完成:**
- **其余 dd 类型的详情图渲染**§2.4`dd_ert_measurement_data`、`dd_ert_measurement_gr_data`、`dd_grid`、`dd_trajectory_data`、测井(深度/时序折线、GPR`dd/gpr/channel/image`、TEM 等。控制器目前对非 `dd_inversion_data` 直接「暂不支持该类型预览」。**现实约束:当前租户仅 ERT/TEM/GPR 三类GPR 对象无数据、无测井数据 → 多数类型无活样本,须先取样本。** 实现计划见 `plans/2026-06-11-dataset-detail-other-dd-types.md`(如已生成)。
- **工具条编辑功能**§2.3,范围外/后续单独立项):白化 / 滤波处理 / 色阶配置 / 异常框注 / 自动标注 / 网格化 / 另存为 / 导出 / 描述富文本 / 大视图全屏。当前为占位按钮。
- 加载态:网格懒加载已有「加载中」遮罩;原数据初次加载仅 busy 光标,未做骨架屏。
- 参考材料: - 参考材料:
- 客户端菜单:`D:\Projects\GEOPRO\Geopro3.0 菜单.xlsx`「客户端」页签R051R096、「测井参数表」「DD类型」 - 客户端菜单:`D:\Projects\GEOPRO\Geopro3.0 菜单.xlsx`「客户端」页签R051R096、「测井参数表」「DD类型」
- 原 web 系统:`http://tenant.geomative.cn/#/projectSpace/datasetMange/datasetInfo`(经 Playwright 操作页面 + 抓取 JS chunk 做源码级分析) - 原 web 系统:`http://tenant.geomative.cn/#/projectSpace/datasetMange/datasetInfo`(经 Playwright 操作页面 + 抓取 JS chunk 做源码级分析)