軟件開發規范（1）

2019-11-18 13:45:24

字體：大中小

來源：轉載

供稿：網友

　　軟件開發規范（1）

1 前言
為了使軟件開發過程有章可循，保證軟件質量，加強開發治理。

2 開發治理
項目進度周報表格如下：
項目編號：
匯報人：
匯報日期：
項目進度具體描述：
其他問題：

3 項目周期
司項目開發周期分為以下幾個步驟：
步驟說明參與角色生成文檔或程序（打*號為可選）
可行性分析對項目的技術，功能需求和市場進行調研和初步分析，確定是否需要立項開發。部門主管核心技術員可行性分析報告*技術調研報告*
立項正式立項，由部門主管指定項目經理，項目經理制定初步計劃。初步計劃包括設計和開發時間的初步估算。部門主管核心技術員項目初步計劃
需求分析對項目進行具體的需求分析，編寫需求分析文檔。對于B/S結構軟件系統需要制作靜態演示頁面。需求分析文檔和靜態演示頁面需要通過部門主管審批才能夠進行到下一個步驟項目經理項目核心小組需求分析文檔靜態演示頁面項目計劃修訂版本
具體設計根據需求分析對項目進行具體設計。具體設計以后，項目經理同部門主管一起指定項目小組開發成員。項目經理項目核心小組具體設計文檔項目計劃確定版本
開發根據設計開發項目，由美工對操作界面進行美化。項目經理項目開發員美工項目計劃修訂版本*
測試項目經理提交測試申請，由測試部門對項目進行測試。項目小組配合測試部門修改軟件中的錯誤。項目經理項目開發員測試部測試申請測試計劃測試報告
項目驗收項目驗收歸檔部門主管項目經理項目所有文檔和程序

4 命名規范
4.1 項目編號命名規范
待完善

4.2 文檔命名規范
待完善

4.3 jsp/Html命名規范
jsp與html文件名全部小寫，并遵循如下的規范：

u 數據/內容顯示頁
名詞，多個單詞用下劃線分隔，要求能說明顯示內容的信息，為避免沖突，可加上 “_list”。例如：
new_message.html 或 my_file_list.jsp

u 操作處理頁
命名格式：名詞_下劃線_動詞，例如：file_delete.jsp。

u 含frame頁面
<frameset>中<frame>的name屬性命名的格式是①xxx._②xxx_③xxx
①xxx部分用來標識當前頁面隸屬于整個系統中的哪一功能模塊。
如：屬于ebwebmail則被表示為ebwebmail，其它情況依次類推。
②xxx部分標識當前頁面所要完成的功能。
如：完成用戶登錄的功能則被標識為login，其它情況依次類推。
③xxx部分用來用來表示頁面在瀏覽器窗口所處的位置。
處于瀏覽器窗口的頂部則標識為top，其它情況依次類推。
例如：ebwebmail_inbox_top.jsp

<frame> src屬性相應的文件名根據情況建議在原命名規范上用下劃線加上所處窗口的位置。

u javascript腳本方法
腳本函數都以①xxx_②xxx的方式命名。
①xxx對應頁面隸屬的模塊。
②xxx表示函數所要實現的功能(動賓結構)，多個單詞用下劃線連接。
例如：ebwebmail_send_mail()

模塊通用的腳本函數必須集合于一個js文件中，在頁面上通過<script language=”Javascript” src=”url”></script>形式導入。js文件名命名使用模塊名，例如：ebwebmail.js。

假如項目已經提供了公共js腳本，則優先使用公共js腳本中提供的函數。

所有定義方法的<script>元素定義在<head></head>中或</body>后。

u javascript腳本內部變量與參數
單詞之間用下劃線分隔且全部小寫，例如：
var file_size。

u <form>表單name屬性
統一以“form_”開頭，其后加該表單所需收集的信息的作用或動作，例如：form_file_upload 或 form_send_mail。

u 表單elements
表單element的名稱以element需收集的信息標示命名，單詞之間使用下劃線分隔且全部小寫，例如：

上一篇：如何在Java中利用數據包

下一篇：軟件開發規范（2）