Arcade & Gaming

The Arcade vertical powers game studios, indie publishers, and hardware manufacturers with four integrated systems: digital key vault distribution, game profile pages, immersive dark-mode storefronts, and pre-order reservation queues. Malet Owners configure these features via the Storefront Window layout system.

Architecture: Two-Plane Design

The Arcade vertical uses the same Control + Feature plane separation as its sibling verticals:

• Control Plane (malets subgraph): VerticalConfig feature flags decide which Arcade modules are enabled per Malet — digitalKeyVault, immersiveTheme, preOrderReservation, subscriptionGating.
• Feature Plane (experiences subgraph): Self-contained DigitalVaultModule and GameProfileModule. Each can be extracted to its own subgraph when a dedicated Gaming vertical Team forms.
• Extensions (services subgraph): Gaming platform and digital delivery type fields on existing Service entities.

Three new Storefront Window layout slot types are available: HERO_TRAILER, DIGITAL_LIBRARY, and PRE_ORDER_QUEUE.

What Arcade Reuses

Digital Key Vault

Securely manage pools of unique license keys (Steam, PSN, Xbox, or custom) and distribute them atomically on checkout. Each product can have one vault containing thousands of keys.

Key Lifecycle

AVAILABLE → CLAIMED (on checkout)
          → REVOKED (on refund)

Create a Vault

# Create a key vault for a product (Malet Owner)
mutation {
	createDigitalVault(maletId: "m_indie_studio", productId: "prod_shadow_quest", platform: "Steam") {
		id
		productId
		platform
		totalKeys
		availableKeys
	}
}

Import Keys (Bulk CSV Upload)

Upload batches of license keys into a vault. Keys are appended to the pool and stock counters update atomically:

# Import a batch of keys (Malet Owner)
mutation {
	importDigitalKeys(
		vaultId: "vault_1"
		keys: [
			"STEAM-AAAA-BBBB-CCCC"
			"STEAM-DDDD-EEEE-FFFF"
			"STEAM-GGGG-HHHH-IIII"
			"STEAM-JJJJ-KKKK-LLLL"
			"STEAM-MMMM-NNNN-OOOO"
		]
	) {
		id
		totalKeys
		availableKeys
	}
}

Claim a Key (Checkout)

When a Buyer completes a Murchase, the system atomically claims exactly one available key using MongoDB's arrayFilters. This is the critical path — no two Buyers can receive the same key:

# Claim one key atomically (called during checkout)
mutation {
	claimDigitalKey(
		productId: "prod_shadow_quest"
		claimantId: "user_kagiso"
		murchaseId: "murch_42"
	) {
		vaultId
		claimedKey # "STEAM-AAAA-BBBB-CCCC"
		availableKeys # 4 remaining
	}
}

Revoke a Key (Refund)

When a Murchase is refunded, the key is revoked (not returned to the available pool to prevent reuse of potentially redeemed keys):

# Revoke a claimed key (Malet Owner — on refund)
mutation {
	revokeDigitalKey(vaultId: "vault_1", key: "STEAM-AAAA-BBBB-CCCC") {
		id
		availableKeys
	}
}

Queries

# Get vault details (Malet Owner — includes all keys)
query {
	digitalVault(id: "vault_1") {
		id
		productId
		platform
		totalKeys
		availableKeys
		keys {
			key
			status
			claimantId
			claimedAt
			murchaseId
		}
	}
}

# Get all vaults for a Malet (Malet Owner dashboard)
query {
	maletDigitalVaults(maletId: "m_indie_studio") {
		id
		productId
		platform
		totalKeys
		availableKeys
	}
}

# Buyer's Digital Library — all claimed keys across vaults
query {
	myDigitalLibrary(buyerId: "user_kagiso") {
		productId
		platform
		key
		claimedAt
	}
}

Digital Library

The myDigitalLibrary query returns all keys a Buyer has claimed across all Malets. This powers the "My Games" / "Digital Library" page in the Buyer's account:

