生态对接 - Acture 文档中心

生态对接用于把项目库中的企业需求转成可跟进的服务需求。页面路径为 /ecosystem/connect；平台管理员从 /admin/ecosystem/connect 进入。管理员在“全部租户”范围内只读查看，选择具体租户后，查询、项目检索、新增需求、状态更新和匹配方跟进都会携带同一个 tenant_id。

业务流程

租户管理员选择一个已有项目，填写服务类型、需求明细和联系人。
系统保存 project_id、公司快照与创建人，并把需求置为待处理状态。
管理员按关键词、服务类型、状态或项目筛选需求。
通过状态接口推进需求，并在匹配结果出现后分别更新每个候选服务商的跟进状态。

普通租户成员可以查看本租户数据。新增、修改状态和跟进操作要求租户管理员或平台管理员权限。

接口合同

所有接口使用账号 JWT：

Authorization: Bearer <ACCESS_TOKEN>

方法	路径	用途
`GET`	`/api/ecosystem/meta`	获取服务类型与状态枚举
`GET`	`/api/ecosystem/dashboard`	获取生态看板汇总
`GET`	`/api/ecosystem/connect-requests`	分页筛选对接需求
`POST`	`/api/ecosystem/connect-requests`	创建对接需求
`PATCH`	`/api/ecosystem/connect-requests/{request_id}`	修改需求资料
`PATCH`	`/api/ecosystem/connect-requests/{request_id}/status`	更新需求状态并记录备注
`PATCH`	`/api/ecosystem/connect-requests/{request_id}/match-follow-up/{match_id}`	更新单个匹配方的跟进状态

列表支持 keyword、service_type、status、project_id、page 和 page_size。平台管理员还可传 tenant_id；租户账号传入其他租户 ID 不会扩大数据范围。

创建示例

curl -X POST 'http://127.0.0.1:8000/api/ecosystem/connect-requests' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "project_id": "<PROJECT_ID>",
    "company_name": "示例企业",
    "service_type": "intellectual",
    "requirement_details": "需要完成核心专利布局"
  }'

创建前应从项目检索结果选择项目，不要只提交手工输入的公司名。服务类型和状态值以 /api/ecosystem/meta 返回为准。

租户边界

查询始终带租户范围；跨租户资源返回未找到。
平台管理员创建数据时必须明确传入 tenant_id。
管理员页面必须先选择具体租户才能新增需求，避免项目与需求写入错误租户。
状态变化写入历史记录，便于后续审计与回溯。
页面导出使用 UTF-8 BOM CSV，并对可能被电子表格执行的公式文本进行转义。