小组成员：

1.王海汀

2.夏国平

3.张慧鑫

4.李鑫

5.黄伟

1 概述

1.1 开发背景

程序建立的目标是为了解决现实中的问题。在寝室断电之后，伴随而来还有网络不畅。这时对于睡眠质量不太好的同学就需要有消遣娱乐的活动。因此我们决定开发 这样一款单机操作的黑白棋游戏。

1.2 开发目标

兼容性强，提示清楚，操作简单，具有存档记忆动能，最重要的是可以玩家与玩家进行对战。

1.3 参考资料

《构建执法》（第二版）邹欣，人民邮电出版社；

《代码大全》，（第二版）史蒂夫.麦克康奈尔，电子工业出版社；

《统一软件开发过程》Ivar.Jacobson，机械工程出版社。

2 需求分析

2.1 需求陈述

该软件是一款集竞技性和娱乐性的一款棋牌类软件，它可以解决同学在寝室断网的情况下的无聊问题，可以进行两人对战，同学之间相互切磋，增进感情。

2.2 操作用例

首先是打开软件，按S开始游戏，按Q退出游戏：

接下来选择S开始的界面，进入游戏，WASD对应上左下右移动，O确定落子，H是提示当前玩家可以落子的位置：

如图是点开H之后的帮助界面，黑子先行：

接下来走了几步：

2.3 功能分析划分

（1）游戏菜单：

很简单的风格，不需要什么复杂的设计

（2）游戏界面：

也是通过简单的绘图工具实现的，将操作的事项列在棋盘的下方，方便使用者查看。

（3）输赢判断：

通过if判断，根据对方棋子的位置来判断自己是否可以落子，如果可以的话就选择可以落子的地方落子，如果不能的话，那么游戏结束。

2.3.1 系统登录

2.3.2 用户管理

2.5 运行环境

Windows操作系统，32位或64位均可

3.1 系统建模

3.1.1 层次方框图

3.1.2  ER图（实体-联系图）

3.2 接口设计

    主函数里包含游戏欢迎界面函数，棋盘界面初始化函数，游戏主体函数和退出函数。

3.2.1 内部接口设计

    初始化游戏界面函数里包含输出棋子函数，有效区域函数；

    控制棋子函数里包含显示棋子函数；

3.2.2 登录界面设计

4 详细设计

4.1 程序流程图

5 实现

5.1 编码

5.1.1 代码约定

1.文件编码

2.自定义的函数名使用通俗易懂，一目了然的名字

4.列长限制

注意花括号的匹配，在代码换行时至少缩进4个空格，缩进不要用tab，增强代码的可读性和美观性。

5.注释

  注释应少而精，注释的作用只是用来增加重要的代码段的易读性，代码的关键处应有注释。

6.变量声明

  每次只声明一个变量，不要使用组合声明，需要变量时再声明，不推荐同时初始化很多变量，尽快将刚刚定义的变量进行初始化。

7.命名约定

变量命名应遵循见名知意、简洁的原则，变量名的定义要以可读性为主，不要使用模糊的变量名进行定义，同时也要避免中英文混用。

8.成员顺序

 每个自定义函数功能模块应该以某种逻辑排序成员，使维护者能解释这种排序逻辑。

9.慎用条件判断。

10.使用大括号合理的囊括循环的代码段。

11.减少代码嵌套

 减少嵌套方法：（1）合并初始条件条件相同的代码段；（2）利用return以省略else；

5.1.2 代码编写原则

1）关键代码段的注释应该尽可能全面

  对于方法的注释应该包含详细的入参和结果说明，自定义函数的注释应该包含该函数本身功能的说明。

2）多次使用的相同变量最好归纳成常量

  多处使用的相同值的变量应该尽量归纳为一个常量，定义为define类型，直接引用，并且可以方便日后的维护。

3）尽量少的在循环中执行方法调用

   尽量在循环中少做一些可避免的方法调用，这样可以节省方法栈的创建。

4）常量的定义可以放到define中。以减少常量定义和引用的次数。

5）包装类和基本类型的选择

 如果使用基本数据类型来做局部变量类型，尽量使用基本数据类型，因为基本类型的变量是存放在栈中的，包装类的变量是在堆中，栈的操作速度比对快很多。

6）尽早的将不再使用的变量引用赋给NULL

7）如果引用指针的话最后要关闭指针，并对开辟的内存空间进行有效回收，避免内存资源空间的浪费。

8）函数最短原则（不多于30行）。

9）变量单一职能原则（一个变量只允许承担一个责任,针对每次赋值，创建一个独立。对应的临时变量。循环变量和收集结果变量除外）。

10）函数单一职能原则（一个函数只做一件事情）。

11）for循环单一职能原则（一个for循环只做一件事情，也许你会考虑效率问题，但不经过测试是没有发言权的）。

11）三次原则（事不过三，三则重构）。

5.2 测试要点

5.2.1 登录测试要点

 登陆测试要点：
