Aptli

移动应用

Aptli 的移动界面专为使用智能手机和平板电脑的现场工作人员设计。直接从浏览器安装(无需应用商店),即可离线访问任务、支持滑动操作的工作列表、活动检查表、用于库存提货的二维码扫描器、支持 GPS 和照片拍摄的报告创建功能,以及地图绘制功能。 移动端体验侧重于任务执行;管理任务仍由桌面端处理。

什么是 PWA?

渐进式网页应用(Progressive Web App)= 像原生应用一样运行的可安装网站:

安装: 直接从浏览器安装——无需应用商店,无需审批流程。具体路径取决于您的设备(各平台详细步骤如下):

  • Android(Chrome/Edge): 登录后,在应用菜单中点击 添加到主屏幕。 备用方法:点击浏览器右上角的三个点菜单 → 安装应用 / 添加到主屏幕
  • iOS(Safari): 点击“分享”按钮 → 添加到主屏幕。iOS 系统绝不会自动提示。
  • 桌面端(Chrome/Edge): 点击地址栏右侧的小安装图标,或使用三点菜单 → 安装 Aptli

安装完成后,应用将以全屏模式打开,且不显示浏览器边框。

相较于移动浏览器的优势:

  • 启动更快(在设备上缓存)
  • 离线可用(设备端运行)
  • 推送通知
  • 主屏幕快捷方式可直达特定功能
  • 性能更佳 (资源已优化)

桌面端专属工具: 批量导入、深度编辑和数据导出等功能仅在桌面应用中提供;移动端 PWA 虽提供“数据传输”快捷方式,但导出功能仅限于桌面版本。

无需应用商店审核:

  • 无需经过 Apple/Google 审核流程
  • 更新即时部署(无应用商店审核延迟)
  • 与网页版采用同一代码库(维护效率更高)

移动端功能范围

包含 - 执行功能:

  • ✅ 查看工单和任务(全部或仅查看自己的)
  • ✅ 从任务中创建工单(滑动操作)
  • ✅ 从工单中生成报告
  • ✅ 在工单上勾选活动检查清单(逐步完成各项任务)
  • ✅ 扫描二维码(取件授权)
  • ✅ 查看包含地标和任务的地图,包括您的优化路线
  • ✅ 创建简单地图地标(点、线、多边形)
  • ✅ 查看报告(全部或仅查看自己的)
  • ✅ 将照片上传至报告
  • ✅ 编辑个人用户资料
  • ✅ 验证手机号码(双因素认证)
  • ✅ 请求帮助(帮助请求表单)
  • ✅ 回复发给您的帮助请求

不包含 - 管理功能:

  • ❌ 修改库存(仅限桌面端,授权人员扫描除外)
  • ❌ 注册新要素(简单草稿允许,批量导入仅限桌面端)
  • ❌ 为用户分配角色(仅限桌面端)
  • ❌ 批量操作(仅限桌面端)

理由:

  • 仅占桌面应用大小/复杂度的 5%
  • 专注于现场执行
  • 复杂的管理任务更适合在桌面端处理

移动端界面

底部导航栏 — 五个固定板块:

底部栏始终显示相同的五个位置,因此您的肌肉记忆不会中断:

  • 今天 — 您的仪表盘:显示分配给您的待办事项,按优先级排序并采用颜色标记,此外还有由贵组织授权的功能模块提供的概览板块。
  • 工作 — 任务、工作单、报告以及 (针对审计员)验证。
  • 库存 —— 提货、您的待提库存、库存搜索和站点。
  • 地图 —— 现场记录,即交互式地图。
  • 更多 —— 其他页面的目录:帮助请求、您的个人资料以及您有权访问的管理页面。

“工作”、“库存”和“更多”内部显示的内容取决于贵组织授权的功能以及您的账户权限——该工具栏本身的形状不会改变。如果贵组织未授权工作管理或库存功能,相应的部分将不会显示。

板块标签(顶部标签栏):

当某个板块包含多个页面(如“工作”、“库存”)时,标题下方会出现一排药丸状的标签。轻触药丸即可切换页面——该标签栏不支持滑动操作,因为水平滑动功能专用于列表卡片(参见下文“滑动操作”)。 点击底栏中的某个部分,将重新打开您在此部分中最后使用的页面。

某些内部标签页具有情境依赖性:

  • 我的物品(库存)仅在您实际持有库存时显示。当提货或转运任务到达您手中时,它会立即出现;当您不再持有任何物品时,它会悄然消失。 无论如何,该页面本身仍可通过链接和通知访问。
  • 验证(工作)仅对有权创建验证的用户显示——这是审计员的待办事项队列。

