← Back to Systems CatalogProprietary Architecture

CruiseHQ

City-Scale Social Operating System, Closed-Loop Microeconomy & DOM-Controlling Voice AI Concierge

https://cruisehq.fun
Production
CruiseHQ Production Interface
44 Structured
Database Migrations
20+ DOM Declarations
Voice Client Tools
94% via 3-Tier Cache
Search Latency Cut
Closed-Loop $CRUISE
Ecosystem Microeconomy

Executive Architectural Overview

City-scale social graph, event ticketing engine, and real-time multiplayer arcade spanning 44 database migrations. Driven by TCG—a bidirectional voice AI concierge that interprets natural speech to execute client tool declarations and physically manipulate the React DOM in real time.

Core Architectural Accomplishments

Architected a city-scale social platform spanning 44 database migrations with a closed-loop $CRUISE microeconomy, atomic spend/grant RPCs, and source-split Bachs checkout.
Engineered TCG: a bidirectional WebSocket voice agent with 20+ client tool declarations mutating React state, pgvector memory recall, and Spotify AUX control via AES-256 proxy.
Built low-latency multiplayer rooms with Supabase Presence/Broadcast, QR peer onboarding, sub-group channels, and remote co-host voice injection.
Implemented deny-by-default RLS policies across all tables and enforced HMAC-SHA256 signature verification on incoming payment webhooks.

Deterministic Guarantees

Concurrency Model
Atomic spend_cruise RPCs, service-role-only minting, and split-at-source ticketing reconciliation.
AI & Protocol Layer
Gemini Multimodal Live API, 20+ client tool declarations, pgvector semantic memory.
Database & Infrastructure
Supabase PostgreSQL with 44 migrations, Upstash Redis 3-tier caching, Serwist PWA at 220+ sitemap scale.
SUBSYSTEMS • ARCHITECTURAL MODULES

Integrated System Components

MODULE 01

Voice-Controlled React DOM Engine (TCG)

TCG agent parses natural speech into client tool declarations (openTool, switchMode, analyzeImage), directly triggering React state transitions without human clicks.

MODULE 02

3-Tier Sub-Second Caching Architecture

Queries check Supabase DB (7-day TTL) → Upstash Redis (15-min TTL) → Firecrawl Search API with automatic background cache replenishment, cutting query latency by 94%.

MODULE 03

Closed-Loop $CRUISE Microeconomy

Atomic spend_cruise and grant_cruise RPCs with service-role security, split-at-source event ticket payouts, and affiliate commission attribution.

MODULE 04

QR Multiplayer Room Engine & AUX Proxy

Enables instant frictionless room joining via mobile QR scan with Supabase Presence, crowd drops, real-time co-host voice streaming, and AES-256 encrypted Spotify AUX proxying.

MODULE 05

Hardened Namespaced Schemas

Shared infrastructure with deny-by-default RLS, service-role-only ledger mutations, and HMAC-SHA256 webhook reconciliation.

PRODUCTION STACK • VERIFIED

Technology Architecture Matrix

Frontend & Runtime
  • Next.js 15
  • Tailwind CSS
  • Serwist Offline PWA (220+ Routes)
  • Presence Avatars
  • Multimodal Client Tools
DB & Concurrency
  • Supabase PostgreSQL (44 Migrations)
  • pgvector Semantic Search
  • Atomic spend_cruise RPCs
  • Service-Role Minting Guard
  • Deny-by-Default RLS
AI & Realtime
  • Gemini Multimodal Live API
  • ElevenLabs Voice Pipeline
  • 20+ Client Tool Handlers (switchMode, openTool)
  • Supabase Broadcast & Presence
  • Spotify AUX Proxy (AES-256)
Payments & Protocols
  • $CRUISE Closed-Loop Microeconomy
  • Bachs Split-Checkout
  • Cruisaider Commission Attributor
  • Paystack Webhooks
  • HMAC-SHA256 Webhook Verification