Game Profiles

Rich game/software showcase pages with platform compatibility, system requirements, developer information, and trailer media.

Mutations

# Create or update a game profile (Malet Owner)
mutation {
	upsertGameProfile(
		maletId: "m_indie_studio"
		productId: "prod_shadow_quest"
		developer: "Studio Kasi"
		platforms: ["PC", "PlayStation 5", "Xbox Series X"]
		publisher: "Mallnline Games"
		ageRating: "PEGI 16"
		trailerUrl: "https://r2.mallnline.com/trailers/shadow-quest.mp4"
	) {
		id
		developer
		platforms
		ageRating
		trailerUrl
	}
}

# Add a system requirement
mutation {
	addGameSystemRequirement(
		productId: "prod_shadow_quest"
		component: "CPU"
		minimum: "Intel i5-8400 / AMD Ryzen 5 1600"
		recommended: "Intel i7-12700 / AMD Ryzen 7 5800X"
	) {
		id
		systemRequirements {
			component
			minimum
			recommended
		}
	}
}

# Add more requirements
mutation {
	addGameSystemRequirement(
		productId: "prod_shadow_quest"
		component: "GPU"
		minimum: "GTX 1060 6GB / RX 580"
		recommended: "RTX 4070 / RX 7800 XT"
	) {
		id
		systemRequirements {
			component
			minimum
			recommended
		}
	}
}

# Remove a system requirement
mutation {
	removeGameSystemRequirement(productId: "prod_shadow_quest", component: "GPU") {
		id
		systemRequirements {
			component
			minimum
			recommended
		}
	}
}

Queries

# Get game profile for a product (public — product detail page)
query {
	gameProfile(productId: "prod_shadow_quest") {
		id
		developer
		publisher
		platforms
		releaseDate
		ageRating
		trailerUrl
		systemRequirements {
			component
			minimum
			recommended
		}
	}
}

# All game profiles for a Malet (Malet Owner / storefront)
query {
	maletGameProfiles(maletId: "m_indie_studio") {
		id
		productId
		developer
		platforms
		releaseDate
		ageRating
	}
}

System Requirements Display

The systemRequirements array renders as a comparison table on the product page:

Gaming Platform & Delivery Types

Extended service fields for digital game products on the existing services subgraph:

Service Fields

Delivery Types

Example: Create a Game Service

mutation {
	createOneService(
		input: {
			service: {
				name: "Shadow Quest — Deluxe Edition"
				description: "Award-winning action RPG with Season 1 DLC included"
				price: 59900 # R599.00 (cents)
				maletId: "m_indie_studio"
				gamePlatform: PC
				digitalDeliveryType: KEY_CODE
			}
		}
	) {
		id
		name
		gamePlatform
		digitalDeliveryType
	}
}

Workroom Steps

The Arcade vertical ships with 4 default Workroom steps for game launch lifecycle management:

These steps are automatically configured on new Arcade Malets via the vertical seed (deep purple/neon green branding).

Deferred Features

The following capabilities are planned for future phases using in-house, open-source/standard solutions — no third-party SaaS dependencies:

Frontend Implementation

Three Svelte 5 storefront widgets render the Arcade vertical in the Visitor-facing storefront:

Components

File Map

Layout Slot Types

Related

• Entertainment & Experiences — Provides Credit Wallets for store credit and Gamified Loyalty for purchase rewards
• Tech & Electronics — Sibling vertical with spec engine and warranty management; shares the experiences subgraph
• Culture & Arts — Sibling vertical; Digital Vault pattern parallels the Exhibition artwork provenance model
• Crypto — Encryption Microservice — Will power Phase 2 AES-256-GCM key encryption at rest for the Digital Vault
• Storefront Sections — Configure DIGITAL_VAULT, GAME_PROFILE, and PRE_ORDER_QUEUE layout slots
• Teams & Sub-Groups — Organize game studio staff with the org → team → member hierarchy
• Support: Digital Keys & Gaming — Visitor-facing guide