docs: refine mmsmapping config defaults

This commit is contained in:
2026-04-22 01:48:45 +08:00
parent 45ab5c9e84
commit 9a388627a0

View File

@@ -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` 自动生成的默认模板配置表格
- 辅助信息展示
- `生成映射`