移动考勤系统需求

1、&AR5安邦保险ANBANGINSURANCE业务需求专项说明书移动考勤系统手机APP变更职场坐标获取方式需求文档编号：业务需求专项说明书V1.0文档描述文档名称手机APM勤需求专项说明书V1.0文档编号手机APM勤需求专项说明书V1.0当前版本V1.0内容简介需求规格说明书-手机APP变更职场坐标获取方式需求文档变更日期版本说明作者审核1 背景目标51.1 需求背景51.2 需求目标52 业务需求说明52.1 业务期望52.2 业务流程52.3 业务规则53 总体需求描述53.1 需求树分解63.2 多系统间功能流程描述74 APP考勤改造描述74.1 开始定位74.1.1 菜单索引

2、74.1.2 实现功能84.1.3 主界面原型84.1.4 执行者84.1.5 流程及规则说明84.1.6 功能按钮说明94.1.7 字段说明94.2 获取坐标所在城市94.2.1 菜单索引94.2.2 实现功能94.2.3 主界面原型94.2.4 执行者94.2.5 流程及规则说明94.2.6 功能按钮说明104.2.7 字段说明104.3 获取城市全部职场104.3.1 菜单索引104.3.2 实现功能104.3.3 主界面原型104.3.4 执行者104.3.5 流程及规则说明104.3.6 功能按钮说明114.3.7 字段说明114.4 手动更改城市114.4.1 菜单索引114.4.

3、2 实现功能114.4.3 主界面原型114.4.4 执行者124.4.5 流程及规则说明124.4.6 功能按钮说明124.4.7 字段说明124.5 手动更新职场坐标信息134.5.1 菜单索引134.5.2 实现功能134.5.3 主界面原型134.5.4 执行者134.5.5 流程及规则说明134.5.6 功能按钮说明144.5.7 字段说明144.6 考勤职场有效范围判定144.6.1 菜单索引144.6.2 实现功能144.6.3 主界面原型144.6.4 执行者154.6.5 流程及规则说明154.6.6 功能按钮说明154.6.7 字段说明154.7 显示职场及当前位置信息16

4、4.7.1 菜单索引164.7.2 实现功能164.7.3 主界面原型164.7.4 执行者164.7.5 流程及规则说明174.7.6 功能按钮说明174.7.7 字段说明17附171 背景目标1.1 需求背景移动考勤功能已实现，在不改变现有打卡功能的前提下，增加了新的打卡途径，使打卡更加便捷。目前准备全国范围推广，全国共有大小4000多个职场，为了使移动考勤功能在保证系统稳定性的前提下得到更大范围的推广，针对手机APP#勤职场获取坐标的方式进行优化调整。1.2 需求目标通过本次调整，不会因为职场的增加，对手机APP端考勤性能造成影响，支持移动考勤面向全国范围的推广与普及。2 业务需求说明2

5、.1 业务期望通过本次开发的功能，继续推广移动考勤的服务概念，目的使员工更加愿意使用移动考勤功能。2.2 业务流程通过现有的手机微信，在关注企业号、并通过移动考勤打卡后，可以通过新增的移动考勤统计推送功能实现个人按周（月）考勤数据的统计并推送到员工微信端企业号下的【移动社区】自动展示。2.3 业务规则1、 本次移动考勤推广需求范围，适用于全国所有机构。2、 系统内支持移动考勤的人员，与拟推广的机构保持一致。即面向某一机构推广，则该机构职场内的人员全部支持移动考勤，暂不考虑某一机构人员部分支持移动考勤的情况。3、 系统推送支持的移动考勤职场，也与推广机构一致：即增加一个推广机构，则支持该机构全部

6、职场移动考勤。不考虑某一机构部分职场支持移动考勤的情况。3总体需求描述安邦云办公手动变更城市更新职场信息3.1 需求树分解本次修改涉及APP考勤定位、打卡、手动变更城市、手动更新职场信息等功能，对应需求树如下:打卡开始定位3.2多系统间功能流程描述手机AP咕勤流程图前台后台开始登录开始定位，获取坐标传给后台通过坐标：按获取城市的算法得到所在城市通过城市获取全部职场城市正确？A否更新通过城市重新获取职场坐标信息比对当前坐标与全部职场坐标的距离显示最近职场及当前位置打卡记录考勤信息成功?结束其中，橘红色部分，为本次新增或调整功能节点4APP考勤改造描述4.1开始定位4.1.1菜单索引移动考勤4.1

7、.2实现功能此项功能为前端功能。与系统APP端现有【开始定位】功能相比，有所不同：仅当员工初次登录时，通过点击【开始定位】，在原有功能的基础上，增加了员工当前所在位置坐标信息向后台传送的功能，供后台完成下一步的判断、处理。此后登录，系统自动记录前一次登录时的城市，无需传送员工当前所在位置坐标。4.1.3主界面原型初次登录城市字段为空，点击开始定位后，根据员工当前位置，后台按照算法可返回城市并显示。开始定位如图，此功能对应页面“开始定位”按钮，页面无变化4.1.4执行者拥有AP色动考勤功能权限的员工。4.1.5流程及规则说明?登录APP后，点击【开始定位】，获取员工当前所在位置的坐标信息。?将当

