feat(n8n): W5 footer purchase-check webhook (公开只读) + docs

- W5 gets username ?u= → Customers→CustomerProducts → {username,known,purchases}
- 无 HMAC(密钥会下发客户端): 改用 CORS 限 drive.digikedai.com + 最小数据 + CF WAF 建议
- 复用现有 NOCODB_* env, 零新增 env
- 2 节点: webhook(GET, lastNode, CORS 头) + Code(w5-body.js)
- footer v2.6 动态行数据源; 待手动导入 n8n
- docs: N8N_WORKFLOWS + PROJECT_STATE 记录 W5 + 导入步骤

docs/N8N_WORKFLOWS.md

@@ -3,7 +3,7 @@
 > n8n 运行在现有 auto.hoelee.com（`bridge_hoelee` 网络）。它是**同步器，不是 SOT**。
 > 更新日期 2026-08-23。
 
-## 已实现的三个 Workflow
+## 已实现的 Workflow
 
 | Workflow | ID | 触发 | 职责 |
 |---|---|---|---|
@@ -11,9 +11,10 @@
 | **W2** CustomerProduct Sync | `D9OWAI7JUjKnRdOn` | NocoDB CustomerProducts webhook | 重算该客有效 grants 并应用 |
 | **W3** Expiry Sync | `zlEfjj5eK5IfILtk` | schedule `*/5` | 定时 | 全量对账 + drift 修复（scopes 层） |
 | **W4** Daily Full Reconciliation | `pl8j9lpg5gjrd0dB` | 每日 03:00 + webhook `alist-w4-reconcile` | 全量对账 + 用户/角色级 drift 修复 + ReconcileLogs |
+| **W5** Footer Purchase Check | （导入后由 n8n 分配） | GET webhook `dk-purchase-check` | footer 动态行数据源（公开只读） |
 
-三个 workflow 共享同一套算法 `calculateEffectiveGrants`（`n8n/shared/effective-grants.js`，
-构建时经 `gen_w1/w2/w3.js` 内联进各 Code 节点）。
+W1–W4 共享同一套算法 `calculateEffectiveGrants`（`n8n/shared/effective-grants.js`，
+构建时经 `gen_w1/w2/w3/w4.js` 内联进各 Code 节点）。W5 是独立的**公开只读** webhook（不属同步器）。
 
 ## W1 — Customer Provision & Status Lifecycle
 
@@ -48,6 +49,24 @@
 - 密码随 repair 不推送（方案 C）
 - 详见 `docs/W4-DESIGN.md`
 
+## W5 — Footer Purchase Check（公开只读，不属同步器）
+
+- 触发：`GET /webhook/dk-purchase-check?u=<username>`（公网经 `auto.hoelee.com`）
+- 职责：footer v2.6 动态行数据源——按 username 查 Customers → 拉该客 CustomerProducts →
+  返回 `{ username, known, purchases:[{product, expires_at, display_state}] }`
+- 安全模型（**无 HMAC**——key 会随 footer JS 下发到客户端=空话）：
+  - CORS：webhook `options.responseHeaders` 设 `Access-Control-Allow-Origin: https://drive.digikedai.com`
+    → 仅 AList 门户 origin 能读响应
+  - 最小数据：只回 product 名 + 到期 + display_state，**不含内部 Id**
+  - 服务器枚举靠 CF WAF 在 auto.hoelee.com 上做限流 + Origin/Referer 规则（见交付指南）
+- 零 AList 认证请求：username 由 footer 本地解码用户自己的 JWT（`localStorage['token']`）取出 →
+  无「空客户端设备驱逐」风险（v2.3 事故机制完全不涉及）
+- 复用现有 env（`NOCODB_URL`/`NOCODB_TOKEN`/`NOCODB_TABLE_CUSTOMERS`/`NOCODB_TABLE_CUSTOMERPRODUCTS`），**零新增 env**
+- 生成：`node n8n/gen_w5.js` → `W5-purchase-check.json`（2 节点：webhook[GET, lastNode, CORS 头] + Code「Lookup Purchases」）
+- 导入（手动）：n8n → Import from File → `W5-purchase-check.json` → 记下 Webhook URL（应为
+  `https://auto.hoelee.com/webhook/dk-purchase-check`）→ 激活。测试：
+  `curl 'https://auto.hoelee.com/webhook/dk-purchase-check?u=tester'` 应回 JSON 含 `known:true` + 2 条 purchases
+
 ## 共用 env 变量
 
 n8n Code 节点内用 `$env.VAR`（`process.env` 不可靠）。下表是本项目需要的 env：

