五子棋需求文檔

1、五子棋goBang項(xiàng)目需求分析報(bào)告作者：陳平、雷小梅、唐莉、鄧悅、程強(qiáng)日期：2016-3-12審批：日期：狀態(tài)修訂人修改日期版本備注五子棋2016-3-121.01. 概述1.1系統(tǒng)目標(biāo)  1. 實(shí)現(xiàn)一個(gè)簡(jiǎn)單的可供兩人娛樂的五子棋的游戲程序，包括如下兩個(gè)方面 :可選擇好友發(fā)起挑戰(zhàn)，執(zhí)黑或執(zhí)白開始游戲。  2.在游戲界面，有開始、重置和退出按鈕。率先完成五個(gè)棋子橫、豎或斜相連的玩家獲得勝利。在游戲未決出勝者階段，點(diǎn)退出方會(huì)被自動(dòng)判負(fù)。1.2系統(tǒng)設(shè)計(jì)思路  根據(jù)以上設(shè)想，可得出基本思路如下：即設(shè)計(jì)一個(gè)1515的圍棋棋盤，由兩玩家交替進(jìn)行落

2、子對(duì)戰(zhàn)，并完成以下功能模塊： 1. 可選擇落子的先后順序， 即選擇執(zhí)黑或執(zhí)白開始游戲。2. 可重置棋盤進(jìn)行新一輪游戲。重新開始時(shí)的再選擇。 3. 中途允許退出，但規(guī)定退出者判為負(fù)。某一方為五子連珠時(shí)判斷為勝方并禁止繼續(xù)落子。1.3產(chǎn)品架構(gòu) 1.3.1客戶端 客戶端：提供登錄、主窗體及下棋等界面及對(duì)應(yīng)的業(yè)務(wù)處理，向服務(wù)器發(fā)送相應(yīng)的服務(wù)請(qǐng)求，并接受相應(yīng)的處理結(jié)果?？蛻舳酥回?fù)責(zé)連接服務(wù)器，并發(fā)出相應(yīng)的服務(wù)請(qǐng)求，具體的處理交給服務(wù)器，而客戶端只接收服務(wù)器處理的結(jié)果并顯示給用戶。1.3.2 服務(wù)器 服務(wù)器：監(jiān)控登錄信息及在線用戶信息，接收客戶端的服務(wù)請(qǐng)求，并做相應(yīng)的處理，然

3、后將處理結(jié)果發(fā)送給客戶端。服務(wù)器負(fù)責(zé)處理核心的業(yè)務(wù)處理，并負(fù)責(zé)連接數(shù)據(jù)庫(kù)，保存和讀取數(shù)據(jù)。2.功能需求2.1客戶端：2.1.1用戶登錄模塊名稱 用戶登錄模塊模塊編號(hào)Use Case01業(yè)務(wù)概述用戶輸入賬號(hào)密碼后向服務(wù)器驗(yàn)證是否正確，正確則登陸，錯(cuò)誤則重新登錄參與角色普通用戶流程圖輸入數(shù)據(jù)用戶名 String userName密碼 String password輸出結(jié)果驗(yàn)證成功彈出主界面，否則回到重新登錄界面2.1.2用戶注冊(cè)模塊名稱用戶注冊(cè)模塊編號(hào)Use Case02業(yè)務(wù)概述用戶輸入注冊(cè)信息后提交給服務(wù)器，服務(wù)器返回結(jié)果參與角色普通用戶流程圖輸入數(shù)據(jù)用戶添加的注冊(cè)信息：賬號(hào),密碼，簽名,性別,

