項目Beta衝刺——凡事預則立

班級：軟件工程1916|W
做業：項目Beta衝刺（團隊）
團隊名稱：Echo
做業目標：規定代碼規範，明確衝刺任務與計劃

目錄

• 團隊博客彙總
• 討論組長是否重選的議題和結論
• 下一階段須要改進完善的功能
• 下一階段新增的功能
• 須要改進的團隊分工
• 須要改進的工具流程
• 衝刺的時間計劃安排
• 代碼規範

團隊博客彙總

隊員學號	隊員姓名	我的博客地址	備註
221600136	張至鋒	https://www.cnblogs.com/love2i/
221600418	黃少勇	http://www.cnblogs.com/huangshaoyong
221600420	黃種鑫	http://www.cnblogs.com/huangzhongxin	隊長
221600422	李東權	http://www.cnblogs.com/Ldqblogs
221600425	林弘傑	http://www.cnblogs.com/lhj20190212

討論組長是否重選的議題和結論

通過討論，隊長不變

下一階段須要改進完善的功能

1. 完善web端員工信息管理模塊的增長與修改功能
2. 完善web端繳費信息的增長功能

下一階段新增的功能

1. 小程序端：
   1.1 查看、回覆報修內容
   1.2 查看、回覆投訴內容

2. web端：
   2.1 查看、回覆報修內容
   2.2 查看、回覆投訴內容
   2.3 人員信息、繳費信息、住宿信息上傳

須要改進的團隊分工

繼續按照以前方式進行團隊分工

須要改進的工具流程

暫無

衝刺的時間計劃安排

	任務	時間
Beta衝刺Day1	web前端：修改Alpha階段遺留問題 -- 錯誤提示不友好 web後端：實現文件上傳功能 小程序前端：界面微調 小程序後端：報修內容回覆及查詢功能接口	5.24
Beta衝刺Day2	web前端：人員等信息上傳功能實現 web後端：報修內容回覆及查詢功能接口 小程序前端：報修回覆界面編寫 小程序後端：報修內容回覆及查詢功能接口	5.25
Beta衝刺Day3	web前端：報修回覆界面編寫 web後端：報修內容回覆及查詢功能接口 小程序前端：對接報修內容回覆及查詢功能接口 小程序後端：對接報修內容回覆及查詢功能接口	5.26
Beta衝刺Day4	web前端：報修回覆界面編寫及接口對接 web後端：對接報修內容回覆及查詢功能接口 小程序前端：投訴回覆界面編寫 小程序後端：投訴內容回覆及查詢功能接口	5.27
Beta衝刺Day5	web前端：報修回覆界面編寫及接口對接、投訴回覆界面編寫 web後端：投訴內容回覆及查詢功能接口 小程序前端：對接投訴內容回覆及查詢功能接口 小程序後端：對接投訴內容回覆及查詢功能接口	5.28
Beta衝刺Day6	web前端：對接投訴內容回覆及查詢功能接口 web後端：對接投訴內容回覆及查詢功能接口 小程序端：協助web端進行聯調	5.29
Beta衝刺Day7	聯調、測試	5.30
Beta衝刺Day8	用戶總結報告	5.31

代碼規範

前端

1、文件組織形式

• 全部項目源代碼請放在項目根目錄 src 目錄下，項目所需最基本的文件包括 入口文件 以及 頁面文件

  入口文件爲 app.js ，頁面文件建議放置在 src/pages 目錄下

• Taro 中普通 JS/TS 文件以小寫字母命名，多個單詞如下劃線鏈接，例如 util.js、util_helper.js

• Taro 組件文件命名遵循 Pascal 命名法

• Taro 中普通 JS/TS 文件以 .js 或者 .ts 做爲文件後綴

• Taro 組件則以 .jsx 或者 .tsx 做爲文件後綴，固然這不是強制約束，只是做爲一個實踐的建議，組件文件依然能夠以 .js或者 .ts 做爲文件後綴

2、JavaScript 書寫規範

