Platform Pages
All frontend routes served by the Bridge AI OS gateway at go.ai-os.co.za
Core
Home
/
Landing page — platform overview and sign-in prompt
Dashboard
/dashboard
Main user dashboard with AIC, mission, treasury, and wallet widgets
Profile
/profile
User profile management, plan info, and account settings
CRM
/crm
Customer relationship management with lead pipeline and AI scoring
Login
/login
Email/password and OAuth (Google/GitHub) sign-in via Supabase PKCE
Docs
/docs
Developer documentation hub — API reference, architecture, guides
Sitemap
/sitemap
This page — interactive system map of all routes, APIs, and services
Intelligence
Digital Twin
/twin
AI-powered digital twin interface — real-time decision simulation
Avatar
/avatar
AI avatar builder and persona configuration
Agents
/agents
Autonomous agent swarm management and orchestration console
EHSA Brain
/ehsa-brain
Causal AI brain for healthcare systems — diagnostic and policy inference
Executive Dashboard
/executive-dashboard
C-suite overview with strategic KPIs, revenue, and AI intelligence briefings
Intelligence
/intelligence
Market and competitive intelligence feeds powered by AIC Phase 3
Economy
Marketplace
/marketplace
AI task marketplace — buy and sell automated services with BRDG tokens
Wallet
/wallet
ZAR + BRDG dual-currency wallet with transaction history
DeFi
/defi
Decentralized finance tools on Linea zkEVM — staking, yield, liquidity
Trading
/trading
Autonomous AI trading engine with strategy builder and backtesting
Tokenomics
/tokenomics
BRDG token supply, distribution model, and vesting schedules
Treasury Dashboard
/treasury-dashboard
AEOS 4-way revenue split monitor, ops bank, and burn tracking
Economy
/economy
Full economic overview — balances, flows, and reinvestment state
Automation
Automation
/automation
Workflow automation builder — triggers, actions, and AI-powered pipelines
BossBots
/bossbots
Deploy and manage boss-level autonomous bots with role hierarchies
Leads
/leads
Lead generation and management with AI scoring and auto-nurture
Marketing
/marketing
AI-driven campaign builder, audience targeting, and performance analytics
Infrastructure
Topology
/topology
Live service topology map — network graph of all microservices
Terminal
/terminal
In-browser PTY terminal proxied via terminal-proxy :5002 websocket
System Dashboard
/system-dashboard
Real-time system metrics — CPU, memory, uptime, error rates
Logs
/logs
Streaming PM2 log viewer for all services
Infrastructure
/infra
VPS infrastructure management — nginx, services, deployments
Admin
/admin
Superadmin control panel — user management, system settings, overrides
Vertical Products
BAN Engine
/ban
Business Automation Node — enterprise vertical intelligence hub
Hospital in a Box
/hospital
Complete hospital management system with AI diagnostics
EHSA App
/ehsa-app
Environmental Health Systems Analytics web application
Aurora
/aurora
Aurora energy intelligence platform — renewable grid management
UBI Platform
/ubi
Universal Basic Income distribution and verification platform
AID Portal
/aid
AI-powered aid and humanitarian assistance coordination portal
ABaaS
/abaas
AI Business as a Service — complete business-in-a-box deployment
Rooted Earth
/rootedearth
Regenerative agriculture intelligence and supply chain platform
Auth & Onboarding
Onboarding
/onboarding
New user onboarding flow — entity setup, mission generation, plan selection
Setup Wizard
/wizard
Step-by-step platform configuration wizard for first-time users
Checkout
/checkout
Plan upgrade checkout — PayFast, Stripe, Paystack, Crypto payment rails
Auth Callback
/auth-callback
OAuth PKCE callback handler — exchanges Supabase code for Bridge JWT
Welcome
/welcome
Post-signup welcome page with platform tour and quick actions
API Reference
All endpoints handled by the Bridge Gateway at :8080. Click a path to copy it.
Auth APIs
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | GET /auth/me | 🔒 | Returns current user profile from JWT |
| POST | /auth/token-exchange | 🔓 | Exchanges Supabase access_token for Bridge JWT |
| POST | /api/auth/root-token | 🔒 | Issues root token using ZERO_TRUST_SECRET header |
| POST | /auth/register | 🔓 | Email/password registration — creates Supabase user + Bridge record |
| POST | /auth/login | 🔓 | Email/password login — returns signed JWT |
AEOS Core
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/economy/me | 🔒 | Returns current user wallet balance in ZAR and BRDG |
| POST | /api/treasury/auto-split | 🔒 | Applies AEOS 4-way revenue split to an incoming amount |
| GET | /api/treasury/splits | 🔒 | Returns treasury split history and balances |
| GET | /api/system/overview | 🔒 | Full system state — services, economy, missions, AIC summary |
Mission Statement Engine
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/mission/generate | 🔒 | Generates AI mission statement + rules + T&C for an entity |
| GET | /api/mission | 🔒 | Lists all missions for the authenticated entity |
| GET | /api/mission/:id | 🔒 | Returns a specific mission by ID |
| PUT | /api/mission/:id | 🔒 | Updates mission status (active/expired) or edits rules |
AIC — Autonomous Intelligence Core
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/aic/classify | 🔒 | Phase 1: Classifies an input signal into entity type + intent |
| POST | /api/aic/score | 🔒 | Phase 2: Opportunity score = (EDV × CP × SVM) / TTC |
| POST | /api/aic/simulate | 🔒 | Phase 2: Monte Carlo simulation of opportunity outcomes |
| POST | /api/aic/process | 🔒 | Phase 1: Main agent process — routes to appropriate swarm agent |
| POST | /api/aic/process-v2 | 🔒 | Phase 2: Enhanced process with scoring + reinvestment routing |
| POST | /api/aic/close | 🔒 | Phase 3: Closes a deal via autonomous closer agent loop |
| GET | /api/aic/state | 🔒 | Phase 2: Returns current AIC pipeline state and metrics |
| GET | /api/aic/queue | 🔒 | Phase 2: Returns job queue depth per agent type |
| GET | /api/aic/autonomy | 🔒 | Phase 3: Returns Autonomy Index (0–100) self-sufficiency score |
| GET | /api/aic/intelligence | 🔒 | Phase 3: Intelligence report — anomalies, opportunities, recommendations |
| GET | /api/aic/system | 🔒 | Phase 3: System manifest — full AIC configuration and capabilities |
| POST | /api/aic/detect | 🔒 | Phase 3: Anomaly detection on time-series input data |
Leads & CRM
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/leads | 🔒 | Returns paginated leads list with AIC score |
| POST | /api/leads | 🔒 | Creates a new lead record |
| POST | /api/leads/:id/convert | 🔒 | Converts a lead to a deal and triggers closer agent |
| POST | /api/leads/ai-generate | 🔒 | Uses AI to generate qualified leads based on ICP criteria |
Apps, Brands & Platform
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/apps | 🔒 | Lists registered apps for the authenticated user |
| POST | /api/apps | 🔒 | Registers a new app with API key generation |
| DELETE | /api/apps | 🔒 | Deletes an app and revokes its API key |
| GET | /api/brands | 🔒 | Lists brand profiles linked to user account |
| POST | /api/brands | 🔒 | Creates a new brand profile with domain and assets |
| DELETE | /api/brands | 🔒 | Removes a brand profile |
| GET | /api/affiliates/me | 🔒 | Returns affiliate stats, referral code, and earnings |
| GET | /api/automations | 🔒 | Lists configured automation workflows |
| GET | /api/banking/summary | 🔒 | Banking integration summary — connected accounts and balances |
| POST | /api/usage/event | 🔒 | Records a platform usage event for billing and analytics |
Brain & AI Services
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/brain/status | 🔒 | Returns super-brain :8000 health, version, and swarm agent count |
| GET | /api/skills | 🔒 | Lists available AI skills registered with the execution server |
| GET | /api/marketplace/tasks | 🔒 | Returns available tasks in the AI marketplace |
| GET | /api/bossbots | 🔒 | Lists deployed BossBot instances and their status |
| POST | /ask | 🔒 | Freeform AI query endpoint — routes to brain RAG + swarm |
| GET | /health | 🔓 | Gateway health check — returns {"status":"OK"} with uptime |
Services
PM2-managed microservices running at /var/www/bridgeai/ on the VPS
bridge-gateway
:8080
Online
Primary HTTP gateway — nginx proxy target. Routes all inbound traffic to internal services, serves static files, handles JWT auth middleware, mission check, rate limiting.
unified-server
:3000
Online
Unified API server — handles /api/economy, /api/apps, /api/brands, /api/leads, /api/automations, and full passthrough list. Node.js + Express.
super-brain
:8000
Online
Python FastAPI AI brain — handles agent swarm, RAG, trading engine, AIC Phase 1–3, anomaly detection, autonomy index, intelligence reporting. WebSocket live events at /ws/<channel>.
auth-service
:5001
Online
Authentication microservice — JWT signing/verification, Supabase OAuth integration, PKCE token exchange, user registration and login, superadmin detection.
ban-engine
:8001
Online
Business Automation Node engine — vertical product intelligence for BAN, hospital, EHSA, Aurora, UBI, AID verticals. Python FastAPI.
god-mode-system
:3000
Standby
Superadmin control layer — full system override capabilities, user impersonation, emergency controls. Restricted to superadmin role only.
svg-engine
dynamic
Online
SVG generation and teaching engine at E:\BridgeAI\svg-engine — programmatic diagram generation, skill visualizations, teaching content rendering.
terminal-proxy
:5002
Online
WebSocket PTY proxy — forwards browser terminal sessions via ws://:5002/terminal to the VPS shell. node-pty powered.
admin-api
varies
Standby
Admin REST API — exposes system management endpoints, user management, service control, settings overrides for the admin dashboard.
Subdomains
All domains and subdomains in the Bridge AI OS network
go.ai-os.co.za
Main platform gateway — all users start here
Live
bridge-ai-os.com
Primary marketing domain — redirects to platform
Live
ai-os.co.za
Apex domain — South Africa primary TLD
Live
ban.ai-os.co.za
Business Automation Node vertical product
Live
ehsa.ai-os.co.za
Environmental Health Systems Analytics platform
Live
aurora.ai-os.co.za
Aurora energy intelligence — renewable grid management
Live
ubi.ai-os.co.za
Universal Basic Income distribution platform
Live
aid.ai-os.co.za
AI-powered humanitarian aid coordination portal
Live
hospitalinabox.ai-os.co.za
Hospital management + AI diagnostic system
Live
rootedearth.ai-os.co.za
Regenerative agriculture intelligence platform
Live
supac.ai-os.co.za
Supa-Claw edge workers and serverless functions
Live
abaas.ai-os.co.za
AI Business as a Service — complete business deployment
Live
WebSockets & Streams
Real-time communication channels for live data, terminal, and event streaming
WS
ws://[host]:8000/ws/<channel>
Brain live events — subscribe to agent decisions, AIC state changes, autonomy updates, and swarm activity by channel name
WS
ws://[host]:5002/terminal
PTY terminal proxy — bidirectional shell session streamed to browser terminal at /terminal via node-pty
SSE
/events/stream
Gateway SSE endpoint — server-sent events for real-time dashboard updates, system alerts, and service status changes
SSE
/api/events
API-level event stream — platform-specific events including lead captures, mission completions, treasury splits, and AIC signals
Revenue & Economy
AEOS — Autonomous Economic Operating System — governs all revenue flows on the platform
AEOS 4-Way Revenue Split
Plan Tiers
FREE
User cut80%
Platform fee5%
Ops bank10%
Burn5%
Priority routing✕
AIC Phase1
PRO
User cut80%
Platform fee5%
Ops bank10%
Burn5%
Priority routing✓
AIC Phase1+2
ENTERPRISE
User cut80%
Platform fee5%
Ops bank10%
Burn5%
Priority routing✓
AIC Phase1+2+3
Payment Rails
PayFast
ZAR · South Africa
Paystack
NGN/ZAR · Africa
Stripe
USD/EUR · Global
Crypto
BRDG · Linea zkEVM
PayPal
USD · Global
Dual Currency
ZAR (Fiat)
Rand
South African Rand for fiat payment rails — PayFast, Paystack, bank transfers. Stored in Supabase wallet table. Used for all local transactions.
BRDG (Token)
On-chain
Bridge Token on Linea zkEVM — ERC-20 utility token. 5% of every transaction is burned. Used for marketplace, staking, and governance voting.