接入控制

集成合同详情

把一个合同范围里的字段映射、Adapter 边界、硬停条件和 mock API 放到同一页，方便接真实系统前审核。

中文
报价模板
supplier_onboarding

供应商接入与商品源模板

当前合同只读取本地 mock 和 seed，不访问真实飞书、Shopify、邮箱或数据库。真实接入前， 这里就是字段与保护边界的验收清单。

返回集成准备查看 Mock API
Mock API/api/mock/onboarding

/api/mock/onboarding

字段合同16

外部字段到平台对象的映射数量

Adapter 边界1

只读、写入、Webhook 或保护边界

校验状态合同无错误

0 个警告或错误

contract summary

合同摘要

合同范围supplier_onboarding

供应商接入与商品源模板

只读
Mock API只读

/api/mock/onboarding

只读
保护边界禁止越界

页面只能依赖 SupplierOnboardingRequirement 和 ProductImportTemplateField，不直接绑定某一个供应商原始表格。

只读
field contracts

字段合同

供应商接入清单 / 供应商 IDSupplierOnboardingRequirement.supplierId / required

把每一项接入要求绑定到具体供应商，后续支持多供应商并行接入。

supplier_3c_demo
供应商接入清单 / 接入项SupplierOnboardingRequirement.label / required

展示运营需要检查的供应商上线事项。

商品源表
供应商接入清单 / 状态SupplierOnboardingRequirement.status / required

判断供应商是否可以进入商品导入、销售触达或上线。

missing
供应商接入清单 / 下一步SupplierOnboardingRequirement.nextAction / required

把缺失项转成运营或供应商可以执行的动作。

缺少商品源表：先按商品源字段模板准备飞书表、表格或数据库字段。
商品源字段模板 / SKUProductVariant.sku / required

由栏目、机型、Version、容量、卡槽规格、状态和颜色/货号自动派生，每行必须稳定唯一。

brand-new-iphone-17e-a3634-b-a-256gb-1sim-esim-not-activate-rv4
商品源字段模板 / 商品名称Product.product_title / required

由品牌、机型和栏目自动生成，用于平台商品和 Shopify 商品标题。

Apple iPhone 17e Brand new
商品源字段模板 / 规格名称ProductVariant.variant_title / required

由 Version、容量、卡槽规格、状态和颜色/货号自动生成，承载手机行业规格差异。

A3634-B/A / 256GB / 1 Sim+E Sim / Not Activate / Black-黑色-RV4
商品源字段模板 / 品类Product.category / required

当前新货源 Base 固定进入 3C 手机行业包，后续其他行业仍要有品类字段。

手机
商品源字段模板 / 基础价格ProductVariant.base_price / required

优先使用 USD价格作为国际报价基础价；必须为数字，异常波动进入隔离。

632
商品源字段模板 / 币种ProductVariant.currency / required

由 USD价格字段派生为 USD；HKD价格保留为采购参考价。

USD
商品源字段模板 / 起订量ProductVariant.moq / required

当前货源表缺 MOQ，自动同步先采用默认 1；后续如供应商提供 MOQ 字段再覆盖。

1
商品源字段模板 / 可售库存InventorySnapshot.quantity_available / required

来自库存字段，必须为非负整数；变化后自动同步 Shopify 库存。

1
商品源字段模板 / 仓库/发货地InventorySnapshot.warehouse / optional

当前由供应商货源口径默认派生，后续可拆成真实仓库或发货地字段。

香港
商品源字段模板 / 目标国家PriceRule.target_country / optional

当前货源表提供通用 USD/HKD 价格，不按国家分价；国家价格规则后续单独叠加。

global
商品源字段模板 / Shopify 商品句柄ShopifyProductMapping.shopify_handle / optional

由商品拆分规则自动派生；映射 ID 存在独立映射层，不写回原货源表。

apple-iphone-17e-brand-new-a3634-b-a-256gb-1sim-esim-not-activate
商品源字段模板 / 审核备注PriceRule.review_note / optional

用于记录自动隔离原因，如错价、缺字段、库存异常或 Shopify API 失败。

price_spike_gt_20_percent
adapter boundaries

Adapter 边界

01
adapter_boundary_supplier_onboarding

页面只能依赖 SupplierOnboardingRequirement 和 ProductImportTemplateField，不直接绑定某一个供应商原始表格。

当前：读取本地 seed，展示供应商接入清单和商品源字段模板。；未来：替换为供应商资料、飞书商品源表配置和运营后台接入状态。

硬停：缺少商品源表 / 必填字段未映射 / Shopify 结账方式未确认 / 邮件发送域名未配置

adapter
validation

合同无错误

  • 无错误当前字段合同和 Adapter 边界没有 error 级问题。