智能渔技统一用户文档设计问题

作者：黄明，最后编写日期：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文件上传上去，提供下载即可。不需要写例如，换成组织机构编号文件下载。

四、 查询用户

1. 由于用户注册username 说明更换成了“登录名”，此处说明也更换为登录名。

2. 组织机构代码不用必填，因为有的用户没有组织机构码（确认此处名称是否为组织机构编号）
   
   成功示例中应该有二项：

3. 用户存在：
   {
   “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”
   }
   }

4. 用户不存在
   {
   “state”: “0”,
   “msg”: “用户不存在”,
   “data”: null
   }

五、更新用户权限

由于角色code是固定值，和用户注册里面的一样，加入备注说明，跳转到角色code的说明文档中。

角色code为固定28个值，如果系统中没有这个角色，应该返回系统无此角色CODE

五、文档中存在的公共问题

一些有规定输入的字段，如下：是否为临时账户，如果客户端调用时输入参数不是Y或者N,那么系统应该做校验处理，返回相应错误码；