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

39 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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`/现有解绑导入接口约束,若后端另有上限以接口契约为准。