Appearance
功能详解
本文档详细说明各功能模块的使用方法和注意事项。
工作日志
创建日志
日志APP的工作日志功能支持详细记录每天的工作情况。
操作步骤
选择项目
- 点击"选择项目"按钮
- 从项目列表中选择,或点击"创建新项目"
- 项目信息包括名称、类型、GPS位置
记录工作时段
- 设置开始时间和结束时间
- 系统自动计算总工时
填写工时信息
- 有效工时: 实际工作的小时数
- 非有效工时: 因特殊情况产生的非工作时间
添加已完成任务
- 从任务池选择今天完成的任务
- 支持多选
- 任务会自动标记为COMPLETED状态
设置明日计划
- 选择明天要做的任务
- 任务保存在日志的planned_task_ids字段
上传工作照片
- 点击"添加照片"
- 支持拍照或从相册选择
- 照片自动上传到阿里云OSS
- 支持多张照片
选择协作人员
- 内部协作人员: 从企业通讯录选择
- 外部协作人员: 手动输入
记录误餐情况
- 勾选早餐、午餐、晚餐误餐情况
- 用于餐补统计
设置可见性
- 选择可以查看此日志的人员
- 可见人员列表保存在visibility字段
- 只有可见人员且关注了你的用户会收到通知
提交日志
- 点击"提交"按钮
- 系统自动通知关注你的用户(在可见范围内)
注意事项
- 项目、工时、已完成任务为必填项
- 照片大小会自动压缩优化
- 提交后可以继续编辑
- 草稿状态可暂存,稍后继续编辑
查看日志
我发出的日志
查看自己创建的所有日志:
- 按日期降序排列
- 显示项目名称、工时、照片数量
- 点击日志卡片查看详情
我收到的日志
查看别人发给你的日志:
- 只显示visibility列表中包含你的日志
- 显示发送人姓名
- 支持按发送人筛选
筛选功能
按日期筛选:
- 点击筛选按钮
- 选择开始日期和结束日期
- 查看指定时间范围的日志
按项目筛选:
- 选择项目
- 查看该项目的所有日志
按人员筛选:
- 在"我收到的日志"中按发送人筛选
- 在"我发出的日志"中按接收人筛选
任务池管理
创建任务
任务池是统一的任务管理系统,所有任务集中管理。
基本信息
任务标题
- 简短描述任务名称
- 便于快速识别
任务内容
- 详细描述任务具体要做什么
- 支持多行文本
任务属性
- 优先级: 高/中/低
- 预估工时: 预计需要多少小时
- 时间段: 上午/下午/晚上/全天
项目和人员
关联项目
- 选择任务所属项目
- 可选项,不关联项目的任务也可创建
分配任务
- 普通用户: 创建的任务assigned_to为自己
- 管理员: 可以将任务分配给其他用户
协作人员
- 内部协作人员: 企业内部参与的同事
- 外部协作人员: 外部单位参与的人员
时间设置
截止时间 (due_time)
- 设置任务必须完成的时间
- 过期未完成会自动标记为EXPIRED
计划开始时间 (planned_start_time)
- 设置未来某个时间开始的任务
- 设置后任务状态变为PLANNED
- 到达时间自动转为TODO
任务状态管理
任务有5种状态,可以手动或自动流转:
TODO (待办)
- 新创建的任务默认状态
- 今天或近期要做的任务
- 在任务列表顶部显示
转换为:
- IN_PROGRESS: 开始执行时手动切换
- COMPLETED: 完成时勾选复选框
- PLANNED: 设置未来开始时间
PLANNED (计划任务)
- 设置了planned_start_time的任务
- 未来某个时间要开始的任务
- 单独的计划任务列表显示
转换为:
- TODO: 到达计划时间自动转换或手动转换
- IN_PROGRESS: 提前开始时手动切换
- COMPLETED: 直接完成
IN_PROGRESS (进行中)
- 正在执行的任务
- 点击"开始"按钮切换
转换为:
- COMPLETED: 完成时切换
- TODO: 暂停时切换回去
COMPLETED (已完成)
- 完成的任务
- 记录actual_completion_time
- 可以关联到工作日志
操作:
- 查看: 在已完成列表查看
- 恢复: 取消勾选可恢复为TODO
- 关联日志: 日志创建时选择已完成任务
EXPIRED (已过期)
- 超过due_time未完成
- 系统自动标记
- 需要手动处理
处理方式:
- 修改截止时间继续执行
- 标记为完成
- 删除任务
管理员任务功能
管理员有额外的任务管理权限:
任务分配
- 点击"分配任务"
- 选择分配给的用户
- 填写任务信息
- 被分配用户会收到通知
查看所有任务
- 查看所有用户的任务
- 按用户、状态、项目筛选
- 查看任务详情和进度
批量操作
- 将PLANNED任务批量转为TODO
- 清理历史过期任务
- 批量修改任务状态
项目管理
创建项目
基本信息填写
项目名称
- 清晰简洁的项目名称
- 便于识别和搜索
项目类型
- 从预设类型中选择
- 类型由管理员在后台配置
项目描述
- 详细说明项目内容
- 包括目标、范围等信息
GPS定位
项目支持4种地址来源:
钉钉定位 (dingtalk)
- 使用钉钉的定位数据
- 自动获取位置和地址
手动输入 (manual)
- 手动输入详细地址
- 系统通过百度地图API获取GPS坐标
GPS定位 (gps_location)
- 使用设备GPS获取精确位置
- 适合在项目现场时使用
基站定位 (cell_location)
- 使用移动网络基站定位
- GPS信号弱时的备选方案
地图选点
- 点击"地图选择位置"
- 在地图上拖动标记到准确位置
- 或搜索地址定位
- 确认后自动填充GPS坐标和地址
项目查询与管理
项目列表
筛选条件:
- 项目类型
- 项目状态 (进行中/已完成/已归档)
- 负责人
- 关键词搜索
排序方式:
- 按创建时间
- 按更新时间
- 按项目名称
项目详情
点击项目查看:
- 完整的项目信息
- GPS位置在地图上标注
- 关联的工作日志
- 关联的任务
- 项目成员
项目星标
- 点击星标图标收藏项目
- 快速访问常用项目
- 星标项目在列表顶部显示
项目类型管理
管理员功能,配置项目分类:
- 进入管理员面板
- 选择"项目类型管理"
- 添加新类型: 输入类型名称和描述
- 编辑类型: 修改已有类型
- 删除类型: 删除不需要的类型(需要先转移使用该类型的项目)
项目节点
为项目设置里程碑节点:
添加节点
- 选择节点类型
- 设置预计完成时间
- 填写节点描述
完成节点
- 标记节点为已完成
- 记录实际完成时间
- 发送通知给项目成员
节点类型
- 管理员预先配置
- 如: 立项、设计、施工、验收等
车辆与签到
上车记录
记录员工使用车辆的情况:
扫描车牌或手动输入
- 扫描车辆二维码
- 或手动输入车牌号
自动记录信息
- 上车时间
- GPS位置
- 上车地点
关联日志
- 上车记录可关联到当天日志
- 显示使用的车辆信息
GPS轨迹
通过E6系统获取车辆GPS数据:
查看轨迹
- 选择车辆和日期
- 查看当天完整行驶轨迹
- 地图上显示行驶路线
停靠点
- 自动识别车辆停靠地点
- 显示停靠时间段
- 匹配项目位置
里程统计
- 每日行驶里程
- 按项目分配里程
- 油耗成本预估
车辆管理
管理员功能:
添加车辆
- 车牌号
- 车辆类型
- GPS设备ID
- 绑定使用人
车辆列表
- 查看所有车辆
- 在线状态
- 使用情况
编辑/删除
- 修改车辆信息
- 更换GPS设备
- 删除报废车辆
上车记录查看
查看今日上车记录:
进入查看数据
- 点击底部导航"查看数据"
- 选择"上车记录"标签页
查看记录列表
- 显示今日所有上车记录
- 包含上车时间、车牌号、上车地点
- 时间格式:HH:mm(北京时间)
数据来源
- 基于用户手机号查询
- 自动同步E6系统数据
- 实时显示最新记录
基地管理
创建基地
管理员可以创建和管理多个基地:
进入基地管理
- 管理员面板 → 基地管理
- 查看现有基地列表
填写基本信息
- 基地编码: 唯一标识符
- 基地名称: 易于识别的名称
- 基地类型: 总部/分公司/仓库
- 详细地址: 完整的地址信息
- 联系电话: 基地联系方式
- 基地负责人: 从员工列表选择
- 所属部门: 选择部门
GPS定位设置
- GPS坐标: 使用地图选点或手动输入经纬度
- 检测范围: 设置签到检测半径(米)
- 用于判断用户是否在基地范围内
基地状态
- 启用: 正常使用的基地
- 停用: 暂时不使用的基地
基地-项目距离管理
系统自动计算和管理基地到项目的距离:
自动计算距离
计算方式
- 手动输入: 人工填写距离数据
- 地图API: 通过百度地图API计算道路距离
- GPS实际: 基于实际GPS轨迹计算
- E6 API: 通过E6车辆系统计算
计算内容
- 直线距离(公里)
- 道路距离(公里)
- 预估行驶时间(分钟)
- 预估油耗成本(元)
自动更新
- 项目GPS位置变更时自动重新计算
- 基地位置变更时批量更新相关项目距离
- 支持手动触发重新计算
查看距离信息
在项目详情中查看
- 显示最近基地
- 显示距离和预估时间
- 用于里程分配计算
在基地管理中查看
- 查看该基地到所有项目的距离
- 按距离排序
- 识别覆盖范围
基地定位判断
系统自动判断用户当前位置:
定位逻辑
- 获取用户当前GPS坐标
- 计算与所有基地的距离
- 如果在某基地检测范围内,标记为在基地
应用场景
- 签到考勤时判断是否在基地
- 工作日志中自动识别工作地点
- 统计分析基地内外工作时间
里程分配管理
项目里程分配
基于车辆GPS数据自动分配每日里程:
分配原理
数据来源
- 从E6系统获取车辆每日GPS轨迹
- 识别车辆停靠的项目位置
- 统计每个项目的停靠时长
权重计算
- 基地距离权重: 距离基地越远,分配权重越高
- 停靠时长权重: 停靠时间越长,分配权重越高
- 访问次数: 多次访问的项目增加权重
分配方式
- 距离基础分配: 根据基地距离和停靠时长智能分配
- 平均分配: 访问的所有项目平均分配里程
- 手动调整: 管理员可手动修改分配比例
查看里程分配
项目每日里程
- 查看某个项目每天分配的里程
- 显示访问车辆数量
- 显示主要出发基地
分配状态
- 待分配: 刚获取的GPS数据,未处理
- 已分配: 系统自动分配完成
- 已审核: 管理员审核通过
审核调整
- 管理员可查看自动分配结果
- 手动调整不合理的分配
- 审核通过后锁定数据
交通成本计算
基于里程自动计算交通成本:
成本计算
- 每个项目的累计里程
- 根据车辆油耗配置计算油耗成本
- 累计每个项目的交通费用
统计分析
- 项目访问频次
- 月度/年度交通成本
- 各基地到项目的总里程
报表导出
- 导出项目交通成本明细
- Excel格式,包含完整统计数据
餐补管理
餐补规则配置
管理员配置餐补标准:
进入配置
- 管理员面板 → 系统配置 → 餐补管理
设置餐补标准
- 早餐餐补: 输入早餐补贴金额(元)
- 午餐餐补: 输入午餐补贴金额(元)
- 晚餐餐补: 输入晚餐补贴金额(元)
规则状态
- 启用: 当前有效的餐补规则
- 禁用: 暂停使用的规则
多版本管理
- 支持创建多个版本的餐补规则
- 系统自动使用最新的启用规则
- 保留历史规则便于追溯
误餐记录
在工作日志中标记误餐:
填写日志时标记
- 勾选"早餐误餐"
- 勾选"午餐误餐"
- 勾选"晚餐误餐"
数据存储
- 以JSON格式存储在日志的meals字段
- 例:
自动计算
- 提交日志时自动计算餐补金额
- 存储在日志的meal_allowance字段
餐补统计
查看和导出餐补统计:
月度餐补查询
- 选择月份
- 查看该月所有误餐记录
- 显示餐补金额小计
餐补明细
- 日期
- 误餐类型(早/午/晚)
- 餐补金额
- 关联工作日志
导出报表
- Excel格式导出
- 包含完整的餐补明细和统计
地址服务
地址智能搜索
使用百度地图API搜索地址:
搜索入口
- 创建/编辑项目时
- 输入地址信息
搜索功能
- 关键词搜索: 输入地址关键词
- 联想建议: 实时显示匹配地址
- POI搜索: 搜索兴趣点(商场、学校等)
选择地址
- 从搜索结果中选择地址
- 自动填充完整地址
- 自动获取GPS坐标
地理编码
地址和GPS坐标相互转换:
地址转坐标
- 输入详细地址
- 调用百度地图API
- 返回GPS经纬度坐标
坐标转地址
- 提供GPS坐标
- 逆地理编码
- 返回详细地址信息
批量编码
- 支持批量地址转坐标
- 用于数据导入和批量处理
地图选点
在地图上直接选择位置:
打开地图
- 点击"地图选择位置"按钮
- 显示百度地图界面
选点操作
- 拖动地图标记到准确位置
- 或搜索地址后定位
- 查看周边POI
确认位置
- 确认后自动填充GPS坐标
- 自动填充详细地址
- 保存到项目或基地信息
APP版本管理
版本信息管理
管理员管理APP版本:
进入版本管理
- 管理员面板 → APP管理 → 版本管理
版本信息字段
- 版本号 (versionCode): 整数,如20006
- 版本名 (versionName): 字符串,如"2.0.6"
- 平台: Android/iOS
- 发布类型: release(正式)/beta(测试)/alpha(内测)
- APK文件: 上传APK文件到服务器
- 文件大小: 自动计算
- MD5校验: 自动生成,用于验证
- 更新描述: 版本更新说明
- 变更日志: 详细的变更记录
- 强制更新: true/false
- 最低兼容版本: 最低支持的旧版本
版本状态
- 激活: 当前可用的版本
- 停用: 不再提供的版本
自动更新流程
用户端自动检查和更新:
启动检查更新
- APP启动时自动检查更新
- 调用版本检查API
- 对比本地版本号
显示更新提示
- 有新版本时弹出对话框
- 显示版本号和更新描述
- 显示变更日志
下载APK
- 点击"立即更新"
- 开始下载APK文件
- 显示下载进度(百分比)
- 支持断点续传
智能下载
- 检查本地是否已下载相同版本
- MD5校验本地文件完整性
- 避免重复下载
安装APK
- 下载完成后提示安装
- 请求安装权限
- 打开安装界面
强制更新
强制更新控制
- 管理员设置forceUpdate为true
- 用户无法跳过更新
- 必须更新才能使用APP
兼容性检查
- 检查用户版本是否低于minSupportedVersion
- 低于最低版本强制更新
- 保证API兼容性
系统日志管理
自动日志收集
APP启动时自动收集日志:
日志收集机制
- APP启动时开始logcat实时收集
- 精确过滤:只收集包名为com.bjbmkj.rizhi的日志
- 包含所有级别:Debug/Info/Warn/Error/Fatal
日志内容
- 业务逻辑日志
- 网络请求日志
- 崩溃堆栈信息
- 异常错误记录
存储管理
- 按天存储:每天一个日志文件
- 文件命名:rizhi_log_YYYY-MM-DD.txt
- 自动清理:保留最近15天
- 存储位置:APP私有目录
日志导出功能
管理员专属功能:
进入日志导出
- 管理员面板 → 系统管理 → 日志导出
选择日期范围
- 选择开始日期
- 选择结束日期
- 最多可选15天范围
导出操作
- 点击"导出日志"
- 系统打包选定日期范围的所有日志文件
- 生成ZIP压缩包
分享日志
- 导出完成后自动打开分享面板
- 优先显示微信、企业微信
- 发送给技术支持人员
远程问题排查
使用场景
- APP崩溃,无法复现
- 功能异常,需要详细日志
- 性能问题分析
操作流程
- 用户联系管理员
- 管理员请求用户导出日志
- 用户通过微信发送日志文件
- 技术人员分析日志定位问题
日志内容
- 完整的操作流程记录
- 网络请求详情
- 错误堆栈信息
- 时间戳精确到毫秒
消息与通知
会话列表
查看所有聊天会话:
- 私聊会话
- 项目群聊
- 最后消息预览
- 未读消息数量
发送消息
开始新会话
- 点击"+"按钮
- 选择联系人
- 或选择项目(发送到项目群)
发送消息
- 输入文字消息
- 点击发送
- 实时送达
消息状态
- ✓ 已发送
- ✓✓ 已送达
- 蓝色✓✓ 已读
已读回执
- 查看消息是否已读
- 查看谁已读了消息(群聊)
- 未读消息红点提示
推送通知
系统自动推送以下通知:
- 新消息提醒
- 任务分配通知
- 工作日志提交通知(关注的人)
- 项目更新通知
推送设置:
- 开启/关闭推送
- 通知声音
- 振动提醒
- 免打扰时段
关注功能
关注同事
搜索用户
- 在搜索框输入姓名
- 查看搜索结果
关注操作
- 点击用户头像
- 点击"关注"按钮
- 关注成功
关注效果
- 对方提交日志时(你在可见范围内)会收到通知
- 查看对方的动态
我的关注
- 查看我关注的所有人
- 显示关注时间
- 取消关注
我的粉丝
- 查看关注我的所有人
- 相互关注的用户单独标记
- 回关操作
推荐关注
系统基于以下条件推荐:
- 钉钉联系人
- 同项目成员
- 相互有工作交集的同事
月度报告
生成报告
选择月份
- 点击月份选择器
- 选择要查看的月份
查看数据
- 工作日志统计
- 任务完成情况
- 有效工时统计
- 非有效工时统计
- 项目参与度
导出Excel
导出操作
- 点击"导出Excel"按钮
- 等待文件生成
- 自动保存到本地
Excel内容
- 格式化的表格
- 边框和样式
- 微软雅黑字体
- 完整的统计数据
打开和分享
- 自动用WPS Office打开
- 或点击"分享"按钮
- 选择微信、企业微信等应用
数据验证
提交日志前系统会验证:
- 必填字段是否完整
- 工时是否合理
- 项目是否有效
- 提示缺失或异常数据
管理员功能
用户管理
用户列表
- 查看所有企业用户
- 显示角色和状态
角色设置
- 普通用户 (user)
- 管理员 (admin)
日志类型
- 项目人员: 需要填写详细工时
- 后勤人员: 简化的日志模式
账号管理
- 禁用用户账号
- 重置用户密码
任务管理
见上文"管理员任务功能"
项目管理
- 修改任何项目信息
- 设置项目负责人
- 更新项目状态
- 批量导入项目
车辆管理
见上文"车辆管理"
系统配置
基础配置
- 系统参数设置
- 功能开关
餐补配置
- 设置餐补标准
- 配置计算规则
补交日志配置
- 允许补交天数
- 审批流程设置
日志导出
导出系统运行日志用于问题排查:
- 进入"系统管理"
- 选择"日志导出"
- 选择日期范围
- 导出日志文件
- 分享给技术支持
实用技巧
快速操作
快捷创建任务
- 长按底部"+"按钮
- 快速创建任务
批量选择
- 选择任务时长按可进入多选模式
- 批量标记为完成
搜索快捷键
- 在列表页面下拉即可搜索
- 输入关键词快速查找
数据同步
- 应用启动时自动同步最新数据
- 下拉刷新获取更新
- 数据本地缓存,离线也能查看
照片管理
- 照片上传前自动压缩
- 节省流量和存储空间
- 点击照片可全屏查看
- 双指缩放查看细节
离线功能
以下功能支持离线使用:
- 查看已缓存的日志
- 查看任务列表
- 查看项目列表
- 编辑草稿
需要网络的功能:
- 提交日志
- 发送消息
- 上传照片
- 同步数据
