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咽動考勤程序自動執