发表于: 2017-12-11 22:22:50
1 594
今日完成的事情:
今天对我们小组讨论了一波之后,对接口方案进行了一波修改:
1)职位的新增,需要在公司已经存在的前提下,才可以新增职位。
在公司页面点击职位跳转到本公司的职位列表:
然后在本公司展示职位的页面有个新增职位按钮,点击之后就可以新增职位,这个新增职位只能通过这种途径来添加,不能直接添加职位。
2)公司标签:
再新增公司页面可以添加标签,然后就是新增职位页面就是新增公司添加的标签:
就是新增职位的标签,是新增公司添加的标签在这里的显示。
如果职位想要增加标签的话,必须公司先增加标签,才能在职位添加标签。
但是这里有一个问题:
这里添加公司标签的时候添加的是一个字符串,我们后端应该怎么把它变成标签的形式,或者说是前端应该以什么方式传递给后端。
3)刚开始讨论的时候,商讨的是超级管理员可以重置其他账户的密码,感觉这个有一些不合理的地方。如果禅机管理员可以重置其他用户的密码,那么其他用户就存在安全因素。
4)听师兄说,公司的框架生成的sql语句只有select id,所以每个数据表都需要ID字段。
5)萝卜多用到最多的应该就是动态查询和模糊查询。所以sql语句设计的时候一定要规范。
仔细分析一下萝卜多主要做的事情,发现主要就是公司的增删改查和职位的增删改查。脑袋里面已经有了一个具体的思路,具体就看怎么实现了。
然后我和我的后端小伙伴分工了一下,他负责公司模块以及article模块的方案设计,我负责职位和角色还有manager模块的方案设计,方案设计已经初步完成了。
其实方案设计具体应该怎么做,我也不是很清楚,就是对照着原型图把每个接口具体的实现讲一下。
最后回头看了一下日报内容可写的内容不是很多,就把自己写的方案设计贴上来一部分吧:
职位管理
职位列表:
接口:get /a/u/profession/search
1)获取所有的职位,展示字段有序号、公司名称、薪资、学历要求、工作经验、发布时间、上架状态,发布时间倒叙排列
2)点击编辑会调用接口put a/u/profession/{professionId}进入编辑职位页面
3)点击上架(下架)会调用put /a/u/pfofession/states/{professionId}
根据动态sql语句更改职位的上下架状态,更改职位的上下架状态需要首先判断公司的上下架状态,如果公司未上架,提示公司上架,才能职位上架。
4)根据公司名称、职位名称、职业类别、学历要求、工作经验、发布时间、薪资、状态等查询职位时调用接口get /a/u/profession/{id}根据动态查询语句筛选公司
5)xxxxxx的在招职位 公司名称+“的在找职位”是通过公司列表点击职位按钮转至某一公司的在招职位列表
调用接口get a/u/profession根据动态查询语句,筛选出该公司的已上架的在找职位。
点击新增调用post /a/u/profession跳转新增公司页面,新增后默认上架转台。
点击编辑会调用接口put a/u/profession/{professionId}进入编辑职位页面
新增职位:
需要有公司的前提下,才能新增职位。
根据页面xxxxxx的在招职位 公司名称+“的在招职位”的新增按钮跳转新增职位页面。
调用接口:post /a/u/profession
每个职位标签对应一个code,code约定好对应的状态信息。
编辑职位:
通过职位后面对应的编辑按钮跳转,调用接口:put /a/u/profession/{professionId}进入编辑职位页面
上面的是职位管理模块的,方案评审的时候会结合着原型图和接口文档一起进行详细的讲解。
具体的讲一下出参和返回参数,如何通过sql动态查询进行筛选自己想要的内容,每个模块之间是如何进行联系的。
明天会具体的对字段约定和一些接口的约定进行一下规范。
明日计划的事情:
明天完善一下方案设计,约个时间进行方案评审。
遇到的问题:
在做方案设计的时候,会遇到我们的接口文档设计的还是有一定的缺陷,需要进行修改。
收获:
不断的优化自己的接口文档,慢慢的自己对接口文档的一些细节性的东西知道应该怎么处理。
评论