Sidecar Architecture

Built for Safety, Designed for Scale

BOB ORBIT runs independently — it can't break what it doesn't touch

3-Layer Architecture

LAYER 3: BOB ORBIT

The Revenue Engine

Vercel Edge Functions
Tag Generator (ML)
Attribution Engine
Brand Dashboard
Platform APIs (9)
Credit System
READ ONLY
LAYER 2: DATA SYNC

The Bridge

Shadow DB

Read-only replica

Sync Schedule

Every 6 hours

Method

PostgreSQL streaming

Safety

Auto-pause if latency >100ms

STREAMING REPLICATION
LAYER 1: CORE PLATFORM

Unchanged & Protected

User Frontend
API Gateway
App Servers
Primary Database
Payment Processing
Order Management
Running normally — zero changes made

The Kill Switch

One environment variable. 60 seconds to full shutdown. Zero impact to core.

# To shut down BOB ORBIT:BOB_ORBIT_ENABLED=false# To restart:BOB_ORBIT_ENABLED=true

<60s

Full shutdown

Zero

Core impact

No

Code changes

Failure Scenarios

Shadow DB Sync Fails

✓ Zero impact

Impact

Tags become stale (>6 hours old)

Response

Auto-pause new campaigns, send alert

Vercel Edge Outage

✓ Zero impact

Impact

Brand dashboards unavailable

Response

Static fallback page served

Attribution Engine Bug

✓ Zero impact

Impact

Incorrect order attribution possible

Response

Manual audit queue activated

ML Model Crash

✓ Zero impact

Impact

No new tags generated

Response

Use last-known tags, restart model

Tech Stack

Frontend

  • Astro (Static site generation)
  • React + shadcn/ui + TailwindCSS
  • Recharts (Data viz)
  • Vercel Edge deployment

Backend

  • Next.js API Routes (Serverless)
  • Clerk (Auth)
  • Upstash Redis (Rate limiting)
  • Inngest (Webhooks)

Data

  • Supabase (Postgres + Vector)
  • PostgreSQL Read Replica
  • Cloudflare KV (Cache)
  • PostHog (Analytics)

Monitoring

  • Axiom (Logs)
  • Vercel Analytics + Grafana
  • PagerDuty (Alerts)
  • 99.9% SLA Uptime

Performance Metrics

<50ms

API Response

<2s

Dashboard Load

<30s

Attribution Time

2.3 hrs (avg)

Shadow DB Lag

99.9%

Uptime SLA

41 global

Edge Locations

Why Sidecar Wins

AspectIntegratedSidecar (BOB ORBIT)
Risk to Core! High✓ Zero
Deployment Time2-4 weeks48 hours
Downtime Required✓ Yes✕ No
Rollback Complexity! High✓ One button
Scaling! Coupled✓ Independent
Infrastructure Cost! Shared✓ Separate billing

See the Architecture in Action

Approve Idea