Glossary
Quick reference for Aptli-specific terms used throughout the platform and this guide.
Data & Records
Versioned model
Records that go through a draft → diff → commit cycle before changes become permanent. Versioned records support offline editing, undo/redo, conflict detection, and a full version history. In Aptli, map features (points, linestrings, polygons, layers, schematics) and tasks use the versioned model.
Contrast with: Real-time model
Real-time model
Records that save immediately to the server with no staging step. Changes are visible to all users instantly. Work orders, reports, validations, transactions, and sites use the real-time model.
Contrast with: Versioned model
Draft
A set of local changes to versioned records that have not yet been committed to the server. Drafts are stored in the browser and persist across page refreshes without network access. A user can have one active draft per version. Drafts can be uploaded to the server for admin review before going live.
Commit
The act of applying a draft's changes permanently to the live dataset. Commits create a new immutable entry in the version history. Only users with the allowCommits admin right can commit.
Version conflict
Occurs when two users have edited the same feature in separate offline drafts. Aptli detects conflicts on commit by comparing the base version each draft was built from against the current live version. Conflicting commits are flagged for admin review and cannot be applied until resolved — no silent overwrites.
Inventory
Resource
A definition of a material, consumable, equipment type, or labor category. Resources define the unit of measure, optional unit conversions, and whether picking up the resource requires a facilitator. Examples: 500 m fiber cable, concrete anchor bolt, installation crew hour.
Stock Item
The current balance of a specific resource at a specific site. Stock items are updated exclusively by transactions — they are never edited directly. A resource can have stock items at multiple sites simultaneously.
Site
A physical or logical location that holds inventory. Sites include warehouses, storage yards, field depots, individual worker "personal sites," and vehicles. Each user can have a personal site that receives inventory from QR pickup scans.
Transaction
An immutable ledger entry recording every inventory movement. Transactions cannot be edited or deleted — corrections are always made by creating a new adjustment transaction. Transaction types:
| Type | Description |
|---|---|
| Receipt | New inventory arriving at a site |
| Transfer | Stock moved from one site to another |
| Consumption | Stock used on a job, linked to a field report |
| Adjustment | Manual correction with a reason code |
| Return | Unused materials returned to a site |
Pickup Code
A time-limited, digitally signed QR code issued when a work order is assigned. Field workers scan the pickup code at a warehouse to authorize and receive their allocated materials. Pickup codes encode the authorized resource quantities, the assignment they belong to, and an expiry time. Only the assigned worker — or a user with the canFacilitatePickups right — can scan them.
Transfer Code
A digitally signed QR code that authorizes a peer-to-peer stock transfer between sites. Unlike pickup codes, transfer codes are not tied to a work order. They can be generated for any site-to-site movement and scanned by the recipient to execute the transfer and record the transaction automatically.
Work Fulfillment
Task
A geospatially-located unit of planned work with defined resource requirements. Tasks are versioned — they go through draft → commit like map features. A task can be located at a point (a manhole), a linestring (a road segment), a polygon (a subdivision), or left unlocated for office work. Tasks belong to projects and are fulfilled through work orders.
Work Order
An allocation of one or more tasks to a team, with a due date and optional pickup code for materials. Work orders track status (pending → in-progress → completed) in real time. Also referred to as an assignment.
Report
A field worker's record of completed work. Reports capture what was done, GPS location, resources actually consumed, and photos. Reports can be submitted against a formal task or ad-hoc for unplanned maintenance. Submitting a report triggers automatic stock deductions and notifies supervisors.
Validation
A supervisor's QA review of a submitted report. Validations record the outcome (pass / fail / needs-revision / approved) and any findings. A failed or needs-revision validation returns the report to the worker; an approved validation can trigger payment release calculations.
Project
A group of related tasks sharing a due date and team assignment. Projects provide a high-level progress view across all their tasks and reports.
Security & Access
Admin Rights
Permissive grants that control what a user can do. Aptli has 40+ granular admin rights covering every create, read, update, and delete action in the system. Examples: workOrdersCreate, reportsDelete, allowCommits, canFacilitatePickups, canRunAiQueries. Admin rights are additive — a user with no rights can only read their own assignments.
Role Restriction
Restrictive field-level filters that control what data a user cannot see. Role restrictions are enforced server-side: unauthorized data is never sent to the client, not merely hidden in the UI. Example: a restriction on assignedTo = currentUser limits a contractor to seeing only their own work orders. Role restrictions and admin rights operate as two independent layers.
Map & GIS
Layer
A named collection of map features sharing a geometry type (points, linestrings, or polygons) and a visual style (icon, color, line weight). Layers define what a feature is — for example, a "Telephone Poles" layer or a "Duct Routes" layer. Layers are versioned.
Schematic
A relationship diagram that models connections between map features or abstract objects. Schematics use a graph editor (nodes and directed edges) to represent network topology, cable paths, conduit fill, or any other relationship that is difficult to express on a geographic map alone. Schematics are versioned.
Draw Staging
A temporary editing area where geometry is drawn and refined before being committed to permanent map features. Draw staging allows complex edits — freehand drawing, snapping, multi-feature operations — to be reviewed before they go live.