菜单(右上角)与“更多”的区别:

  • “更多”(底部栏)可带您访问页面:帮助请求、个人资料、访问请求管理(管理员)以及服务门户目录 (门户管理员)。
  • 菜单按钮(右上角 ☰)用于执行 操作 并包含 偏好设置:二维码扫描器、显示我的二维码、语言和单位切换、主题、全屏模式、教程、离线缓存按钮(iOS)、隐藏导航栏以及注销。

手势支持:

  • 左右滑动列表卡片以执行快速操作(见下文)
  • 下拉刷新 (更新数据)
  • 在地图上双指缩放

列表卡片上的滑动操作

所有工作和库存列表都采用相同的滑动操作逻辑,因此只需掌握一次即可:

  • 短滑动向右 → 显示该记录类型的主要操作
    • 任务 → 为该任务创建工作单
    • 工作单 → 根据工作单创建报告
    • 报告/验证 → 添加验证(若您有权限)
    • 我的物品 → 转移库存
  • 短向右滑动 → 显示 生命周期操作:删除(或在查看已删除记录时恢复)。仅当您的账户拥有相应权限时才会显示——否则卡片会直接弹回。
  • 向右长滑动(滑到底)在地图上查看:跳转至地图部分,并定位到该记录的位置。
  • 向左长滑动(滑到底)隐藏:仅在本设备、本列表中将卡片收起。 隐藏操作不会更改服务器上的任何内容,也不会影响其他任何人。列表工具栏中会出现一个 隐藏 (n) 开关;开启后,隐藏的卡片会在原位置显示为暗色,再次滑动(或点击显示的按钮)即可取消隐藏。

点击卡片仍会打开它——滑动只是快捷方式,绝非替代操作。显示的删除按钮仍需点击确认,且删除操作遵循与其他任何更改相同的撤销/提交流程。

今天 — 您的待办事项

“今天”屏幕列出了您的待办事项,提供两种排序模式——最近(按距离排序)和最紧急(按截止日期优先排序)。每张卡片都带有带编号且采用颜色编码的徽章

  • 数字 表示该项在当前队列中的位置。切换排序模式或完成工作时,编号会重新调整。
  • 颜色 代表紧急程度分级,与排序方式无关:红色 = 逾期,琥珀色 = 即将到期,蓝色 = 时间充裕,灰色 = 无截止日期。

相同的数字和颜色也会出现在地图的 “我的路线” 视图(如下)中,因此“第 2 站,琥珀色”在列表和地图上的含义是一致的。

工作单与任务

“工作”部分将分配给您的工作按标签页分类:任务——单个工作单元——以及工作单——分配给您的派工任务,此外还有报告和(针对审计员的)验证

筛选选项:

  • 我的 / 分配给我的 / 我创建的
  • 状态(待处理、进行中、已完成)
  • 高级筛选功能在滑出式面板中打开(点击筛选图标)

工作单卡片:

  • 名称和描述
  • 指派用户
  • 状态图标
  • 截止日期和距离指示器
  • 关联任务

操作:

  • 点击查看详情
  • 向右滑动创建报告;完全向右滑动可在地图上查看
  • 查看二维码(若已授权且存在取件码)
  • 更新状态(进行中 → 已完成)

活动检查清单

已注册的活动可附带一份检查清单——即构成该活动完成所需的步骤,这些步骤由管理员在活动注册表中预先定义。

当工单派发某项活动时,该工单将获得该检查清单的独立副本。 打开工单,展开每项活动行下的检查清单:

  • 完成项目后勾选 — 勾选标记会像其他编辑一样与工单一起保存。
  • 标记为必填的项目必须全部勾选,检查清单才算完成;可选项目绝不会阻碍完成。
  • 进度图标(例如 已完成 3/5)可让您一目了然地掌握每行任务的进度。
  • 在一个工单上勾选项目绝不会影响调度了同一活动的其他工单,且后续对注册表检查清单的编辑也不会干扰已执行中的工作。

报告生成

快速生成报告流程:

  1. 在工作单中 → 向右滑动(或打开工作单并点击“创建报告”)
  2. 预填内容:工作单、任务、建议消耗量
  3. 调整实际数据(实际发生的情况)
  4. 点击相机图标 → 拍摄照片
  5. 自动捕获 GPS 位置(当前位置)
  6. 提交 → 生成耗材交易记录

针对移动端优化的字段:

  • 大型触控区域(按钮、输入框)
  • 描述支持语音转文字
  • 从相机或相册上传照片
  • GPS 自动填充(或手动选择地图位置)
  • 最小化必填字段(姓名、已完成工作、消耗来源)

离线操作

  • 在“设备端处理”下创建报告
  • 照片本地缓存
  • 恢复连接后自动提交
  • 若服务器端数据发生变更,自动解决冲突

地图视图

