一、约定

标题	内容
路由地址	http://ip:port/adminManage/roleManage
路由页面	src\views\adminManage\roleManage\index\index.vue
操作权限	需要权限控制
API调用约定	当前组件进行API调用集中管理、内置组件仅做展现层控制。

二、属性（Attributes）

组件props传入参数

无

内部data参数

序号	参数名	类型	说明	默认值	可选值
1	from	object	专家注册开关数据	{allowExpertRegister:0}	--
2	countExpertTotal	number	专家总数	0	--
3	countExpertData	object	各状态专家数量	{}	--
4	searchForm	object	搜索表单	{page:{pageNo:1,pageSize:10},expertStatusList:[],orgProvinceList:[],nationList:[],userInfoEnable:null,realName:null,phone:null,orgName:null,idNumber:null,userName:null,dutyName:null,orgType:null}	--
5	tableData	array	表格数据	[]	--
6	total	number	总数据条数	0	--
7	multipleSelection	array	表格多选数据	[]	--
8	tableLoading	Boolean	表格加载状态	false	true,false
9	dialogShow	Boolean	弹窗显示状态	false	true,false
10	dialogType	string	弹窗类型	''	'add'/'edit'/'check'/'editUserName'
11	formData	object	表单数据	{}	--
12	importDialogShow	Boolean	导入弹窗显示状态	false	true,false
13	expertStatusOptions	array	专家状态选项	[{label:'未提交',value:1,...},{label:'待审核',value:2,...},{label:'通过',value:3,...},{label:'未通过',value:4,...}]	--

三、组件管理

（一）组件事件

组件自身提供的功能

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

专家用户注册开关控制

专家数据统计展示

专家列表展示与搜索

专家添加、编辑、查看

专家审核与审核记录

专家账号启用/禁用

专家信息修改（手机号、密码、头像、用户名）

专家批量导入

专家档案下载

（二）子组件

使用子组件提供功能

表格数据展示

弹窗表单操作

抽屉表单操作

分页控制

专家导入

状态标签展示

1. BaseDialog二次封装的弹窗组件

提供弹窗功能

父→子组件传参

show: 弹窗显示状态

title: 弹窗标题

defaultFooterShow: 是否显示底部按钮

width: 弹窗宽度

class: 弹窗样式类名

子→父事件上报

上报通知	用途	执行内部事件
dialogConfirm	确认按钮点击	handleConfirm
dialogCancel	取消按钮点击	handleCancel

2. BaseDrawer组件（抽屉组件）

提供抽屉功能

父→子组件传参

show: 抽屉显示状态

title: 抽屉标题

子→父事件上报

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

3. Pagination 分页组件二次封装

提供分页功能

父→子组件传参

page: 分页信息

total: 总数据条数

子→父事件上报

上报通知	用途	执行内部事件
change-page-emit	分页变化	handleChangePage

4. useImportDialog 上传文件弹窗组件

提供导入功能

父→子组件传参

show: 弹窗显示状态

title: 弹窗标题

upload-url: 上传地址

download-url: 下载模板地址

子→父事件上报

上报通知	用途	执行内部事件
dialogConfirm	导入完成	getTableData

5. BaseTags组件

提供标签展示

父→子组件传参

color: 标签背景色

text-color: 标签文字颜色

text: 标签文本

子→父事件上报

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

四、事件方法

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

1. handleClick() 专家注册开关切换

切换专家注册开关状态

调用updateExpertRegister接口更新状态

2. getExpertCount() 获取专家统计数据

调用countExpert接口获取各状态专家数量

更新统计数据

3. getTableData() 获取表格数据

整理请求参数

设置表格加载状态

调用loadPage接口获取专家列表数据

更新表格数据和总条数

4. handleSearch() 搜索

重置页码为1

调用getTableData方法获取数据

5. handleReset() 重置搜索条件

重置搜索表单数据

调用getTableData方法获取数据

6. handleOpenUserInfoDialog(type, row) 打开用户信息弹窗

设置弹窗类型

根据类型初始化表单数据

显示弹窗

7. handleConfirm() 弹窗确认

验证表单数据

根据弹窗类型执行不同的操作：

添加专家：调用saveOne接口

编辑用户名：调用updateUserName接口

操作成功后刷新表格数据并关闭弹窗

8. handleCancel() 弹窗取消

关闭弹窗

重置表单数据

9. handelView(row, type) 查看专家详情

跳转到专家详情页面

传递专家ID和操作类型参数

10. handelEdit(row, type) 编辑专家信息

跳转到专家编辑页面

传递专家ID和操作类型参数

11. handleSwitchChange(row) 切换账号状态

