“学长认证模块”JAVA开发文档官方讲解：要注意一些商业细节

大家好，我是你们的大拿老师~

 

本期我们将对首届挑战杯“吾研”项目中——学长认证模块JAVA 项目的开发设计文档的官方改进版进行讲解。本期的实习生的作品作为第一期来说，还是出乎意料的好。

 

 

大家虽然考虑的比较到位，但是还是少了很多真正的商用细节。

 

一. 主要功能

 

主要的本期产品功能就是两个，一个是在认证环节信息的填写。

第二个是在整个认证流程的状态变更，以及它能做到的下一步动作。比如说把未认证状态变成已认证，在审核中的的时候，用户可以放弃认证或者修改认证。

 

二. 吾研认证表

 

 

大拿老师点评：

 

1. 因为还没有去做登录模块，所以现在可以把用户id写死，然后让这个流程能走下去。

2. CollegeId需要写成一个枚举，后面会有省的枚举和学校的数据执行表。

3. StudyCard（校园卡）要往后放，不要放这么前的位置。

4. 注意：对于校园卡，前端用的是vant这么一种上传，作为JAVA开发一定要去看看vant前端的框架传过来的图案是个什么样的类型。

5. 一般来说，数据图片不会放在数据库里，一般存的是一个可读取的地址。

6. status为0时说明数据是无效的。

7. email 和studycard 实际上可以通用成一个字段。

 

三. 吾研认证流水表

 

 

大拿老师点评：

 

1. status：为0时是未审核，1是审核中，2是认证成功，3是认证失败。

2. 流水表就是不断的插入，对应的主表它的状态要进行变更。

3. 从审核中变成未认证的时候，实际上就是把认证表的status从1变回0，用来区别用户新发起认证还是重新发起认证。历史认证的记录对后面的审核是有帮助的。

4. 邮箱：需要有一个邮箱的接收验证码。不同场景设计不同的技术方案。

 

四. 接口

 

 

大拿老师点评：

 

1. 邮件发送接口：一般来说service不会出现实现类，一定是有问题的。JAVA本身的定义和接口就是为了能去做一个内部实现的遮挡，不对外呈现。注意发送的时候一定是一起发送的。

2. 少一个最主要的接口：认证接口，以及它的对象是什么值。