39 lines
2.5 KiB
Markdown
39 lines
2.5 KiB
Markdown
## Context
|
||
|
||
本次变更同时涉及任务导入弹窗、配置管理表单、公共错误处理约定和三类资产展示面。已有解绑导入 API、`VoucherUpload` 组件及 H5 配置页面能力,不新增后端接口或新的上传基础设施。
|
||
|
||
## Goals / Non-Goals
|
||
|
||
- Goals:
|
||
- 让 CSV 解绑导入沿用已有批量导入的交互模式和共享上传能力。
|
||
- 让页面错误提示遵循“公共请求层统一提示、页面不重复提示”的约定。
|
||
- 让关联手机号在列表和详情的字段、空值、图标和展示格式一致。
|
||
- Non-Goals:
|
||
- 不改变解绑导入 API、权限模型、任务处理逻辑或后端手机号数据范围。
|
||
- 不删除或迁移历史 H5 运营弹窗配置。
|
||
- 不修改其他业务页面中与本次列表加载无关的错误提示。
|
||
|
||
## Decisions
|
||
|
||
- Decision: 复用 `VoucherUpload` 作为 CSV 解绑导入的文件入口;通过 `purpose` 和 CSV 校验参数表达业务约束,提交前只使用组件产出的对象存储 key。
|
||
- Decision: `asset_detail` 仅从新增/编辑的页面选择项隐藏,历史配置的 `PAGE_NAMES`/回显映射继续保留,避免历史数据无法查看或保存时被静默改写。
|
||
- Decision: 关联手机号直接消费 `associated_phones`,使用统一的“、”拼接和 `-` 空值占位,不在前端二次脱敏,以符合接口“按资产数据范围返回完整手机号”的契约。
|
||
- Decision: 资产详情图标沿用 `BasicInfoCard` 现有 `asset-label--*` iconfont 伪元素机制,新增关联手机号对应的 class/glyph,不引入新的图标库。
|
||
|
||
## Risks / Trade-offs
|
||
|
||
- 共享上传组件的默认文件数量、大小或校验提示可能与旧弹窗不同,需要在弹窗层明确传入参数并回归关闭/重选行为。
|
||
- 隐藏 `asset_detail` 后,已存在该值的编辑表单必须允许回显,否则会造成用户误以为配置被清空;实现时需区分“历史值回显”和“新选项列表”。
|
||
- 完整手机号展示属于敏感信息,必须保持现有权限和后端资产数据范围,不得通过前端扩大查询范围。
|
||
|
||
## Migration Plan
|
||
|
||
1. 先完成组件和页面改造并通过静态检查。
|
||
2. 在测试环境验证上传任务、历史弹窗配置回显和关联手机号字段兼容性。
|
||
3. 发布前确认公共请求层已覆盖列表接口错误提示;如未覆盖,先补齐公共层再移除页面提示。
|
||
|
||
## Open Questions
|
||
|
||
- 无。上传大小上限沿用 `VoucherUpload`/现有解绑导入接口约束,若后端另有上限以接口契约为准。
|
||
|