智能园区报修系统——易修 需求说明书 软件概要设计 详细设计说明书

                                                                            智能园区报修系统

                                                                                             ——易修

                                                                                     队长：马腾俊075

                                                                                                      队员：隋锦涛072、于俊杰070、杜世伟071

                                                                                                                张倩055、于艳红053

1.引言

1.1编写目的

 本文档为随心听文档的需求分析报告，说明了编写本软件硬件软件以及经费需求。

1.2项目背景

  在高校或企业园区，一些公共设施经常需要定期维护和及时维修，不及时的检修和一些突发的事件可能会造成重大财产损害，甚至危害学生和职工的生命。如何防治和及时应对，成为大家普遍关心的热点问题。

  根据调查，比如在高校校园内，经常有公共设施:房屋、电力设备等的损坏，经常会出现教学用品：电脑、投影仪等的故障，这些情况大大影响了正常的教学工作活动，及时地维修和定期的维护是必要的。如果仅仅等待维修人员的定期检修和维护，一些重大突发的事故隐患可能无法及时发现。作为学校的学生和教工群体，他们在教学生活中，一旦发现这类事情，往往会发现不知如何处理，不知道向那个部门汇报的情况，传统的电话报修系统也不便于管理和维护，无法支持先进的数据分析和智能故障预测。并且，对于目前高校，如果大量增加维修保养人员无疑会增加额外的支出。

  如果能及时的迅速的让每一个学校的学生和教工都能把自己遇到的或者发现的相关问题汇报给对应的管理部门，往往可以更快得应对和维修，避免一些可能的重大损失。

1.3范围

说明：

    1.软件名称：“易修”报修系统；

    2.该软件用于企业或学校的设备报修及修理；

    3.目的：

      a.实现软件各功能要求；

      b.准确实现个人信息管理、设备报修等任务。

1.4定义

    Web Service：一种新的Web应用程序分支，是自包含、自描述、模块化 ，可以发布、定位、通过Web调用部署以后，其他Web Service应用程序可以发现并调用它部署的服务。

    Java：一种面向对象的编程语言

    MYSQL ：一个关系数据库管理系统

    JSP : 全名为Java Server Pages，中文名叫java服务器页面，其根本是一个简化的Servlet设计，它是由Sun Microsystems公司倡导、许多公司参与一起建立的一种动态网页技术标准。

    MVC ：全名是Model View Controller，是模型(model)－视图(view)－控制器(controller)的缩写，一种软件设计典范，用一种业务逻辑、数据、界面显示分离的方法组织代码，将业务逻辑聚集到一个部件里面，在改进和个性化定制界面及用户交互的同时，不需要重新编写业务逻辑。

1.5参考资料

    （1）《软件工程导论》 （第 5 版） 张海藩著 清华大学出版社

    （2）《软件工程》 （第 2 版） 夏小娜著 科学出版社

    （3）《Tomcat与JSP Web开发技术详解》孙卫琴、李洪成 

电子工业出版社

    （4）《JSP数据库编程实例》孙一林、彭波  清华大学出版社

    （5）《巧学活用HTML》LEE ANNE PHILLIPS  电子工业出版社

需求说明书

2.项目概述

 2.1 产品描述

本软件Wwb端可用于用户注册自己的信息、管理自己的信息，用户能够提交报修设备，技术人员可以根据用户提交的损坏设备进行修理。管理员能够对用户以及技术人员的信息和设备信息进行统一的管理。Android端与Web端的功能基本一致，是一款及时有效地报修软件。

 2.2 产品功能 E-R图

 2.3 数据流图

 2.4 用户特点

操作人员需会熟练使用手机软件，能够看懂操作说明文档。其中管理人员享有最高优先权。

 2.5 假设和依据

    本系统开发日期是2015年7月至9月。

    本系统需要的高级语言Java、JSP。

    本系统可以根据不同的操作者进行密码管理，杜绝了无权用户进行恶意登录进行破坏，给单位造成无畏的损失。

    本系统设计是在Android4.2操作系统及以上的手持设备上运行的，操作实用、简易、方便、直观。

2.具体需求

3.1功能需求

3.1.1功能需求1