4、生日，個(gè)性簽名(賬號(hào)密碼 不能為空)處理1、用戶在登錄界面點(diǎn)擊注冊(cè)，進(jìn)入注冊(cè)界面2、用戶在注冊(cè)界面按要求填寫注冊(cè)信息3、點(diǎn)擊注冊(cè)向服務(wù)器發(fā)送信息 4、服務(wù)器回復(fù)注冊(cè)結(jié)果5、如果注冊(cè)成功進(jìn)入用戶登陸界面，否則彈出服務(wù)器回復(fù)的提示，提示用戶修改輸出數(shù)據(jù)顯示注冊(cè)結(jié)果2.1.3查看好友信息模塊名稱用戶模塊 查看好友信息模塊編號(hào)UseCase03業(yè)務(wù)概述提交要查看用戶的賬號(hào)，服務(wù)器返回資料參與角色普通用戶流程圖選定好友查看好友信息服務(wù)器接收用戶指定命令向用戶返回結(jié)果輸入數(shù)據(jù)1、好友列表右擊用戶頭像，彈出右鍵菜單，點(diǎn)擊查看好友信息2、彈出一個(gè)dialog，向服務(wù)器請(qǐng)求用戶信息 Util.formatQue

5、ryUserInfo(userId)3 服務(wù)器返回賬號(hào),密碼,昵稱,簽名,性別,生日,電話,郵箱,所在地= Util.parseUserInfo(msg)顯示用戶的信息處理向服務(wù)器發(fā)送 msg = Util.formatQueryUserInfo (userId)接收返回結(jié)果 UserInfoBean = Util.parseUserInfo(msg)輸出數(shù)據(jù)UserInfoBean2.1.4修改用戶信息，修改密碼模塊名稱用戶模塊 修改用戶信息，修改密碼模塊編號(hào)Use Case03業(yè)務(wù)概述用戶提交新資料給服務(wù)器，服務(wù)器返回結(jié)果參與角色普通用戶流程圖點(diǎn)擊設(shè)置，選擇修改信息按鈕 用戶根據(jù)提示進(jìn)行修

6、改點(diǎn)擊確認(rèn)修改按鈕信息傳入服務(wù)器修改成功輸入數(shù)據(jù)用戶基本資料(密碼,昵稱,簽名,性別,生日,電話,郵箱,個(gè)性簽名) 1、tree上右擊主界面頭像，彈出一個(gè)dialog2、從userInfoBean 里提取用戶信息，密碼3、用戶修改信息后（新密碼兩個(gè)框）4、如果用戶修改了密碼，則驗(yàn)證 舊密碼是否正確，兩次新密碼是否相同，是則提交服務(wù)器 Util.formatUpdateUserInfo(賬號(hào),密碼,性別,生日,電話,個(gè)性簽名)（沒填寫就填一個(gè)”null”）否則提示用戶錯(cuò)誤，沒有修改密碼則直接提交。5、服務(wù)器回復(fù)msg 6 、顯示提交結(jié)果處理資料封裝成USerInfoBean 由Util.form

7、atUpdateUserInfo（UserInfoBean）返回String將此String發(fā)送給服務(wù)器接收服務(wù)器返回 String 處理成 TipsBean = Util.parseTipsInfo(str)輸出結(jié)果TipsBean2.1.5發(fā)起挑戰(zhàn)模塊名稱用戶模塊 發(fā)起挑戰(zhàn)進(jìn)入游戲界面模塊編號(hào)useCase05業(yè)務(wù)概述向在線好友發(fā)起挑戰(zhàn)，好友同意便可進(jìn)入游戲參與角色普通用戶流程圖選定右擊好友發(fā)起挑戰(zhàn)好友是否接受其挑戰(zhàn) 接受 拒絕顯示提示信息轉(zhuǎn)入游戲界面輸入數(shù)據(jù)好友用戶名處理1. 好友列表中鼠標(biāo)右擊好友，彈出右鍵菜單，點(diǎn)擊發(fā)起挑戰(zhàn)2. 彈出一個(gè)信息提示窗口，顯示等待好友回應(yīng)中.3. 服務(wù)器返

