Skip to content

功能详解 ​

本文档详细说明各功能模块的使用方法和注意事项。

工作日志 ​

创建日志 ​

日志APP的工作日志功能支持详细记录每天的工作情况。

操作步骤 ​

  1. 选择项目

    • 点击"选择项目"按钮
    • 从项目列表中选择,或点击"创建新项目"
    • 项目信息包括名称、类型、GPS位置
  2. 记录工作时段

    • 设置开始时间和结束时间
    • 系统自动计算总工时
  3. 填写工时信息

    • 有效工时: 实际工作的小时数
    • 非有效工时: 因特殊情况产生的非工作时间
  4. 添加已完成任务

    • 从任务池选择今天完成的任务
    • 支持多选
    • 任务会自动标记为COMPLETED状态
  5. 设置明日计划

    • 选择明天要做的任务
    • 任务保存在日志的planned_task_ids字段
  6. 上传工作照片

    • 点击"添加照片"
    • 支持拍照或从相册选择
    • 照片自动上传到阿里云OSS
    • 支持多张照片
  7. 选择协作人员

    • 内部协作人员: 从企业通讯录选择
    • 外部协作人员: 手动输入
  8. 记录误餐情况

    • 勾选早餐、午餐、晚餐误餐情况
    • 用于餐补统计
  9. 设置可见性

    • 选择可以查看此日志的人员
    • 可见人员列表保存在visibility字段
    • 只有可见人员且关注了你的用户会收到通知
  10. 提交日志

    • 点击"提交"按钮
    • 系统自动通知关注你的用户(在可见范围内)

注意事项 ​

  • 项目、工时、已完成任务为必填项
  • 照片大小会自动压缩优化
  • 提交后可以继续编辑
  • 草稿状态可暂存,稍后继续编辑

查看日志 ​

我发出的日志 ​

查看自己创建的所有日志:

  • 按日期降序排列
  • 显示项目名称、工时、照片数量
  • 点击日志卡片查看详情

我收到的日志 ​

查看别人发给你的日志:

  • 只显示visibility列表中包含你的日志
  • 显示发送人姓名
  • 支持按发送人筛选

筛选功能 ​

按日期筛选:

  • 点击筛选按钮
  • 选择开始日期和结束日期
  • 查看指定时间范围的日志

按项目筛选:

  • 选择项目
  • 查看该项目的所有日志

按人员筛选:

  • 在"我收到的日志"中按发送人筛选
  • 在"我发出的日志"中按接收人筛选

任务池管理 ​

创建任务 ​

任务池是统一的任务管理系统,所有任务集中管理。

基本信息 ​

  1. 任务标题

    • 简短描述任务名称
    • 便于快速识别
  2. 任务内容

    • 详细描述任务具体要做什么
    • 支持多行文本
  3. 任务属性

    • 优先级: 高/中/低
    • 预估工时: 预计需要多少小时
    • 时间段: 上午/下午/晚上/全天

项目和人员 ​

  1. 关联项目

    • 选择任务所属项目
    • 可选项,不关联项目的任务也可创建
  2. 分配任务

    • 普通用户: 创建的任务assigned_to为自己
    • 管理员: 可以将任务分配给其他用户
  3. 协作人员

    • 内部协作人员: 企业内部参与的同事
    • 外部协作人员: 外部单位参与的人员

