【在線實習(xí)·吾研第一期】“學(xué)長認證模塊”JAVA開發(fā)文檔官方講解

大家好,我是你們的大拿老師~
本期我們將對首屆挑戰(zhàn)杯“吾研”項目中——學(xué)長認證模塊JAVA 項目的開發(fā)設(shè)計文檔的官方改進版進行講解。本期的實習(xí)生的作品作為第一期來說,還是出乎意料的好。

大家雖然考慮的比較到位,但是還是少了很多真正的商用細節(jié)。
一. 主要功能
主要的本期產(chǎn)品功能就是兩個,一個是在認證環(huán)節(jié)信息的填寫。
第二個是在整個認證流程的狀態(tài)變更,以及它能做到的下一步動作。比如說把未認證狀態(tài)變成已認證,在審核中的的時候,用戶可以放棄認證或者修改認證。
二. 吾研認證表

大拿老師點評:
1. 因為還沒有去做登錄模塊,所以現(xiàn)在可以把用戶id寫死,然后讓這個流程能走下去。
2. CollegeId需要寫成一個枚舉,后面會有省的枚舉和學(xué)校的數(shù)據(jù)執(zhí)行表。
3. StudyCard(校園卡)要往后放,不要放這么前的位置。
4. 注意:對于校園卡,前端用的是vant這么一種上傳,作為JAVA開發(fā)一定要去看看vant前端的框架傳過來的圖案是個什么樣的類型。
5. 一般來說,數(shù)據(jù)圖片不會放在數(shù)據(jù)庫里,一般存的是一個可讀取的地址。
6. status為0時說明數(shù)據(jù)是無效的。
7. email 和studycard 實際上可以通用成一個字段。
三. 吾研認證流水表

大拿老師點評:
1. status:為0時是未審核,1是審核中,2是認證成功,3是認證失敗。
2. 流水表就是不斷的插入,對應(yīng)的主表它的狀態(tài)要進行變更。
3. 從審核中變成未認證的時候,實際上就是把認證表的status從1變回0,用來區(qū)別用戶新發(fā)起認證還是重新發(fā)起認證。歷史認證的記錄對后面的審核是有幫助的。
4. 郵箱:需要有一個郵箱的接收驗證碼。不同場景設(shè)計不同的技術(shù)方案。
四. 接口

大拿老師點評:
1. 郵件發(fā)送接口:一般來說service不會出現(xiàn)實現(xiàn)類,一定是有問題的。JAVA本身的定義和接口就是為了能去做一個內(nèi)部實現(xiàn)的遮擋,不對外呈現(xiàn)。注意發(fā)送的時候一定是一起發(fā)送的。
2. 少一個最主要的接口:認證接口,以及它的對象是什么值。