8、回，若好友接受其挑戰(zhàn)，則進(jìn)入游戲界面，若好友不同意，則顯示該好友拒絕了請(qǐng)求.輸出數(shù)據(jù)消息（服務(wù)器udp端口）2.1.6游戲設(shè)置模塊名稱用戶模塊 - 游戲設(shè)置模塊編號(hào)useCase06業(yè)務(wù)概述在游戲界面，點(diǎn)擊游戲設(shè)置，即可調(diào)節(jié)音量參與角色普通用戶流程圖點(diǎn)擊游戲設(shè)置彈出游戲設(shè)置界面音量關(guān)閉音量增大（減?。┹斎霐?shù)據(jù)無(wú)處理數(shù)據(jù)當(dāng)點(diǎn)擊游戲設(shè)置時(shí)，彈出音量設(shè)置的dialog，可直接調(diào)成靜音，也可以用漸進(jìn)式的方法進(jìn)行調(diào)解。當(dāng)拖動(dòng)音量滑動(dòng)條時(shí)，調(diào)用方法輸出要素音量減小或音樂關(guān)閉2.1.7悔棋模塊名稱用戶模塊 - 悔棋模塊編號(hào)UserCase07業(yè)務(wù)概述在游戲界面，對(duì)決期間下好一步棋后五秒之內(nèi)，點(diǎn)擊悔棋，可向?qū)?/p>

9、方發(fā)送悔棋請(qǐng)求參與角色普通用戶輸入數(shù)據(jù)無(wú)處理數(shù)據(jù)當(dāng)點(diǎn)擊悔棋后將請(qǐng)求發(fā)送給好友后，根據(jù)好友回應(yīng)進(jìn)行下一步操作輸出要素悔棋或不變2.2服務(wù)開啟/ 關(guān)閉2.2服務(wù)器2.2.1處理用戶登錄模塊名稱-處理用戶登錄模塊編號(hào)Manager Case01業(yè)務(wù)概述從客戶端接收用戶發(fā)來(lái)的登錄信息命令，根據(jù)接收的賬號(hào)和密碼在服務(wù)器內(nèi)部存儲(chǔ)的數(shù)據(jù)中判斷用戶提供的賬號(hào)和密碼是否正確，返回登錄結(jié)果，正確就返回在線用戶列表和該用戶信息。參與角色管理員事件流流程圖數(shù)據(jù)輸入用戶（賬號(hào)，密碼）數(shù)據(jù)處理1、接收客戶端發(fā)送的賬號(hào)，密碼2、向數(shù)據(jù)庫(kù)緩存到內(nèi)存的里查詢 賬號(hào)/密碼 是否存在并正確3、正確則返回客戶端用戶信息和在線用戶列表

10、4、錯(cuò)誤返回客戶端提示界面：賬號(hào)或密碼錯(cuò)誤數(shù)據(jù)輸出登錄后返回結(jié)果2.2.2處理用戶注冊(cè)模塊名稱用戶注冊(cè)模塊編號(hào)Manager Case02業(yè)務(wù)概述用戶向服務(wù)器發(fā)出注冊(cè)請(qǐng)求，服務(wù)器收到請(qǐng)求將數(shù)據(jù)存儲(chǔ)在數(shù)據(jù)庫(kù)后，再將返回結(jié)果給用戶。參與角色管理員流程圖輸入數(shù)據(jù)用戶注冊(cè)信息處理數(shù)據(jù)1、接收客服端 （賬號(hào),密碼,昵稱,簽名,性別,生日，個(gè)性簽名）2、如果賬號(hào)已存在則返回提示：此賬號(hào)已存在！3、如果賬號(hào)可用則將用戶注冊(cè)信息傳入數(shù)據(jù)操作服務(wù)，向數(shù)據(jù)庫(kù)用戶表添加此用戶并返回注冊(cè)成功的結(jié)果給客戶端。輸出數(shù)據(jù)注冊(cè)結(jié)果2.2.3處理查看用戶信息模塊名稱處理查詢用戶信息模塊編號(hào)Manager Case03業(yè)務(wù)概述根

