Aptli

Work Fulfillment

Work fulfillment covers the full lifecycle of field operations — from planning what needs to be done, to assigning crews, authorizing material pickups, capturing completed work, and verifying quality. The system separates planning (versioned, supports offline collaboration) from execution (real-time, immediate confirmation for workers).

Core Workflow

Tasks (Versioned) → Work Orders (Real-Time) → Reports (Real-Time) → Validations (Real-Time)
   Planning              Allocation              Execution            Quality Check

Tasks - Planning Phase (Versioned)

  • Admins design work areas offline
  • Define resource requirements and locations
  • Batch operations supported (redesign entire campaign)
  • Version/commit workflow with rollback capability

Work Orders - Allocation Phase (Real-Time)

  • Allocate tasks to workers with timelines
  • Generate QR pickup codes for protected inventory
  • Immediate confirmation (no waiting for version commits)
  • Flexible: 10x more tasks than targets for worker choice

Reports - Execution Phase (Real-Time)

  • Workers document completed work
  • Auto-create inventory consumption transactions
  • Payment calculation based on actual work completed
  • Ad-hoc work supported (no formal task required)

Validations - Quality Check Phase (Real-Time, Shown on Reports)

  • QC staff verify report accuracy
  • Validations appear as traffic-light badges on the reports page (no standalone list page)
  • Click a badge to open the validation modal — view, edit, or create without leaving the report
  • Record findings (volume mismatches, quality issues)
  • Multi-resource validation (some pass, some fail)
  • Severity levels: critical, warning, info
  • Mobile supervisor queue at /m/validations is preserved

Key Concepts

Real-Time Execution:

  • Work orders, reports, validations operate in real-time (not versioned)
  • Workers need immediate confirmation: "Do I have this work?"
  • Payment chain requires committed data (can't wait for admin version commit)
  • Stock visibility must be current (next QR scan needs accurate balance)

Multi-Resource Tasks:

  • Single task can require multiple resources (reduces map clutter)
  • Example: Door installation = 1 door + 12 screws + 0.5L adhesive
  • Progress calculated as average across all resources

Resource Targets vs Reservations:

  • Work orders show Resource Targets = goals to accomplish
  • NOT hard reservations (inventory not locked)
  • Allows flexibility when priorities change
  • Actual allocation happens at QR pickup scan time

Ad-Hoc Work:

  • Reports don't require formal tasks
  • Linking a task in the report is optional
  • Supports unplanned maintenance, issue responses
  • Still creates consumption transactions and payment data

Progress Calculation

Task-Level Progress

Average completion across all resources in task.

Example:

Task A (10m cable + 10m digging):
  Cable: 5m completed / 10m = 50%
  Digging: 0m completed / 10m = 0%
  Progress = (50% + 0%) / 2 = 25%

Work Order-Level Progress

Progress toward assigned resource targets (not full task volumes).

Example:

Work order (10m cable from Task A, 20m cable from Task B):
  Reported: 5m from Task A, 10m from Task B
  Progress = (5/10 + 10/20) / 2 = 50%

Key Rule: Calculate against assigned amount, not full task volume.

Over-Delivery Handling

Cap contributions at 100% per task, validation verifies accuracy.

Example:

Work order (20m cable, 40m digging):
  Reported: 10m cable, 60m digging
  Progress = (10/20 + min(60,40)/40) / 2 = 75%

Immutability Considerations

Work Orders and Reports Stay:

  • When infrastructure demolished, assignments/reports remain
  • Provides work history (what was done, when, by whom)
  • Soft deletes supported (configurable retention in app settings)
  • View Deleted admin right to see soft-deleted records

Task Versions Compressed:

  • Task version history compressed, never deleted
  • Rollback to previous task definitions possible
  • Spatial conflict detection (overlapping geography)

Transaction Audit Trail:

  • Consumption transactions from reports immutable
  • Cannot erase material usage
  • Corrections add new adjustment transactions

Sections

  • Projects - Group related work orders; track campaign-level progress
  • Tasks - Define work areas with resource requirements
  • Work Orders - Allocate work to users with inventory authorization
  • Reports - Document completed work and consumption
  • Validations - Quality control managed as badges on the reports page