• 使用兩個空格進行縮進
• 字符串統一使用單引號
• 關鍵字後面加空格，函數聲明時括號與函數名間加空格
• 屬性前面不要加空格
• 遇到分號時空格要後留前不留，逗號後面加空格，始終將逗號置於行末
• 鍵值對當中冒號與值之間要留空格
• 對於變量和函數名統一使用駝峯命名法
• 不重複聲明變量，不定義未使用變量
• 對象定義存值器，必定要對於的定義取值器
• 對象屬性轉行時注意統一代碼風格
• 不定義冗餘的函數參數，避免多餘的函數上下文綁定，嵌套代碼塊中禁止再次定義函數
• 類名以大寫字母開頭，子類構造器必定要調用super，使用this以前確保super已調用
• 同一模塊有多個導入時一次性寫完，return、throw、continue和break後再也不跟代碼
• 使用===代替==，if/else關鍵字要與花括號保存在同一行
• 避免使用常量做爲條件表達式條件（循環語句除外）

3、組件及JSX書寫規範

• 組件以類的形式進行建立，而且當個文件中只能存在當個組件
• 使用兩個空格進行縮進，不要混合使用空格與製表符做爲縮進
• JSX 屬性均使用單引號
• 多個屬性，多行書寫，每一個屬性佔用一行，標籤結束另起一行
• 終始在自閉合標籤前面添加一個空格
• 屬性名稱始終使用駝峯命名法
• 用括號包裹多行 JSX 標籤
• 當標籤沒有子元素時，始終使用自閉合標籤
• 事件綁定均以on開頭，子組件傳入函數時屬性名須要以on開頭

後端

1、命名規則

• 類名統一使用UpperCamelCase風格，如XmlService
• 方法名，參數名，成員變量，局部變量統一使用lowerCamelCase風格，如inputUserId
• 常量命名所有大寫，單詞間用下劃線隔開，如MAX_STOCK_COUNT
• 抽象類命名使用 Abstract 或 Base 開頭；異常類命名使用 Exception 結尾；測試類
  命名以它要測試的類的名稱開始，以 Test 結尾
• 類型與中括號緊挨相連來表示數組
• 包名統一使用小寫，點分隔符之間有且僅有一個天然語義的英語單詞。包名統一使用
  單數形式
• Service/DAO 層方法命名規約
  1） 獲取單個對象的方法用 get 作前綴。
  2） 獲取多個對象的方法用 list 作前綴，複數形式結尾如：listObjects。
  3） 獲取統計值的方法用 count 作前綴。
  4） 插入的方法用 save/insert 作前綴。
  5） 刪除的方法用 remove/delete 作前綴。
  6） 修改的方法用 update 作前綴。

2、代碼風格

• 採用 4 個空格縮進，禁止使用 tab 字符
• if/for/while/switch/do 等保留字與括號之間都必須加空格
• 註釋的雙斜線與註釋內容之間有且僅有一個空格
• 方法參數在定義和傳入時，多個參數逗號後邊必須加空格
• 全部的覆寫方法，必須加@Override 註解
• 全部的相同類型的包裝類對象之間值的比較，所有使用 equals 方法比較
• finally 塊必須對資源對象、流對象進行關閉，有異常也要作 try-catch

3、應用分層

圖中默認上層依賴於下層，箭頭關係表示可直接依賴，如：開放接口層能夠依賴於
Web 層，也能夠直接依賴於 Service 層，依此類推：

• 開放接口層：可直接封裝 Service 方法暴露成 RPC 接口；經過 Web 封裝成 http 接口；進行
  網關安全控制、流量控制等。
• 終端顯示層：各個端的模板渲染並執行顯示的層。當前主要是 velocity 渲染，JS 渲染，
  JSP 渲染，移動端展現等。
• Web 層：主要是對訪問控制進行轉發，各種基本參數校驗，或者不復用的業務簡單處理等。
• Service 層：相對具體的業務邏輯服務層。
• DAO 層：數據訪問層，與底層 MySQL、Oracle、Hbase 等進行數據交互。