VIRTUO

The Platform

Four-Layer Decoupled Spatial Commerce Engine

VIRTUO separates environment presets, fixed-footprint modular architecture, interior display systems, and multi-tenant commerce so every merchant runs on one hardened WebGL and PostgreSQL platform.

World Engine

Approved environment presets supply the sky shader, directional sun vector, fog curve, reflection lightformers, and bounded 50m × 50m terrain around the showroom. Natural perimeter dunes conceal the 41m invisible courtyard boundary without artificial fences.

MVP Preset
DESERT-001 (Desert Glass)
Phase 2/3 Presets
OCEAN-001, FOREST-001, ALPINE-001, SKY-001, URBAN-001
Plot Dimensions
50m × 50m (41m walkable courtyard)

Modular Store Engine

Reconstructs a fixed-footprint 14m × 24m × 4m architectural pavilion at the world origin (Y = 0, entrance facing +Z). Blue-tinted structural glass bays, carved limestone reliefs, and the illuminated orange squircle portal load from validated module IDs.

Showroom Footprint
14m W × 24m D × 4m H (ADR 0005)
Entrance Portal
3m × 3m Facing +Z (ARCH-PORTAL-001)
Collision Model
Circle-vs-AABB Sliding Proxies (No Physics Engine)

Interior & Asset Pipeline

Materials, lighting presets, pedestals, counters, and decorative sculptures are placed by validated SceneConfig coordinates. Every 3D asset is compressed with Meshopt and KTX2 UASTC textures and verified against aisle-clearance and overlap gates.

Geometry & Texture
Meshopt + KTX2 BasisU (≤1K Normal/Roughness)
Validation Gate
Zod validateScene (bounds, overlap, 1.2m aisle)
Provenance Rule
Mandatory asset_licenses approval row

Multi-Tenant Commerce & RLS

Products, variants, integer minor-unit prices across 6 currencies, guest carts, authenticated checkout, and idempotent payment webhooks run on PostgreSQL with strict tenant_id Row-Level Security.

Supported Currencies
MYR, SGD, USD, EUR, GBP, AUD
Payment Adapter
PaymentProvider Interface (Demo + ToyyibPay)
Tenant Isolation
virtuo_app RLS enforced + cross-tenant test suite
View the configuration

One Engine. Infinite Spatial Configurations.

VIRTUO never hardcodes a single brand into the WebGL renderer. Select an environment preset, a merchandise display system, and an operating mode below to see how SceneConfig reassembles the experience on the fly.

World Environment Preset

DESERT-001

Controls sky shader, horizon terrain, directional sun vector, fog density, and courtyard boundary.

Merchandise Display System

FURN-PEDESTAL-001

Swaps interior display anchors, GLB compression targets, and inspection camera distance.

Spatial Operating Mode

LIVE IN MVP

Reconfigures the interaction layer between retail shopping, guided press exhibitions, and a live AI agent company floor.

Desert Glass Pavilion — Fragrance & Cosmology
DESERT-001/FURN-PEDESTAL-001/3D Retail Boutique
AZ 143° · EL 16°

Desert Glass Pavilion · 3D Retail Boutique

Blue-tinted structural glass pavilion anchored inside a bounded 50m × 50m twilight dune courtyard with an illuminated amber entrance portal.

Walk This World Now

Fragrance & Cosmology · Display Slot Telemetry

Meshopt + KTX2 UASTC · ≤1K PBR Normal/Roughness

Sculptural flacons, stoppers, and relief medallions rendered as real 3D GLB objects on individual lit plinths. Prices, olfactory notes, and stock resolve live from PostgreSQL.

P1Amber Oud · 100 ml Extrait
FURN-PEDESTAL-00118.4k tris
P2Dune No.01 · 100 ml Parfum
FURN-PEDESTAL-00116.2k tris
P3Obsidian · 100 ml Extrait
FURN-PEDESTAL-00119.1k tris
P4Lapis · 100 ml Eau de Parfum
FURN-PEDESTAL-00117.8k tris

Live Validated SceneConfig Contract

src/schemas/scene.ts · Zod Validated
{
  "schemaVersion": 1,
  "store": {
    "id": "store-desert-fragrance",
    "slug": "auren",
    "templateId": "GLASS-PORTAL-001",
    "operatingMode": "retail-storefront"
  },
  "world": {
    "presetId": "DESERT-001",
    "version": 1,
    "bounds": "50m × 50m (41m walkable courtyard)",
    "sun": "[18.0, 9.0, -24.0]"
  },
  "interior": {
    "categoryModule": "fragrance",
    "displayFixture": "FURN-PEDESTAL-001",
    "lightingPreset": "luxury-warm"
  },
  "runtime": {
    "navigation": "first-person-kinematic (2.2 m/s, 0.4m radius)",
    "interaction": "product-raycast (3.5m range) + server-cart",
    "telemetry": "postgres-rls + verified-payment-webhooks"
  }
}

Four-Layer Spatial Architecture

The world is replaceable; the store is reusable; products and commerce data remain independent. Each layer has a strict boundary enforced by TypeScript and PostgreSQL Row-Level Security.

Core 3D Engine

src/engine/core · src/engine/navigation

Three.js and React Three Fiber v9 rendering, 1.65m eye-level camera, pointer-lock and mobile touch controls, circle-vs-box sliding collision, 41m courtyard boundary, centre-ray focus.

Never owns: Store names, brand copy, hardcoded product prices, or heavy physics engines.

Store Configuration

src/schemas/scene.ts · src/content/stores/*.json

Zod-validated SceneConfig defining world preset ID, architectural template, interior material presets, furniture coordinates, and product display slots.

Never owns: Imperative Three.js rendering logic or unvalidated client-supplied footprints.

Ecommerce & Merchant Platform

src/commerce · src/checkout · src/payments · src/merchant

Multi-currency integer minor-unit pricing (MYR, SGD, USD, EUR, GBP, AUD), guest-to-account cart merge, PaymentProvider webhook verification, and merchant admin.

Never owns: Client-calculated order totals, redirect-based payment marking, or cross-tenant leaks.

Controlled 3D Asset Library

src/engine/assets · public/assets

Meshopt and KTX2 compressed GLB product models, modular limestone and portal architecture bays, collision footprints, and verified asset licence provenance.

Never owns: Unlicensed 3D downloads or commerce text baked into textures.