时间设置 ​

  1. 截止时间 (due_time)

    • 设置任务必须完成的时间
    • 过期未完成会自动标记为EXPIRED
  2. 计划开始时间 (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未完成
  • 系统自动标记
  • 需要手动处理

处理方式:

  • 修改截止时间继续执行
  • 标记为完成
  • 删除任务

管理员任务功能 ​

管理员有额外的任务管理权限:

任务分配 ​

  1. 点击"分配任务"
  2. 选择分配给的用户
  3. 填写任务信息
  4. 被分配用户会收到通知

查看所有任务 ​

  • 查看所有用户的任务
  • 按用户、状态、项目筛选
  • 查看任务详情和进度

批量操作 ​

  • 将PLANNED任务批量转为TODO
  • 清理历史过期任务
  • 批量修改任务状态

项目管理 ​

创建项目 ​

基本信息填写 ​

  1. 项目名称

    • 清晰简洁的项目名称
    • 便于识别和搜索
  2. 项目类型

    • 从预设类型中选择
    • 类型由管理员在后台配置
  3. 项目描述

    • 详细说明项目内容
    • 包括目标、范围等信息

GPS定位 ​

项目支持4种地址来源:

  1. 钉钉定位 (dingtalk)

    • 使用钉钉的定位数据
    • 自动获取位置和地址
  2. 手动输入 (manual)

    • 手动输入详细地址
    • 系统通过百度地图API获取GPS坐标
  3. GPS定位 (gps_location)

    • 使用设备GPS获取精确位置
    • 适合在项目现场时使用
  4. 基站定位 (cell_location)

    • 使用移动网络基站定位
    • GPS信号弱时的备选方案

地图选点 ​

  1. 点击"地图选择位置"
  2. 在地图上拖动标记到准确位置
  3. 或搜索地址定位
  4. 确认后自动填充GPS坐标和地址

项目查询与管理 ​

项目列表 ​

筛选条件:

  • 项目类型
  • 项目状态 (进行中/已完成/已归档)
  • 负责人
  • 关键词搜索

排序方式:

  • 按创建时间
  • 按更新时间
  • 按项目名称

项目详情 ​

点击项目查看:

  • 完整的项目信息
  • GPS位置在地图上标注
  • 关联的工作日志
  • 关联的任务
  • 项目成员

项目星标 ​

  • 点击星标图标收藏项目
  • 快速访问常用项目
  • 星标项目在列表顶部显示

项目类型管理 ​

管理员功能,配置项目分类:

  1. 进入管理员面板
  2. 选择"项目类型管理"
  3. 添加新类型: 输入类型名称和描述
  4. 编辑类型: 修改已有类型
  5. 删除类型: 删除不需要的类型(需要先转移使用该类型的项目)

项目节点 ​

为项目设置里程碑节点:

  1. 添加节点

    • 选择节点类型
    • 设置预计完成时间
    • 填写节点描述
  2. 完成节点

    • 标记节点为已完成
    • 记录实际完成时间
    • 发送通知给项目成员
  3. 节点类型

    • 管理员预先配置
    • 如: 立项、设计、施工、验收等

车辆与签到 ​

上车记录 ​

记录员工使用车辆的情况:

  1. 扫描车牌或手动输入

    • 扫描车辆二维码
    • 或手动输入车牌号
  2. 自动记录信息

    • 上车时间
    • GPS位置
    • 上车地点
  3. 关联日志

    • 上车记录可关联到当天日志
    • 显示使用的车辆信息

GPS轨迹 ​

通过E6系统获取车辆GPS数据:

查看轨迹 ​

  1. 选择车辆和日期
  2. 查看当天完整行驶轨迹
  3. 地图上显示行驶路线

停靠点 ​

  • 自动识别车辆停靠地点
  • 显示停靠时间段
  • 匹配项目位置

里程统计 ​

  • 每日行驶里程
  • 按项目分配里程
  • 油耗成本预估

车辆管理 ​

管理员功能:

  1. 添加车辆

    • 车牌号
    • 车辆类型
    • GPS设备ID
    • 绑定使用人
  2. 车辆列表

    • 查看所有车辆
    • 在线状态
    • 使用情况
  3. 编辑/删除

    • 修改车辆信息
    • 更换GPS设备
    • 删除报废车辆

上车记录查看 ​

查看今日上车记录:

  1. 进入查看数据

    • 点击底部导航"查看数据"
    • 选择"上车记录"标签页
  2. 查看记录列表

    • 显示今日所有上车记录
    • 包含上车时间、车牌号、上车地点
    • 时间格式:HH:mm(北京时间)
  3. 数据来源

    • 基于用户手机号查询
    • 自动同步E6系统数据
    • 实时显示最新记录

基地管理 ​

创建基地 ​

管理员可以创建和管理多个基地:

  1. 进入基地管理

    • 管理员面板 → 基地管理
    • 查看现有基地列表
  2. 填写基本信息

    • 基地编码: 唯一标识符
    • 基地名称: 易于识别的名称
    • 基地类型: 总部/分公司/仓库
    • 详细地址: 完整的地址信息
    • 联系电话: 基地联系方式
    • 基地负责人: 从员工列表选择
    • 所属部门: 选择部门
  3. GPS定位设置

    • GPS坐标: 使用地图选点或手动输入经纬度
    • 检测范围: 设置签到检测半径(米)
    • 用于判断用户是否在基地范围内
  4. 基地状态

    • 启用: 正常使用的基地
    • 停用: 暂时不使用的基地

基地-项目距离管理 ​

系统自动计算和管理基地到项目的距离:

自动计算距离 ​

  1. 计算方式

    • 手动输入: 人工填写距离数据
    • 地图API: 通过百度地图API计算道路距离
    • GPS实际: 基于实际GPS轨迹计算
    • E6 API: 通过E6车辆系统计算
  2. 计算内容

    • 直线距离(公里)
    • 道路距离(公里)
    • 预估行驶时间(分钟)
    • 预估油耗成本(元)
  3. 自动更新

    • 项目GPS位置变更时自动重新计算
    • 基地位置变更时批量更新相关项目距离
    • 支持手动触发重新计算

查看距离信息 ​

  1. 在项目详情中查看

    • 显示最近基地
    • 显示距离和预估时间
    • 用于里程分配计算
  2. 在基地管理中查看

    • 查看该基地到所有项目的距离
    • 按距离排序
    • 识别覆盖范围

基地定位判断 ​

系统自动判断用户当前位置:

  1. 定位逻辑

    • 获取用户当前GPS坐标
    • 计算与所有基地的距离
    • 如果在某基地检测范围内,标记为在基地
  2. 应用场景

    • 签到考勤时判断是否在基地
    • 工作日志中自动识别工作地点
    • 统计分析基地内外工作时间

里程分配管理 ​

项目里程分配 ​

基于车辆GPS数据自动分配每日里程:

分配原理 ​

  1. 数据来源

    • 从E6系统获取车辆每日GPS轨迹
    • 识别车辆停靠的项目位置
    • 统计每个项目的停靠时长
  2. 权重计算

    • 基地距离权重: 距离基地越远,分配权重越高
    • 停靠时长权重: 停靠时间越长,分配权重越高
    • 访问次数: 多次访问的项目增加权重
  3. 分配方式

    • 距离基础分配: 根据基地距离和停靠时长智能分配
    • 平均分配: 访问的所有项目平均分配里程
    • 手动调整: 管理员可手动修改分配比例

查看里程分配 ​

  1. 项目每日里程

    • 查看某个项目每天分配的里程
    • 显示访问车辆数量
    • 显示主要出发基地
  2. 分配状态

    • 待分配: 刚获取的GPS数据,未处理
    • 已分配: 系统自动分配完成
    • 已审核: 管理员审核通过
  3. 审核调整

    • 管理员可查看自动分配结果
    • 手动调整不合理的分配
    • 审核通过后锁定数据

交通成本计算 ​

基于里程自动计算交通成本:

  1. 成本计算

    • 每个项目的累计里程
    • 根据车辆油耗配置计算油耗成本
    • 累计每个项目的交通费用
  2. 统计分析

    • 项目访问频次
    • 月度/年度交通成本
    • 各基地到项目的总里程
  3. 报表导出

    • 导出项目交通成本明细
    • Excel格式,包含完整统计数据

餐补管理 ​

餐补规则配置 ​

管理员配置餐补标准:

  1. 进入配置

    • 管理员面板 → 系统配置 → 餐补管理
  2. 设置餐补标准

    • 早餐餐补: 输入早餐补贴金额(元)
    • 午餐餐补: 输入午餐补贴金额(元)
    • 晚餐餐补: 输入晚餐补贴金额(元)
  3. 规则状态

    • 启用: 当前有效的餐补规则
    • 禁用: 暂停使用的规则
  4. 多版本管理

    • 支持创建多个版本的餐补规则
    • 系统自动使用最新的启用规则
    • 保留历史规则便于追溯

误餐记录 ​

在工作日志中标记误餐:

  1. 填写日志时标记

    • 勾选"早餐误餐"
    • 勾选"午餐误餐"
    • 勾选"晚餐误餐"
  2. 数据存储

    • 以JSON格式存储在日志的meals字段
    • 例:
  3. 自动计算

    • 提交日志时自动计算餐补金额
    • 存储在日志的meal_allowance字段

餐补统计 ​

查看和导出餐补统计:

  1. 月度餐补查询

    • 选择月份
    • 查看该月所有误餐记录
    • 显示餐补金额小计
  2. 餐补明细

    • 日期
    • 误餐类型(早/午/晚)
    • 餐补金额
    • 关联工作日志
  3. 导出报表

    • Excel格式导出
    • 包含完整的餐补明细和统计

地址服务 ​

地址智能搜索 ​

使用百度地图API搜索地址:

  1. 搜索入口

    • 创建/编辑项目时
    • 输入地址信息
  2. 搜索功能

    • 关键词搜索: 输入地址关键词
    • 联想建议: 实时显示匹配地址
    • POI搜索: 搜索兴趣点(商场、学校等)
  3. 选择地址

    • 从搜索结果中选择地址
    • 自动填充完整地址
    • 自动获取GPS坐标

地理编码 ​

地址和GPS坐标相互转换:

  1. 地址转坐标

    • 输入详细地址
    • 调用百度地图API
    • 返回GPS经纬度坐标
  2. 坐标转地址

    • 提供GPS坐标
    • 逆地理编码
    • 返回详细地址信息
  3. 批量编码

    • 支持批量地址转坐标
    • 用于数据导入和批量处理

地图选点 ​

在地图上直接选择位置:

  1. 打开地图

    • 点击"地图选择位置"按钮
    • 显示百度地图界面
  2. 选点操作

    • 拖动地图标记到准确位置
    • 或搜索地址后定位
    • 查看周边POI
  3. 确认位置

    • 确认后自动填充GPS坐标
    • 自动填充详细地址
    • 保存到项目或基地信息

APP版本管理 ​

版本信息管理 ​

管理员管理APP版本:

  1. 进入版本管理

    • 管理员面板 → APP管理 → 版本管理
  2. 版本信息字段

    • 版本号 (versionCode): 整数,如20006
    • 版本名 (versionName): 字符串,如"2.0.6"
    • 平台: Android/iOS
    • 发布类型: release(正式)/beta(测试)/alpha(内测)
    • APK文件: 上传APK文件到服务器
    • 文件大小: 自动计算
    • MD5校验: 自动生成,用于验证
    • 更新描述: 版本更新说明
    • 变更日志: 详细的变更记录
    • 强制更新: true/false
    • 最低兼容版本: 最低支持的旧版本
  3. 版本状态

    • 激活: 当前可用的版本
    • 停用: 不再提供的版本

自动更新流程 ​

用户端自动检查和更新:

  1. 启动检查更新

    • APP启动时自动检查更新
    • 调用版本检查API
    • 对比本地版本号
  2. 显示更新提示

    • 有新版本时弹出对话框
    • 显示版本号和更新描述
    • 显示变更日志
  3. 下载APK

    • 点击"立即更新"
    • 开始下载APK文件
    • 显示下载进度(百分比)
    • 支持断点续传
  4. 智能下载

    • 检查本地是否已下载相同版本
    • MD5校验本地文件完整性
    • 避免重复下载
  5. 安装APK

    • 下载完成后提示安装
    • 请求安装权限
    • 打开安装界面

强制更新 ​

  1. 强制更新控制

    • 管理员设置forceUpdate为true
    • 用户无法跳过更新
    • 必须更新才能使用APP
  2. 兼容性检查

    • 检查用户版本是否低于minSupportedVersion
    • 低于最低版本强制更新
    • 保证API兼容性

系统日志管理 ​

自动日志收集 ​

APP启动时自动收集日志:

  1. 日志收集机制

    • APP启动时开始logcat实时收集
    • 精确过滤:只收集包名为com.bjbmkj.rizhi的日志
    • 包含所有级别:Debug/Info/Warn/Error/Fatal
  2. 日志内容

    • 业务逻辑日志
    • 网络请求日志
    • 崩溃堆栈信息
    • 异常错误记录
  3. 存储管理

    • 按天存储:每天一个日志文件
    • 文件命名:rizhi_log_YYYY-MM-DD.txt
    • 自动清理:保留最近15天
    • 存储位置:APP私有目录

日志导出功能 ​

管理员专属功能:

  1. 进入日志导出

    • 管理员面板 → 系统管理 → 日志导出
  2. 选择日期范围

    • 选择开始日期
    • 选择结束日期
    • 最多可选15天范围
  3. 导出操作

    • 点击"导出日志"
    • 系统打包选定日期范围的所有日志文件
    • 生成ZIP压缩包
  4. 分享日志

    • 导出完成后自动打开分享面板
    • 优先显示微信、企业微信
    • 发送给技术支持人员

远程问题排查 ​

  1. 使用场景

    • APP崩溃,无法复现
    • 功能异常,需要详细日志
    • 性能问题分析
  2. 操作流程

    • 用户联系管理员
    • 管理员请求用户导出日志
    • 用户通过微信发送日志文件
    • 技术人员分析日志定位问题
  3. 日志内容

    • 完整的操作流程记录
    • 网络请求详情
    • 错误堆栈信息
    • 时间戳精确到毫秒

消息与通知 ​

会话列表 ​

查看所有聊天会话:

  • 私聊会话
  • 项目群聊
  • 最后消息预览
  • 未读消息数量

发送消息 ​

  1. 开始新会话

    • 点击"+"按钮
    • 选择联系人
    • 或选择项目(发送到项目群)
  2. 发送消息

    • 输入文字消息
    • 点击发送
    • 实时送达
  3. 消息状态

    • ✓ 已发送
    • ✓✓ 已送达
    • 蓝色✓✓ 已读

已读回执 ​

  • 查看消息是否已读
  • 查看谁已读了消息(群聊)
  • 未读消息红点提示

推送通知 ​

系统自动推送以下通知:

  • 新消息提醒
  • 任务分配通知
  • 工作日志提交通知(关注的人)
  • 项目更新通知

推送设置:

  • 开启/关闭推送
  • 通知声音
  • 振动提醒
  • 免打扰时段

关注功能 ​

关注同事 ​

  1. 搜索用户

    • 在搜索框输入姓名
    • 查看搜索结果
  2. 关注操作

    • 点击用户头像
    • 点击"关注"按钮
    • 关注成功
  3. 关注效果

    • 对方提交日志时(你在可见范围内)会收到通知
    • 查看对方的动态

我的关注 ​

  • 查看我关注的所有人
  • 显示关注时间
  • 取消关注

我的粉丝 ​

  • 查看关注我的所有人
  • 相互关注的用户单独标记
  • 回关操作

推荐关注 ​

系统基于以下条件推荐:

  • 钉钉联系人
  • 同项目成员
  • 相互有工作交集的同事

月度报告 ​

生成报告 ​

  1. 选择月份

    • 点击月份选择器
    • 选择要查看的月份
  2. 查看数据

    • 工作日志统计
    • 任务完成情况
    • 有效工时统计
    • 非有效工时统计
    • 项目参与度

导出Excel ​

  1. 导出操作

    • 点击"导出Excel"按钮
    • 等待文件生成
    • 自动保存到本地
  2. Excel内容

    • 格式化的表格
    • 边框和样式
    • 微软雅黑字体
    • 完整的统计数据
  3. 打开和分享

    • 自动用WPS Office打开
    • 或点击"分享"按钮
    • 选择微信、企业微信等应用

数据验证 ​

提交日志前系统会验证:

  • 必填字段是否完整
  • 工时是否合理
  • 项目是否有效
  • 提示缺失或异常数据

管理员功能 ​

用户管理 ​

  1. 用户列表

    • 查看所有企业用户
    • 显示角色和状态
  2. 角色设置

    • 普通用户 (user)
    • 管理员 (admin)
  3. 日志类型

    • 项目人员: 需要填写详细工时
    • 后勤人员: 简化的日志模式
  4. 账号管理

    • 禁用用户账号
    • 重置用户密码

任务管理 ​

见上文"管理员任务功能"

项目管理 ​

  • 修改任何项目信息
  • 设置项目负责人
  • 更新项目状态
  • 批量导入项目

车辆管理 ​

见上文"车辆管理"

系统配置 ​

  1. 基础配置

    • 系统参数设置
    • 功能开关
  2. 餐补配置

    • 设置餐补标准
    • 配置计算规则
  3. 补交日志配置

    • 允许补交天数
    • 审批流程设置

日志导出 ​

导出系统运行日志用于问题排查:

  1. 进入"系统管理"
  2. 选择"日志导出"
  3. 选择日期范围
  4. 导出日志文件
  5. 分享给技术支持

实用技巧 ​

快速操作 ​

  1. 快捷创建任务

    • 长按底部"+"按钮
    • 快速创建任务
  2. 批量选择

    • 选择任务时长按可进入多选模式
    • 批量标记为完成
  3. 搜索快捷键

    • 在列表页面下拉即可搜索
    • 输入关键词快速查找

数据同步 ​

  • 应用启动时自动同步最新数据
  • 下拉刷新获取更新
  • 数据本地缓存,离线也能查看

照片管理 ​

  • 照片上传前自动压缩
  • 节省流量和存储空间
  • 点击照片可全屏查看
  • 双指缩放查看细节

离线功能 ​

以下功能支持离线使用:

  • 查看已缓存的日志
  • 查看任务列表
  • 查看项目列表
  • 编辑草稿

需要网络的功能:

  • 提交日志
  • 发送消息
  • 上传照片
  • 同步数据

炳明一企通正式版 · 企业服务与协同管理