VENTURIPLATFORM
Technical Specification

Engine Architecture & Headless CMS

Understand how Venturi separates raw physical inventory sync engines from presentation environments, allowing teams to deliver performant shopping experiences.

1. System Overview

Venturi Platform functions as the Digital Chassis for enterprise auto dealers. By divorcing legacy dealer database schemas (like CDK, Reynolds & Reynolds, or Cox Automotive) from the client web layout, web interfaces load instantly and inventory updates instantly.

The platform relies on a decoupled execution graph. A Python-based sync processor queries raw DMS systems periodically, storing structured vehicle records inside a high-throughput read-optimized database replica.

2. Ingestion Flow

Traditional inventory processing introduces feed latency of up to 24-48 hours. Venturi executes continuous webhook-driven event validation to check for newly active status, price updates, or removed vehicles.

REQUEST PAYLOADPOST /v1/inventory/sync
{
  "dealership_group": "Automotive Tier 1 Group",
  "rooftop_id": "RT_9048",
  "vehicles": [
    {
      "vin": "1FMCU9GD3Hxxxxxxx",
      "stock_number": "P2045A",
      "status": "in_transit",
      "price": 34950
    }
  ]
}

3. Edge Presentation API

The front-end queries vehicle attributes using a low-latency Edge API, returning formatted JSON optimized for Next.js Server Components.

GraphQL Endpoint

Perform direct queries for exact fields, bypassing over-fetching issues on mobile channels.

Restful Edge SDK

Auto-generated bindings in TypeScript allow developers to rapidly prototype new layouts.

4. Multi-Tenant Mechanics & Compliance

A single instance of Venturi can govern thousands of independent rooftop deployments. Security is isolated at the tenant/database row layer, allowing group admins to manage global listings while local dealer stores run completely self-contained configurations.

Each tenant configuration maintains an optional oem_config block enforcing co-op marketing and brand compliance parameters automatically:

DATABASE CONFIG SPECoem_config JSON
{
  "safety_locks": {
    "pricing": {
      "restrict_under_msrp": true,
      "max_discount_pct": 5.0,
      "mode": "block" // "block" | "warn"
    },
    "logos": {
      "allowed_logos": ["porsche_*.png", "audi_*.png"]
    }
  },
  "compliance": {
    "required_disclaimer": "All pricing includes active dealer incentives..."
  }
}