中介新增 修改接口

openspec/changes/sync-intermediary-frontend-with-detailed-fields/specs/frontend-api-layer/spec.md

@@ -0,0 +1,67 @@
+# Spec: 前端 API 层扩展
+
+## ADDED Requirements
+
+### Requirement: 添加个人中介模板下载接口调用
+
+前端 SHALL 提供调用个人中介模板下载接口的函数。
+
+#### Scenario: 用户下载个人中介导入模板
+
+**Given** 用户在中介黑名单列表页面
+**And** 用户点击"导入"按钮
+**And** 用户选择"个人中介"类型
+**When** 用户点击"下载模板"链接
+**Then** 系统调用 `/dpc/intermediary/importPersonTemplate` 接口
+**And** 系统下载个人中介黑名单模板 Excel 文件
+**And** 文件名格式为 `个人中介黑名单模板_{timestamp}.xlsx`
+
+---
+
+### Requirement: 添加机构中介模板下载接口调用
+
+前端 SHALL 提供调用机构中介模板下载接口的函数。
+
+#### Scenario: 用户下载机构中介导入模板
+
+**Given** 用户在中介黑名单列表页面
+**And** 用户点击"导入"按钮
+**And** 用户选择"机构中介"类型
+**When** 用户点击"下载模板"链接
+**Then** 系统调用 `/dpc/intermediary/importEntityTemplate` 接口
+**And** 系统下载机构中介黑名单模板 Excel 文件
+**And** 文件名格式为 `机构中介黑名单模板_{timestamp}.xlsx`
+
+---
+
+### Requirement: 添加个人中介数据导入接口调用
+
+前端 SHALL 提供调用个人中介数据导入接口的函数。
+
+#### Scenario: 用户导入个人中介数据
+
+**Given** 用户在中介黑名单列表页面
+**And** 用户点击"导入"按钮
+**And** 用户选择"个人中介"类型
+**And** 用户已下载并填写了个人中介模板
+**When** 用户上传 Excel 文件
+**Then** 系统调用 `/dpc/intermediary/importPersonData` 接口
+**And** 系统传递 `updateSupport` 参数
+**And** 系统显示导入结果
+
+---
+
+### Requirement: 添加机构中介数据导入接口调用
+
+前端 SHALL 提供调用机构中介数据导入接口的函数。
+
+#### Scenario: 用户导入机构中介数据
+
+**Given** 用户在中介黑名单列表页面
+**And** 用户点击"导入"按钮
+**And** 用户选择"机构中介"类型
+**And** 用户已下载并填写了机构中介模板
+**When** 用户上传 Excel 文件
+**Then** 系统调用 `/dpc/intermediary/importEntityData` 接口
+**And** 系统传递 `updateSupport` 参数
+**And** 系统显示导入结果