Compliance Orchestration

Phase 1: FMCSA Driver & Drug/Alcohol Compliance

Active Driver Queue

JD
John Doe
DOT Regulated
ACTIVE
AS
Alice Smith
DOT Regulated
LEGACY_PENDING
MR
Mike Ross
DOT Regulated
PROHIBITED

System Health

Clearinghouse Queries 98% Complete
Random Pool Enrollment Action Required
Gatekeeper Alert: 2 drivers selected for random testing require location verification before notification can be sent.

Immutable Compliance Ledger (Recent)

READ ONLY
Timestamp Event Type Entity Actor IP Address
2023-10-24 14:30:05 NOTIFIED_DRIVER Mike Ross (UUID...8a) System Cron 10.0.0.1
2023-10-24 10:15:22 ACTIVATED_DRIVER John Doe (UUID...2b) Admin User 192.168.1.5
2023-10-23 09:00:00 LAB_RESULT_INGEST Mike Ross (UUID...8a) External

Driver Lifecycle State Machine

Visualizing the One-Way Transition Logic

Intake
Broker Approved
Vetting
MVR/Clearinghouse Clear
Clinical
Waiting for Drug Test
Active
Dispatch Eligible

Driver: Alice Smith (Legacy Onboarding)

Constraint: Driver cannot move to ACTIVE status until Final Negative Pre-Employment Drug Test is received.
Gap-Fill UI: Legacy drivers must verify current compliance. No back-dating allowed.

Random Testing Engine (Gatekeeper)

382.305 Compliance

Workflow: Notify Driver Mike Ross

Admin has selected driver. System must verify feasibility before sending notification to avoid "Refusal to Test" liability.

System Logic: Checks distance < 45 miles, Operating Hours, Holiday Closure.

Full Compliance Ledger

This table represents the append-only `ComplianceEvent` table. No updates or deletes are permitted.

ID (UUID) Timestamp Event Type Entity ID Source IP User Agent
evt_9a8b... 2023-10-24 14:30:05 NOTIFIED_DRIVER drv_123... 10.0.0.1 Mozilla/5.0 (Cron)
evt_7c2d... 2023-10-24 10:15:22 ACTIVATED_DRIVER drv_456... 192.168.1.5 Chrome/118.0
evt_3f1a... 2023-10-23 09:00:00 LAB_RESULT_INGEST drv_123... External
evt_1b9c... 2023-10-22 16:45:00 CONSENT_SIGNED drv_456... Mobile App

Broker Magic Link View

READ ONLY ACCESS

Review: John Doe Application

Token expires in 72 hours. PII Proxy Active.

CDL Status: VALID
MVR Status: CLEAR
Clearinghouse: NO VIOLATIONS
Insurance Broker Note: