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
| Actor | Role in code | What they do |
|---|---|---|
| Viewer | viewer | Signs 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). |
| Editor | editor | Everything 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. |
| Admin | admin | Everything an editor does, plus users, AI providers and Kafka ingestion settings. |
| External AI client | JWT of any role | Uses 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
| System | Direction | Purpose | Code |
|---|---|---|---|
| AI model providers | Outbound | Tagging prompts and the provider connection test | Infrastructure/Documents/Ai.cs (AiClient) |
| slotcatalog.com | Outbound | Search a game and download its page as raw HTML | Infrastructure/Documents/SlotCatalogClient.cs |
| Casino platform export | Inbound | JSON game export imported into the catalogue | Infrastructure/PlatformGameImporter.cs |
| Casino platform events | Inbound | Transactions and sessions, through Kafka or the Activity HTTP API | Kaleido.Gre.Ingest, Kaleido.Gre.Activity |
| Responsible-gambling system | Inbound | Writes the suppression list | Recommender/Endpoints.cs (/suppressed) |
| Organisation Kafka clusters | Inbound | One consumer per configured ingestion, with TLS, SASL and Schema Registry support | Ingest/IngestConfig.cs, Ingest/SourceConsumer.cs |
| SigNoz | Outbound | Traces, metrics and logs, always through the OpenTelemetry collector | Kaleido.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.