docs/00-overview.md

docs/08-queue-scheduler.md

@@ -0,0 +1,46 @@
+# 08 Queue / Scheduler
+
+## Queue
+
+以下任务原则上应进入 Queue：
+
+- 第三方订单同步
+- 库存同步
+- 物流同步
+- 批量导入
+- 批量导出
+- 面单生成
+- Tracking 同步
+- 大量库存计算
+- 报表生成
+- AI 分析
+- 邮件 / 通知
+- Webhook 处理
+
+**不要让用户 HTTP 请求长时间等待第三方 API。**
+
+Job 要求：
+
+- 携带 `tenant_code`，执行时恢复 TenantContext。
+- 幂等：重复执行不会产生重复业务数据或重复扣减库存。
+- 配置合理的重试次数、退避与超时。
+
+## Scheduler
+
+使用 Laravel Scheduler，例如：
+
+- 订单同步
+- 库存同步
+- Tracking 同步
+- 异常订单检查
+- 库存预警
+- AI 分析任务
+- 报表任务
+
+所有定时任务必须可配置，并考虑：
+
+- 防重复执行
+- 失败重试
+- 日志
+- 超时
+- 租户隔离