对于最小系统用户，在报修端设置报修类型和具体内容描述（可以选择拍照，语音等），来启动或者关闭报修系统。当报修系统获得新的用户报修内容后根据维修类型分配给相应的负责人，在负责人的移动后勤管理端出现任务及描述。

 对于最大系统用户，在一个或多个报修端开启以后，报修端之间可以协同工作，例如同类型的问题可以实现批量处理，数据存储中心会及时将数据分析报告提交给后勤主管。

3.1.2功能需求2

服务端应用：基于Web应用，用以对报修端进行管理和配置，并对数据存储的报修数据进行分析生成统计报表。

智能管理移动端：控制报修任务状态。

智能用户移动段：提交报修任务，控制自提交任务状态。

3.2外部接口需求

3.2.1用户接口

    Android4.2操作系统及以上的手持设备；

    各种PC端浏览器

3.2.2硬件接口

    搭载Android操作系统的手机终端和Window7操作系统系统的服务器。

3.2.3软件接口

    Android操作系统

3.2.4通信接口

    HTTP协议

3.3  性能需求

    操作灵活，响应时间短，可移植性。

3.4  设计约束

    设计约束受其他标准、硬件限制等方面的影响。

3.4.1其他标准的约束

    梦行者研发小组完全按照刘国玲老师的标准开发，包括软件和文档规模。

    财务处理基本无。

3.4.2硬件的限制

    手机存储空间不低于20M，Windows存储空间不低于30M。

3.5属性

3.5.1可用性

    本软件是完全由Java和JSP程序设计语言开发的，它可以进行单步追踪。一旦出现错误就可以通过单步追踪进行查找处理。

3.5.2安全性

    本软件安全可靠，设置专门的登陆验证方法。

3.5.3可维护性

    可查看管理文档对本软件进行维护管理。

3.5.4可转移\转换性

    搭载Android4.2及以上操作系统的移动设备都可以安装并运行本软件。 

4.附录

    本系统可以根据不同的操作者进行密码管理，杜绝了无权用户进行恶意登录进行破坏，给用户造成无畏的损失。

软件概要设计

2.总体设计

 2.1 需求规定

（1）环境需求：

  良好的开发环境和运行环境。

（2）功能需求：

  对于最小系统用户，在报修端设置报修类型和具体内容描述（可以选择拍照，语音等），来启动或者关闭报修系统。当报修系统获得新的用户报修内容后根据维修类型分配给相应的负责人，在负责人的移动后勤管理端出现任务及描述。

（3）用户界面需求

  运用界面的艺术设计原则使界面友好美观，精致独特，提高用户使用规范。

（4）性能需求

  可靠性，可用性，可维护性，可移植性。  

 2.2 运行环境

     Web端是各种类型的浏览器

     客户端是Android4.2操作系统及以上的手持设备。

 2.3 HIPO图

3.接口设计

3.1 用户接口

    本系统采用GUI设计，无需输入命令。

3.2 外部接口

采用javabean以及servlet技术，提供由JSP页面调用的接口。

1.验证用户名、密码

2.验证用户身份

3.提交信息

4.获取信息

3.3内部接口

    1.数据库类接口：用于接收从数据库获取的数据;

    2.页面转换 当前屏的实例，下一屏的类，结束即按返回键不返回此屏

4.运行设计

4.1运行模块组合

 具体软件的运行模块组合为程序多窗口的运行环境，各模块在软件运行过程中能较好的交换信息并处理数据。

4.2运行控制

软件运行时有友好接口，基本能够实现用户的数据处理要求。

4.3运行时间

大量用户同时进行数据的提交会使响应时间延长，同时考虑到现阶段的3G网络的网速，响应时间会相对延长，但仍可在用户接受的等待时间内将页面呈现给用户。

5.系统数据结构设计

5.1逻辑结构设计要点

由于所给出的数据结构和数据项太多，目前无法一一确定相应的访问方式。存取单位已经标明。目前暂无相应策略，待编码阶段对设计考虑和保密条件进行补充。

5.2数据结构与程序的关系

    数据结构以类的方式进行组织。

   访问数据结构中的数据项通过相应对象Get，Set等方法，进行良好的数据封装和保护。

