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.
Inspections List
The Inspections page (route /inspections) is your master queue — every order and inspection your company has ever booked, filterable, searchable, and exportable. It’s where you go to find a specific job, check status across the team, and triage what needs attention.
This article covers the list view. To create a new order, see Order Creation Wizard. To drill into one order, see Inspection Details. To edit a finalized inspection’s report, see Inspection Reviewer.
What you see when you open it
[SCREENSHOT: inspections-list.png — desktop, the Inspections page with a view toggle at the top (Inspections | Quotes), a row of filters (search, status, date range), a + New Order button, and a paginated table below with columns for order number, client, address, scheduled date, inspector, status badge, and actions.]
The top of the page has:
- A view-mode toggle — Inspections (the default) or Quotes (the leads waiting to be converted to orders)
- A search field — matches across order number, client name, and property address
- A status filter — All / Scheduled / Assigned / In Progress / Completed / Cancelled
- A date-range filter — From / To dates
- A + New Order button (top-right) — opens the Order Creation Wizard
Below, the paginated table of orders.
The view-mode toggle
The toggle changes the underlying Firestore collection the page reads from:
| Toggle | Reads from | What appears |
|---|
| Inspections (default) | artifacts/{tenant}/public/data/inspections | Confirmed orders and their inspections |
| Quotes | artifacts/{tenant}/public/data/leads | Submitted quotes / leads not yet converted to orders |
Quotes come from two sources:
- Mobile Field Quote — inspectors generate them on-site
- Public booking — homeowners submit them through
/book or /book/:slug on your white-label site
Toggle to Quotes to see the lead queue and convert promising ones into orders via the wizard.
Filters
All filters compose with AND logic — every active filter must match.
| Filter | What it matches |
|---|
| Search term | Substring match (case-insensitive) on order number, client name, and property address |
| Status | Exact status match. The pending and assigned statuses are both represented; UI displays uppercase (ASSIGNED) |
| Date From / Date To | Matches the inspection’s scheduledDate within the range. Master orders without their own date use the next-upcoming child’s date |
Filters apply client-side after the Firestore query — large historical lists may be slower to filter than to load.
Table columns
The default columns:
| Column | Source field | Notes |
|---|
| Order # | inspectionNumber | Monospace; click to drill into Inspection Details |
| Client | clientName | Primary client name only — co-client not shown |
| Property | inspectionAddress | Single-line; full address in details view |
| Scheduled | scheduledDate | Date + time. Master orders show the next-upcoming child phase. |
| Inspector | assignedInspectorName | The inspector assigned to the next-upcoming phase, or — if unassigned |
| Type | inspectionType | ”Residential Property Inspection” / “New Construction Phase 1” / etc. |
| Template | templateName | The template assigned (drives what the mobile app shows) |
| Total | totalAmount | Gross billing for the order (currency-formatted) |
| Payment | paymentStatus | A pill: paid / pending / partial / refunded |
| Status | status | Color-coded pill — see Status colors below |
| Actions | — | Per-row icon buttons |
Status colors
| Status | Pill color |
|---|
scheduled | Default (gray) |
assigned | Primary (royal blue) |
in_progress | Warning (amber) |
completed | Success (green) |
cancelled | Error (red) |
The underlying data may carry uppercase variants (PENDING, COMPLETED) from older or web-admin-side writes. The list normalizes lowercase for display.
Per-row actions
The Actions column on each row exposes icon buttons:
| Icon | Action |
|---|
| 👁 View | Navigate to Inspection Details for the order |
| ✏ Edit | Open the order in edit mode — opens an InspectionForm dialog |
| 🔗 Assign | Quickly change the assigned inspector (multi-phase: changes the next-upcoming phase) |
| 🔳 QR Code | Show the team-inspection QR (for orders that allow team capture) |
| 🗑 Delete | Delete the order — with confirmation dialog |
Deletion safety
Tapping Delete opens a confirmation:
Are you sure you want to delete this inspection?
[Cancel] [Delete]
Deletion removes the order document and (separately) any associated child inspections. The action does not delete uploaded media — photos remain in Google Cloud Storage and would need to be cleaned up via a maintenance script if you want to fully expunge.
Recommend marking as cancelled instead of deleting. Cancelled orders remain in the list (filterable), keep their history, and can be referenced for reporting. Deletion erases the audit trail.
Multi-phase orders — master + children
Multi-phase orders (New Construction Phase 1 / 2 / Final) have a master order document plus per-phase child inspection documents. The list shows the master, hides the children to keep things readable.
When the master is opened in Inspection Details, the children appear in the Inspections tab.
The scheduled date shown on a master order row resolves as:
- Next upcoming child phase’s
scheduledDate (where status is not completed/cancelled)
- If all phases done, the last completed phase’s date
- If neither, the master’s own
scheduledDate
- If still none, blank
Legacy standalone inspections
Older inspections written before the master/child architecture (pre-Phase 6.1) have no projectId. The list shows these as their own rows regardless of ID format — your historical inspections do not disappear.
Default page size: 20 rows. Adjust with the page-size selector at the bottom (10 / 20 / 50 / 100). Page count and total row count are displayed.
The Firestore query loads all matching documents up-front (client-side sort + filter). For tenants with thousands of historical inspections, expect a moment of latency on the initial load — subsequent pagination is instant.
When you change a filter, pagination resets to page 1. Status changes do the same. The filter state is not persisted across page reloads — refreshing the page returns you to defaults.
Empty states
| Condition | Display |
|---|
| No inspections in your account | ”No inspections yet — tap + New Order to create your first.” |
| Filters return nothing | ”No matches — try widening your filters.” |
| Quotes view, no leads | ”No quotes — leads from mobile Field Quote and public booking will appear here.” |
| Error loading | An MUI Alert with the error message |
Creating a new order
The + New Order button (top-right) opens the Order Creation Wizard at /inspections/new. The wizard walks through client info, property, services, pricing, scheduling, and review.
You can also create an order indirectly:
- Convert a quote — open the Quotes view, click a lead, “Convert to Order” runs the wizard pre-filled
- From the Dashboard — Quick Actions tile
What this page does NOT do
- It does not show individual deficiencies. That’s the inspection-detail and Inspection Reviewer workspace.
- It does not run reports or analytics. That’s the Reports tab.
- It does not send messages or contracts. That’s the Comms Cockpit and Contracts Cockpit for bulk operations, or the per-order detail page for one-offs.
- It does not edit pricing rules. That’s Pricing Manager.
Tips
- Bookmark
/inspections?status=in_progress if you want to land on “what’s happening today” every morning.
- Use the Quotes toggle weekly to clear out stale leads. The Field Quote and public booking flows pile up; a Monday review keeps the queue clean.
- For multi-inspector teams, sort by Inspector to see what each person’s day looks like.
- Date range From=today, To=today is your “today’s calendar” view without needing the calendar integration.
Related articles