Skip to main content

System context

This page places the platform among the people and systems around it. It is the outermost view: one box for Kaleido, with everything it talks to.

Actors​

ActorRole in codeWhat they do
ViewerviewerSigns in, browses games, similar games, the similarity map and the Simulation page. Can run read-only computations such as what-if (/gre/profile/affinities/compute, /gre/recommender/recommend).
EditoreditorEverything a viewer does, plus editing games and the taxonomy, running AI tagging, accepting or rejecting tags, tuning similarity and recommender settings, starting builds and simulations.
AdminadminEverything an editor does, plus users, AI providers and Kafka ingestion settings.
External AI clientJWT of any roleUses the MCP tools. Read tools need any role; write tools need editor or admin.

Roles are defined in src/Kaleido.Taxonomy.Domain/Entities.cs (Roles) and enforced by policies in src/Kaleido.Taxonomy.Api/Program.cs.

External systems​

SystemDirectionPurposeCode
AI model providersOutboundTagging prompts and the provider connection testInfrastructure/Documents/Ai.cs (AiClient)
slotcatalog.comOutboundSearch a game and download its page as raw HTMLInfrastructure/Documents/SlotCatalogClient.cs
Casino platform exportInboundJSON game export imported into the catalogueInfrastructure/PlatformGameImporter.cs
Casino platform eventsInboundTransactions and sessions, through Kafka or the Activity HTTP APIKaleido.Gre.Ingest, Kaleido.Gre.Activity
Responsible-gambling systemInboundWrites the suppression listRecommender/Endpoints.cs (/suppressed)
Organisation Kafka clustersInboundOne consumer per configured ingestion, with TLS, SASL and Schema Registry supportIngest/IngestConfig.cs, Ingest/SourceConsumer.cs
SigNozOutboundTraces, metrics and logs, always through the OpenTelemetry collectorKaleido.Gre.Telemetry, deploy/otel/collector.yaml

Outbound calls to addresses an admin supplied (AI base URLs, page fetches) go through SafeHttp, which refuses loopback, private and link-local addresses at connect time unless Network:AllowPrivateHosts is set for local development.