From 8149996107cb7e4453b177c83d99ab3515cd7e5e Mon Sep 17 00:00:00 2001
From: justin <justin@liquidator.optimal-reality.com>
Date: Thu, 28 May 2026 22:43:57 -0500
Subject: [PATCH] Add 8 DOT/FMCSA services to catalog and handler registry

Service catalog (compliance-orders.ts):
- mcs150-update: $79 (MCS-150 biennial update)
- boc3-filing: $149 (BOC-3 process agent)
- ucr-registration: $79 + $59 gov fee (UCR annual)
- dot-registration: $149 (new USDOT number)
- mc-authority: $499 + $300 gov fee (operating authority)
- dot-drug-alcohol: $199 (D&A compliance program)
- dot-audit-prep: $399 (new entrant safety audit prep)
- dot-full-compliance: $499 (bundle)

Handler registry (__init__.py):
- MCS150UpdateHandler for admin-assisted filings
- BOC3FilingHandler for process agent designations
- Other DOT services use MCS150 handler pattern (admin todo)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 api/src/routes/compliance-orders.ts  | 53 ++++++++++++++++++++++++++++
 scripts/workers/services/__init__.py | 12 +++++++
 2 files changed, 65 insertions(+)

diff --git a/api/src/routes/compliance-orders.ts b/api/src/routes/compliance-orders.ts
index 3a1af8a..66e7947 100644
--- a/api/src/routes/compliance-orders.ts
+++ b/api/src/routes/compliance-orders.ts
@@ -216,6 +216,59 @@ const COMPLIANCE_SERVICES: Record<
     erpnext_item: "STATE-PUC",
     discountable: true,
   },
+  // ── DOT / FMCSA Motor Carrier Services ──────────────────────────────
+  "mcs150-update": {
+    name: "MCS-150 Biennial Update",
+    price_cents: 7900,
+    erpnext_item: "MCS150-UPDATE",
+    discountable: true,
+  },
+  "boc3-filing": {
+    name: "BOC-3 Process Agent Filing",
+    price_cents: 14900,
+    erpnext_item: "BOC3-FILING",
+    discountable: true,
+  },
+  "ucr-registration": {
+    name: "UCR Annual Registration",
+    price_cents: 7900,
+    gov_fee_cents: 5900,    // minimum tier ($59 for 0-2 power units)
+    gov_fee_label: "UCR registration fee (tier-based, minimum shown)",
+    erpnext_item: "UCR-REGISTRATION",
+    discountable: true,
+  },
+  "dot-registration": {
+    name: "New USDOT Number Registration",
+    price_cents: 14900,
+    erpnext_item: "DOT-REGISTRATION",
+    discountable: true,
+  },
+  "mc-authority": {
+    name: "MC Operating Authority Application",
+    price_cents: 49900,
+    gov_fee_cents: 30000,   // $300 FMCSA application fee
+    gov_fee_label: "FMCSA operating authority application fee",
+    erpnext_item: "MC-AUTHORITY",
+    discountable: true,
+  },
+  "dot-drug-alcohol": {
+    name: "DOT Drug & Alcohol Compliance Program",
+    price_cents: 19900,
+    erpnext_item: "DOT-DRUG-ALCOHOL",
+    discountable: true,
+  },
+  "dot-audit-prep": {
+    name: "New Entrant Safety Audit Preparation",
+    price_cents: 39900,
+    erpnext_item: "DOT-AUDIT-PREP",
+    discountable: true,
+  },
+  "dot-full-compliance": {
+    name: "DOT Full Compliance Bundle",
+    price_cents: 49900,
+    erpnext_item: "DOT-FULL-COMPLIANCE",
+    discountable: true,
+  },
 };
 
 // ── Intake validation map ─────────────────────────────────────────────
diff --git a/scripts/workers/services/__init__.py b/scripts/workers/services/__init__.py
index 2b5c803..c923003 100644
--- a/scripts/workers/services/__init__.py
+++ b/scripts/workers/services/__init__.py
@@ -45,6 +45,9 @@ from .foreign_qualification import ForeignQualificationHandler
 from .state_puc_filing import StatePucFilingHandler
 # FCC Carrier / ISP Registration pipeline
 from .fcc_carrier_registration import FCCCarrierRegistrationHandler
+# DOT / FMCSA Motor Carrier Services
+from .mcs150_update import MCS150UpdateHandler
+from .boc3_filing import BOC3FilingHandler
 
 SERVICE_HANDLERS: dict[str, type] = {
     "flsa-audit": FLSAAuditHandler,
@@ -91,6 +94,15 @@ SERVICE_HANDLERS: dict[str, type] = {
     "cdr-storage-tier1":         CDRStorageTier1Handler,
     "cdr-storage-tier2":         CDRStorageTier2Handler,
     "cdr-storage-tier3":         CDRStorageTier3Handler,
+    # ── DOT / FMCSA Motor Carrier Services ────────────────────────────
+    "mcs150-update":             MCS150UpdateHandler,
+    "boc3-filing":               BOC3FilingHandler,
+    "ucr-registration":          MCS150UpdateHandler,  # admin-assisted, same pattern
+    "dot-registration":          MCS150UpdateHandler,  # admin-assisted
+    "mc-authority":              MCS150UpdateHandler,  # admin-assisted
+    "dot-drug-alcohol":          MCS150UpdateHandler,  # admin-assisted (partner enrollment)
+    "dot-audit-prep":            MCS150UpdateHandler,  # admin-assisted (document prep)
+    "dot-full-compliance":       MCS150UpdateHandler,  # fans out to individual services
 }
 
 # Service slugs that operate on a telecom entity — used by job_server.py