Aptli

工作履行

工作履行涵盖现场作业的完整生命周期——从规划需要完成的工作,到分配团队、授权材料领取、记录完成工作,以及验证质量。系统将规划(版本化,支持离线协作)与执行(实时,为工作人员提供即时确认)分离。

核心工作流

任务(版本化)→ 工单(实时)→ 报告(实时)→ 验证(实时)
   规划              分配          执行          质量检查

任务 — 规划阶段(版本化)

  • 管理员离线设计工作区
  • 确定资源需求与位置
  • 支持批量操作(重新设计整个活动)
  • 带回滚功能的版本/提交工作流

工单 — 分配阶段(实时)

  • 向工作人员分配带时间线的任务
  • 为受保护库存生成 QR 领料码
  • 即时确认(无需等待版本提交)
  • 灵活机制:任务量可超目标 10 倍供工人自主选择

报告 — 执行阶段(实时)

  • 工作人员记录已完成工作
  • 自动生成库存消耗交易
  • 根据实际完成工作量计算支付金额
  • 支持临时性工作(无需正式任务)

验证 — 质量检查阶段(实时,显示在报告中)

  • 质检人员核验报告准确性
  • 验证以交通灯徽章的形式显示在报告页面(无独立列表页)
  • 点击徽章打开验证模态框——无需离开报告即可查看、编辑或创建
  • 记录发现问题(数量不符、质量缺陷)
  • 多资源验证(部分通过,部分失败)
  • 严重性等级:严重、警告、信息
  • 移动端主管队列 /m/validations 保持不变

核心概念

实时执行:

  • 工单、报告、验证均实时进行(不支持版本控制)
  • 工作人员需要即时确认:"我是否需要执行此任务?"
  • 支付链要求已提交数据(不可等待管理员版本提交)
  • 库存可见性必须实时更新(下一次 QR 码扫描需准确余额)

多资源任务:

  • 单个任务可涉及多种资源(减少地图杂乱)
  • 示例:门安装 = 1 扇门 + 12 颗螺丝 + 0.5 升粘合剂
  • 进度按所有资源的平均值计算

资源目标与预留:

  • 工单显示的 resourceTargets 代表待完成目标,而非硬性预留(库存未锁定)
  • 优先级变更时可灵活调整
  • 实际分配在 QR 码扫描时执行

临时性工作:

  • 报告无需正式任务
  • 将任务关联到报告是可选操作
  • 支持计划外维护及问题响应
  • 仍会生成消耗交易和支付数据

进度计算

任务层级进度

任务中所有资源的平均完成情况。

示例:

任务 A(10 米电缆 + 10 米挖掘):
  电缆:完成 5 米 / 10 米 = 50%
  挖掘:完成 0 米 / 10 米 = 0%
  进度 = (50% + 0%) / 2 = 25%

工单层级进度

指已分配资源目标的达成进度(非完整任务量)。

示例:

工单(任务 A 提供 10 米电缆,任务 B 提供 20 米电缆):
  报告数据:任务 A 提供 5 米,任务 B 提供 10 米
  进度 = (5/10 + 10/20) / 2 = 50%

关键规则: 按分配量计算,而非任务总量。

超额交付处理

每项任务按 100% 贡献值计算,验证机制确保准确性。

示例:

工单(20 米电缆,40 米挖掘):
  报告:10 米电缆,60 米挖掘
  进度 = (10/20 + min(60,40)/40) / 2 = 75%

不可变性考量

工单和报告持久化:

  • 基础设施拆除后,工单/报告仍保留
  • 提供工作历史记录(执行内容、时间、负责人)
  • 支持软删除(可在应用设置中配置保留时长)
  • 管理员通过 viewDeleted 权限查看软删除记录

任务版本压缩:

  • 任务版本历史记录压缩存储,永不删除
  • 可回滚至先前任务定义
  • 空间冲突检测(地理区域重叠)

交易审计追踪:

  • 报告中的消耗交易不可篡改
  • 无法删除物料使用记录
  • 更正操作将新增调整交易

章节

  • 项目 — 将相关工单归组;跟踪活动级别的进度
  • 任务 — 定义工作区域及其资源需求
  • 工单 — 将工作分配给具备库存授权的用户
  • 报告 — 记录已完成的工作及资源消耗情况
  • 验证 — 以报告页面徽章形式管理的质量控制