> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acturehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 生态对接

> 在账号态下创建、筛选和跟进企业生态服务需求。

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

## 业务流程

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

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

## 接口合同

所有接口使用账号 JWT：

```http theme={null}
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 不会扩大数据范围。

## 创建示例

```bash theme={null}
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，并对可能被电子表格执行的公式文本进行转义。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.