接入控制

集成合同详情

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

中文
报价模板
sales_queue

销售队列

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

返回集成准备查看 Mock API
Mock API/api/mock/sales-queue

/api/mock/sales-queue

字段合同7

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

Adapter 边界1

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

校验状态合同无错误

0 个警告或错误

contract summary

合同摘要

合同范围sales_queue

销售队列

只读
Mock API只读

/api/mock/sales-queue

只读
保护边界禁止越界

销售页只能读取 SalesQueueItem 和平台对象，不直接读取抓取原始字段或邮箱 provider 原始事件。

只读
field contracts

字段合同

线索治理结果 / 买家公司 IDSalesQueueItem.buyerCompanyId / required

把运营线索池中的买家公司映射到销售队列。

buyer_fr_retailer
线索治理结果 / 采购需求 IDSalesQueueItem.demandId / required

销售队列以 BuyerDemand 为主对象，避免只按买家公司推进。

demand_fr_refurb
报价记录 / 报价 IDSalesQueueItem.quoteId / optional

若已经生成 Quote，销售队列需要展示报价草稿或报价页状态。

quote_fr_retail_001
邮件记录 / 邮件日志 IDSalesQueueItem.emailLogId / optional

若已经生成邮件草稿，销售队列需要展示审核和发送状态。

email_log_fr_quote_001
线索治理动作 / 下一步动作SalesQueueItem.actionLabel / actionHref / derived

让供应商销售页可以从队列项进入报价、销售或详情页面。

转入销售智能体 / /supplier/sales/queue/demand_fr_refurb
销售队列 / 队列状态SalesQueueItem.status / statusLabel / queueState / derived

用统一状态机表达报价草稿、邮件发送、跟进和订单承接进度。

needs_review / 待人工审核
销售队列 / 可执行动作SalesQueueItem.operatorActions / derived

把每个状态下可做的人工审核、批准发送、跟进和订单承接动作显式暴露给页面。

action_approve_sales_email / 批准发送
adapter boundaries

Adapter 边界

01
adapter_boundary_sales_queue

销售页只能读取 SalesQueueItem 和平台对象，不直接读取抓取原始字段或邮箱 provider 原始事件。

当前：从本地 BuyerCompany、BuyerContact、BuyerDemand、Quote 和 EmailDeliveryLog 派生销售队列。；未来：由运营审核结果、销售智能体运行和真实邮件事件共同更新销售队列状态。

硬停：买家需求未审核 / 联系人邮箱不可触达 / 报价价格未审核 / 邮件草稿未审核

adapter
validation

合同无错误

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