8、前位置的坐标信息，传送给系统后台，作为系统后台得出员工所在城市的判断、处理条件4.1.6功能按钮说明【开始定位】4.1.7字段说明字段名是否必录说明员工当前位置坐标数值否非录入项，通过点击【开始定位】，系统自动获得。坐标为一条记录，包括经度、纬度两项取值。此字段为4.2方法的入参。4.2 获取坐标所在城市4.2.1 菜单索引无4.2.2 实现功能此项功能为后台功能，在前端传入坐标信息后，手机APP端后台，根据传入坐标，计算出距离最短的职场坐标，通过职场坐标基础信息表，获取该职场对应的城市。4.2.3 主界面原型无。4.2.4 执行者手机AP咽动考勤后台程序自动执行。4.2.5 流程及规则说明?

9、根据传入坐标，计算出距离最短的职场坐标：可调用oracle的函数getDistance获取员工当前位置与职场间的距离，通过访问职场信息表可获取该职场对应的城市，此函数包括4个入参，即传入的员工当前位置的经、纬度，以及职场的经、纬度，直接得出两点间的距离。通过职场信息表获取职场所在城市、职场与当前位置距离的sql如下：selectt.officename,getDistance(t.latitude,t.longitude,39.907249,116.458636)*1000asdistancefromWEB_OFFICEtorderbydistance;?视获取到的城市信息数量，判断下一步的操

10、作：如果取到一个城市，调用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

11、主界面原型无。4.3.4 执行者手机AP咽动考勤后台程序自动执行。4.3.5 流程及规则说明?通过4.2、4.4方法查询出的城市信息，查询出该城市所有职场的坐标，返回给前台4.3.6 功能按钮说明无。4.3.7 字段说明字段名是否必录说明员工当前所在城市职场坐标数值否非录入项，系统自动获得。可能为多条。坐标包括经、纬度两项取值。4.4 手动更改城市4.4.1 菜单索引无4.4.2 实现功能通过前台新增的城市选择框，支持【开始定位】后，系统后台针对员工所在城市的展示；也支持员工手动选择所在城市。主要用于通过坐标定位获取城市信息出现偏差时，员工可自行手动选择所在城市，以便于完成所在城市职场坐标信息

12、的更新。4.4.3 主界面原型界面示例：St支持员工定位后所在城市的展示；也支持手动重新选择城市选项，为点击后弹出对话框，支持先选择省、再选择市，如图:|后HIRSh3确定I4.4.4 执行者拥有AP色动考勤功能权限的员工。4.4.5 流程及规则说明?员工点击【开始定位】后，APP移动考勤后台程序得到员工当前位置坐标后通过算法，自动获取员工所在城市，并传送到前台展示；?如果定位获取到的城市信息与实际有偏差，员工可以手动重新选择城市。更改城市时，先选择所在省、再选择所在市（地级市）。4.4.6 功能按钮说明无。4.4.7 字段说明字段名是否必录说明所在城巾字符串是通过【开始定位】后台会返回城巾，

13、贝闻自动展示；如果自动展小城巾启偏差，支持员工再次手动选择。4.5 手动更新职场坐标信息4.5.1 菜单索引无4.5.2 实现功能通过前台新增的【更新】按钮，支持移动考勤人员通过手动选择城市后，重新获取选定城市的移动考勤职场信息，连同当前位置，一并在地图上显示。4.5.3 主界面原型界面示例：国建去行按照显示的城市，获取城市对应的全部职场信息，并选取距离最近的一个，在地图上显示。此打卡职堵为未知开始定位4.5.4 执行者拥有AP色动考勤功能权限的员工。4.5.5 流程及规则说明?移动考勤人员手动选择城市后，将变更后的城市传给后台;?调用后台4.3方法，按照重新选定城市获取该地区移动考勤职场坐标

14、信息?4.5.6 功能按钮说明【更新】4.5.7 字段说明字段名是否必录说明当前位置坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。最近的职场坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。4.6 考勤职场有效范围判定4.6.1 菜单索引无4.6.2 实现功能此项功能为前台功能。通过后台返回的最近职场的坐标，与当前坐标计算出两点间的距离，判断员工当前位置，是否已经进入某一职场的考勤有效范围：如果已进入，则显示已进入考勤范围。4.6.3 主界面原型界面示例：修量17:51nt前台展示没有变化；在判断比对时，比对的职场个数，较之前有所增加：目前对当前位置与当前城市所有职场进

15、行比对。4.6.4 执行者手机AP咽动考勤程序自动执行4.6.5 流程及规则说明?【开始定位】时，后台按照传入的当前位置的坐标，获取当前位置所在城市，按照城市检索出所有职场的坐标，并计算当前位置与城市下所有职场坐标间的距离，按照距离判断当前位置是否进入某一职场的有效考勤范围；?手动重新选择城市，点击【更新】，重新获取城市的职场坐标后，并计算当前位置与城市下所有职场坐标间的距离，按照距离判断当前位置是否进入某一职场的有效考勤范围。4.6.6 功能按钮说明无。4.6.7 字段说明字段名是否必录说明当前位置坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。最近的职场坐标数值否非录入项，系统自动获得。坐标包括经、纬度两项取值。4.7 显示职场及当前位置信息4.7.1 菜单索引无4.7.2 实现功能通过前台的地图显示功能，支持【开始定位】后的当前员工位置以及距离最近职场的展示；同时，也支持手动选择城市、点击【更新】，重新获取城市职场坐标后，当前位置与距离最近职场的展示。4.7.3 主界面原型FZti扈一跪界面示例：移动社区页面展示推送成功的当前统计周期内的打卡次数，考勤详情查询，通过微信、APP的考勤查询功能查看未知开始定位4.7.4 执行者手机AP咽动考勤程序自动执