End-to-End Workflows
Three complete operational flows — from first carrier upload to final investigator review.
Carriers create incidents, upload evidence, ingest CDRs, and share with government agencies — all within an org-isolated secure environment.
1. Create an Incident
carrier_adminLog in to the Carrier Portal and click "New Incident". Enter a case number, title, priority level, and initial status. The incident is scoped to your organization — no other carrier can see it.
POST /carrier/incidents2. Upload Evidence
carrier_adminOpen the incident page and go to the Evidence tab. Select a file, choose the evidence type (CDR, recording, log, document, etc.), retention class, and source. The system generates a presigned S3 URL — your file uploads directly to the vault. SHA-256 is computed in-browser and verified on completion.
POST /evidence/init → S3 PUT → /evidence/complete3. Create a CDR Mapping Profile
carrier_adminOn the Carrier Portal dashboard, click "New Profile" to define how your carrier's CDR columns map to the TIGER canonical schema. Map at minimum: orig_tn, dest_tn, start_time_utc. The profile is reusable across incidents.
POST /carrier/cdr-mappings4. Import CDR Batch
carrier_adminOn the CDR Import tab of the incident page, select your mapping profile and upload a CSV file. TIGER normalizes every row into the canonical schema, assigns a TGX-CDR key to each record, and computes a call fingerprint for deduplication. Row counts and error logs are shown immediately.
POST /incidents/{id}/cdr-batches5. Share with Government
carrier_adminWhen the investigation is ready for agency review, change incident visibility to "Shared with Agency" or assign a specific government org. The assigned agency can now see the incident, evidence list, CDR records, and victim reports — with read-only access.
POST /gov/incidents/{id}/shareGovernment investigators review assigned incident packages — evidence, CDR records, and victim reports — and manually correlate reports to call records.
1. Sign In to Government Portal
gov_admin / gov_analystGovernment investigators with gov_admin or gov_analyst credentials log in at /login. Role-based routing automatically directs them to /gov. No carrier data is accessible until explicitly assigned.
POST /auth/login → GET /me2. Review Assigned Incidents
gov_analystThe Government Portal dashboard shows all incidents your agency has been assigned to, or that have been shared platform-wide. Click "Review" on any incident to open the detail view.
GET /gov/incidents3. Inspect Evidence
gov_analystOn the Evidence tab of the incident page, review uploaded files: filename, evidence type, source, file size, SHA-256 hash, upload status, and download link (if available). Government users cannot upload — read-only review only.
GET /incidents/{id}/evidence4. Review CDR Records
gov_analystThe CDR Records tab shows normalized call detail records for the incident. Filter by batch, originating number, or destination number to focus on specific call clusters. All records display in canonical TIGER format regardless of the original carrier format.
GET /incidents/{id}/cdr-records5. Review Victim Reports
gov_analystThe Victim Reports tab shows all corroborating submissions linked to this incident. Each report shows the victim's phone, caller number, reported call time, narrative, and current match status.
GET /incidents/{id}/victim-reports6. Manually Link Report to CDR
gov_adminFor unmatched or ambiguous victim reports, gov_admin users can manually select a specific CDR record and link the two. A CDRReportLink record is created with link_type=manual. The action is logged in audit_events.
POST /gov/victim-reports/{id}/linkVictims submit corroborating reports anonymously. Automatic CDR matching is attempted. A tracking token lets them check status without logging in.
1. Receive or Find the Reporting Link
PublicVictims may receive a direct link from their carrier (e.g., tigerex.us/victim), or find the public reporting portal from any browser. No account, login, or registration is required.
Public — no auth2. Submit Your Report
PublicFill in the report form: your phone number, the number that called you, the approximate call time and date, and a narrative of what happened. Contact information is optional. Submit — you'll receive a tracking token immediately.
POST /victim/report3. Automatic Matching
SystemTIGER's heuristic engine attempts to match your report against CDR records from carrier submissions. Matching is based on victim phone, caller number, and call time proximity. If a high-confidence match is found, matched_cdr_id is set automatically.
Internal — CDR matching service4. Check Your Report Status
PublicUse your tracking token at /victim/report/[token] to check the current status of your submission: unmatched, matched, multiple candidates, or needs review. No personal information is returned — only match status and review state.
GET /victim/report/{token}5. Investigator Review
gov_adminIf your report enters "needs_review" or "multiple_candidates" status, a government investigator will manually review it and link it to the correct CDR record. Your privacy is protected — investigators only see the call metadata.
POST /gov/victim-reports/{id}/link