设置行加载状态

调用updateOne接口更新账号状态

更新成功后刷新表格数据

12. handleBatchEnable(status) 批量启用/禁用

判断是否选择了数据

调用updateList接口批量更新账号状态

更新成功后刷新表格数据

13. handleAudit(row) 审核专家

跳转到专家审核页面

传递专家ID参数

14. handleAuditRecord(row) 查看审核记录

调用getAuditRecord接口获取审核记录

显示审核记录抽屉

15. handleDownLoadRecord(row) 下载专家档案

调用downloadExpertFile接口下载专家档案

16. handlePassword(row) 修改密码

初始化修改密码数据

显示修改密码弹窗

17. modifyPasswordFn() 保存修改密码

验证密码是否一致

调用updatePassword接口更新密码

更新成功后关闭弹窗

18. handleChangePhone(row) 更换手机号

初始化更换手机号数据

显示更换手机号弹窗

19. sendSmsCode() 发送短信验证码

验证手机号格式

调用sendSms接口发送验证码

开始倒计时

20. modifyPhoneFn() 保存修改手机号

验证手机号和验证码

调用updatePhone接口更新手机号

更新成功后关闭弹窗并刷新表格数据

21. handleUserHead(row, type) 修改头像

初始化头像上传数据

显示头像上传弹窗

22. handleProjectNum(row) 查看评审项目

跳转到评审项目页面

传递专家ID参数

23. handleSelectionChange(val) 表格多选变化

更新多选数据

24. handleImportUser() 导入专家

显示导入弹窗

专家库列表页

一、约定#

二、属性（Attributes）#

三、组件管理#

（一）组件事件#

（二）子组件#

1. BaseDialog二次封装的弹窗组件#

2. BaseDrawer组件 （抽屉组件）#

3. Pagination 分页组件二次封装#

4. useImportDialog 上传文件弹窗组件#

5. BaseTags组件#

四、事件方法#

1. handleClick() 专家注册开关切换#

2. getExpertCount() 获取专家统计数据#

3. getTableData() 获取表格数据#

4. handleSearch() 搜索#

5. handleReset() 重置搜索条件#

6. handleOpenUserInfoDialog(type, row) 打开用户信息弹窗#

7. handleConfirm() 弹窗确认#

8. handleCancel() 弹窗取消#

9. handelView(row, type) 查看专家详情#

10. handelEdit(row, type) 编辑专家信息#

11. handleSwitchChange(row) 切换账号状态#

12. handleBatchEnable(status) 批量启用/禁用#

13. handleAudit(row) 审核专家#

14. handleAuditRecord(row) 查看审核记录#

15. handleDownLoadRecord(row) 下载专家档案#

16. handlePassword(row) 修改密码#

17. modifyPasswordFn() 保存修改密码#

18. handleChangePhone(row) 更换手机号#

19. sendSmsCode() 发送短信验证码#

20. modifyPhoneFn() 保存修改手机号#

21. handleUserHead(row, type) 修改头像#

22. handleProjectNum(row) 查看评审项目#

23. handleSelectionChange(val) 表格多选变化#

24. handleImportUser() 导入专家#

一、约定

二、属性（Attributes）

三、组件管理

（一）组件事件

（二）子组件

1. BaseDialog二次封装的弹窗组件

2. BaseDrawer组件（抽屉组件）

3. Pagination 分页组件二次封装

4. useImportDialog 上传文件弹窗组件

5. BaseTags组件

四、事件方法

1. handleClick() 专家注册开关切换

2. getExpertCount() 获取专家统计数据

3. getTableData() 获取表格数据

4. handleSearch() 搜索

5. handleReset() 重置搜索条件

6. handleOpenUserInfoDialog(type, row) 打开用户信息弹窗

7. handleConfirm() 弹窗确认

8. handleCancel() 弹窗取消

9. handelView(row, type) 查看专家详情

10. handelEdit(row, type) 编辑专家信息

11. handleSwitchChange(row) 切换账号状态

12. handleBatchEnable(status) 批量启用/禁用

13. handleAudit(row) 审核专家

14. handleAuditRecord(row) 查看审核记录

15. handleDownLoadRecord(row) 下载专家档案

16. handlePassword(row) 修改密码

17. modifyPasswordFn() 保存修改密码

18. handleChangePhone(row) 更换手机号

19. sendSmsCode() 发送短信验证码

20. modifyPhoneFn() 保存修改手机号

21. handleUserHead(row, type) 修改头像

22. handleProjectNum(row) 查看评审项目

23. handleSelectionChange(val) 表格多选变化

24. handleImportUser() 导入专家