接入控制

真实集成前阻塞总览

把接真实飞书、Shopify、邮箱和知识发布前必须停下来的条件集中展示，避免把 mock 误当真实接入。

未启用

真实集成前阻塞总览

当前仍处于 mock 模式；所有外部系统都必须先通过这些阻塞项，再进入真实 adapter 开发。

返回集成准备查看阻塞 API 查看操作 Runbook

阻塞对象5

adapter、商品源和知识发布

Hard stops25

真实接入前必须处理

当前模式mock

未启用真实外部系统

真实接入未启用

当前仍然只读 mock

blockers

接入前置阻塞项

飞书商品源feishu_product_source / 外部 adapter / not_configured

确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。

9 项

Shopifyshopify_commerce / 外部 adapter / not_configured

确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。

7 项

邮件事件email_events / 外部 adapter / not_configured

确认邮件服务商、API key 和 webhook secret。

3 项

商品源字段映射product_source_mapping / 商品源准备 / 真实货源表已确认

实现 Feishu 变更事件、自动 SKU 派生、Shopify 映射写入、库存价格更新和同步日志。

3 项

知识发布knowledge_release / AI 训练治理 / 草稿

人工复核草稿知识、AgentRun 输出和业务反馈后，再发布知识版本。

3 项

hard stops

必须停下来的具体原因

01

飞书商品源

缺少飞书配置：appToken

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

02

飞书商品源

缺少飞书配置：brandNewTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

03

飞书商品源

缺少飞书配置：asisTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

04

飞书商品源

缺少飞书配置：asisPlusTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

05

飞书商品源

缺少飞书配置：cpoTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

06

飞书商品源

缺少飞书配置：shopifyMappingTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

07

飞书商品源

缺少飞书配置：syncLogTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

08

飞书商品源

缺少飞书配置：quarantineTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

09

飞书商品源

缺少飞书配置：orderHoldTableId

当前不会访问飞书；真实启用前先运行 dry-run，并确认不会改客户原货源表库存。

人工确认

02

Shopify

缺少 Shopify 配置：shopDomain

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

03

Shopify

缺少 Shopify 配置：clientId

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

04

Shopify

缺少 Shopify 配置：clientSecret

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

05

Shopify

缺少 Shopify 配置：locationId

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

06

Shopify

缺少 Shopify 配置：publicationId

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

07

Shopify

缺少 Shopify 配置：appMode

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

08

Shopify

缺少 Shopify 配置：webhookSecret

当前不会调用 Shopify API，避免误创建商品、库存、订单或结账链接。

人工确认

03

邮件事件

缺少邮件配置：AI_TRADE_EMAIL_PROVIDER

当前不会访问邮件服务，避免误发送、误标记退订或误处理真实回复。

人工确认

04

邮件事件

缺少邮件配置：AI_TRADE_EMAIL_API_KEY

当前不会访问邮件服务，避免误发送、误标记退订或误处理真实回复。

人工确认

05

邮件事件

缺少邮件配置：AI_TRADE_EMAIL_WEBHOOK_SECRET

当前不会访问邮件服务，避免误发送、误标记退订或误处理真实回复。

人工确认

04

商品源字段映射

稳定 SKU 无法派生时隔离该记录。

商品源表已确认；Shopify 写入前还缺 app 权限、location/publication、订单回流和异常通知配置。

人工确认

05

商品源字段映射

库存、USD价格或 HKD价格不是合法数字时隔离该记录。

商品源表已确认；Shopify 写入前还缺 app 权限、location/publication、订单回流和异常通知配置。

人工确认

06

商品源字段映射

Shopify 写入失败超过重试上限时隔离该 SKU，并写同步日志。

商品源表已确认；Shopify 写入前还缺 app 权限、location/publication、订单回流和异常通知配置。

人工确认

05

知识发布

不会写入知识库，只展示未来发布前需要审核的动作。

不会写入知识库：法国小 B 邮件模板

人工确认

06

知识发布

当前版本未发布，必须先完成人工审核。

不会写入知识库：法国小 B 邮件模板

人工确认

07

知识发布

已有 AgentRun 引用，需要复核输出结果后再发布。

不会写入知识库：法国小 B 邮件模板

人工确认

真实接入顺序

不要跳过前置条件

飞书商品源确认 Base 和表 ID，再读商品、库存、价格和映射。
Shopify确认店铺、token、webhook 和 checkout 模式。
邮件事件确认 provider、API key 和 webhook secret，仍保留发送前审核。