为微任务生成精简规格书，明确目标、边界、验收标准与验证方法。…

# 订单导出微任务规格书

一、任务目标

开发云函数接口，将小程序近30天订单导出为Excel文件，供管理端下载使用。

二、功能范围

• 时间范围：默认导出调用时刻往前推30天内的全部订单
• 数据上限：单次最多支持5000条订单，正常生成文件不报错
• 输出格式：.xlsx 文件（建议使用 exceljs 或类似库生成）
• 触发方式：管理端调用云函数，异步生成后返回下载链接（云存储临时链接）

三、字段要求（验收以字段完整为准）

Excel须包含以下列（列名与顺序建议与数据库字段映射文档一致）：

| 类别 | 字段示例 |

|---|---|

| 订单基础 | 订单号、订单状态、下单时间、支付时间 |

| 商品信息 | 商品名称、SKU规格、数量、单价、小计 |

| 金额信息 | 商品总额、运费、优惠金额、实付金额 |

| 用户信息 | 用户昵称/OpenID、收货人、联系电话、收货地址 |

| 其他 | 支付方式、订单备注、物流单号 |

> 注意：金额字段以“分”转“元”保留两位小数；时间为可读格式（如 YYYY-MM-DD HH:mm:ss），禁止导出时间戳原始值。

四、技术要点

• 分页查询：使用 skip/limit 或游标分页，避免一次性拉取超限（云数据库单次查询有上限，需分批查询后合并写入）
• 云函数超时：建议将云函数超时配置上调（如调至20秒以上），防止大数据量导出超时
• 文件存储：Excel上传至云存储，返回临时下载链接（有效期可设为24小时内）
• 异常处理：
• 订单数超过5000条：返回明确提示（如“超出单次导出上限，请分批导出”）
• 无订单数据：返回空Excel（含表头）或提示信息，需与产品确认
• 查询失败：返回结构化错误码，不静默失败

五、验收标准

1. 字段完整：导出文件包含上述全部字段，无缺列、列名正确、金额与时间格式规范

2. 边界测试：

• 5000条订单导出成功、文件可正常打开、数据条数与库内一致
• 空数据、超限数据场景有明确提示，不报错、不崩溃

3. 数据准确：抽检若干订单，Excel内容与数据库记录一致（金额、状态、时间）

4. 可下载：返回链接在小程序/浏览器中可正常下载打开

六、交付物

• 云函数代码 + 部署说明
• 字段映射清单（数据库字段 → Excel列名）
• 自测记录（含5000条边界用例截图/日志）