6.系统出错处理设计

6.1出错信息

6.2补救措施

    1.配置文件错误：删除配置文件，即可恢复到应用程序2的初始配置状态。

    2.数据库错误：程序具有数据库备份功能，只要已经备份了数据库，即可将数据库还原，挽回部分损失。

6.3系统维护设计 

    本软件使用过程中如出现一下情况中的其中一条，我们将会给与维护和补救，或采取后备技术，来适当调整源程序。

    1.死循环，不能退出。

    2.某个文件丢失。

    3.模拟器一闪而过。

详细设计说明书

2.程序1（应用程序框架）设计说明

 2.1 程序流程

    应用程序框架：用户整合各个功能模块，使各功能模块协调工作，此框架直接以GUI形式展现给用户，供用户使用各功能模块。此模块为主程序模块。各模块脱离此模块整个程序将失去完整性。 

 2.2 功能

     客户端可以实现用户、技术人员及管理员登录，登陆后用户可以更改个人信息并且提交设备报修信息，以及查看设备信息，技术人员可以修改自己的信息并且可以看到损坏设备，可以选择设备进行修理，实时显示设备状态，管理员可以对用户信息以及设备信息进行修改更正。

 2.3 性能

    灵活准确，响应时间短

 2.4 输入项

   客户端输入项：注册客户信息时需输入客户相关信息，如：帐号，密码 。用户名信息只能用英文或数字组成,密码只能用英文或数字组成，如gch22888 416628。，登陆成功后，可以修改自己的个人信息并且使用设备报修功能，随时查看设备状况。

2.5 输出项

客户端的输出包括从服务器上获取到的个人信息以及设备信息。

2.6 Web端相关设计

使用JDBC查询数据库，相关类如下：

2.6.1用户验证

类名：LogonDao

作用：共有三个验证方法，分别为管理员验证、用户验证和技术人员验证

2.6.2用户信息数据库操作类

类名：SinfoDao

作用：用来对数据库中用户表进行操作的类

2.6.3技术人员信息数据库操作类

类名：TinfoDao

作用：用来对数据库中技术人员表进行操作的类

2.6.4设备信息数据库操作类

类名：DamageDao

作用：用来对数据库中设备表进行操作的类

2.6.4安全性验证

作用：防止直接用网址进行登录，定时对登录的对象进行验证

2.7 服务器端

2.7.1 概述

    Tomcat 服务器是一个免费的开放源代码的Web 应用服务器，属于轻量级应用服务器，在中小型系统和并发访问用户不是很多的场合下被普遍使用，是开发和调试JSP 程序的首选。对于一个初学者来说，可以这样认为，当在一台机器上配置好Apache 服务器，可利用它响应HTML（标准通用标记语言下的一个应用）页面的访问请求。

2.7.2 作用

    当配置正确时，Apache 为HTML页面服务，而Tomcat 实际上运行JSP 页面和Servlet。另外，Tomcat和IIS等Web服务器一样，具有处理HTML页面的功能，另外它还是一个Servlet和JSP容器，独立的Servlet容器是Tomcat的默认模式。

2.8 客户端应用程序（Android端）

2.8.1 主界面

作用：程序开始地方，命题与团队信息介绍：AppStart类        

2.8.2 各功能模块

2.9 数据库字段设计

数据表描述

（1） adminlogon表：管理员登陆信息

（2） slogon表：用户登录信息

（3）tlogon表：技术人员登录信息                     

（4）sinfo表：用户信息

（5）tinfo表：技术人员信息

（6）damage表：损坏设备信息

（7）on_damage表;正在修理设备信息

（8）end_damage表：修理完成设备信息

2.10 接口

    用户接口：Android4.2操作系统及以上的手持设备；各种PC端浏览器

    硬件接口：搭载Android操作系统的手机终端和Window7操作系统系统的服务器。

    软件接口：Android操作系统

    通信接口：HTTP协议

2.11 存储分配

    手机存储空间不低于20M，Windows存储空间不低于30M。

2.12 测试计划

    详见《测试计划以及测试报告》

2.13 尚未解决的问题

    预期语音报修的功能未能实现