接入控制

集成合同详情

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

中文
报价模板
buyer_event

买家与邮件事件

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

返回集成准备查看 Mock API
Mock API/api/mock/buyer-event-contract

/api/mock/buyer-event-contract

字段合同9

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

Adapter 边界3

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

校验状态合同无错误

0 个警告或错误

contract summary

合同摘要

合同范围buyer_event

买家与邮件事件

只读
Mock API只读

/api/mock/buyer-event-contract

只读
保护边界禁止越界

页面只能依赖 BuyerCompany / BuyerContact / BuyerDemand，不直接读取抓取原始字段。

只读
field contracts

字段合同

买家来源记录 / 来源 IDBuyerCompany.sourceId / required

追踪买家来自平台、地图、官网入口还是人工导入。

source_google_maps_uk
买家来源记录 / 店铺或公司名称BuyerCompany.name / required

买家公司去重、搜索和销售触达的主识别字段。

London Repair & Trade
买家来源记录 / 国家 / 城市 / 公司类型BuyerCompany.country / city / businessType / required

决定语言、本地化报价和行业包匹配优先级。

英国 / London / 维修店
联系人来源记录 / 邮箱BuyerContact.email / required

V0 只考虑邮件触达，邮箱是进入销售队列的必要条件。

buying@example.co.uk
联系人来源记录 / 邮箱来源 URLBuyerContact.sourceUrl / required

给人工审核和后续反垃圾策略保留来源证据。

https://example.co.uk/contact
买家需求表单 / 采购品类 / 数量 / 市场BuyerDemand.productsWanted / estimatedQuantity / market / required

官网自然买家进入需求池或直接匹配当前行业包。

iPhone 15 Pro / 10-20 台 / 英国
邮件事件 / 投递状态EmailDeliveryLog.status / required

区分草稿、已发送、退信、回复等销售阶段。

sent
邮件事件 / 打开 / 点击 / 回复时间EmailDeliveryLog.openedAt / clickedAt / repliedAt / optional

买家行为回流，驱动销售跟进节奏。

2026-04-30T12:24:00+08:00
报价记录 / 报价 IDEmailDeliveryLog.quoteId / required

把邮件事件绑定到报价页和 QuoteItem。

quote_uk_repair_001
adapter boundaries

Adapter 边界

01
adapter_boundary_lead_source

页面只能依赖 BuyerCompany / BuyerContact / BuyerDemand，不直接读取抓取原始字段。

当前：读取本地 BuyerCompany / BuyerContact seed，模拟海外平台、地图和公开渠道线索。；未来：替换为公开来源采集、人工导入或外部线索表只读 adapter。

硬停：联系人来源不明 / 邮箱置信度过低 / 买家疑似重复但未合并

lead_source
02
adapter_boundary_buyer_request

官网表单只能创建买家需求对象，不直接触发真实邮件发送。

当前：买家需求页不提交，只展示会生成的数据对象。；未来：表单提交后创建 BuyerCompany / BuyerContact / BuyerDemand。

硬停：邮箱格式无效 / 采购品类无法识别 / 买家未同意被邮件联系

website_form
03
adapter_boundary_email_events

邮件事件只更新 EmailDeliveryLog 和销售状态，不直接创建订单。

当前：读取本地 EmailDeliveryLog seed，模拟发送、打开、点击和回复事件。；未来：替换为邮件服务 provider webhook 或定时同步 adapter。

硬停：退信 / 退订或停止触达 / 报价价格未审核

email_provider
validation

合同无错误

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