TIGER — Telecom Incident Gateway for Evidence Reporting
Operational Workflows

End-to-End Workflows

Three complete operational flows — from first carrier upload to final investigator review.

📡
Carrier Workflow

Carriers create incidents, upload evidence, ingest CDRs, and share with government agencies — all within an org-isolated secure environment.

Open Carrier Portal →
📋

1. Create an Incident

carrier_admin

Log 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/incidents
🔒

2. Upload Evidence

carrier_admin

Open 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/complete
🗺️

3. Create a CDR Mapping Profile

carrier_admin

On 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-mappings
📞

4. Import CDR Batch

carrier_admin

On 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-batches
📤

5. Share with Government

carrier_admin

When 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}/share
🏛️
Government Investigator Workflow

Government investigators review assigned incident packages — evidence, CDR records, and victim reports — and manually correlate reports to call records.

Open Government Portal →
🔐

1. Sign In to Government Portal

gov_admin / gov_analyst

Government 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 /me
📋

2. Review Assigned Incidents

gov_analyst

The 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/incidents
🔒

3. Inspect Evidence

gov_analyst

On 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}/evidence
📞

4. Review CDR Records

gov_analyst

The 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-records
🛡️

5. Review Victim Reports

gov_analyst

The 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-reports
🔗

6. Manually Link Report to CDR

gov_admin

For 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}/link
🛡️
Victim / Witness Workflow

Victims submit corroborating reports anonymously. Automatic CDR matching is attempted. A tracking token lets them check status without logging in.

File a Report →
🔗

1. Receive or Find the Reporting Link

Public

Victims 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 auth
📝

2. Submit Your Report

Public

Fill 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/report
🤖

3. Automatic Matching

System

TIGER'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 service
🔍

4. Check Your Report Status

Public

Use 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_admin

If 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
View Architecture →← Home