Documentation Index
Fetch the complete documentation index at: https://help.1nspect.app/llms.txt
Use this file to discover all available pages before exploring further.
Assigning Inspectors & Handoff
This workflow article covers everything related to assignment and handoff — how an order moves from the office to an inspector’s mobile device, how multi-inspector teams collaborate via the Team QR feature, and what happens when an inspector is reassigned mid-engagement.
When you use these flows
- Daily — assigning each new order to an available inspector
- Multi-inspector teams — coordinating field work with the Team QR feature
- Reassignment — when an inspector calls in sick, has a conflict, or a job needs reassignment
- New hire — onboarding a new inspector and routing their first jobs
Single-inspector assignment
The basic flow:
- In the Order Creation Wizard → Step 2 (Full Order Creation), the Assigned Inspector field. Pick from the dropdown of your team’s inspectors.
- Save. The order is written to Firestore with
assignedInspectorName set.
- The mobile app picks it up. The inspector’s Assigned Inspections screen has a real-time Firestore listener — the new order appears within seconds of save.
- The inspector starts work. Their mobile app’s Start Inspection button is enabled (after contract gate passes).
Visibility rules
The mobile Assigned Inspections list filters on all of these (BITE 68.3):
assignedInspectorName = the signed-in inspector’s identitystatus in (assigned, in_progress)- Contract activity:
skipWorkflow: true OR contractStatus is set to something other than pending_review
- Scheduled within 30 days
An inspection assigned to someone else, or with no contract activity, or more than 30 days out, is invisible to the inspector.
Reassignment
When: Original inspector can’t make the appointment.
How:
- Open the order in Inspection Details
- Change the Assigned Inspector field (or use the per-row Assign action on the Inspections List)
- Save
System changes:
assignedInspectorName updates to the new inspector- The old inspector’s Assigned Inspections loses this card within seconds
- The new inspector’s list gains it within seconds
- An optional notification email fires (if you’ve wired one to a
inspection.assignment_changed trigger or similar)
Local data: If the original inspector had already opened the inspection (downloading template + narrative library), the local data remains on their device. It does no harm but takes up storage. Inspectors can delete from Archived Inspections periodically.
Multi-phase orders — different inspectors per phase
For New Construction or other multi-phase orders, you can assign different inspectors to different phases:
| Phase | Assigned to |
|---|
| Phase 1 (Foundation) | Inspector A |
| Phase 2 (Frame & Mech) | Inspector A |
| Final | Inspector B |
assignedInspectorName. Change one without affecting the others.
Phase gating
By default, Phase 2 cannot begin until Phase 1 is completed. This is enforced on the mobile Assigned Inspections screen — Phase 2’s card is visible but the Start button is disabled with a tooltip.
To override (allow concurrent phases), there’s a disablePhaseGating flag on the order — configurable in the Order Wizard or via support for legacy orders.
Team QR — multi-inspector concurrent capture
For large properties where two or three inspectors work together on the same inspection, the Team QR feature lets all of them capture against the same inspection record.
Enabling
In the Order Creation Wizard → Step 2, toggle Allow Team Inspection: ON.
This sets allowTeamInspection: true on the inspection. The primary assigned inspector sees the Team QR button on their Assigned Inspections card.
Joining
The primary inspector taps Team QR to display a QR code modal:
🔬 Team Inspection QR Code
1937 Kalli Jo Ln, Austin TX
[ ▓▓▓▓▓▓▓▓▓ ]
[ ▓ QR Code ▓ ]
[ ▓▓▓▓▓▓▓▓▓ ]
Share this QR code with team members to join the inspection
{"type": "inspection", "inspectionId": "<id>", "timestamp": <unix-ms>}.
Secondary inspectors:
- Open the 1nspecT mobile app, signed in as themselves
- Tap the QR scan action (typically in the Home or Assigned Inspections view)
- Scan the displayed code
- The mobile app joins them to the inspection — they can capture findings against it
Sync mode for team inspections
When a team inspection has multiple active inspectors, EcoSync switches from Solo-Eco (15-min heartbeat) to Team-Live (real-time sync). All inspectors see each other’s findings within seconds.
Team-Live battery cost
The 15-minute heartbeat is significantly more battery-efficient than real-time. On a long inspection, expect Team-Live to drain ~30% more battery than Solo-Eco. Bring a charger or limit team inspections to shorter properties.
What gets captured per inspector
When multiple inspectors capture on the same inspection:
| Field | How it resolves |
|---|
assignedInspectorName | Stays as the primary inspector (the one assigned in the Order Wizard) |
Per-finding capturedBy | The inspector who saved that specific finding |
inspections.startedAt | First inspector to tap Start |
inspections.completedAt | Last inspector — only the primary can tap Finalize |
Calendar integration during assignment
If Calendar Integration is connected, the Order Creation Wizard checks the assigned inspector’s calendar for conflicts. The dropdown surfaces:
| Indicator | Meaning |
|---|
| ✅ Available | No conflicts at the proposed time |
| ⚠ Busy | Existing event during the inspection window |
| 🔄 Tentative | Existing event marked tentative |
Handoff: when the inspector finishes
After the inspector marks the inspection complete on mobile:
- The inspection moves out of Assigned Inspections and into Archived Inspections on their device
- The web admin’s Inspection Reviewer becomes available
- The operator (typically not the inspector) picks up the report-finalization work
- The inspector’s mobile work is done — they’re free for the next job
This is the “handoff moment” between field capture and report finalization. The same person can do both, or different people can — the platform doesn’t enforce role separation here.
Errors and recovery
| Symptom | Cause | Fix |
|---|
| Inspector doesn’t see assigned inspection | Network issue or wrong identity match | Verify the inspector’s name matches assignedInspectorName exactly. Field is case-sensitive in older orders. |
| Team QR scan doesn’t join | Secondary inspector signed into wrong tenant | Both inspectors must be on the same tenant |
| Multi-phase Start button still disabled | Phase 1 isn’t marked completed yet | Have the Phase 1 inspector tap Finalize first |
| Reassignment doesn’t sync | Firestore latency or stale listener | Pull-to-refresh on Assigned Inspections |
Related articles
