ENTERPRISE GATEWAY / V1

把企业接口，接入任务流程。

这是企业网关协议，不是六家软件的原生适配器。预置方案需要结合实际产品版本、接口授权和业务字段完成开发联调。

正式任务先生成草稿，再由负责人批准并单独执行。演示连接不请求外部系统。业务数据按企业隔离，成员分为所有者、管理员、操作员和只读成员；审批仍为单级。

1. 确认软件与操作

金蝶kingdee用友yonyouERPNexterpnextOdooodoo钉钉dingtalk企业微信wecom

确认金蝶/用友的具体产品线、ERPNext/Odoo 的版本和模块，以及钉钉/企业微信自建应用权限。企业网关适配具体 API 并保管厂商密钥。

order.create_draft
purchase.create_draft
followup.create_note
planning.create_proposal
reconciliation.create_report
support.create_reply_draft

运营者设置以下运行环境变量。推荐由企业管理员在表单直接保存认证密钥，平台使用 AES-GCM 加密。以下为兼容旧版凭据引用方式：owner 为 workspace.user_id，不是成员 user.id。

ENTERPRISE_ALLOWED_HOSTS=gateway.your-company.example
ENTERPRISE_CREDENTIALS_JSON={"acme-erp":{"owner":"WORKSPACE_ID","token":"SERVER_SIDE_SECRET"}}

只允许已列入白名单的 HTTPS 域名。请求携带 Authorization: Bearer <token>，禁止重定向，20 秒超时，须返回 application/json。运营者须审查域名，避免指向内部或不可信资源。

验证协议、厂商与能力。仅声明已实现的操作，每个网关绑定一个厂商。

{
  "protocol": "chordai-gateway/v1",
  "provider": "erpnext",
  "idempotency": true,
  "capabilities": [
    "order.create_draft"
  ]
}

请求含 task_id、operation、payload。验证权限、主数据与字段，不产生业务写入。

{
  "valid": true
}

请求增加 approved_by，Idempotency-Key 为 task_id。网关须持久化幂等记录并绑定请求内容，并发下最多创建一次草稿。不得提交审批、确认采购或付款。

{
  "status": "succeeded",
  "document_id": "ERP-DRAFT-0001"
}

查询持久化回执。处理中返回 processing；成功返回 succeeded 和 document_id。只有确定从未开始执行时才返回 not_found，以免重复写入。

{
  "status": "succeeded",
  "document_id": "ERP-DRAFT-0001"
}

映射支持顶层字段重命名，例如 {"customer":"customer_code"}。嵌套明细、主数据和厂商规则由网关处理。联通测试仅验证网关协议，上线前仍须在企业测试环境验收各操作。修改连接后原任务快照失效，需要重新建任务。

执行超时后标记待核对，先查询原任务状态，不直接重复写入。网关必须保证重启前后的幂等一致性。

企业管理员可选择“自定义 API”，填写 HTTPS 基础地址、密钥、联通测试路径、各岗位的草稿 POST 路径、回执字段与状态查询。密钥加密保存且不回显。目标接口必须真正支持幂等写入；平台不能自动推断第三方 API 的业务规则。

数据库支持 MySQL 和 PostgreSQL，经企业侧代理只读连接。代理在企业内网运行，只允许配置的目标数据库、表和列，单次预览最多 20 行。平台不会执行任意 SQL 或写数据库。代理与真实数据库、TLS、权限须在企业环境部署验收。

运营环境需设置 ENTERPRISE_ENCRYPTION_KEY（32 字节随机密钥的 Base64），并妥善保管，不能在升级时随意更换。连接域名需加入 ENTERPRISE_ALLOWED_HOSTS。企业 API / 数据库密码均通过表单加密保存，不应写进普通配置 JSON。

已实现岗位目录、独立企业与成员权限、试用与订阅申请、人工核实收款开通、结构化任务、模型路由、审批、网关执行和审计。真实厂商授权、在线支付、自动收件、附件解析、定时任务和后台队列尚待实施。