2.5 KiB
2.5 KiB
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
- 先完成组件和页面改造并通过静态检查。
- 在测试环境验证上传任务、历史弹窗配置回显和关联手机号字段兼容性。
- 发布前确认公共请求层已覆盖列表接口错误提示;如未覆盖,先补齐公共层再移除页面提示。
Open Questions
- 无。上传大小上限沿用
VoucherUpload/现有解绑导入接口约束,若后端另有上限以接口契约为准。