中介新增 修改接口

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** 系统显示导入结果

openspec/changes/sync-intermediary-frontend-with-detailed-fields/specs/frontend-detail-view/spec.md

@@ -0,0 +1,58 @@
+# Spec: 前端详情视图
+
+## ADDED Requirements
+
+### Requirement: 添加中介详情查看功能
+
+前端 SHALL 提供查看中介详细信息的对话框，根据中介类型显示不同的字段。
+
+#### Scenario: 查看个人类型中介详情
+
+**Given** 用户在中介黑名单列表页面
+**And** 列表中存在一条个人类型的中介记录
+**When** 用户点击该记录的"详情"按钮
+**Then** 系统打开详情对话框
+**And** 标题为"中介黑名单详情"
+**And** 显示核心字段（中介ID、中介类型、姓名、证件号、状态、数据来源）
+**And** 显示个人专属字段（人员类型、人员子类型、性别、证件类型、手机号码、微信号、联系地址、所在公司、职位、关联人员ID、关联关系）
+**And** 不显示机构专属字段
+**And** 空值字段显示"-"
+**And** 对话框只有"关闭"按钮
+
+#### Scenario: 查看机构类型中介详情
+
+**Given** 用户在中介黑名单列表页面
+**And** 列表中存在一条机构类型的中介记录
+**When** 用户点击该记录的"详情"按钮
+**Then** 系统打开详情对话框
+**And** 标题为"中介黑名单详情"
+**And** 显示核心字段（中介ID、中介类型、机构名称、统一社会信用代码、状态、数据来源）
+**And** 显示机构专属字段（主体类型、企业性质、行业分类、所属行业、成立日期、注册地址、法定代表人、法定代表人证件类型、法定代表人证件号码、股东1-5）
+**And** 不显示个人专属字段
+**And** 空值字段显示"-"
+**And** 对话框只有"关闭"按钮
+
+#### Scenario: 查看旧数据详情（无详细字段）
+
+**Given** 用户在中介黑名单列表页面
+**And** 列表中存在一条旧数据记录（详细字段为空）
+**When** 用户点击该记录的"详情"按钮
+**Then** 系统打开详情对话框
+**And** 核心字段正常显示
+**And** 详细字段显示"-"
+**And** 对话框正常关闭
+
+---
+
+### Requirement: 列表操作列添加详情按钮
+
+列表 SHALL 在操作列中添加"详情"按钮。
+
+#### Scenario: 操作列显示详情按钮
+
+**Given** 用户在中介黑名单列表页面
+**When** 列表加载完成
+**Then** 操作列显示"详情"按钮
+**And** "详情"按钮不需要权限控制
+**And** "详情"按钮图标为 "el-icon-view"
+**And** 操作列宽度调整为 240px（原 180px）

openspec/changes/sync-intermediary-frontend-with-detailed-fields/specs/frontend-form-enhancement/spec.md

