SetReviewExperts组件（设置评审专家）

一、约定

标题	内容
路由地址	公共组件无单独路由
路由页面	src/components/SetReviewExperts/index.vue
操作权限	需具备 `proj_req_manage_assign_reviewer` 权限
API调用约定	当前组件进行API调用集中管理、内置组件仅做展现层控制。

二、属性（Attributes）

组件props传入参数

序号	参数名	类型	说明	默认值	可选值
1	projectId	String	项目ID	''	-
2	mode	String	模式	'default'	-
3	height	Number	表格高度	300	-
4	isDisabled	Boolean	是否禁用操作按钮	false	true

内部data参数

序号	参数名	类型	说明	默认值	可选值
1	multipleSelection	Ref	表格中选中的行数据	[]	-
2	excludeIds	Ref	排除的专家ID列表	[]	-
3	currentPage	Ref	当前页码	1	-
4	pageSize	Ref	每页显示数量	10	[10, 20, 50, 100]
5	total	Ref	数据总数	0	-
6	reviewExpertsList	Ref	评审专家列表数据	[]	-
7	searchData	Ref	搜索表单数据	{ province: [], expertName: '', nationList: [], phone: '', orgName: '', dutyName: '', orgType: '' }	-
8	loading	Ref	表格加载状态	false	true
9	drawerData	Ref	抽屉数据	{ switch: false, title: '' }	-
10	expertsListRef	Ref	专家列表组件引用	-	-
11	expertsProjectRef	Ref	专家项目组件引用	-	-
12	isAllowSubmit	Ref	是否允许提交	true	true, false

三、组件管理

（一）组件事件

组件自身提供的功能

核心功能点，执行的事件关系

1. getExistingExcludeIds() 和 getReviewExpertsList() 初始化数据

若 projectId 存在，则执行 getExistingExcludeIds 方法获取已存在的排除专家ID列表，并执行 getReviewExpertsList 方法获取评审专家列表数据。

（二）子组件

使用 XX 子组件提供 MMM 功能

对子组件的传参赋值

子组件上报事件的接收处理

1. BaseDrawer组件（抽屉）

实现抽屉功能

父→子组件传参

v-model:show：抽屉显示状态

title：抽屉标题

子→父事件上报

上报通知	用途	执行内部事件
cancelClick	点击取消按钮	handleDrawerCancel
confirmClick	点击确认按钮	handleDrawerConfirm

2. expertsList组件（专家列表）

实现专家列表显示和选择功能

父→子组件传参

excludeIds：排除的专家ID列表

子→父事件上报

上报通知	用途	执行内部事件
无	无	无

3. expertsProject组件（专家项目）

实现专家项目信息显示功能

父→子组件传参

无

子→父事件上报

上报通知	用途	执行内部事件
无	无	无

四、事件方法

核心事件，含数据处理、API调用、事件管理管理等

1. handleSelectionChange(val) 数据变化

表格选中行数据变化时，更新 multipleSelection 的值。

2. getReviewExpertsList获取评审专家列表()

执行后调用 getReviewExpertsListPage (/projectExpert/loadPage)项目专家库表分页查询API，根据搜索条件和分页信息获取数据，并更新 reviewExpertsList 和 total 的值。

3. getExistingExcludeIds() 获取已存在的排除专家ID列表：

执行后调用 getExpertIdListByProjectId(/projectExpert/loadExpertIdListInProject)根据项目id查询已经添加专家id列表 API，根据项目ID获取排除的专家ID列表，并更新 excludeIds 的值。

4. searchFn() 搜索专家

重置页码为1，并调用 getReviewExpertsList 方法重新获取评审专家列表数据。

5. resetSearchForm() ：，

重置搜索表单数据和页码为1，并调用 getReviewExpertsList 方法重新获取评审专家列表数据。

6. handleSizeChange(val) 分页变化

每页显示数量变化时，更新 pageSize 的值，并调用 getReviewExpertsList 方法重新获取评审专家列表数据。

7. handleCurrentChange(val) 页码变化