使用合理的测试用例对游戏界面的测试
1.按照游戏界面的提示，按下正确的按键。观察程序的反应。
2.输入默认值，空白，空格；
3.如果程序只允许输入字母，尝试输入数字；反之，尝试输入字母，
4.强制输入程序不允许的输入数据，观察程序是否能正确处理非法数据。

5.2.2 主界面测试要点

主界面测试要点：对用户按键输入进行测试。当用户按下错误的按键，系统如何处理。

测试方法：

1）当用户按下指定的按键是观察系统给出的相应。如单击“帮助”，正确执行操作；再按一下帮助按钮，退出帮助界面。
2）对非法的输入或操作给出相应的相应，并应该给出足够的提示说明。
3）对可能造成数据无法恢复的操作必须给出明确的错误提示信息，给用户重新输入的机会。

5.3 测试结果和总结

对该项目的测试结果符合预期的结果，对各个模块都做了相应的单元测试，谈谈个人的一些看法，比如没有需求，也没什么任何文档或有少量不全文档；提交测试大部分是到了开发的后期，有一部分项目是快验收了，才提交测试。面对这些问题，一直未有很好的解决办法，个人觉得测试人员针对这些问题可以自己作一些调整，以期更好的完成测试工作：

　　1. 得到了测试任务之后，可以首先看看功能能不能正常走通。

　　1.1 根据功能做一个基本的测试计划，并写明一些测试方法（如边界值，等价类划分等）。

　　1.2 开始要实施测试了，一边写测试用例一边执行，如果可以最好是先写测试用例然后执行，没时间写完整的用例时，可以列出需求点，针对每个需求点来进行测试。同时在执行中及时的补充与修改。

　　1.3 要整理出对功能中不明白之处，可以找相关人员可以是PM沟通。这个一定要坚持直到得到明确的答案。

　　2. 学会换位思考，将自己当成客户

这是非常重要的，在测试中你可能会发现，有时无法关注测试的重点。

有时客户表达的需求，开发团队所理解的需求，以及客户真正使用时的需求，有重大的差别；

　　这时你需要静下心来，将自己当成客户，如果是客户他会怎样来操作这个界面，同时他要这个功能主要想完成哪些工作，如何才能更方面操作、更快捷的完成工作。

　　如此反复几次，这种思考方式将对你的测试非常有利。

　　3. 非常复杂的业务逻辑，学会庖丁解牛，分解成一小块一小块测试

　　有时你会碰到这种情况，所要测试的模块业务逻辑非常复杂。

　　这时你该怎么办呢？工作中一定要静下心来，认真仔细的分析这个业务。由简单到复杂，简单的测试通过后才能做复杂的测试。而不是一开始就做复杂的测试。

　　4. 求助开发或PM

　　还有一种业务或者服务，因为作为测试开发经验较少，所以有时程序的方法还不是很了解。也不知道这个功能是怎么实现的，但为了做到百分百的测试。你需要求助于开发或PM，让他们来帮你完成测试方法或用例。

　　同时更重要的是，你要以他们给的方法和用例为基石，设计出更好的更全面的测试方法。

程序源代码：https://coding.net/u/xiaotangyuan/p/heibaiqi/git/blob/master/%E9%BB%91%E7%99%BD%E6%A3%8B.cpp

6 维护

6.1：维护方法

1,建立明确的软件质量目标和优先级。事先开始做组织工作，需要建立维护机构，申明提出维护申请报告的过程及评价过程：为每一个维护申请规定的处理步骤；还必须建立维护活动的登记制度以及规定评价和评审的标准。

2,使用提高软件质量的技术和工具。模块化和结构化程序设计，使用结构化程序设计技术，提高现有系统的可维护性。

3,进行明确的质量保证审查。

4,验收检查是一个特殊的检查点的检查，是交付使用前的最后一次检查，是软件投入运行之前保证可维护性的最后机会。

5,周期性的维护审查，并选择可维护的程序设计语言。

6,好的文档是建立可维护性的基本条件。程序应当成为其自身的文档，即在程序中插入注释，以提高程序的可理解性，并缩进，空行等明显的视觉组织来突出程序的控制结构。

6.2：维护文档

6.3：功能拓展方法

在软件维护过后，有些用户可能需要更多的软件功能，这样我们就需要给软件功能进行拓展。为了估计软件维护的有效程度，确定软件产品的质量，并且确定在维护中的实际开销，所以在功能拓展中应当做好事先的拓展方案以及市场调查。

iptables的扩展实现：为了实现新的扩展，需要在iptables的源代码目录下的extensions目录添加新的功能的代码。iptables的扩展功能框架非常清晰，只需要按照iptables的match结构xtables_match和target结构xtables_target的定义，实现相应的功能即可。

C语言程序员也可以实现这样的功能！可以实现一下tc的扩展。以tc中的filer为例。tc的用户可以实现自己的filter的实现，并将生成的so库文件放置在tc的库目录下。那么该扩展功能既可以被tc支持。同时，还要编写一个tc的内核实现模块并加载。这样，新的功能，在不重新编译tc，不重启机器的情况下，就得以支持了。也是我们期待的结构。

团队作业二