显示功能:

  • 所有已提交的要素(来自图层)
  • 当前位置附近的任务(距离过滤)
  • 您的工单高亮显示(颜色编码的透镜图标)

地图控件:

  • 图层选择器(切换要素可见性)
  • 当前位置按钮(根据 GPS 重新居中)
  • 底图切换器(道路、卫星、地形)
  • 搜索(按名称/ID 查找要素)

所有绘图、缩放和图层控制功能均与之前完全相同——下方的“透镜”均为新增功能,并非替代功能。

“我的路线”视图:

地图上方的视图栏包含 “我的路线”:这是针对您未完成工作的编号标记,其颜色根据紧急程度区分——这些编号和颜色与“今天”屏幕上的徽章完全一致,因此列表和地图始终保持同步。已命名的任务会在标记旁显示其名称。 如有数据,将显示距离;该应用不提供预计行车时间。

当“我的路线”处于激活状态时,地图点击操作将被过滤为仅限工作任务,因此你在执行路线任务时不会误选无关的田块记录。关闭该视图后,选择功能将恢复正常。你也可以自行覆盖此设置:**“仅选择工作任务”**开关位于“已选要素”面板中,可根据需要自由调整。

简易绘图:

  • 点击**+**悬浮操作按钮;首次点击显示绘图工具,第二次点击激活所选工具(这种两级操作方式可确保在小屏幕上保持界面简洁)
  • 选择几何类型(点、线、多边形)
  • 点击地图添加点
  • 填写基本属性
  • 保存为草稿版本
  • **注意:**在移动端创建的草稿与桌面端采用相同的版本/提交系统。移动端用户可以请求提交,但只有管理员才能批准;最终版本在批准后对所有人可见。

离线地图图块:

  • 缓存地图图块(有效期 30 天)
  • 优先加载缓存图块以提升速度;仅在缺失时才使用网络
  • 离线状态下仍可使用
  • 恢复联网后同步要素

扫描功能

用于库存领取和要素参考的二维码扫描器:

使用场景:

  • 扫描任务提货二维码 → 授权库存转移
  • 扫描要素二维码 → 打开要素详情
  • 扫描求助请求二维码 → 响应具体问题

工作流程:

  1. 打开右上角菜单并点击 二维码扫描器 (扫描器为全局模态窗口,在每个移动页面均可使用)
  2. 相机打开并显示二维码取景框
  3. 对准二维码
  4. 自动检测并解码
  5. 执行操作(提货、导航至功能等)

提货授权:

  1. 扫描任务提货二维码
  2. 验证:
    • 您是授权收件人(或拥有 canFacilitatePickups 权限)
    • 源站点有库存
    • GPS 位置(若已配置,需在地理围栏范围内)
  3. 确认提货
  4. 自动生成转账交易
  5. 库存已添加至您的个人站点——若“库存”页面中尚未显示“我的物品”标签页,此时将自动生成

离线二维码扫描:

  • 离线时缓存扫描记录
  • 恢复在线后进行处理
  • 防止重复提货(去重逻辑)

库存转移 (仅限授权员工)

拥有 canFacilitatePickups 权限的员工:

工作流程:

  1. 拣货员抵达仓库
  2. 出示任务二维码
  3. 员工代表拣货员扫描二维码
  4. 系统验证:
    • 工人是授权的收件人
    • 工作人员拥有 canFacilitatePickups 权限
    • 库存充足
  5. 完成调拨
  6. 交易记录中包含扫描执行者、受托人以及扫描方式(自助或工作人员协助)

手动创建转运单: 工作人员可手动创建转运单:

  • 选择起始站点
  • 选择收件人
  • 选择资源及数量
  • 确认 → 转运单创建成功

个人资料管理

打开 更多 → 个人资料

可编辑字段:

  • 姓名、职位、部门
  • 电话号码 (需验证)
  • 通知偏好设置
  • 语言选择

手机验证:

  1. 输入电话号码
  2. 点击“发送验证码”
  3. 接收包含 6 位验证码的短信
  4. 输入验证码
  5. 手机验证通过 (启用短信通知)

双因素认证:

  • 在个人资料中启用双因素认证
  • 使用认证应用扫描TOTP二维码
  • 输入6位验证码以确认
  • 后续登录时必须使用

无法在移动端编辑:

  • 电子邮件(安全限制)
  • 角色(管理员功能)
  • 管理员权限(管理员功能)

帮助请求

打开 更多 → 帮助

创建帮助请求:

  1. 填写表单:
    • 主题行
    • 描述(支持语音转文字)
    • 类别(技术、访问权限、资料等)
    • 优先级(低、中、高、紧急)
  2. 可选:添加照片
  3. 提交 → 通知将发送至相关团队

回复帮助请求:

  • 查看发给您的请求
  • 添加评论/备注
  • 更新状态
  • 上传回复照片
  • 问题解决后关闭

