Aptli User Guide
Aptli simplifies tracking and maintenance of real-world assets, enabling teams to collaborate on complex jobs, deploy standards for representing assets, and enable multiple views on progress, relationships, and network health.
The following sections cover the major areas of the guide. Use the navigation boxes below to jump directly to a topic.
Key Concepts
Versioned vs Real-Time:
- Versioned Models - GIS features, layers, schematics support offline collaboration with version history
- Changes tracked locally until Submit
- Version controls always visible (Submit, Undo, Redo, Resync)
- Uncommitted changes badge shows pending work
- Spatial conflict detection when multiple users edit same area
- See Version Management
- Real-Time Models - Assignments, reports, transactions provide immediate confirmation for execution workflows
- No offline drafting (changes save immediately)
- No version history (operational data)
- Worker sees updates instantly
Security Layers:
- Authentication - Who you are (passwords, 2FA, OAuth)
- Admin Rights - What you CAN modify (permissive grants)
- Role Restrictions - What you CANNOT see (restrictive filters)
- Server-Side Enforcement - Data truly doesn't exist for unauthorized users
Immutability:
- Map feature versions compressed, never deleted
- Inventory transactions create audit trail, corrections add new records
- Soft deletes for assignments/reports (configurable retention)
What's In Aptli
Map & GIS
Draw, import, and manage geographic features (points, lines, polygons) with version history and conflict detection. Import GDB, SHP, GeoPackage, DXF, and DGN files via the background import pipeline. See Field Operations and GIS Imports.
AI Assistant
Ask questions about your data in plain language. The AI toolbar searches local features first, then the server database, then falls back to the configured AI provider. Draw an AI Lasso on the map to query any geographic area against OSM context. See AI Assistant.
Work Fulfillment
Plan tasks → create work orders → submit reports → validate quality. Work orders support QR-code-based inventory pickup authorization and send notifications when due dates approach or pickup codes are about to expire. See Work Fulfillment.
Projects
Group work orders into campaigns and track aggregate progress. Project managers track progress and set project status manually. See Projects.
Inventory
Track stock items, sites, and every movement via an immutable transaction log. Receive shipments by scanning from a printed resource QR code reference book. See Inventory Management.
Notifications
Push notifications and a personal calendar/ICS feed keep field workers informed of work order changes, due-date warnings, and pickup code expirations. See Notifications.
Automations
Define trigger-based rules that fire automatically — notify a team when an import completes, post to a webhook when a work order status changes, chain actions together. See Automations.
Admin Review Queue
Field-submitted GIS versions wait for admin approval before going live. Admins review the diff, preview the map changes, and commit or reject. See Version Review Queue.