docs/PROJECT_STATE.md

@@ -33,8 +33,12 @@
 7. **W4** 每日 03:00 全量对账 + ReconcileLogs 审计 — 本地 + 直连生产实测通过（dry-run→repair→复跑幂等；34 项 mock 测试过）；单向同步 NocoDB=SOT，密码不随 repair 推送（方案 C）
 8. 文档体系：ARCHITECTURE / PERMISSIONS / ADMIN_GUIDE / DATABASE_SCHEMA / N8N_WORKFLOWS 等；git 已推 Gitea
 9. **公网链路切换（08-25）**：DSM 文件统一收进 `/volume1/docker/alist-digikedai/`（容器名全部未动——n8n `ALIST_URL` 硬依赖）；CF Tunnel `drive.digikedai.com` 回源 `http://172.16.0.1:5246`；traefik 删除 `/login`→n8n 劫持路由（曾致登录页挂起）；nginx 移除 drive 域不限速白名单（现吃默认 1.5MB/s + limit_conn 10/IP）。完整记录 = DSM `/volume1/docker/alist-digikedai/alist-serve-resource/NETWORK_ARCHITECTURE.md`
+10. **W5 + footer v2.6（08-28）**：footer 动态购买行——本地解码用户 JWT 取 username → GET webhook `dk-purchase-check?u=` → NocoDB 查购买/到期 → 渲染。W5 源（`n8n/w5-body.js` + `gen_w5.js` → `W5-purchase-check.json`）已入库，**待用户手动导入 n8n + 激活**；footer v2.6 已部署线上（详见 dsm-resource-management `desc/DELIVERY_GUIDE.md` §7.10 + skill `alist-footer`）。实测 headless 9/9 PASS（含 CDP 模拟 W5 响应验证整链路）。安全= CORS 限 drive 域 + 最小数据 + 零新增 env（复用 NOCODB_*）
 
 ## 🔴 下一步（按序）
+**（紧迫）手动导入 W5**：n8n → Import from File → `n8n/W5-purchase-check.json` → 激活 → 记 webhook URL
+（`https://auto.hoelee.com/webhook/dk-purchase-check`）。测：`curl 'https://auto.hoelee.com/webhook/dk-purchase-check?u=tester'`
+应回 `known:true` + 2 条 purchases。导入后 footer 动态行即自动上线（无需再改 footer）。
 1. **补 n8n env 并 rebuild（Portainer stack 144，改 env 必须 rebuild）**：`NOCODB_TABLE_RECONCILELOGS=mktsb7le6fqr2u1` + `NOCODB_FK_RECONCILELOG_CUSTOMER=nc_jitu___Customers_id`（W4 审计落库当前被跳过）；顺手加 `TZ=Asia/Kuala_Lumpur` 修 UTC 时区
 2. **决策：auto.hoelee.com 是否退役/迁移**——n8n 公网访问现在只剩 UI 用途；hook 已容器化。若保留，建议迁到 CF Tunnel 新链路；若退役，同步删 VPS DNS + DSM 反代条目
 3. **清理上个会话残留**：NocoDB Customer Id=8 `e2e_test_01` + AList user 17 / role `customer-e2e_test_01`