Aptli

移动应用

Aptli 的移动界面专为使用智能手机和平板电脑的外勤人员设计。直接从浏览器安装 — 无需应用商店 — 即可获得离线优先的任务查看、用于库存取货的 QR 扫描器、带 GPS 和拍照的报告创建以及地图绘制功能。移动端体验专注于执行；管理任务仍在桌面端进行。

什么是 PWA？

渐进式网页应用（Progressive Web App） = 可安装的网站，运行效果如同原生应用：

安装步骤：

  1. 在移动浏览器中打开 Aptli（Chrome、Safari、Edge）
  2. 浏览器显示"安装应用"提示
  3. 点击"安装" → 图标添加至主屏幕
  4. 以全屏模式打开（无浏览器外框）

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

  • 启动更快（设备端缓存）
  • 支持离线使用（service worker 缓存）
  • 推送通知
  • 特定功能的主屏幕快捷方式
  • 更优性能（资源优化）

**额外桌面工具：**批量导入、深度编辑和数据导出等功能仅在桌面应用中可用；移动 PWA 提供"数据传输"快捷方式，但导出功能仅限于桌面版。

无需应用商店：

  • 无需 Apple/Google 审核流程
  • 更新即时部署（无应用商店审核延迟）
  • 与 Web 版本共享代码库（维护效率高）

移动端范围

包含 - 执行功能：

  • ✅ 查看任务（全部或仅我的）
  • ✅ 从任务创建报告
  • ✅ 扫描 QR 码（取货授权）
  • ✅ 查看带要素和任务的地图
  • ✅ 创建简单地图要素（点、线、多边形）
  • ✅ 查看报告（全部或仅我的）
  • ✅ 将照片上传至报告
  • ✅ 编辑个人用户资料
  • ✅ 验证电话号码（2FA）
  • ✅ 请求帮助（帮助请求表单）
  • ✅ 回应指派给您的帮助请求

排除 - 管理功能：

  • ❌ 创建任务（仅限桌面端）
  • ❌ 修改库存（仅限桌面端，授权人员扫描除外）
  • ❌ 注册新要素（简单草稿可，批量导入仅限桌面端）
  • ❌ 为用户添加角色（仅限桌面端）
  • ❌ 批量操作（仅限桌面端）

理由：

  • 相当于桌面应用 5% 的体量/复杂度
  • 专注于现场执行
  • 复杂管理任务更适合在桌面端处理

移动界面

移动 PWA 界面 — 主屏幕、任务、报告及 QR 扫描器

应用内 QR 码扫描器界面

底部导航栏：

  • 首页（快速概览）
  • 任务（查看与筛选）
  • 报告（创建与查看）
  • 地图（要素、任务、绘图）
  • 个人资料（账户设置）

快捷方式（长按主页图标）：

  • 扫描器（QR 码阅读器）
  • 快速报告（基于当前位置创建报告）
  • 我的任务（地图上突出显示我的任务）

手势支持：

  • 在标签页间滑动
  • 下拉刷新（更新数据）
  • 长按调出上下文菜单
  • 在地图上双指缩放

扫描器功能

用于库存取货和要素引用的 QR 码扫描器：

使用场景：

  • 扫描任务取货 QR 码 → 授权库存转移
  • 扫描要素 QR 标签 → 打开要素详情
  • 扫描帮助请求 QR 码 → 响应特定问题

操作流程：

  1. 点击扫描器快捷方式（或底部导航的扫描器图标）
  2. 相机开启并显示 QR 取景框
  3. 对准 QR 码
  4. 自动检测并解码
  5. 执行操作（取货、导航至要素等）

取货授权：

  1. 扫描任务取货 QR 码
  2. 验证：
    • 您是授权收件人（或拥有 canFacilitatePickups 权限）
    • 源站点库存充足
    • GPS 定位（若配置了地理围栏则需在围栏内）
  3. 确认取货
  4. 自动创建转移交易
  5. 库存添加至您的个人站点

离线 QR 扫描：

  • 离线状态下缓存扫描
  • 恢复联网后处理
  • 防止重复取货（去重逻辑）

任务视图

筛选选项：

  • 所有任务
  • 分配给我的
  • 我创建的
  • 状态（待处理、进行中、已完成）

任务卡：

  • 名称与描述
  • 指派用户（头像）
  • 状态徽章
  • 资源目标摘要
  • 进度条
  • 截止日期指示器

操作：

  • 点击查看详情
  • 创建报告（快速操作按钮）
  • 查看 QR 码（若已授权且存在取货码）
  • 更新状态（进行中 → 已完成）

报告创建

快速报告流程：

  1. 从任务 → 点击"创建报告"
  2. 预填：任务、子任务、建议消耗
  3. 调整实际值（实际发生情况）
  4. 点击相机图标 → 拍摄照片
  5. 自动捕获 GPS（当前位置）
  6. 提交 → 创建消耗交易

移动端优化字段：

  • 大尺寸触控目标（按钮、输入框）
  • 用于描述的语音转文字
  • 从相机或相册上传照片
  • GPS 自动填充（或手动地图选择）
  • 最少必填字段（名称、已完成工作、消耗来源）

