Files
one-pipe-system/openspec/changes/update-asset-import-popup-and-phone-display/design.md
luo 9a6761e01d
All checks were successful
构建并部署前端到测试环境 / deploy (push) Successful in 54s
fix: some
2026-09-20 17:29:09 +08:00

2.5 KiB
Raw Blame History

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/现有解绑导入接口约束,若后端另有上限以接口契约为准。