Two portals, two audiences
SP Admin Portal
For provider managers and ops staff (e.g. Adrianna at Innate Fox). Receive incoming requests, assign investigators, track SLA, manage the team roster.
Contractor Portal
For the field investigator. See today’s assignments, get directions to the site, complete the mobile form on a phone, submit the report.
The parallel-services concept
This is the most important mental model in this section. Service Instances run alongside a journey, not inside it. [Screenshot: A journey detail page with a sidebar showing the Avenue stage tracker and, beneath it, a “Services” panel with two ServiceInstance cards (Investigation, Expert Witness) running in parallel] A client journey progresses linearly through a single Avenue at a time — Prospect → Pre-Litigation → Litigation → DNQ. That linear track is where the case status lives. Services don’t move the avenue forward. They are parallel add-ons:- A journey can have zero, one, or many ServiceInstances open at once.
- An investigation can be requested while the case sits in Pre-Litigation and keep running after the case enters Litigation.
- Each ServiceInstance has its own status, its own provider, its own staged workflow (request → assigned → in-progress → review → complete).
- Closing a ServiceInstance does not advance the journey’s avenue. Advancing the avenue does not close active services.
Investigation lifecycle at a glance
Firm requests
An attorney or paralegal opens a journey, picks Investigations in the inner nav, and creates a request — propertyAddress, tenant, priority (
STANDARD, URGENT, EMERGENCY), and any context the investigator needs.Provider receives
The request lands in the SP admin’s Investigation Requests queue with status
PENDING. They see firm name, requestor, address, and SLA implied by priority.Provider assigns
SP admin assigns an investigator (a
ServiceProviderEmployee with role INVESTIGATOR). Status flips to ASSIGNED and that contractor sees it on their dashboard.Field work
Contractor opens the assignment on their phone, gets directions, fills the mobile investigation form (per-category save, photo capture with GPS, notes). Status
IN_PROGRESS.Submission
Contractor submits. Status
PENDING_REVIEW. The submitted form lands in the firm’s Investigations review queue.Firm reviews
Attorney approves the report (or requests revisions). Approval makes the report eligible for the investigation demand-letter pipeline. Status
COMPLETED.