Back to selected workCase study 03 / 09
WebActive

EigenMC

Full-stack FMCSA motor-carrier intelligence SaaS with a public product site, authenticated React dashboard, FastAPI backend, PostgreSQL data model, admin controls, lead workflows, CSV exports, usage limits, and a resilient TypeScript scraping pipeline.

EigenMC project interface
EigenSol / Selected workEigenSol

Project brief

Inside the build.

EigenMC is a full SaaS platform for searching, filtering, managing, and exporting FMCSA motor-carrier data. It combines a public marketing site, authenticated dashboard, FastAPI backend, PostgreSQL database, admin tools, and a dedicated scraping pipeline.

The product turns public carrier registry data into a practical workflow for prospecting, contact discovery, lead conversion, follow-up management, account administration, and data access control.

Client
EigenSol
Delivery role
Full-Stack Product Engineering
Discipline
Web
Project status
Active

Challenge & response

Turning constraints into a working system.

The challenge

FMCSA carrier data is public, but direct usage is slow and fragmented. Users need fast filtering across large datasets, reliable contact access, CSV exports, and a workflow for turning carrier records into leads.

The platform also needed commercial access controls such as view quotas, contact export limits, subscription states, session limits, and admin-managed user permissions.

On the data side, the scraper had to tolerate blocked responses, proxy failures, interrupted jobs, retry loops, and long-running refresh operations.

The response

  1. Built a React and Vite dashboard with carrier search, URL-backed filters, server-side pagination, CSV export, redacted rows, detail views, lead conversion, lead pipeline management, and admin workspaces.

  2. Implemented a FastAPI backend with JWT sessions, role-based access, carrier search APIs, leads APIs, dashboard snapshots, admin controls, subscriptions, custom limits, export quotas, and PostgreSQL persistence.

  3. Created a modular TypeScript scraper with jobs, tasks, parsers, consumers, checkpoints, persistent retry, proxy handling, database output modes, and operational documentation.

  4. Added a lightweight static product website for EigenMC’s public-facing marketing and conversion surface.

Product capabilities

What the delivery makes possible.

Each capability connects a product requirement to something people can use.

01

Carrier Search Workspace

Users can search and filter carriers by MC range, keyword, state, city, entity type, FMCSA status, internal status, contact availability, equipment, inspection data, and lead state.

02

Quota-Aware Data Access

The backend enforces view quotas, redacted carrier rows, export quotas, subscription state, and custom user limits so access can be controlled commercially.

03

Lead Pipeline

Carriers can be converted into leads and managed across new, follow-up, active, failed, completed, and archived states with notes, follow-up scheduling, bulk actions, and CSV export.

04

Admin And Super-Admin Controls

Admins can manage users, roles, active status, temporary passwords, assigned admins, allowed sessions, subscriptions, custom limits, and broader platform settings.

05

Dashboard Snapshots

The API provides single-call user, admin, and super-admin dashboard snapshots to avoid noisy multi-request frontend loading patterns.

06

Resilient Scraping Pipeline

The TypeScript scraper supports FMCSA SAFER and SMS scraping, checkpoint resume, persistent retry, proxy pools, batch-level retries, MC-level retries, database consumers, and file outputs.

System architecture

A connected delivery, not isolated features.

  1. The static EigenMC marketing site presents the product separately from the SaaS dashboard.

  2. The React dashboard consumes FastAPI endpoints for authentication, carriers, leads, dashboards, admin workflows, dialers, limits, and settings.

  3. FastAPI owns authentication, roles, subscriptions, carrier access rules, lead management, exports, and admin operations over PostgreSQL.

  4. The scraper fetches FMCSA data, parses and normalizes records, checkpoints progress, retries failed work, and writes results to PostgreSQL or export files.

Delivered impact

What changed after the build.

  1. Turned raw FMCSA registry data into a searchable, quota-controlled carrier intelligence product.

  2. Connected search directly to business actions: contact copying, dialer links, CSV exports, lead conversion, follow-ups, and admin-managed access.

  3. Created a production-minded ingestion pipeline that can resume interrupted runs, retry blocked records, rotate proxies, and keep the SaaS database fresh.

Built with

A stack selected for the work.

  • React 18
  • TypeScript
  • Vite 6
  • Tailwind CSS 4
  • Radix UI
  • Redux Toolkit
  • React Query
  • TanStack Table
  • React Hook Form
  • Zod
  • FastAPI
  • SQLAlchemy
  • PostgreSQL
  • Alembic
  • Pydantic
  • JWT Auth
  • TypeScript Scraper
  • Node.js
  • undici
  • htmlparser2
  • cheerio
  • curl-cffi
  • Playwright
  • Vitest
  • Cloudflare Tunnel
  • EC2

Start a conversation

Have a product challenge worth solving?

Tell us what needs to change, what already exists, and where the product needs to go next.

Discuss your project