接入控制

集成合同详情

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

中文
报价模板
quote_order

报价页与订单回流

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

返回集成准备查看 Mock API
Mock API/api/mock/quote-order-contract

/api/mock/quote-order-contract

字段合同7

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

Adapter 边界3

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

校验状态合同无错误

0 个警告或错误

contract summary

合同摘要

合同范围quote_order

报价页与订单回流

只读
Mock API只读

/api/mock/quote-order-contract

只读
保护边界禁止越界

报价页只展示已生成且通过边界检查的 Quote，不直接读取商品源表。

只读
field contracts

字段合同

报价记录 / 供应商 IDQuote.supplierId / required

把报价隔离到具体供应商。

supplier_3c_demo
报价记录 / 买家公司 / 联系人Quote.buyerCompanyId / buyerContactId / required

把报价页、邮件和后续订单绑定到同一个买家。

buyer_uk_repair_shop / contact_uk_repair_owner
报价记录 / 报价状态Quote.status / required

表达草稿、已发送、已查看、点击结账、已下单等销售阶段。

viewed
报价明细 / 商品 / SKU / 数量 / 单价 / MOQQuoteItem.productId / variantId / quantity / unitPrice / moq / required

驱动报价页商品行、起订量和 checkout 草稿。

variant_iphone_15_pro_256_a / 10 / 735 / 10
Cart / Checkout / checkoutUrlQuoteItem.checkoutUrl / derived

买家点击后进入 Shopify 结账。

https://demo-ai-trade.myshopify.com/cart/iphone-15-pro-demo:10
Order / shopifyOrderIdOrder.shopifyOrderId / required

Shopify 订单回流后用于去重和追踪。

gid://shopify/Order/demo-1001
Order / paymentStatus / orderStatusOrder.paymentStatus / orderStatus / required

决定履约、售后和复购下一步。

pending / new
adapter boundaries

Adapter 边界

01
adapter_boundary_quote_page

报价页只展示已生成且通过边界检查的 Quote，不直接读取商品源表。

当前：报价页读取本地 Quote / QuoteItem seed。；未来：报价页读取真实 Quote API，并按 quoteToken 暴露给买家。

硬停：报价没有买家 / 报价没有明细 / 价格或 MOQ 未审核

platform
02
adapter_boundary_checkout_link

checkout 链接只能来自 QuoteItem 和 Shopify 映射，不能由页面拼接。

当前：使用 Shopify checkout 占位链接，不创建真实 checkout。；未来：根据 QuoteItem 生成 Shopify cart 或 checkout 链接。

硬停：SKU 未映射 Shopify / 库存低于 MOQ / 报价已过期

shopify
03
adapter_boundary_order_return

订单回流只创建 Order，再由查询层派生履约与复购状态。

当前：读取本地 Order seed，模拟 Shopify 订单回流。；未来：接收 Shopify webhook 或定时拉取订单。

硬停：支付状态不可信 / 无法匹配 Quote / 无法匹配 BuyerCompany

shopify
validation

合同无错误

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