Developer Docs

Experiences Subgraph

The Experiences subgraph is the Feature Plane within our Progressive Vertical Extraction architecture. It provides self-contained, cross-vertical modules that add rich business logic to Malets and Products.

Port: 3020 · Federation: Apollo v2 · Database: MongoDB (experiences DB)

Two-Plane Architecture

We split vertical configuration from feature logic:

  1. Control Plane (malets subgraph): Owns what features are enabled via feature flags and UI layout slots.
  2. Feature Plane (experiences subgraph): Owns how the features actually work, persisting state and exposing business logic APIs.

This separation allows an Experience module (e.g., Event Ticketing) to be used by multiple Malet verticals (e.g., Entertainment and Culture) without copying code.

Capabilities & Modules

The subgraph currently houses 13 isolated modules. Each module is fully self-contained (no cross-module imports) to allow seamless extraction into dedicated vertical subgraphs in the future.

Core Modules

  • Event Ticketing: Manages Event entities and QR-code checked EventTicket issuance. Integrates closely with the Services subgraph.
  • Credit Wallet: Provides an idempotent CreditWallet for users to store and spend digital balances at specific Malets. Supports atomic balance deductions.
  • Gamified Loyalty: Tracks VisitorLoyalty points, tiers, and achievements based on Murchases and visit frequency.

Vertical-Specific Extracted Capabilities

  • Professional: Client Portal (engagement lifecycle) and Document Vault (secure metadata tied to Media files).
  • Wellness: Membership (subscriptions and session quotas) and Wellness Profile (intake forms and private practitioner notes).
  • Culture: Exhibition (curation of artworks) and Artist Profile (public showcase pages).
  • Tech: Spec Sheet (detailed product properties) and Warranty (claim tracking and lifecycle).
  • Arcade: Digital Vault (license key distribution) and Game Profile (system requirements).

Configuration

The experiences subgraph requires the following environment variables:

  • EXPERIENCES_SERVICE_PORT: Defaults to 3020.
  • EXPERIENCES_SERVICE_URL: Used by the Gateway for schema composition.
  • DB_URI: MongoDB connection string.