设备端工作(离线工作)

缓存:

  • API 响应结果缓存(有效期 1 小时)
  • 地图图块缓存(有效期 30 天)
  • 应用外壳缓存(即时加载)
  • 图片和资源缓存

不依赖网络连接的操作:

  • 创建报告(联网时提交)
  • 拍摄照片(联网时上传)
  • 绘制地图草图(联网时同步)
  • 查看缓存的任务/报告

同步指示符:

  • 在线:绿色圆点
  • 离线:灰色圆点 + “X 项待同步”
  • 同步中:旋转图标 + “正在同步 X 项...”
  • 显示上次同步时间

安装说明

Aptli 可直接通过浏览器安装——无需应用商店,无需审批流程。具体路径取决于您的设备。

Android(Chrome 或 Edge)

主要路径——应用内按钮:

  1. 在 Chrome 或 Edge 中打开 Aptli。
  2. 登录 → 您将进入移动端首页。
  3. 点击页眉中的 添加到主屏幕(下载图标)。
  4. 出现 Chrome 的原生安装对话框 — 点击 安装
  5. Aptli 的图标将出现在您的主屏幕上。

备用路径 — 浏览器菜单:

  1. 点击浏览器中的三个点菜单。
  2. 点击安装应用添加到主屏幕
  3. 确认 — Aptli 图标将出现在您的主屏幕上。

Chrome 在 Chrome 76 版本(2019 年)中移除了自动弹出的安装横幅。在现代 Android 系统中,安装始终需要点击才能开始——无论是应用内的 添加到主屏幕 按钮,还是浏览器菜单。两种方式均可;登录后,应用内的按钮响应更快。

iOS(Safari)

在 iOS 上,PWA 仅支持通过 Safari 安装——iOS 版 Chrome 和 Firefox 均为 WebKit 壳层,不具备安装界面。此外,iOS 绝不会显示自动安装提示;您需要通过“分享”菜单手动发起安装。

  1. 在 Safari 中打开 Aptli。
  2. 点击 分享 按钮(带箭头的方框)。
  3. 滚动并点击 添加到主屏幕
  4. 点击 添加
  5. Aptli 的图标将出现在您的主屏幕上。

桌面端(Chrome、Edge 或其他 Chromium 浏览器)

  1. 在浏览器中打开 Aptli。
  2. 在地址栏右侧查找安装图标(⊕ 或一个小显示器/电脑图标)。
  3. 点击该图标——浏览器将弹出安装对话框。
  4. 点击 安装
  5. Aptli 将在独立窗口中打开,不显示浏览器边框。它还会出现在您的操作系统应用启动器中 (“开始”菜单、“应用程序”文件夹等)中。

如果未显示安装图标:

  • Chrome: 三点菜单 → 安装 Aptli
  • Edge: 三点菜单 → 应用将此网站安装为应用

Firefox 及其他浏览器

基于 Chromium 的浏览器(Chrome、Edge、Opera、Brave)以及 iOS 版的 Safari 对 PWA 安装的支持最为完善。Firefox 支持在 Android 设备上安装,但不支持在桌面端安装。

更新

PWA 会自动更新:

  • 无需通过应用商店更新
  • 新版本在后台下载
  • 更新就绪时提示刷新
  • 修复程序/新功能即时部署

安全注意事项

设备本地存储:

  • 会话数据在设备上受到保护
  • 不会以明文形式存储任何敏感数据
  • 注销时将清除所有本地数据

GPS 隐私:

  • 仅在必要时访问位置信息(报告、二维码取件)
  • 明确请求权限
  • 可拒绝(支持手动输入位置)
  • GPS 数据在传输过程中加密(HTTPS)

照片隐私:

  • 照片在上传前存储在本地
  • 上传成功后自动删除
  • 服务器存储数据经过加密
  • 访问受权限控制

最佳实践

安装 PWA:

  • 比移动浏览器更快
  • 离线也可使用
  • 体验更佳

启用通知:

  • 接收任务更新
  • 获取求助请求的回复
  • 取件码过期提醒

掌握滑动手势规则:

  • 短滑动针对特定记录;长滑动为通用操作(显示/隐藏)
  • 所有列表均采用相同手势——学会一次,随处可用

定期同步:

  • 每天打开应用(即使处于离线状态)
  • 队列中的操作会自动处理
  • 防止积压大量待办事项

使用相机:

  • 照片可证明工作已完成
  • 记录质量问题
  • 比输入文字描述更快

现场提交报告:

  • 仍在现场时提交
  • 记忆犹新 = 细节准确
  • GPS 自动定位(别忘了记录位置)

缓存地图图块:

  • 在线时在服务区域内打开地图
  • 图块缓存有效期为 30 天
  • 离线时也可使用地图