离线报告创建：

  • 离线状态下创建报告
  • 照片本地缓存
  • 连接恢复时自动提交
  • 服务器端数据变更时进行冲突解决

地图视图

显示的要素：

  • 所有已提交的要素（来自图层）
  • 当前位置附近的任务（邻近性筛选）
  • 您的任务以高亮显示（颜色编码）

地图控制：

  • 图层选择器（切换要素可见性）
  • 当前位置按钮（基于 GPS 重新定位）
  • 底图切换器（道路、卫星、地形）
  • 搜索（按名称/ID 查找要素）

简易绘图：

  • 点击 + 悬浮操作按钮；首次点击显示绘图工具，第二次点击激活所选工具（此双层交互机制可在小屏幕上保持界面简洁）
  • 选择几何类型（点、线、多边形）
  • 点击地图添加点位
  • 填写基本属性
  • 保存至草稿版本
  • **注意：**移动端创建的草稿与桌面端共享相同的版本/提交系统。移动用户可请求提交，但仅管理员有权批准；经批准后的最终版本将对所有人可见。

离线地图瓦片：

  • 地图瓦片已缓存（30 天有效期）
  • CacheFirst 策略（快速加载）
  • 无需网络连接即可使用
  • 重新联网时同步要素

库存转移（仅限授权人员）

拥有 canFacilitatePickups 权限的员工：

工作流程：

  1. 工人抵达仓库
  2. 出示任务 QR 码
  3. 员工代工人扫描 QR 码
  4. 系统验证：
    • 工人是授权接收方
    • 员工拥有 canFacilitatePickups 权限
    • 库存充足
  5. 完成转移
  6. 交易记录谁执行了扫描、代谁扫描以及扫描方式（自行 vs 员工协助）

手动创建转移： 员工可创建手动转移：

  • 选择源站点
  • 选择接收方
  • 选择资源与数量
  • 确认 → 创建交易

个人资料管理

可编辑字段：

  • 姓名、职位、部门
  • 电话号码（带验证）
  • 通知偏好
  • 语言选择

电话验证：

  1. 输入电话号码
  2. 点击"发送验证码"
  3. 收到含 6 位数字的短信验证码
  4. 输入验证码
  5. 电话验证完成（启用短信通知）

双因素认证：

  • 在个人资料中启用 2FA
  • 使用身份验证器应用扫描 TOTP QR 码
  • 输入 6 位数字代码确认
  • 未来登录时必须使用

移动端无法编辑：

  • 电子邮箱（安全限制）
  • 角色（管理员功能）
  • 管理员权限（管理员功能）

帮助请求

创建帮助请求：

  1. 点击"请求帮助"（从个人资料或菜单）
  2. 填写表单：
    • 主题行
    • 描述（支持语音转文字）
    • 类别（技术、访问、材料等）
    • 优先级（低、中、高、紧急）
  3. 可选：添加照片
  4. 提交 → 通知发送至相应团队

回应帮助请求：

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

离线功能

Service Worker 缓存：

  • API 响应缓存（1 小时过期）
  • 地图瓦片缓存（30 天过期）
  • 应用外壳缓存（即时加载）
  • 图像与资源缓存

离线优先操作：

  • 创建报告（联网后提交）
  • 拍摄照片（联网后上传）
  • 绘制地图要素（联网后同步）
  • 查看缓存的任务/报告

同步指示器：

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

安装说明

iOS（Safari）：

  1. 在 Safari 中打开 aptli.com
  2. 点击分享按钮（带箭头的方框）
  3. 向下滚动并点击"添加到主屏幕"
  4. 点击"添加"
  5. 应用图标出现在主屏幕上

Android（Chrome）：

  1. 在 Chrome 中打开 aptli.com
  2. 点击菜单（三个点）
  3. 点击"添加到主屏幕"
  4. 点击"添加"
  5. 应用图标出现在主屏幕上

或者：

  • 浏览器自动显示"安装应用"横幅
  • 提示时点击"安装"

更新

PWA 自动更新：

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

安全注意事项

设备端存储：

  • 会话数据在设备端安全保护
  • 敏感数据不以明文存储
  • 退出时清除所有本地数据

GPS 隐私：

  • 仅在必要时访问位置（报告、QR 取货）
  • 明确请求权限
  • 可拒绝授权（支持手动输入位置）
  • GPS 数据传输加密（HTTPS）

照片隐私：

  • 照片在本地存储直至上传
  • 上传成功后删除
  • 服务器存储加密
  • 访问由权限控制

最佳实践

安装 PWA：

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

启用通知：

  • 接收任务更新
  • 帮助请求回复
  • 取货码过期提醒

定期同步：

  • 每日打开应用（即使离线）
  • 队列操作自动处理
  • 防止大量积压

使用相机：

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

现场报告：

  • 在场时提交
  • 记忆新鲜 = 细节准确
  • GPS 自动捕获（切勿遗漏位置）

缓存地图瓦片：

  • 在线时在服务区域打开地图
  • 瓦片缓存 30 天
  • 地图支持离线使用