考勤模块概要设计

开发设计

参考同类应用

• 口袋助理

相关设计

基础功能

• 位置定位

防作弊

• 记录设备的mac地址
• 禁用模拟位置定位
• 记录Wi-Fi的SSID

考勤技术需求

建立考勤通讯服务

1. 支持主从数据交互

定位相关（封装高德）

1. 进入应用先调起低精度定位。若有WiFi使用定位，没有WiFi使用数据流量定位。
2. 之后GPS调起高精度定位。
3. 若有GPS定位结果，则以GPS为准。若无，则以网络定位结果为准。若都没有结果，则判定为定位失败。
4. 进入签卡页面，以实时定位结果为准，循环定位次数MAX=3（MAX可配置）。
5. 如果签卡获取定位信息成功，则向外发送定位结果。
6. 如果签卡获取定位信息失败，则向外发送定位失败的原因。
7. 如果是定位中，则向外发送定位的进度（当前第几次定位）。
   

   定位结果需要包含：经纬度、详细地址、精度、定位类型、第N次定位、设备的MAC地址、WIFI的SSID、模拟定位的开关状态

业务相关

1. 旧的跟定位相关的业务
2. 新的业务跟产品沟通

原型开发需求

暂时不需要地图预览相关功能。
参考“口袋助理”（大家申请时，填写公司帐号 862390），完成Demo版的开发。

SDK（android、ios）

• 支持地理位置定位，内置高德SDK
• 建立服务，支持数据传输交互

API

• 申请打卡
  
  • 支持打标签，用于区分是日常签卡还是活动打卡
  • 进入签卡位置500米（可配）范围内认为签卡有效
    

接口名：pd.attendance.apply
接口含义：申请打卡
参数：
   0. sessionId     //登录后的sessionId凭据【必填】
   1. id            //【必填】
   2. longitude     //经度【必填】
   3. latitude      //纬度【必填】
   4. range         //打卡有效范围【选填，默认500米】
   5. device_mac    //打卡设备mac地址【选填】
   6. type          //gps/wifi/traffic【必填】
   7. date          //打卡时间：yyyy-MM-dd HH:mm【必填】
   8. address       //详细地址信息【选填】
返回：
    { "model":"true" } // 无论打卡的点、时间是否正确，都可以执行打卡事件

• 获取打卡任务
  
  • 上班打卡
  • 下班打卡
  • 活动打卡

接口名：pd.attendance.daily
接口含义：获取每日签卡任务
参数：
    0. sessionId        //登录后的sessionId凭据【必填】
返回：
    * 若未设置考勤，则显示“您未有考勤任务”。
    {
        "daily": {
            "desc": "您未有考勤任务",
            "data": []
        }
    }
    * 若已设置考勤，但是检查还未到生效日期，则显示“已开启考勤，于2016/11/14日开始生效。”
    {
        "daily": {
            "desc": "已开启考勤，于2016/11/14日开始生效",
            "data": []
        }
    }
    * 若已设置考勤，且已经在生效日期范围内，则显示正确的考勤任务数据。
    {
    "daily": {
        "desc": "每日考勤任务",
        "data": [
            {
                "id":99,
                "title": "上班",
                "date": "09:00",
                "status": "1",    // 超出打卡距离打卡
                "description": "已签到 08:50"
            },
            {
                "id":100,
                "title": "下班",
                "date": "18:00",
                "status": "0",    // 正常打卡
                "description": "签退"
            },
            {
                "id":101,
                "title": "加班签退",
                "date": "22:00",
                "status": "2",    // 提前签退
                "description": "已签退 21:50"
            }
        ]
    },
    "activity": {
        "desc": "幸福活动天天有，打折打到手抽筋",
        "data": [
            {
                "id":201,
                "title": "未来科技城·海创园相亲大会",
                "date": "09:00",
                "status": "0",
                "description": "签到"
            }
        ]
    }
}

• 判断打卡的状态？
  
  • 判断打卡是否超出距离范围
  • 判断打卡时间超出时间范围——迟到、早退
    

接口名：pd.attendance.status
接口含义：获取打卡状态
参数：
    0. sessionId        //登录后的sessionId凭据【必填】
    1. date             //打卡时间：yyyy-MM-dd HH:mm【必填】
    2. taskId           //打卡任务序号【必填】
    3. longitude        //经度【必填】
    4. latitude         //纬度【必填】
返回：
{
    "id":99,
    "distance": 300,// 实际距离
    "date": "2016年11月14日 14:20"// 实际打卡时间
    "status":0 // 0 正确的打卡状态（打卡距离在精度范围内、在时间之前打卡）
               // 1 超出打卡距离
               // 2 超出时间打卡
}

什么是打卡？

将 经纬度、时间，上传给服务器的过程叫做打卡。

校验打卡有效性？

将 打卡的经纬度、时间与既定的经纬度、时间比对的过程称为有效性验证。

打卡数据核验？

将 设备MAC地址、打卡方式、附近Wi-Fi的SSID列表上传给服务器，作为检验打卡有效性。

客户端限制打卡的情况？

没有网络时，不允许打卡。
有网络时，但是网络定位与GPS定位情况偏差很大时。
开启位置模拟选项。