Harmon
d108b33f80
- add documentation governance and cleanup audit documents - update README and docs index to distinguish current vs historical sources - move superseded planning, SBAS, Gamma, and experiment notes into docs/archive - fix remaining archive text garbling in two documents
233 lines
4.2 KiB
Markdown
233 lines
4.2 KiB
Markdown
# SBAS 前端设计说明
|
|
|
|
更新日期：2026-04-06
|
|
|
|
## 1. 设计目标
|
|
|
|
SBAS 前端必须解决四个问题：
|
|
|
|
- 让用户知道“匹配结果”和“正式生产运行”不是一回事
|
|
- 让用户能从已有 PS 批次发起正式运行
|
|
- 让用户能查看 `psinsar` 成果，而不是只看实验目录
|
|
- 让用户能逐步过渡到更复杂的时序成果浏览，而不是一次性堆满功能
|
|
|
|
## 2. 导航结构
|
|
|
|
当前建议保留现有导航层级，只把占位页替换成真实页面。
|
|
|
|
### 2.1 生产规划组
|
|
|
|
- `ps_results`
|
|
- 匹配结果浏览与批次创建
|
|
- `ps_production`
|
|
- 正式生产入口
|
|
- `ps_products`
|
|
- 成果编目与产品管理
|
|
|
|
### 2.2 InSAR 变形分析组
|
|
|
|
- `psinsar_results`
|
|
- 以成果浏览为主的只读结果页
|
|
- `psinsar_analysis`
|
|
- 后续时序分析页，当前可继续保留占位
|
|
|
|
## 3. 页面一：`ps_production`
|
|
|
|
## 3.1 页面目标
|
|
|
|
从已有 `ps_task_batches` 中选择一个 stack，提交一次正式 SBAS 运行，并查看最近运行状态。
|
|
|
|
## 3.2 页面布局
|
|
|
|
建议分成三块：
|
|
|
|
- 运行说明卡
|
|
- 新建运行表单
|
|
- 最近运行列表
|
|
|
|
## 3.3 新建运行表单字段
|
|
|
|
必填字段：
|
|
|
|
- `batch_id`
|
|
|
|
可选字段：
|
|
|
|
- `run_name`
|
|
- `reference_date`
|
|
- `water_mask_mode`
|
|
- `notes`
|
|
|
|
只读展示字段：
|
|
|
|
- `direction`
|
|
- `stack_size`
|
|
- `with_orbit_count`
|
|
- `missing_orbit_count`
|
|
|
|
## 3.4 提交后反馈
|
|
|
|
提交后需要立刻给出：
|
|
|
|
- `task_id`
|
|
- `run_id`
|
|
- 当前状态
|
|
|
|
当前 Phase 1 仅执行 prepare，因此状态建议为：
|
|
|
|
- `PENDING`
|
|
- `RUNNING`
|
|
- `PREPARED`
|
|
- `FAILED`
|
|
|
|
## 3.5 最近运行列表
|
|
|
|
每个运行卡片至少展示：
|
|
|
|
- `run_name`
|
|
- `run_id`
|
|
- `batch_id`
|
|
- `reference_date`
|
|
- `stack_size`
|
|
- `status`
|
|
- `created_at`
|
|
|
|
详情展开建议展示：
|
|
|
|
- DEM 路径
|
|
- 轨道池路径
|
|
- 生成的 stack manifest 路径
|
|
- 输入日期列表
|
|
- 质量/预检查摘要
|
|
|
|
## 4. 页面二：`ps_products`
|
|
|
|
## 4.1 页面目标
|
|
|
|
承接管理员视角的产物目录维护。
|
|
|
|
能力包括：
|
|
|
|
- 查看 `psinsar` catalog 状态
|
|
- 手动重建 catalog
|
|
- 浏览产品列表
|
|
- 查看产品详情
|
|
|
|
## 4.2 页面布局
|
|
|
|
建议分成三块：
|
|
|
|
- catalog 状态卡
|
|
- 管理操作区
|
|
- 产品列表与详情区
|
|
|
|
## 4.3 catalog 状态卡
|
|
|
|
展示字段：
|
|
|
|
- `catalog_name`
|
|
- `storage_root`
|
|
- `status`
|
|
- `needs_rebuild`
|
|
- `manifest_count`
|
|
- `db_count`
|
|
- `issue_count`
|
|
- `last_full_rebuild_at`
|
|
|
|
## 4.4 产品列表
|
|
|
|
每个产品卡片建议展示：
|
|
|
|
- `display_name`
|
|
- `product_id`
|
|
- `run_key`
|
|
- `reference_date`
|
|
- `stack_size`
|
|
- `status`
|
|
- `published_at`
|
|
|
|
优先展示缩略图：
|
|
|
|
- `preview/velocity_preview.png`
|
|
|
|
## 4.5 产品详情
|
|
|
|
详情建议包含：
|
|
|
|
- 基本信息
|
|
- 时序信息
|
|
- 质量摘要
|
|
- 资产列表
|
|
- 问题列表
|
|
|
|
资产列表首屏优先顺序：
|
|
|
|
- `velocity_geotiff`
|
|
- `timeseries_cube`
|
|
- `temporal_coherence_geotiff`
|
|
- `quality_mask_geotiff`
|
|
- `preview_png`
|
|
- 其他辅助资产
|
|
|
|
## 5. 页面三：`psinsar_results`
|
|
|
|
## 5.1 页面目标
|
|
|
|
承接业务用户视角的成果浏览，不承担目录维护操作。
|
|
|
|
## 5.2 与 `ps_products` 的区别
|
|
|
|
- `ps_products` 偏运维和管理
|
|
- `psinsar_results` 偏展示和检索
|
|
|
|
## 5.3 当前 Phase 1 能力
|
|
|
|
- 浏览产品列表
|
|
- 查看缩略图
|
|
- 查看资产清单
|
|
- 查看质量摘要
|
|
|
|
## 5.4 后续 Phase 2/3 扩展
|
|
|
|
- 地图叠加 `velocity.tif`
|
|
- 按 AOI 或时间筛选
|
|
- 像元点位时序查询
|
|
- 专题统计与热点识别
|
|
|
|
## 6. 交互原则
|
|
|
|
- 生产和结果页面必须分开
|
|
- 管理操作只出现在管理页
|
|
- 结果页优先展示 `velocity.tif` 对应预览
|
|
- 但详情页必须强调主科学产物是 `geo_timeseries.h5`
|
|
|
|
## 7. 前端阶段性实施建议
|
|
|
|
### Phase 1
|
|
|
|
- `ps_production`：真实可提交 prepare 任务
|
|
- `ps_products`：真实 catalog 管理页
|
|
- `psinsar_results`：复用 catalog 浏览能力做只读页
|
|
|
|
### Phase 2
|
|
|
|
- 地图叠加 `velocity.tif`
|
|
- 结果筛选
|
|
- 与 run 详情联动
|
|
|
|
### Phase 3
|
|
|
|
- `geo_timeseries.h5` 点查询
|
|
- 时间曲线图
|
|
- 多产品对比
|
|
|
|
## 8. 当前结论
|
|
|
|
前端第一阶段不应追求“一口气把时序分析全做完”，而应优先做三件事：
|
|
|
|
- 让 SBAS 生产有正式入口
|
|
- 让 SBAS 结果有正式目录
|
|
- 让用户在系统里能看到真正的 `psinsar` 成果
|
|
|
|
这三件事完成后，系统才算真正开始承接 SBAS 能力。
|