Skip to main content

Web app (web/)

A React 19 and TypeScript single-page app built with Vite and served by nginx on port 5173. It talks only to the Taxonomy API (VITE_API_URL, default http://localhost:8080); GRE services are reached through the /gre/... gateway, never directly.

Pages​

RouteMenu labelVisible toBacked by
/Dashboardall/dashboard/overview
/games, /games/:idGames Catalogueall (edit: editor)/games, /games/{id}, /games/{id}/characteristics, documents, AI extract
/taxonomyTaxonomy Modelall (edit: editor)/taxonomy/*
/similaritySimilar Gamesall/games/{id}/similar, /compare, /similarity/map, /similarity/heatmap
/engineSimilarity Engineeditor/similarity/settings, /similarity/settings/preview
/simulationGRE Simulationall (actions: editor)/gre/*, /hubs/pipeline
/taggingAI Taggingeditor/tagging/*, /review/tags/*, /conflicts
/settingsPreferencesalllocal preferences
/settings/capture, /capturePage captureeditor/games/{id}/documents (a bookmarklet sends the page HTML from the browser when a site blocks automated downloads)
/settings/providersAI providersadmin/ai/providers
/settings/kafkaKafka ingestionadmin/gre/ingest/sources
/settings/ai-tagging-agentAI Tagging Agenteditor/ai/prompts/tagging
/usersUsersadmin/users
/connectivityConnectivityallHow to connect AI clients (Claude, Claude Code, Cursor) to the MCP server

Simulation page​

web/src/pages/Simulation.tsx is a workspace built around a clickable pipeline diagram (web/src/sim/PipelineFlow.tsx). Each box is a step; selecting it opens that step's panel below the diagram (?step= in the URL). The boxes are colour-coded and their connectors animate with live traffic from the SignalR snapshots.

Step boxPanel componentsWhat it does
generate, store, profilesDataTabGenerate a simulated world (batch run), see what the activity service holds, build affinities
stream, kafkaLiveTabStart a stream to a chosen ingestion; throughput, lag and Kafka state
profileLiveTabLive Redis profiles of streaming customers
recommenderLiveWatch, MapTab (live), DataTab (crowd), TuneTabWatch one customer's list change live, the co-play network, crowd builds, and weight tuning with saved vs draft lists
similarityDataTab (similarity), MapTabCatalogue build and the tag-similarity network
outputCustomersTab, WhatIfTab, EvaluateTabThree views: one customer's story (activity, affinities, recommendations; stars mark ground-truth favourites), a hand-built what-if customer, and persona fit plus the holdout accuracy test (AccuracyCard)
howHowTabPlain-language explanation (also the How it works button)

Reset data (ResetData) calls DELETE /data on the services to start a simulation clean.

The colour of each recommendation bar segment encodes the clue: green for tagged alike, blue for played together, orange for popular, purple for new.