1、种植物联网云平台系统软件需求规格说明书文件编号：版本号： 软件需求规格说明书版本： 1.0日期： 2014-2-10xxxxxxx科技有限公司修订记录日期版次描述作者审核批准1.引言本文档说明构建系统的功能性需求，描述软件的硬件需求、软件需求、质量需求、等非功能性需求，确定该软件设计的限制和定义软件的其他有效性需求。本文档为概要设计和详细设计提供直接参考，同时也是用户手册和测试计划、测试用例的编写依据。1.1.文档目的保证种植物联网系统项目在受控状态下进行。在进行系统设计、编码前，对产品的目的、范围、特性、功能、性能、运行环境、内外部接口以及系统流程等做出完整、准确、清晰、具体的要求。1.2.
2、参考资料产品经理需求描述和历史项目积累。2.总体描述2.1.产品功能以云的方式以企业为集合将大量的传感器节点构成监控网络，通过各种传感器采集信息，以帮助使用者及时发现问题，并且准确地确定发生问题的位置，这样农业将逐渐地从以人力为中心、依赖于孤立机械的生产模式转向以信息和软件为中心的生产模式，从而大量使用各种自动化、智能化、远程控制的生产设备。2.2.用户类和特性广泛的农场或农业企业。基于广泛的物联网传感器设备和云端管理系统。2.3.运行环境软硬件资源级别详细配置获取方式说 明硬件平台关键服务器采购JDK关键版本:V1.6+开源软件MySQL关键版本:V 5.1开源软件2.4.需求一览表 云端用
3、户功能系统登录用户登录组织权限管理人员管理组织结构管理角色管理权限管理控制台气象信息地块基本信息地块基本信息面板地块基本信息更多页地块设备信息地块设备信息面板地块设备信息更多页实时数据功能实时数据查看面板更多节点箱数据查看一个采集箱所有采集数据即时查看功能同种采集数据即时查看功能设备控制模式切换设备操作功能方案配置环境异常预警列表环境异常预警列表环境异常预警更多页设备异常预警列表设备异常预警列表设备异常预警更多页数据异常预警列表数据异常预警列表数据异常预警更多页气象预警列表气象预警列表气象预警更多页农场地图视频查看视频查看所有视频查看页配置台农场地块管理地块位置设置预警策略配置预警标准值配置方
4、案设置设备配置系统设置后台服务天气信息获取服务按定时设备操作服务按参数操作设备服务展示中心分基地农场概要信息维护统计分析OAuth第三方帐户帐户登陆帐户绑定3. 功能需求3.1 系统登录用于给用户提供一个进入系统的入口。3.1.1 用户登录3.1.1.1功能说明 登陆是进入系统的一个入口。本地登陆：对于登陆系统的用户将以企业标识、账号和密码登录系统，系统根据登陆的用户账号获取用户的角色权限，根据权限进入到主界面，展现对应的功能。3.1.1.2 激励响应序列Actors 角色： 用户Trigger 触发条件：A、login.jsp 用户登陆界面。Preconditions 前置条件： Descr
5、iption 基本事件流描述A、1、输入企业标识、用户名、密码，单击提交按钮；2、系统验证用户合法性；3、获取用户权限和企业信息；4、转向系统主页面。B、 1、查询数据库，获得将要去向的系统的连接地址和账号密码； 2、调用需要跳转到的系统上的登陆接口验证账号合法性； 3、获得用户权限； 4、获得企业信息； 5、转向系统主界面。Extensions 备选事件流 如果对应可以公网访问的系统有验证码限制，则在用户名和密码之前做判断。End Condition 后置条件1、Success End Condition 成功后置条件：进入系统主界面，根据权限显示对应的菜单目录。2、Failed End C
6、ondition 失败后置条件：跳转回登陆界面，提示错误信息。Special Requirement 特殊需求无User Interface 用户界面3.2组织权限管理该模块用来管理系统用户，用户角色，角色的权限和组织架构的。该部分直接采用聚光bear平台提供的对应模块即可。3.2.1 人员管理3.2.1.1 功能说明该功能是提供给有管理员权限的用户管理系统用户的。可以在该模块中添加修改和删除用户。3.2.1.1激励响应序列Actors 角色： 有管理员权限的用户Trigger 触发条件：1、进入到人员管理界面2、A：点击添加按钮B：点击删除按钮C：点击需要修改用户行后面的修改按钮。Preco
7、nditions 前置条件： 用户已登录Description 基本事件流描述 A、添加用户：1、输入名称、电子邮箱、固定电话、移动电话、联系地址选择所属部门和所属岗位，点击“下一步”。2、选择账号分配方式，选择或者输入账号。点击下一步。3、勾选角色，点击保存。B、删除用户： 1、弹出“是否要删除这个用户”警告框，点击确定。 C、修改用户： 1、输入需要修改项目的内容，点击下一步； 2、修改账号信息，点击下一步； 3、修改角色，点击保存。Extensions 备选事件流End Condition 后置条件1、Success End Condition 成功后置条件：回到人员管理页面，展示操作成
8、功后数据。2、Failed End Condition 失败后置条件：弹出警告框，提示失败原因Special Requirement 特殊需求无User Interface 用户界面3.2.2 组织结构管理3.2.2.1功能说明该功能是提供给用户维护农场或企业的组织结构用的。3.2.2.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、点击组织管理，进入到组织管理界面。2、点击页面左侧框架内组织树上需要操作的节点。3、A：点击添加；B：点击删除；C：点击右侧框架中需要编辑的组织上的修改按钮。Preconditions 前置条件： 用户已登录。Description 基本事件
9、流描述 A：添加组织1、在左侧树中选择父节点，点击添加按钮；2、输入组织名称（必须）和组织描述，点击保存。B：删除组织1、点击左侧树中的父节点。2、勾选右侧列表中需要删除的组织。3、点击删除按钮。4、弹出确认窗口，点击确定。C：修改组织1、点击左侧树中父节点；2、点击右侧需要修改的组织上的修改按钮；3、在需要修改的项目里填写修改后的数据，点击保存。Extensions 备选事件流End Condition 后置条件1、Success End Condition 成功后置条件：返回到组织管理界面。2、Failed End Condition 失败后置条件：弹出失败窗口。Special Requi
10、rement 特殊需求 无User Interface 用户界面3.2.3 角色管理3.2.3.1功能说明该功能是提供给具有管理员权限的用户管理系统中用户角色的功能3.2.3.2 激励响应序列Actors 角色：有管理员权限的用户Trigger 触发条件：1、进入到人员管理界面2、A：点击添加按钮B：点击删除按钮C：点击需要修改用户行后面的修改按钮。Preconditions 前置条件： 用户已登录。Description 基本事件流描述 A、添加用户：1、输入角色名称，勾选是否默认，点击保存。B、删除角色： 1、弹出警告框，点击确定。 C、修改角色： 1、修改角色名称和是否默认，点击保存。E
11、xtensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：回到角色管理页面，展示操作成功后数据。2、Failed End Condition 失败后置条件：弹出警告框，提示失败原因Special Requirement 特殊需求无User Interface 用户界面3.2.4 权限管理3.2.4.1功能说明在聚光平台的基础上继续细化从模块访问到页面的操作的一系列权限。3.2.4.2 激励响应序列3.3控制台整合各种资源和信息集都合到一起显示，组成一个信息丰富的展示页面，用于给用户在大屏幕或者投影上显示，使得农场里所有信息
12、都能一目了然。这个页面也是系统的各个功能的快捷入口。包括了以下子功能：气象信息、地块基本信息、地块设备信息、实时数据功能、设备操作功能、种植历史查看、种植方案、环境异常预警列表、设备异常预警列表、数据异常预警列表、农场地图、3D大棚、外链系统、视频查看。具体页面参照如下的图（图3.3）。图3.33.3.1 农场地图3.3.1.1功能说明本功能能够以假3D的方式直观的查看农场全貌，可以自由的缩放，并能作为软件背景方式展现。用图标来标识农场中的各个地块，当鼠标移动到地块上方，地块以高亮或者区域变色的直观方式凸显出来。点击地块标识的时候，地块上能够显示地块的名称，同时间能够让即时采集数据、设备控制面
13、板切换到这个地块上来。3.3.1.2激励响应序列Actors 角色：用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 已登录Description 基本事件流描述1、用户进入控制台页面；2、系统载入农场地图；3、系统向数据库查询农场地块数据，返回给前台页面；4、前台页面根据地块的信息和坐标在地图上标出各个地块和范围。5、用户点击某个地块；6、对应地块高亮并显示轮廓；7、页面将即时采集数据、设备控制面板切换到这个地块上来。Extensions 备选事件流无End Condition 后置条件1、Success End Co
14、ndition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求无User Interface 用户界面图3.3.13.3.2 气象信息3.3.2.1功能说明这个功能用来显示基地所在地区当天和未来几天的天气情况。用直观的图片加文字的方式显示。3.3.2.2激励响应序列Actors 角色：用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 已登录Description 基本事件流描述1、用户进入控制台页面；2、系统向数据库查询当前天气数据，返回给前
15、台页面；3、前台页面根据后台传来的天气数据显示出相对应的画面。Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求无User Interface 用户界面图3.3.23.3.3 地块基本信息3.3.3.1功能说明本功能用于展示基地内所有地块的基本信息，包括地块名称、面积、大棚类型、所种植物、管理人员等。每页显示3个大棚的信息，以定时切换的方式每10秒钟切换一次。有进入查看全部大棚信息页面的超链接。3.3.
16、3.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 用户已登录Description 基本事件流描述1、用户进入控制台页面；2、系统向数据库查询基地所有地块数据，返回给前台页面；3、前台页面根据后台传来的数据显示出相对应的信息并定时切换。Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无U
17、ser Interface 用户界面图3.3.33.3.4 地块基本信息更多页3.3.4.1功能说明本功能用于展示基地内所有地块的基本信息，包括地块名称、面积、大棚类型、所种植物、管理人员等。每页显示4个大棚的信息，以定时切换的方式每10秒钟切换一次。有进入查看全部大棚信息页面的超链接。3.3.4.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 用户已登录Description 基本事件流描述1、用户进入控制台页面；2、系统向数据库查询基地所有地块数据，返回给前台页面；3、前台页面根
18、据后台传来的数据显示出相对应的信息并定时切换。Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interface 用户界面图3.3.43.3.5 地块设备信息3.3.5.1功能说明该功能以栈面板的方式所有大棚中的设备信息。点击地块列表中的任何一个，在地块的下方会出现对应地块上所有的设备统计信息。3.3.5.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界
19、面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 用户已登录Description 基本事件流描述1、用户进入控制台页面；2、系统向数据库查询基地所有地块和设备数据，返回给前台页面；3、前台页面根据后台传来的数据显示出地块列表；4、用户点击任意一个地块；5、页面上在点击的地块下面显示出设备统计信息。Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interfa
20、ce 用户界面图3.3.53.3.6 实时数据功能3.3.6.1功能说明本功能用于显示地图上选中地里节点箱的即时数据。如果没有选择一个地块，系统将选择一个默认地块上的节点箱。即时数据根据节点箱上采集器的类型和数量显示，采集的数据每5秒钟更新一次，并标明和前一次数据的差距。还提供进入更多采集信息页面的连接。3.3.6.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 用户已登录Description 基本事件流描述1、用户进入到控制台页面；2、后台向数据库查询被选中地块中节点箱信息，返回
21、给页面；3、后台接口根据前台的请求查询数据库，然后返回给前台。4、前台根据后台返回的参数条目，创建出采集信息条目。5、前台根据节点箱信息调用后台实时数据接口，获取实时采集数据。6、后台接口根据前台请求查询数据库，将结果返回给前台。7、页面将返回的数据填充到对应的页面元素中去。8、过5秒钟后，调转到步骤5。Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interface 用户界面图3.3
22、.63.3.7 模式切换功能3.3.7.1功能说明本功能向用户提供了3种设备的控制模式切换的功能：手动、定时、智能。 手动模式：用户根据自己的需要手动开启和关闭相应的设备； 定时模式：设备将根据事先设置好的定时方案在特定的时间段开启指定的设备； 智能模式：设备将根据生长模型设置的作物最佳生长环境范围结合当前采集点数据做综合判断来开启和关闭相应的设备。3.3.7.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 用户已登录Description 基本事件流描述1、用户进入统一展示页面；2
23、、用户点击地图界面中的一个地块；3、在界面中设备列表的左面出现模式切换按钮；4、点击其中一个模式的按钮；5、前台向后台发送切换模式指令；6、后台开启对应的服务控制设备。Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interface 用户界面 图3.3.73.3.8 设备操作功能3.3.8.1功能说明本功能向用户提供了可以操作在地图上选中地块里设备的界面。用户可以点击界面上对应设备就可
24、以控制设备的开关。界面提供翻页，如果页面展示不下所有的设备，可以点击向前或者向后箭头，对应的页面就可以滑动到界面中。3.3.8.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击目录中的控制台。Preconditions 前置条件： 用户已登录，当前模式为“手动模式”。Description 基本事件流描述1、用户进入统一展示页面；2、用户点击地图界面中的一个地块；3、设备操作页面根据点击的地块信息调用后台即时数据接口获取地块上的设备信息和设备状态；4、后台接口收到前台请求，查询数据库，后将数据传输回前台。5、前台根据返回的数据，将设备以列
25、表的形式展现在页面中；6、用户点击一个设备的开关按钮；7、前台调用后台接口，向后台发送操作命令。8、后台根据前台的操作命令，将操作发给接入服务器。9、接入服务器返回操作结果。10、后台将结果传给前台。11、前台根据结果改变界面上设备的状态。12、用户点击界面上的向前或向后按钮、13、页面将以滑动的方式将隐藏的设备显示出来。Extensions 备选事件流无End Condition 后置条件3、Success End Condition 成功后置条件：无4、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interface
26、 用户界面 图3.3.73.3.9 方案配置3.3.9.1功能说明本功能能够让用户配置设备控制的模式。模式可以有三种:手动控制,定时控制,环境控制.1.手动控制时,用户可以直接控制页面下方的各种设备.2.定时控制时,系统根据配置好的设备定时方案来操作各种设备.3.环境控制时,系统可以根据传感器采集来的数据和事先设置好的环境区间来执行对应的设备.3.3.9.2激励响应序列Actors 角色： 用户Trigger 触发条件：1、用户从登陆界面登入到系统。2、点击控制台中的“方案”按钮。Preconditions 前置条件： 用户已登录Description 基本事件流描述1、用户进入控制台页面；2
27、、用户选择了地图上的一个地块;3、用户点击控制台界面中的“方案”按钮；4、系统获取数据库事先配置好的定时方案和环境方案,并显示配置界面.5、用户选择方案模式(手动,定时,环境),选择对应的定时方案和环境方案,点击”确定”;6、系统将页面信息保存到数据库中. Extensions 备选事件流无End Condition 后置条件1、Success End Condition 成功后置条件：无2、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interface 用户界面3.3.10 视频查看3.3.10.1功能说明本功能能够
28、让用户查看当前选中地块上的视频实时图像。3.3.10.2激励响应序列Actors 角色： 用户Trigger 触发条件：3、用户从登陆界面登入到系统。4、点击控制台中的“视频”按钮。Preconditions 前置条件： 用户已登录Description 基本事件流描述7、用户进入控制台页面；8、用户点击控制台界面中的“视频”按钮；9、前台向后台请求摄像头信息；10、后台返回摄像头信息；11、页面加载视频插件；12、视频插件调用视频服务器，获取实时图像数据；13、视频插件将图像显示到页面上。Extensions 备选事件流无End Condition 后置条件3、Success End Con
29、dition 成功后置条件：无4、Failed End Condition 失败后置条件：无Special Requirement 特殊需求 无User Interface 用户界面 图3.3.103.3.11 环境异常预警3.3.11.1功能说明本功能向用户提示农场所有地块上节点箱传感器所采集的数据超出正常范围的情况。让用户能够尽早的获得环境异常的信息，并尽快着手处理这些问题。 本功能以列表方式展现，列表显示最新的6条数据，最新的预警会出现在列表的最上面，最后一条淡出。如果需要查看全部的环境预警，可以进入到更多页面。3.3.11.2激励响应序列Actors 角色： 用户Trigger 触发条件：
