【正文】 ................. 3 . 系統(tǒng)需求說明書 ............................................................................ 9 . 應用開發(fā)需求說明書 ................................................................... 11 . 系統(tǒng)設計說明書 .......................................................................... 12 . 接口設計文件 .............................................................................. 17 . 項目組態(tài)規(guī)范 .............................................................................. 18 . 需求設計階段文件評審 .............................................................................. 20 . 各文檔應進行評審工作 ................................................................ 20 . 評審并有評審記錄和審批記錄。 文件類型 說明 用戶需求說明書 針對技術規(guī)格書生成本項目的用戶需求文件，并將各種需求有序標識出來 系統(tǒng)需求說明書 根據用戶需求，提煉出 來本系統(tǒng)的功能、性能、軟 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 3 頁 共 38 頁 件的要求，將各個需求分門別類，并進行和分析和總結 應用開發(fā)需求說明書 對系統(tǒng)需求中分析出來的軟件要求進行更深層的分型，可按功能完成多個應用開發(fā)需求文件 系統(tǒng)設計說明書 根據系統(tǒng)需求完成系統(tǒng)設計文件，設計文件不應憑空產生，應在原有系統(tǒng)或其他類似系統(tǒng)基礎上優(yōu)化而來，避免與當地其他規(guī)范相沖突 接口設計說明書 目標是簡介清晰表達各子系統(tǒng)之間的相關性 應用開發(fā)設計說明書（可無） 由于平臺開發(fā)人員最專業(yè)不熟悉，可根據情況完成一部分應用開發(fā)設計文件 系統(tǒng)功能點狀態(tài)清單 此清單文件，讓項目 管理人員清晰的了解當前系統(tǒng)的狀態(tài)和目前所有組態(tài)工作的進展情況 項目組態(tài)規(guī)范 此文件為下一階段組態(tài)工作的重要輸入文件，應根據下面章節(jié)（文件內容要求）中說明詳細描述 . 文件內容要求 . 用戶需求說明書 用戶需求分析 是 在系統(tǒng)設計、開發(fā) 工作進行之前 中對用戶需求所作的調查與分析，是系統(tǒng)設計、系統(tǒng)完善和系統(tǒng)維護的依據 。概要設計解決軟件系統(tǒng)的模塊劃分和模塊的層次機構以及數據庫設計；詳細設計解決每個模塊的控制流程，內部算法和數據結構的設計。 應嚴格按照類表和類設計文件 建立 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 22 頁 共 38 頁 . 類命名規(guī)范 . 類名應保持在 4 個字母以內 . 類名應能大致表示所屬類的意義 . 類名顯示名不能留空，應根據類表填寫其真實意思 . 類屬性命名規(guī)則 . 類屬性宜采用 2 個英文單詞表示 . 類屬性顯示名不應留空，并應能表示其意思 . 類屬性名稱的首個英 文字母應以小寫子字母開頭，后面的單詞的首字母應大寫 . 類命令命名規(guī)則 . 命令宜采用 2 個英文單詞表示 . 命令顯示名不應留空，并應能表示其意思 . 命令名稱的首個英文字母應以小寫子字母開頭，后面的單詞的首字母應大寫 . 命令應在類編輯器中填寫清晰的使用方法，方便其他人使用 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 23 頁 共 38 頁 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 24 頁 共 38 頁 . 其他行為：參考“類命名規(guī)則” . IO 組態(tài)規(guī)范 . 應熟讀 IO 組態(tài)工具使用手冊 . 應熟讀本次組態(tài)相關驅動的使用手冊 . 應正確使用點表生成生成的 IO 組態(tài)標簽導入 IO 組態(tài) . 數據庫組態(tài)規(guī)范 . 應采用點表生成器生成的實例列表建立全局實例 . 全局實例 應避免手工錄入，如必須手工錄 入，應記錄成文，方便后人對應。一般函數粒度應控制在 100 以內，大于 100 行的函數必須在函數注釋中說明必要性。amp。 . 測試文檔應清晰明了，可以實施 . 測試環(huán)境要求 . 測試軟件宜采用新版本的軟件平臺 . 每次測試應記錄本次測試使用的軟件平臺版本 . 每次測試后的軟件版本（包括平臺、應用、工程）應進行備份 . 備份的軟件版本一般每個 10個版本左右進行刪除 . 測試時應采用相對干凈的操作系統(tǒng)環(huán)境 . 測試前應具備軟件記錄 . 本階段的測試應包括以下內容 ? 協(xié)議測試 ： 協(xié)議測試的目的是 驗證接口雙方通信的正確性，測試中主要關注初始化、消息格 式的正確性、集成 系統(tǒng)從設備、子系統(tǒng)讀取信息、集成系統(tǒng)向設備、子系統(tǒng)寫信息或命令 以及冗余機制。 ? 功能測試 ： 功能測試 用于驗證接口功能的正確實現，該測試應參照 詳細接口技術規(guī)格書中的功能接口部分 進行。 ? 點對點測試 ： 點對點測試 完成檢查 綜合監(jiān)控 系統(tǒng)計算機和所接入設備、子系統(tǒng)之間接口所有點的正確性，即所有狀態(tài)采集點和控制點 都可以正確地上傳下達。amp。amp。 . 模塊規(guī)范 . 模塊命名 任何需使用 VBA 完成功能的 MACSSCADA 圖形，應具有以下四個模塊 模塊名稱 模塊作用 a 全局變量定義及初始化 定義本圖形內的全局變量，并完成整個圖形初始化的操作 b 數據操作類函數 對數據部分進行操作的函數的集合，如：數據之間的快速查找、匹配等 c 人機界面類函數 對人機界面上的控件或圖元進行操作的函數的集合，如：對顯示樹型結構，顯示表格內容等 d 權限判定 對權限進行讀取獲得判定的函數的集合。 . 各相關評審人員應在評審前熟讀待評文檔 . 評審記錄應明確說明時間、地點、人物 . 評審記錄應具備明確的說明本次評審的文件 . 評審記錄應準確記錄本次評審發(fā)現的問題 . 評審記錄應明確記錄問題的解決人和跟蹤人 . 評審記錄應準確描述評審是否通過 . 評審記錄格式宜參考公司評審文檔 . 評審通過的的文檔應當堂進行審批和會簽 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 21 頁 共 38 頁 5. 工廠制造階段 規(guī)范 . 系統(tǒng)軟件組態(tài)規(guī)范 . 組態(tài)整體規(guī)范 . 組態(tài)前應熟讀整個平臺 軟件的使用說明書，并了解軟件大致架構?？蓞⒖家韵赂袷竭M行匯編： 1 概述 目的 參考文件 2 需求 出處 3 需求 說明 顯示 要求 細節(jié) 1 細節(jié) 2 控制 要求 細節(jié) 1 細節(jié) 2 4 直接 開發(fā)需求 函數開發(fā)要求 細節(jié) 1 細節(jié) 2 功能開發(fā)要求 細節(jié) 1 細節(jié) 2 5 未盡事宜 系統(tǒng)功能 1 系統(tǒng)功能 2 聯(lián)動功能 6 換乘站改造技術方案 等 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 12 頁 共 38 頁 . 系統(tǒng)設計說明書 系統(tǒng)設計是新系統(tǒng)的物理設計階段。 ? VBA：由微軟提供的一種可潛入應用程序中進行快速開發(fā)的一種宏語言。 [] 規(guī)范 ac9e0b360d02b745adb8567a68ca4dbc 第 I 頁 共 4 頁 [錯誤 !未找到引用源。 .................................................. 20 . 各相關評審人員應在評審前熟讀待評文檔 .................................... 20 . 評審記錄應明確說明時間、地點、人物 ....................................... 20 . 評審記錄應具備明確的說明本次評審的文件 ................................ 20 . 評審記錄應準確記錄本次評審發(fā)現的問題 .................................... 20 . 評審記錄應明確記錄問題的解決人和跟蹤人 ................................ 20 . 評審記錄應準確描述評審是否通過 .............................................. 20 . 評審記錄 格式宜參考公司評審文檔 .............................................. 20 . 評審通過的的文檔應當堂進行審批和會簽 .................................... 20 5. 工廠制造階段規(guī)范 ............................................................................................ 21 . 系統(tǒng)軟件組態(tài)規(guī)范 ..................................................................................... 21 . 組態(tài)整體規(guī)范 .............................................................................. 21 . 點表、類表模板 .......................................................................... 21 . 類編輯器組態(tài)規(guī)范 ....................................................................... 21 . IO 組態(tài)規(guī)范 ................................................................................ 24 系統(tǒng)設計部 錯誤 !未找到引用源。 用戶需求文件是用戶對系統(tǒng)的最直接的要求和輸入，書寫時應本著精準、通俗 、簡介 的 方式進行的記錄和編寫 。這個階段結束，要交付 概要設計說明書 和設計說明，也可以合并在一起，稱為設計說明書。 . 除外部變量名等特殊字段，其它字段應在模板中填寫 . 子實例的各種屬性應與點表中對應，不應自創(chuàng) . IO 標簽的填寫應使用點表生成器的相應功能生成后拷貝，而不應手工填寫 . 容器的建立應已少、精、夠用為標準建立 . 跟功能相關的實例建立應在功能狀態(tài)表清單中標識出來，以便更好記錄 工程技術部 ac9e0b360d02b745adb8567a68ca4dbc ac9e0b360d02b745adb8567a68ca4dbc 第 25 頁 共 38 頁 . 圖形組態(tài)規(guī)范 . 報警、日志