发表于: 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}根据动态查询语句筛选公司

5xxxxxx的在招职位 公司名称+“的在找职位”是通过公司列表点击职位按钮转至某一公司的在招职位列表

调用接口get a/u/profession根据动态查询语句,筛选出该公司的已上架的在找职位。

点击新增调用post /a/u/profession跳转新增公司页面,新增后默认上架转台。

点击编辑会调用接口put a/u/profession/{professionId}进入编辑职位页面

新增职位:

需要有公司的前提下,才能新增职位。

根据页面xxxxxx的在招职位 公司名称+“的在招职位”的新增按钮跳转新增职位页面。

调用接口:post /a/u/profession

每个职位标签对应一个codecode约定好对应的状态信息。

编辑职位:

通过职位后面对应的编辑按钮跳转,调用接口:put /a/u/profession/{professionId}进入编辑职位页面

上面的是职位管理模块的,方案评审的时候会结合着原型图和接口文档一起进行详细的讲解。

具体的讲一下出参和返回参数,如何通过sql动态查询进行筛选自己想要的内容,每个模块之间是如何进行联系的。

明天会具体的对字段约定和一些接口的约定进行一下规范。

明日计划的事情:

明天完善一下方案设计,约个时间进行方案评审。

遇到的问题:

在做方案设计的时候,会遇到我们的接口文档设计的还是有一定的缺陷,需要进行修改。

收获:

不断的优化自己的接口文档,慢慢的自己对接口文档的一些细节性的东西知道应该怎么处理。


返回列表 返回列表
评论

    分享到