移动考勤系统需求.doc

.业务需求专项说明书移动考勤系统手机APP变更职场坐标获取方式需求文档编号：业务需求专项说明书V1.0 文档描述文档名称手机APP考勤需求专项说明书V1.0文档编号手机APP考勤需求专项说明书V1.0当前版本V1.0内容简介需求规格说明书-手机APP变更职场坐标获取方式需求文档变更日期版本说明作者审核目 录1背景目标61.1需求背景61.2需求目标62业务需求说明62.1业务期望62.2业务流程62.3业务规则63总体需求描述73.1需求树分解73.2多系统间功能流程描述84APP考勤改造描述84.1开始定位94.1.1菜单索引94.1.2实现功能94.1.3主界面原型94.1.4执行者104.1.5流程及规则说明104.1.6功能按钮说明104.1.7字段说明104.2获取坐标所在城市104.2.1菜单索引104.2.2实现功能114.2.3主界面原型114.2.4执行者114.2.5流程及规则说明114.2.6功能按钮说明114.2.7字段说明124.3获取城市全部职场124.3.1菜单索引124.3.2实现功能124.3.3主界面原型124.3.4执行者124.3.5流程及规则说明124.3.6功能按钮说明134.3.7字段说明134.4手动更改城市134.4.1菜单索引134.4.2实现功能134.4.3主界面原型134.4.4执行者144.4.5流程及规则说明144.4.6功能按钮说明144.4.7字段说明154.5手动更新职场坐标信息154.5.1菜单索引154.5.2实现功能154.5.3主界面原型154.5.4执行者164.5.5流程及规则说明164.5.6功能按钮说明164.5.7字段说明164.6考勤职场有效范围判定174.6.1菜单索引174.6.2实现功能174.6.3主界面原型174.6.4执行者184.6.5流程及规则说明184.6.6功能按钮说明184.6.7字段说明184.7显示职场及当前位置信息194.7.1菜单索引194.7.2实现功能194.7.3主界面原型194.7.4执行者194.7.5流程及规则说明204.7.6功能按钮说明204.7.7字段说明20附录20;.1 背景目标1.1 需求背景移动考勤功能已实现，在不改变现有打卡功能的前提下，增加了新的打卡途径，使打卡更加便捷。目前准备全国范围推广，全国共有大小4000多个职场，为了使移动考勤功能在保证系统稳定性的前提下得到更大范围的推广，针对手机APP考勤职场获取坐标的方式进行优化调整。1.2 需求目标通过本次调整，不会因为职场的增加，对手机APP端考勤性能造成影响，支持移动考勤面向全国范围的推广与普及。2 业务需求说明2.1 业务期望通过本次开发的功能，继续推广移动考勤的服务概念，目的使员工更加愿意使用移动考勤功能。2.2 业务流程通过现有的手机微信，在关注企业号、并通过移动考勤打卡后，可以通过新增的移动考勤统计推送功能实现个人按周（月）考勤数据的统计并推送到员工微信端企业号下的【移动社区】自动展示。2.3 业务规则1、 本次移动考勤推广需求范围，适用于全国所有机构。2、 系统内支持移动考勤的人员，与拟推广的机构保持一致。即面向某一机构推广，则该机构职场内的人员全部支持移动考勤，暂不考虑某一机构人员部分支持移动考勤的情况。 3、 系统推送支持的移动考勤职场，也与推广机构一致：即增加一个推广机构，则支持该机构全部职场移动考勤。不考虑某一机构部分职场支持移动考勤的情况。3 总体需求描述3.1 需求树分解本次修改涉及APP考勤定位、打卡、手动变更城市、手动更新职场信息等功能，对应需求树如下：3.2 多系统间功能流程描述其中，橘红色部分，为本次新增或调整功能节点。4 APP考勤改造描述4.1 开始定位4.1.1 菜单索引 移动考勤4.1.2 实现功能此项功能为前端功能。与系统APP端现有【开始定位】功能相比，有所不同：仅当员工初次登录时，通过点击【开始定位】，在原有功能的基础上，增加了员工当前所在位置坐标信息向后台传送的功能，供后台完成下一步的判断、处理。此后登录，系统自动记录前一次登录时的城市，无需传送员工当前所在位置坐标。4.1.3 主界面原型初次登录城市字段为空，点击开始定位后，根据员工当前位置，后台按照算法可返回城市并显示。如图，此功能对应页面 “开始定位”按钮，页面无变化。4.1.4 执行者 拥有APP移动考勤功能权限的员工。4.1.5 流程及规则说明 登录APP后，点击【开始定位】，获取员工当前所在位置的坐标信息。 将当前位置的坐标信息，传送给系统后台，作为系统后台得出员工所在城市的判断、处理条件。4.1.6 功能按钮说明 【开始定位】4.1.7 字段说明字段名类型是否必录说明员工当前位置坐标数值否非录入项，通过点击【开始定位】，系统自动获得。坐标为一条记录，包括经度、纬度两项取值。此字段为4.2方法的入参。4.2 获取坐标所在城市4.2.1 菜单索引 无4.2.2 实现功能 此项功能为后台功能，在前端传入坐标信息后，手机APP端后台，根据传入坐标，计算出距离最短的职场坐标，通过职场坐标基础信息表，获取该职场对应的城市。4.2.3 主界面原型无。4.2.4 执行者 手机APP移动考勤后台程序自动执行。4.2.5 流程及规则说明 根据传入坐标，计算出距离最短的职场坐标：可调用oracle的函数getDistance获取员工当前位置与职场间的距离，通过访问职场信息表可获取该职场对应的城市，此函数包括4个入参，即传入的员工当前位置的经、纬度，以及职场的经、纬度，直接得出两点间的距离。通过职场信息表获取职场所在城市、职场与当前位置距离的sql如下：selectt.officename,getDistance(t.latitude,t.longitude,39.907249,116.458636) *1000asdistancefromWEB_OFFICE torderbydistance; 视获取到的城市信息数量，判断下一步的操作：如果取到一个城市，调用4.3方法；如果取到大于一个城市（距离相等的情况），默认取第一个城市，调用4.3方法；如果未取到城市，直接返回给前台，不再调用4.3方法。4.2.6 功能按钮说明无。4.2.7 字段说明字段名类型是否必录说明员工当前位置所在城市字符串否输出项，通过计算、查表获得。合理取值：一条；0条或多条，均为异常情况。异常情况处理，参见流程及规则说明。4.3 获取城市全部职场4.3.1 菜单索引 无4.3.2 实现功能 此项功能为后台功能，通过4.2、4.4方法查询出的城市信息，查询出该城市所有职场的坐标，返回给前台。如果4.2方法查询无结果，则此方法不执行，直接返回空给前台。4.3.3 主界面原型无。4.3.4 执行者 手机APP移动考勤后台程序自动执行。4.3.5 流程及规则说明 通过4.2、4.4方法查询出的城市信息，查询出该城市所有职场的坐标，返回给前台。4.3.6 功能按钮说明无。4.3.7 字段说明字段名类型是否必录说明员工当前所在城市职场坐标数值否非录入项，系统自动获得。可能为多条。坐标包括经、纬度两项取值。4.4 手动更改城市4.4.1 菜单索引 无4.4.2 实现功能 通过前台新增的城市选择框，支持【开始定位】后，系统后台针对员工所在城市的展示；也支持员工手动选择所在城市。主要用于通过坐标定位获取城市信息出现偏差时，员工可自行手动选择所在城市，以便于完成所在城市职场坐标信息的更新。4.4.3 主界面原型界面示例：支持员工定位后所在城市的展示；也支持手动重新选择城市选项，为点击后弹出对话框，支持先选择省、再选择市，如图：4.4.4 执行者 拥有APP移动考勤功能权限的员工。4.4.5 流程及规则说明 员工点击【开始定位】后，APP移动考勤后台程序得到员工当前位置坐标后通过算法，自动获取员工所在城市，并传送到前台展示； 如果定位获取到的城市信息与实际有偏差，员工可以手动重新选择城市。更改城市时，先选择所在省、再选择所在市（地级市）。4.4.6 功能按钮说明无。4.4.7 字段说明字段名类型是否必录说明所在城市字符串是通过【开始定位】后台会返回城市，页面自动展示；如果自动展示城市有偏差，支持员工再次手动选择。4.5 手动更新职场坐标信息4.5.1 菜单索引 无4.5.2 实现功能 通过前台新增的【更新】按钮，支持移动考勤人员通过手动选择城市后，重新获取选定城市的移动考勤职场信息，连同当前位置，一并在地图上显示。4.5.3 主界面原型界面示例：按照显示的城市，获取城市对应的全部职场信息，并选取距离最近的一个，在地图上显示。4.5.4 执行者 拥有APP移动考勤功能权限的员工。4.5.5 流程及规则说明 移动考勤人员手动选择城市后，将变更后的城市传给后台； 调用后台4.3方法，按照重新选定城市获取该地区移动考勤职场坐标信息。4.5.6 功能按钮说明【更新】4.5.7 字段说明字段名类型是否必录说明当前位置坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。最近的职场坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。4.6 考勤职场有效范围判定4.6.1 菜单索引 无4.6.2 实现功能 此项功能为前台功能。通过后台返回的最近职场的坐标，与当前坐标计算出两点间的距离，判断员工当前位置，是否已经进入某一职场的考勤有效范围：如果已进入，则显示已进入考勤范围。4.6.3 主界面原型界面示例：前台展示没有变化；在判断比对时，比对的职场个数，较之前有所增加：目前对当前位置与当前城市所有职场进行比对。4.6.4 执行者 手机APP移动考勤程序自动执行。4.6.5 流程及规则说明 【开始定位】时，后台按照传入的当前位置的坐标，获取当前位置所在城市，按照城市检索出所有职场的坐标，并计算当前位置与城市下所有职场坐标间的距离，按照距离判断当前位置是否进入某一职场的有效考勤范围； 手动重新选择城市，点击【更新】，重新获取城市的职场坐标后，并计算当前位置与城市下所有职场坐标间的距离，按照距离判断当前位置是否进入某一职场的有效考勤范围。4.6.6 功能按钮说明无。4.6.7 字段说明字段名类型是否必录说明当前位置坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。最近的职场坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。4.7 显示职场及当前位置信息4.7.1 菜单索引 无4.7.2 实现功能 通过前台的地图显示功能，支持【开始定位】后的当前员工位置以及距离最近职场的展示；同时，也支持手动选择城市、点击【更新】，重新获取城市职场坐标后，当前位置与距离最近职场的展示。4.7.3 主界面原型界面示例：移动社区页面展示推送成功的当前统计周期内的打卡次数，考勤详情查询，通过微信、APP的考勤查询功能查看4.7.4 执行者 手机APP移动考勤程序自动执行。4.7.5 流程及规则