11、據(jù)用戶命令，服務(wù)器向數(shù)據(jù)庫(kù)查找相應(yīng)要查找的信息，將結(jié)果返回給客戶端。參與角色管理員流程圖輸入數(shù)據(jù)賬號(hào)處理數(shù)據(jù)1、接收客戶端要查找的賬號(hào)2、調(diào)用查詢處理服務(wù)返回該賬號(hào)的用戶信息給客服端(賬號(hào),密碼,昵稱,簽名,性別,生日)輸出數(shù)據(jù)賬號(hào)相應(yīng)的用戶信息2.2.6處理 接收 保存 發(fā)送用戶消息模塊名稱處理 接收 保存 發(fā)送用戶消息模塊編號(hào)Manager Case00業(yè)務(wù)概述參與角色管理員事件流接收發(fā)送消息 Udp端口接收消息后 “ userid/ip/port內(nèi)容 “， 存在message 對(duì)象內(nèi) 1 message 加上信息 寫入數(shù)據(jù)庫(kù)聊天記錄表 2轉(zhuǎn)發(fā)給 ip/port輸入數(shù)據(jù)MessageBea

12、n (Util.parseMessage(str)處理數(shù)據(jù)messageBean里得到目標(biāo)Id如果這用戶在線則則發(fā)送至 messageBean.getTagUserSA() 設(shè)置messageBean為未讀調(diào)用數(shù)據(jù)操作服務(wù) 存儲(chǔ)此消息輸出數(shù)據(jù)無(wú)2.2.7顯示處理操作模塊名稱顯示處理操作模塊編號(hào)Manager Case04業(yè)務(wù)概述通過面板顯示各種處理和操作。參與角色管理員事件流將服務(wù)器處理的各種操作顯示在面板內(nèi)如 用戶登陸，發(fā)送消息，修改信息，查詢信息2.2.8管理用戶模塊模塊名稱管理用戶模塊模塊編號(hào)Manager Case00業(yè)務(wù)概述管理員操作各種用戶的信息。參與角色管理員事件流點(diǎn)擊查詢所有用

13、戶，彈出對(duì)話框顯示所以用戶信息，對(duì)話框上可以修改用戶信息，增刪用戶，查看用戶聊天記錄3. 數(shù)據(jù)庫(kù)3.1 用戶表(賬號(hào)、昵稱、密碼、性別、生日、電話、所在地、對(duì)戰(zhàn)記錄)3.2 聊天記錄表(信息編號(hào)、發(fā)送者賬號(hào)、接受者賬號(hào)、發(fā)送時(shí)間、信息編號(hào))3.3 聊天內(nèi)容（信息編號(hào)、內(nèi)容、是否已讀)3.4 登錄信息表(登錄編號(hào)、登錄IP、端口號(hào)、登錄時(shí)間、是否在線、帳號(hào))3.5 對(duì)戰(zhàn)記錄表（用戶ID、結(jié)果、時(shí)間）3.其它非功能需求在這里列舉出所有非功能需求，主要包括可靠性、安全性、可維護(hù)性、可擴(kuò)展性、可測(cè)試性等。3.1性能需求本系統(tǒng)在正常的網(wǎng)絡(luò)環(huán)境下，應(yīng)能夠保證系統(tǒng)的及時(shí)響應(yīng)：涉及數(shù)據(jù)量大的部分模塊相應(yīng)功能響應(yīng)時(shí)間不超過30秒。其他模塊相應(yīng)功能響應(yīng)時(shí)間不超過15秒。3.2安全措施需求本系統(tǒng)的系統(tǒng)架構(gòu)，以及權(quán)限機(jī)制可以保證系統(tǒng)的安全性。首先，從系統(tǒng)架構(gòu)看，本系統(tǒng)可采用CS模型，從而使服務(wù)器數(shù)據(jù)源與客戶端分離，保證了數(shù)據(jù)的物理獨(dú)立性；其次，本系統(tǒng)的用戶授權(quán)機(jī)制通過角色的定義管理實(shí)現(xiàn)，通過定義某些角色能進(jìn)行的操作權(quán)限，和定義用戶擁有的角色，限定用戶的操作權(quán)限，實(shí)現(xiàn)對(duì)用戶的授權(quán)。3.3軟件質(zhì)量屬性 主要質(zhì)量屬性詳細(xì)要求正確性對(duì)用戶輸入的正常數(shù)據(jù)能夠得到正確的結(jié)果健壯性對(duì)各種輸入，系統(tǒng)能夠做