@@ -0,0 +1,139 @@
+# Spec: 前端表单增强
+
+## ADDED Requirements
+
+### Requirement: 新增/编辑对话框支持详细字段录入
+
+新增和编辑对话框 SHALL 扩展以支持个人和机构类型的详细字段录入。
+
+#### Scenario: 新增个人类型中介
+
+**Given** 用户点击"新增"按钮
+**And** 对话框打开，默认选择"个人"类型
+**When** 用户查看对话框
+**Then** 显示"基本信息"、"个人信息"两个标签页
+**And** 自动切换到"个人信息"标签页
+**When** 用户填写个人信息字段
+**And** 用户点击"确定"按钮
+**Then** 系统提交核心字段和个人字段到后端
+**And** 显示"新增成功"提示
+**And** 列表刷新
+
+#### Scenario: 新增机构类型中介
+
+**Given** 用户点击"新增"按钮
+**And** 用户将中介类型切换为"机构"
+**When** 用户查看对话框
+**Then** 显示"基本信息"、"机构信息"两个标签页
+**And** 自动切换到"机构信息"标签页
+**When** 用户填写机构信息字段
+**And** 用户点击"确定"按钮
+**Then** 系统提交核心字段和机构字段到后端
+**And** 显示"新增成功"提示
+**And** 列表刷新
+
+#### Scenario: 编辑个人类型中介
+
+**Given** 用户点击一条个人类型记录的"修改"按钮
+**When** 对话框打开
+**Then** 系统加载该记录的详细信息
+**And** "个人信息"标签页显示已保存的个人字段值
+**When** 用户修改个人信息字段
+**And** 用户点击"确定"按钮
+**Then** 系统提交修改后的数据到后端
+**And** 显示"修改成功"提示
+**And** 列表刷新
+
+#### Scenario: 编辑机构类型中介
+
+**Given** 用户点击一条机构类型记录的"修改"按钮
+**When** 对话框打开
+**Then** 系统加载该记录的详细信息
+**And** "机构信息"标签页显示已保存的机构字段值
+**When** 用户修改机构信息字段
+**And** 用户点击"确定"按钮
+**Then** 系统提交修改后的数据到后端
+**And** 显示"修改成功"提示
+**And** 列表刷新
+
+#### Scenario: 切换中介类型时自动跳转标签页
+
+**Given** 用户在新增或编辑对话框中
+**And** 当前选择的是"个人"类型
+**When** 用户将中介类型切换为"机构"
+**Then** 对话框自动切换到"机构信息"标签页
+**And** 个人字段保持不变（隐藏但保留值）
+
+---
+
+### Requirement: 导入对话框支持类型选择
+
+导入对话框 SHALL 支持选择导入类型（个人/机构），并根据类型下载对应模板。
+
+#### Scenario: 选择个人类型导入
+
+**Given** 用户点击"导入"按钮
+**When** 对话框打开
+**Then** 默认选择"个人中介"类型
+**And** 显示"是否更新已经存在的数据"复选框
+**And** 显示"下载模板"链接
+**When** 用户保持"个人中介"类型
+**And** 用户点击"下载模板"链接
+**Then** 系统下载个人中介模板
+
+#### Scenario: 选择机构类型导入
+
+**Given** 用户点击"导入"按钮
+**When** 对话框打开
+**And** 用户选择"机构中介"类型
+**And** 用户点击"下载模板"链接
+**Then** 系统下载机构中介模板
+
+#### Scenario: 上传个人中介文件
+
+**Given** 用户在导入对话框中
+**And** 用户选择"个人中介"类型
+**And** 用户勾选"是否更新已经存在的数据"
+**When** 用户上传 Excel 文件
+**And** 用户点击"确定"按钮
+**Then** 系统调用 `/dpc/intermediary/importPersonData` 接口
+**And** 系统传递 `updateSupport=true` 参数
+**And** 显示导入结果
+
+#### Scenario: 上传机构中介文件
+
+**Given** 用户在导入对话框中
+**And** 用户选择"机构中介"类型
+**And** 用户不勾选"是否更新已经存在的数据"
+**When** 用户上传 Excel 文件
+**And** 用户点击"确定"按钮
+**Then** 系统调用 `/dpc/intermediary/importEntityData` 接口
+**And** 系统传递 `updateSupport=false` 参数
+**And** 显示导入结果
+
+---
+
+### Requirement: 表单字段布局优化
+
+表单 SHALL 使用标签页和响应式布局优化大量字段的展示。
+
+#### Scenario: 个人信息标签页布局
+
+**Given** 用户在新增或编辑对话框中
+**And** 中介类型为"个人"
+**When** 用户查看"个人信息"标签页
+**Then** 字段使用两列布局（el-col :span="12"）
+**And** 长文本字段（如联系地址）使用整行布局
+**And** 字段标签宽度为 120px
+**And** 输入框有合适的 maxlength 限制
+
+#### Scenario: 机构信息标签页布局
+
+**Given** 用户在新增或编辑对话框中
+**And** 中介类型为"机构"
+**When** 用户查看"机构信息"标签页
+**Then** 字段使用两列布局
+**And** 长文本字段（如注册地址）使用整行布局
+**And** 股东信息区域使用分隔线（el-divider）分隔
+**And** 字段标签宽度为 140px（ accommodate 更长的标签名称）
+**And** 输入框有合适的 maxlength 限制