1 數(shù)據(jù)庫(kù)使用規(guī)范
1.1服務(wù)器上有關(guān)數(shù)據(jù)庫(kù)的一切操作只能由服務(wù)器管理人員進(jìn)行。
1.2程序中訪問(wèn)數(shù)據(jù)庫(kù)時(shí)使用統(tǒng)一的用戶(hù)、統(tǒng)一的連接文件訪問(wèn)數(shù)據(jù)庫(kù)。
1.3原則上每一個(gè)頻道只能建一個(gè)庫(kù),庫(kù)名與各頻道的英文名稱(chēng)相一致,庫(kù)中再包含若干表。比較大的、重點(diǎn)的欄目可以考慮單獨(dú)建庫(kù),庫(kù)名與欄目的英文名稱(chēng)相一致。
1.4命名:
(1) 數(shù)據(jù)庫(kù)、表、字段、索引、視圖等一系列與數(shù)據(jù)庫(kù)相關(guān)的名稱(chēng)必須全部使用與內(nèi)容相關(guān)的英文單詞命名(盡量避免使用漢語(yǔ)拼音),對(duì)于一個(gè)單詞難以表達(dá)的,可以考慮用多個(gè)單詞加下劃線(_)連接(不能超過(guò)四個(gè)單詞)命名。
(2) 所有的名稱(chēng)必須統(tǒng)一使用英文小寫(xiě)字母。
(3) 所有的名稱(chēng)起始和結(jié)尾不能使用下劃線(_)。
(4) 所有的名稱(chēng)不能包含26個(gè)英文小寫(xiě)字母和下劃線(_)以外的其他字符。
1.5不再使用的數(shù)據(jù)庫(kù)、表應(yīng)刪除,在刪除之前必須備份(包括結(jié)構(gòu)和內(nèi)容)。
2 文檔規(guī)范
所有的項(xiàng)目必須有相關(guān)的文檔說(shuō)明(可以是電子文檔)。文檔應(yīng)包含如下內(nèi)容:
(1)項(xiàng)目名稱(chēng)。
(2)項(xiàng)目小組名單,項(xiàng)目負(fù)責(zé)人。
(3)項(xiàng)目開(kāi)發(fā)起始時(shí)間和結(jié)束時(shí)間。
(4)項(xiàng)目?jī)?nèi)容描述。
(5)項(xiàng)目位置。(在哪個(gè)頻道、哪個(gè)欄目)
(6)與項(xiàng)目有關(guān)的程序文件名(含路徑名),文件內(nèi)容及實(shí)現(xiàn)的功能描述。
(7)完整的程序流程圖。
(8)數(shù)據(jù)庫(kù)、表、視圖、索引的名稱(chēng),用途。字段的名稱(chēng)、類(lèi)型、長(zhǎng)度、用途,必須附上相關(guān)的SQL語(yǔ)句。
3源代碼與頁(yè)面嵌套規(guī)范
3.1源代碼:
(1) 使用自定義變量(包括全局變量、局部變量)之前必須先聲明變量,并用注釋語(yǔ)句標(biāo)明變量的類(lèi)型、用途。
(2)自定義函數(shù)必須用注釋語(yǔ)句標(biāo)明函數(shù)的用途、參數(shù)的數(shù)據(jù)類(lèi)型、意義,返回值的類(lèi)型。
(3)程序中重要的過(guò)程或代碼較長(zhǎng)的過(guò)程應(yīng)使用注釋語(yǔ)句標(biāo)明該過(guò)程的起始行和結(jié)束行,并注明該過(guò)程的功能。
(5) 所有的注釋文字一律使用簡(jiǎn)體中文。
3.2 HTML頁(yè)面嵌套:
(1) 網(wǎng)頁(yè)設(shè)計(jì)部設(shè)計(jì)的HTML頁(yè)面以嵌套的方式確定用于動(dòng)態(tài)顯示程序執(zhí)行結(jié)果的位置、寬度、行數(shù)(或高度)等,并在相應(yīng)位置予以文字說(shuō)明。頁(yè)面中與程序無(wú)關(guān)的圖片、文字、聯(lián)結(jié)等必須使用完整的URL。
(2) 軟件開(kāi)發(fā)人員和編輯人員可以根據(jù)情況協(xié)商,將頁(yè)面文件及圖片與程序獨(dú)立存放在各自的服務(wù)器上,頁(yè)面改版和修改程序獨(dú)立進(jìn)行。
(3) 使用include技術(shù)將分割開(kāi)的HTML頁(yè)面分別嵌入程序代碼中,要求做到修改HTML頁(yè)面時(shí)無(wú)須改寫(xiě)程序,而修改程序時(shí)不會(huì)影響HTML頁(yè)面效果,將頁(yè)面改版和修改程序兩項(xiàng)工作分別獨(dú)立。
(4) 頁(yè)面和程序嵌套以后不能破壞原HTML頁(yè)面的整體顯示效果,字體、字號(hào)、顏色等應(yīng)盡量保持原HTML頁(yè)面的風(fēng)格。
(5) 動(dòng)態(tài)生成的頁(yè)面的各項(xiàng)指標(biāo)(如圖片大小、頁(yè)面寬度、高度、頁(yè)面文件的字節(jié)數(shù)等)應(yīng)符合本公司網(wǎng)頁(yè)設(shè)計(jì)方面的要求。
4測(cè)試規(guī)范(軟件部分)
對(duì)于較大的項(xiàng)目應(yīng)成立相應(yīng)的測(cè)試小組,小組成員由軟件開(kāi)發(fā)人員、網(wǎng)頁(yè)設(shè)計(jì)人員、技術(shù)人員、編輯人員組成。測(cè)試過(guò)程應(yīng)參照網(wǎng)頁(yè)設(shè)計(jì)部為該項(xiàng)目提供的原HTML頁(yè)面進(jìn)行。測(cè)試內(nèi)容包括以下幾點(diǎn):
(1) 頁(yè)面寬度、高度(行數(shù))。
(2) 頁(yè)面文字、圖片、色彩是否風(fēng)格統(tǒng)一。
(3)頁(yè)面的圖片顯示是否正常、有無(wú)變形。
(4)彈出頁(yè)面的效果。
(5)頁(yè)面的聯(lián)接是否正確。
(6)動(dòng)態(tài)生成的頁(yè)面是否符合以上幾個(gè)方面的要求,頁(yè)面大�。ㄗ止�(jié)數(shù),包括頁(yè)面的圖片、*.js、*.css、*.class等相關(guān)文件)是否符合網(wǎng)頁(yè)設(shè)計(jì)的要求。
(7) 軟件方面的功能是否實(shí)現(xiàn)。如數(shù)據(jù)庫(kù)的查詢(xún)、修改、刪除,文件的上傳、下載等操作是否正常。
(8) 測(cè)試結(jié)束后,根據(jù)《軟件開(kāi)發(fā)需求書(shū)》在《測(cè)試報(bào)告》上如實(shí)填寫(xiě)測(cè)試結(jié)果,包括測(cè)試通過(guò)的、未通過(guò)的,指出出錯(cuò)的頁(yè)面和相關(guān)的程序文件,并附上測(cè)試中出現(xiàn)的錯(cuò)誤信息。