From c28b2af6514b3ba3be94c7813d95c3a2a9fc14c8 Mon Sep 17 00:00:00 2001
From: obroccolio <jinjunxiang@hnu.edu.cn>
Date: Thu, 13 Aug 2026 12:16:33 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20wordcloud=20=E5=A5=91=E7=BA=A6=E8=A1=A5?=
 =?UTF-8?q?=E5=85=85=E7=94=9F=E4=BA=A7=E8=AE=A2=E5=8D=95=E5=88=97=E8=A1=A8?=
 =?UTF-8?q?=EF=BC=88GET=20/api/orders=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/wordcloud-contract.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/wordcloud-contract.md b/docs/wordcloud-contract.md
index 646a8bc..b65ed3e 100644
--- a/docs/wordcloud-contract.md
+++ b/docs/wordcloud-contract.md
@@ -131,4 +131,8 @@ wordcloud 项目内部仍在大量变更，但只要不违反本文档，`wxmp_b
 - 结果图由 wxmp_backend 下载并转存 COS，返回给小程序的是 COS 公网 URL。
 - `WORDCLOUD_API_URL` 未配置时，下单派单返回结构化“未配置”错误（状态字面量
   `not_configured`，见 `api-contract-v1.md` §8 的 `POST /api/orders/:id/dispatch`），不做假成功。
+- **生产订单列表（wordcloud 侧运营查看，raw 消费可选）**：wordcloud 在 `POST /api/jobs`
+  WCD 模式下从 `manifest.meta.orderNo` 登记生产订单，暴露 `GET /api/orders` 与
+  `GET /api/orders/{order_no}`。`wxmp_backend` 不消费该接口，仅供 wordcloud/运营侧查看
+  下单投递的生产任务与状态；`job_id → orderNo` 仍以 `wxmp_backend` 侧 `CustomizationTask` 为准。
 - wordcloud 若对外暴露公网，需要加访问 token 或网络白名单，防止被直接刷任务。
\ No newline at end of file