j1
负责项
- 【j1】登录系统(6)、常用菜单(4)、菜单管理(21)、首页面板(8)
在线评审视频链接
没有在线评审视频。
共性问题
菜单组 id 的命名规则不统一
几个接口之间的字段命名规则不统一。
获取菜单组名称列表 gid
添加对应菜单组 gpId
获取可选菜单下拉列表
- 如原型所示,该接口应该返回【菜单名称】,和【菜单 id】组成的数组。
返回值为空,这不是有意义的接口。
添加常用菜单
- 不应该传递【模块-菜单名称】,前端应该传递的是 id 值,是【菜单 id】,而不是在数据库内存储中文名称。
获取常用菜单列表(条件+分页)
- 分页字段是必填项,必须校验。不要指望前端自己主动传递分页值。后端要做校验。
分页查询菜单目录
/menumana/query-menucatalogpage
- 分页字段要做必填项校验。
- 前端查询 storeType 商户类型时,不可能传递纯中文当做类型来查询的。应该换成具体的 code。
- 如原型所示,商户类型是必填项,必须要提供商户类型,才能查询菜单。
必填校验
storeType 商户类型不能传递纯中文
storeType 商户类型是必填项
添加菜单目录
- 取名不要写成【组名称】,写成菜单名称,否则会带来误导。
- storeType 商户类型,前端不可能传递纯中文作为类型查询值。应该为具体的 code。
字段备注改名
不能用中文作为类型的值
修改菜单目录
/menumana/modify-menucatalog/{id}
- 统一请求方式。前端为了满足项目内全部 500 多个接口的写法,是不可能同时满足 Path 和 Body 参数写法的。应该写成唯一的 body 写法,在 body 内传递 id 值。
- 其余更改内容和【添加菜单目录】接口一样。
获取对应菜单组
- 分页参数要做必填校验。
- 分页接口必须用 PageDTO 来包裹。
分页参数要做必填校验
分页接口必须按照 PageDTO 来包裹
获取菜单组列表
- 分页参数做必填校验。
- GId 是什么?写好备注。
添加菜单组
- 很多参数没有按照原型要求,设置成必填项。请严格按照原型要求,设置字段为必填项。
详情
修改菜单组
/menu-group/update-menu-group/{gId}
- 前端使用了统一的工具。现在没办法同时以 path 和 body 的形式上传参数。
获取菜单列表(条件+分页)
/meunmana/menuitem/get-menulist
- 分页字段做必填校验。
- 商户类型,在原型内显示,应该为必填项。
- 应该用【菜单组 id】来查询,而不是【菜单项 id】。
- 返回项缺少很多字段。请自己检查页面,手动补全。这里不一一列举了。
分页字段做必填校验
商户类型应为必填项
查询参数不对
应该用【菜单组 id】来查询,而不是【菜单项 id】
很多字段找不到,需要重新补全
批量删除
- 删除菜单时一个一个单独删除的,不是批量删除。
权限查询(条件与分页)
/menumana/privilege/query-condition
- 【菜单项 id】必填,因为是从具体的菜单项点进来的,所以必须要传递【菜单项 id】。
- 补全字段注释。
- 分页栏字段必须做必填校验。
- 返回值没有说清楚商户类型 id,无法完成编辑弹框的回显需求。
返回值没有说清楚商户类型
编辑业务回显时,是要根据【商户类型 id】,来回显数据的。
本接口的返回字段,没有说清楚是那个字段代表了【商户类型 id】
添加权限
- 缺少很多必填项。权限名称、资源路径、商户类型。是必填项。没有做校验。
- 缺少必要的【菜单项 id】字段。被添加的权限,是来自于【菜单项】的。没有【菜单项 id】,就无法给指定的【菜单项】增加权限。
缺少必填校验
如图所示,权限名称、资源路径、商户类型。是必填项。没有做校验。
修改权限
/menumana/privilege/modify-privilege
- 缺少必填项校验,请参考【添加权限】接口的评论。