作者:黄明,最后编写日期:2019-4-19
一、 用户注册
1. 缺少一列是否唯一,新增和必填一样的列。
2 .用户编号是唯一
3. 缺少根据用户编号查询用户是否存在的接口 。描述:业务系统根据用户编号生成规则,生成用户编号(编号生成规则:用户类型二位+业务编号二位+顺序号六位),在调用此公共模块验证生成的用户编号是否唯一。
4. 账户有效时间,拆分为二个字段,账户有效开始时间,账户有效结束时间。
5.缺少用户类型字段,该字段为sting(20) 有三个固定值可传输,①ordinary_users社会公众②local_departments地方部门及推荐单位③industry_experts行业专家
6. 由于存在社会公众与行业专家,组织机构代码可以为空,因为社会公众可能不存在组织机构代码。
7. 是否临时账户,应当给出可选值,①Y是②N否
8. 用户名应当唯一,并修改用户名说明为“登录名”,同样的道理,是唯一的字段,应该添加唯一判断的接口,此处需要添加通过用户名判断是否存在的接口。
9. 角色code可以输入多个值,一个用户对应多个角色,此处格式不正确.
10. 缺少姓名字段与邮政编码字段
二、 角色code
角色code为系统管理员在公用模块新增角色时,手动输入的CODE码字段,此处应该提供目前需要的28个系统角色对应的code码。
如下表格:
角色CODE | 对应可访问系统 |
---|---|
XXYYPPGL | 休闲渔业品牌管理 |
svn地址查看有哪些系统,路径如下
28个系统如下:
三、 组织机构码
1.说明错误,组织机构码不是由公共模块根据系统生成的。而是来自农业部提供的组织机构编号(如果农业部提供的文件,名称是组织机构编号,请在用户注册接口也统一命名,统一为组织机构编号)
2.将组织机构码的Excel文件上传上去,提供下载即可。不需要写例如,换成组织机构编号文件下载。
四、 查询用户
-
由于用户注册username 说明更换成了“登录名”,此处说明也更换为登录名。
-
组织机构代码不用必填,因为有的用户没有组织机构码(确认此处名称是否为组织机构编号)
成功示例中应该有二项: -
用户存在:
{
“state”: “1”,
“msg”: “用户存在”,
“data”: {
“username”: “用户名”,
“work_company”: “上海”,
“company_addres”: “上海南京路”,
“company_nature”: “事业单位”,
“belong_system”: “农业部”,
“belong_department”: “人事部”,
“position”: “科长”,
“Job_title”: “中级工程师”,
“signs”: “15afgef6fdsg6”,
“efttime”: “2019-10-20 10:03:02”,
“usercode”: “ieerw432”,
“rolecode”: “xxyy-zj-2847279”,
“groupcode”: “00111021”,
“password”: “552867959748427776”,
“email”: "1573548651@qq.com"
“telephone”: “1573561462”
“rolecode”: “srs-09”
“groupcode”: “pjsxe”
}
} -
用户不存在
{
“state”: “0”,
“msg”: “用户不存在”,
“data”: null
}
五、更新用户权限
由于角色code是固定值,和用户注册里面的一样,加入备注说明,跳转到角色code的说明文档中。
角色code为固定28个值,如果系统中没有这个角色,应该返回系统无此角色CODE
五、文档中存在的公共问题
一些有规定输入的字段,如下:是否为临时账户,如果客户端调用时输入参数不是Y或者N,那么系统应该做校验处理,返回相应错误码;