System Architecture Guide

J.A.R.V.I.S.

JUST A RATHER VERY INTELLIGENT SYSTEM

A comprehensive AI-powered platform for automotive sales, service, and fleet management. Integrating lead generation, vehicle intelligence, and real-time diagnostics.

Lead Engine
Vehicle KB
Scan Tool
01

Core System Pillars

Three integrated components forming the foundation of X.OS v2.1

Lead Generation & Communication Engine

Podium-inspired front-end for capturing, nurturing, and managing customer interactions across all channels.

BUILD PENDING

Vehicle Knowledge Base

Central data repository containing static vehicle specifications and dynamic, real-time diagnostic data.

OPERATIONAL

Scan Tool Integration

Data pipeline feeding live vehicle information from Autel Bluetooth diagnostic tools into the knowledge base.

OPERATIONAL
02

Lead Generation Engine

Multi-channel lead capture and communication system inspired by the best in class

Spider Funnel

Unified inbox ingesting leads from web, SMS, social, phone, Google, and third-party sites.

Enhanced Messaging UX

Modern chat UI with pre-chat info capture and seamless webchat-to-SMS transition.

Visual Lead Pipeline

Kanban-style drag-and-drop board for managing leads through customizable sales stages.

Automated Drip Campaigns

Event-triggered, intelligent follow-up sequences with smart auto-cancellation.

Spider Funnel Visualization
SPIDER FUNNEL

Every channel converges into a single unified inbox. No lead slips through.

CAPTURE CHANNELS
Web
Phone
SMS
Email
Social
Google
03

Vehicle Knowledge Base

Two-part database combining static manufacturer specs with live diagnostic data

Static Vehicle Database

All manufacturer-provided specifications for every vehicle, populated via API integrations.

Mercedes-BenzPRIMARY
api.mercedes-benz.com/vehicle_specifications/v1

Full specs, equipment, options, paint/upholstery by VIN

NHTSA vPICFALLBACK
vpic.nhtsa.dot.gov/api/

Make, model, year, engine by VIN

Other OEMsEXTENDED
CarQueryAPI / Auto-Data.net

Comprehensive specs for all manufacturers

Dynamic Vehicle Database

Live, vehicle-specific data obtained from diagnostic scans. Provides J.A.R.V.I.S. with real-time health and status.

DTCs

Diagnostic Trouble Codes with freeze frame data

Live Sensors

Temps, pressures, RPMs, voltages in real-time

Service History

Maintenance records and service intervals

Module Status

ECU, TCU, BCM module health reports

Database Visualization
04

Scan Tool Integration

Autel Bluetooth scanner data pipeline — from OBD-II port to J.A.R.V.I.S.

Vehicle Scan Visualization
AUTEL BLUETOOTH INTEGRATION

Robust, near-real-time solution without requiring access to Autel's proprietary protocols.

01

Autel Scan & Export

Technician uses the Autel Bluetooth scanner (MaxiAP200) with the MaxiAP mobile app. After a full system scan, the diagnostic report is exported as a PDF.

02

PDF Ingestion Service

Cloud-based Python service accepts PDF uploads and uses parsing libraries (PyMuPDF / pdfplumber) to extract VIN, DTCs, vehicle details, and live data snapshots.

03

Data Processing & Storage

Parsed data is structured into standardized JSON format and written to the Dynamic Vehicle Database, keyed by VIN.

04

J.A.R.V.I.S. Access

On customer query, J.A.R.V.I.S. queries both the Static and Dynamic databases to provide a complete picture of vehicle history and current health.

05

Implementation Checklist

Components required to bring X.OS v2.1 J.A.R.V.I.S. to full operational status

Lead Generation Front-End

All features from the refinement spec

PENDING

Static Vehicle Database

NHTSA VIN decoder integrated, Mercedes API identified

COMPLETE

Dynamic Vehicle Database

Store scan tool data keyed by VIN

COMPLETE

PDF Ingestion Service

Autel PDF parser with drag-and-drop upload

COMPLETE

J.A.R.V.I.S. Core AI

Gemini 2.5 Flash brain with MiniMax TTS voice output

COMPLETE

Brand Assets

Logo and favicon integrated into all components

PENDING