Files
junhong_cmp_fiber/.scratch/ur49-device-batch-allocation-csv/issues/01-device-batch-allocation-foundation.md
2026-07-23 12:51:52 +09:00

1.3 KiB
Raw Blame History

01 — 建立设备 CSV 批量任务与受控上传基础设施

What to build: 为设备 CSV 批量分配提供可复用的任务基础设施:运营人员能够取得仅允许 CSV 的受控上传地址;系统可持久化并追踪异步任务,严格校验、解析和去重单列表格,安全记录行级失败,并仅以任务 ID 向异步队列投递任务。

Blocked by: None — can start immediately.

Status: ready-for-agent

架构通道: 主通道为 Infrastructure + Application。此任务建立任务生命周期、对象存储用途和 CSV 解析边界;不迁移既有同步设备分配、套餐系列绑定及设备导入用例。

  • 受控上传用途只生成 .csv 对象键,并拒绝错误扩展名、用途、类型或不存在的对象。
  • 独立任务可记录五态生命周期、汇总、脱敏失败明细和中文错误摘要;入队失败不会遗留永久处理中任务。
  • CSV 支持 UTF-8含 BOM、LF/CRLF 和固定单列表头,并在任何写入前拒绝文件级错误;行级错误、重复行和计数关系可准确保留。
  • 异步载荷只包含结构化 task_id,不包含文件字节、临时路径或敏感上下文;解析与批量查询契约支持每批最多 200 条标识。