商品、自动同步、采购需求、邮件、订单、供应商接入
接入控制
集成准备
在接真实飞书、Shopify、邮箱和订单回流前，先把字段合同、Adapter 边界和硬停条件对齐。
中文
报价模板接入准备
飞书货源到 Shopify 自动同步先有合同，再接真实写入
这一页把外部系统接入拆成字段合同、Adapter 边界、自动同步和异常隔离。真实写入前先 dry-run，再全量。
外部字段到平台对象的映射
读写、Webhook 和保护边界
当前不会访问飞书、Shopify 或邮箱
Adapter 准备状态
每个缺失配置都拆成可执行检查项
飞书与 Shopify 自动同步先看配置、合同和异常边界；补齐凭证后进入 dry-run，再进入真实写入。
飞书商品源 / appToken确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / brandNewTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / asisTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / asisPlusTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / cpoTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / shopifyMappingTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / syncLogTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / quarantineTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
飞书商品源 / orderHoldTableId确认 Brand new、Asis、Asis+、CPO 源表，以及 Shopify 映射、同步日志、异常隔离、订单占用表。缺失配置
Shopify 成交链路 / shopDomain确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
Shopify 成交链路 / clientId确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
Shopify 成交链路 / clientSecret确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
Shopify 成交链路 / locationId确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
Shopify 成交链路 / publicationId确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
Shopify 成交链路 / appMode确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
Shopify 成交链路 / webhookSecret确认 Shopify 店铺、client credentials、location、publication、webhook secret 和 checkout 承接方式。缺失配置
邮件事件回流 / AI_TRADE_EMAIL_PROVIDER确认邮件服务商、API key 和 webhook secret。缺失配置
邮件事件回流 / AI_TRADE_EMAIL_API_KEY确认邮件服务商、API key 和 webhook secret。缺失配置
邮件事件回流 / AI_TRADE_EMAIL_WEBHOOK_SECRET确认邮件服务商、API key 和 webhook secret。缺失配置
字段合同
明确外部字段如何进入 Supplier、Product、Buyer、Quote 和 Order。
Adapter 边界
页面只依赖平台对象，不直接读取飞书、Shopify 或邮箱原始字段。
硬停条件
缺配置、低置信邮箱、未审核价格和支付待确认都不能自动推进。
接入合同对象
商品源合同飞书 Base / Shopify 商品
已建模商品、库存、价格、行业字段和 Shopify 映射已经有稳定字段合同。
买家事件合同线索来源 / 邮件事件
已建模买家公司、联系人、官网需求和邮件打开、点击、回复事件按对象流转。
报价订单合同报价页 / Shopify 订单
已建模Quote、QuoteItem、Order 和订单回流预览已拆出独立边界。
自动同步合同飞书事件 / Shopify 写入
已建模事件、巡检、价格阈值、订单占用和异常隔离已经形成合同。
真实接入顺序
飞书商品源
第一步四张源表和四张状态表形成自动同步输入与日志。
Shopify 商品
第二步dry-run 通过后自动创建商品、更新价格库存并直接发布。
买家线索
第三步接入公开来源、人工导入或官网需求表单。
邮件与订单
后续最后接邮件事件、报价点击和 Shopify 订单回流。
工作摘要
接入前硬停
- 先 dry-run全量预演无结构错误后再写入
- 异常隔离错价或 API 错误不阻塞其他 SKU
- 不直接写订单订单只能从 Shopify 回流