当前页码变化时，更新 currentPage 的值，并调用 getReviewExpertsList 方法重新获取评审专家列表数据。

8. openDrawerFn() 打开添加专家抽屉

打开添加专家抽屉，设置抽屉标题为“添加专家”，并显示抽屉。

9. setReviewExpertForProjectFn(list) 添加专家

添加专家，调用 setReviewExpertForProject (/projectExpert/saveList)给项目添加多个专家API，将选中的专家数据添加到项目中，添加成功后更新数据并关闭抽屉。

10. handleDrawerConfirm() 确认添加专家

确认添加专家，获取选中的专家数据，调用 setReviewExpertForProjectFn 方法添加专家，添加成功后关闭抽屉并更新数据。

11. handleDrawerCancel() 取消添加专家

取消添加专家，关闭抽屉。

12. removeSingleExpertsFn(row) 移除单个专家

移除单个专家，弹出确认框，确认后调用 removeSingleExpertsByProject(/projectExpert/deleteOne)把专家移除专家库 API 移除专家，移除成功后更新数据。

13. removeMultipleExpertsFn() 批量移除专家

批量移除专家，若有选中的行数据，则弹出确认框，确认后调用 removeMultipleExpertsByProject(/projectExpert/deleteList)把多个专家移除专家库 API 批量移除专家，移除成功后更新数据。

14. opneReviewItems(row) 查看评审项目

-查看评审项目，打开专家项目组件并显示该专家的评审项目信息。

15. haveReviewExpertsList() 判断是否有评审专家列表数据

判断是否有评审专家列表数据，返回 reviewExpertsList 的长度是否大于0的布尔值。

SetReviewExperts组件（设置评审专家）

一、约定#

二、属性（Attributes）#

三、组件管理#

（一）组件事件#

1. getExistingExcludeIds() 和 getReviewExpertsList() 初始化数据#

（二）子组件#

1. BaseDrawer组件（抽屉）#

2. expertsList组件（专家列表）#

3. expertsProject组件（专家项目）#

四、事件方法#

1. handleSelectionChange(val) 数据变化#

2. getReviewExpertsList获取评审专家列表()#

3. getExistingExcludeIds() 获取已存在的排除专家ID列表：#

4. searchFn() 搜索专家#

5. **resetSearchForm() **：，#

6. handleSizeChange(val) 分页变化#

7. handleCurrentChange(val) 页码变化#

8. openDrawerFn() 打开添加专家抽屉#

9. setReviewExpertForProjectFn(list) 添加专家#

10. handleDrawerConfirm() 确认添加专家#

11. handleDrawerCancel() 取消添加专家#

12. removeSingleExpertsFn(row) 移除单个专家#

13. removeMultipleExpertsFn() 批量移除专家#

14. opneReviewItems(row) 查看评审项目#

15. haveReviewExpertsList() 判断是否有评审专家列表数据#

一、约定

二、属性（Attributes）

三、组件管理

（一）组件事件

1. getExistingExcludeIds() 和 getReviewExpertsList() 初始化数据

（二）子组件

1. BaseDrawer组件（抽屉）

2. expertsList组件（专家列表）

3. expertsProject组件（专家项目）

四、事件方法

1. handleSelectionChange(val) 数据变化

2. getReviewExpertsList获取评审专家列表()

3. getExistingExcludeIds() 获取已存在的排除专家ID列表：

4. searchFn() 搜索专家

5. resetSearchForm() ：，

6. handleSizeChange(val) 分页变化

7. handleCurrentChange(val) 页码变化

8. openDrawerFn() 打开添加专家抽屉

9. setReviewExpertForProjectFn(list) 添加专家

10. handleDrawerConfirm() 确认添加专家

11. handleDrawerCancel() 取消添加专家

12. removeSingleExpertsFn(row) 移除单个专家

13. removeMultipleExpertsFn() 批量移除专家

14. opneReviewItems(row) 查看评审项目

15. haveReviewExpertsList() 判断是否有评审专家列表数据