From 9a388627a001996fd176fe983d41a243c811285c Mon Sep 17 00:00:00 2001 From: yexb <553699424@qq.com> Date: Wed, 22 Apr 2026 01:48:45 +0800 Subject: [PATCH] docs: refine mmsmapping config defaults --- ...-22-mmsmapping-layout-and-config-design.md | 44 ++++++++++++------- 1 file changed, 29 insertions(+), 15 deletions(-) diff --git a/docs/superpowers/specs/2026-04-22-mmsmapping-layout-and-config-design.md b/docs/superpowers/specs/2026-04-22-mmsmapping-layout-and-config-design.md index db0a885..398dd1d 100644 --- a/docs/superpowers/specs/2026-04-22-mmsmapping-layout-and-config-design.md +++ b/docs/superpowers/specs/2026-04-22-mmsmapping-layout-and-config-design.md @@ -21,7 +21,7 @@ - 左上只保留 ICD 文件选择和 `解析 ICD` 按钮 - 左下统一展示接口返回中的 `mappingJson` 和 `problems` -- 右侧作为系统配置区,承载基础请求字段、模板配置表格和辅助信息 +- 右侧作为系统配置区,承载精简请求字段、默认模板配置表格和辅助信息 - 页面不再要求用户直接编辑 `request JSON` ### 2.2 业务目标 @@ -52,6 +52,8 @@ - `prettyJson` - `outputDir` - `indexSelection` +- 前端页面只对用户开放 `version`、`author` 和 `indexSelection` 相关配置 +- `saveToDisk`、`prettyJson`、`outputDir` 仍按接口契约参与请求,但采用页面内部默认值,不在右侧配置区开放编辑 - 第一次解析时可不传有效 `indexSelection`,接口会返回 `NEED_INDEX_SELECTION` - 第二次生成时,`indexSelection` 必须沿用解析返回的合法候选值 - `mappingJson` 为字符串字段,需要前端格式化展示 @@ -90,34 +92,38 @@ 右侧固定为配置与生成工作区,包含三部分: -1. 基础请求字段表单 -2. 基于 `DefaultCfg.txt` 生成的模板配置表格 +1. 精简请求字段表单 +2. 基于 `DefaultCfg.txt` 自动生成的默认模板配置表格 3. 解析返回的辅助信息展示及 `生成映射` 操作区 ## 6. 右侧配置区设计 -### 6.1 基础请求字段 +### 6.1 前端可配置请求字段 -基础字段全部保留并可配置: +右侧仅保留以下可配置字段: - `version` - `author` -- `saveToDisk` -- `prettyJson` -- `outputDir` 使用表单形式维护,不再暴露底层 JSON 文本。 -这些字段参与两类请求: +以下字段不在右侧开放配置,而是由页面内部写死默认值: + +- `saveToDisk = false` +- `prettyJson = true` +- `outputDir = ''` + +上述字段仍参与两类请求: - 解析 ICD 请求 - 生成映射请求 区别在于解析请求强制使用空的 `indexSelection`。 -### 6.2 模板表格骨架 +### 6.2 默认模板表格骨架 右侧表格的骨架由 `DefaultCfg.txt` 提供。 +页面在解析完成后,基于 `DefaultCfg.txt` 自动生成一份默认模板,作为右侧的初始可编辑草稿。 优先使用 `ReportList` 生成分组,每个分组至少展示: @@ -167,7 +173,7 @@ ### 7.2 自动匹配建议 -解析完成后,页面尝试将模板分组与候选分组自动匹配: +解析完成后,页面尝试将默认模板分组与候选分组自动匹配: 1. 优先按 `groupDesc` 匹配 2. 若不唯一,则结合以下信息辅助判断: @@ -205,14 +211,18 @@ 点击 `解析 ICD` 时: -- 使用当前基础请求字段 +- 使用当前前端可配置字段 +- 同时附带页面内部默认值: + - `saveToDisk = false` + - `prettyJson = true` + - `outputDir = ''` - 强制令 `request.indexSelection = []` - 调用 `getIcdMmsJson` 解析成功后: - 保存本次 `indexCandidates` -- 生成新的配置草稿 +- 基于 `DefaultCfg.txt` 自动生成新的默认模板草稿 - 右侧展示辅助信息与模板配置表格 ### 8.3 生成映射 @@ -222,6 +232,10 @@ - 取右侧当前最新草稿 - 做本地校验 - 组装最终 `request.indexSelection` +- 同时附带页面内部默认值: + - `saveToDisk = false` + - `prettyJson = true` + - `outputDir = ''` - 再次调用 `getIcdMmsJson` ### 8.4 多次生成 @@ -319,8 +333,8 @@ 职责: -- 基础请求字段表单 -- 模板配置表格 +- 精简请求字段表单 +- 基于 `DefaultCfg.txt` 自动生成的默认模板配置表格 - 辅助信息展示 - `生成映射`