Containers
Every box below is a separately deployable container in deploy/compose.yaml. Application services are built from deploy/api.Containerfile, deploy/services.Containerfile (one target per GRE service) and deploy/web.Containerfile.
Container table
| Container | Image or project | Port (host) | Depends on | State it holds |
|---|---|---|---|---|
web | web/ built into nginx | 5173 | api | None |
api | src/Kaleido.Taxonomy.Api | 8080 | postgres | public schema, raw HTML volume rawhtml |
activity | src/Kaleido.Gre.Activity | 8081 | postgres | activity schema |
simulator | src/Kaleido.Gre.Simulator | 8082 | postgres, activity, api | simulator schema |
profile | src/Kaleido.Gre.Profile | 8083 | postgres, activity | profile schema |
recommender | src/Kaleido.Gre.Recommender | 8084 | postgres, profile, api, redis | recommender schema, in-memory catalogue |
ingest | src/Kaleido.Gre.Ingest | 8085 | kafka, redis | Redis c:* and cfg:ingest:* keys |
postgres | pgvector/pgvector:pg17 | 5434 | Volume pgdata | |
kafka | apache/kafka:3.9.0 | 9094 | Volume kafkadata, 7-day retention, 48 partitions per topic | |
redis | redis:7.4 | 6380 | Volume redisdata, append-only file | |
otel-collector | otel/opentelemetry-collector-contrib | 4327, 4328 | None | |
kafka-ui | provectuslabs/kafka-ui | 8088 | kafka | None (local only, no login) |
Call graph between services
Only these HTTP calls exist between services. Every call between GRE services carries X-Api-Key; calls to the Taxonomy API use a JWT obtained with a service account (Taxonomy:User, Taxonomy:Password).
| Caller | Callee | Endpoint | Why |
|---|---|---|---|
| api | every GRE service | /{path} under /gre/{service}/ | Gateway for signed-in users |
api (PipelineSampler) | simulator, ingest, activity, profile, recommender | streams, stats, runs, builds | Live pipeline view over SignalR |
| simulator | api | POST /auth/login, GET /similarity/export | Game pool for a simulated world |
| simulator | activity | POST /events/transactions, POST /events/sessions | Batch runs |
| simulator | ingest | GET /internal/sources/{id}/connection | Kafka connection to write test messages |
| simulator | activity, profile, recommender | stats, customers/{id}/activity, builds, recommend, settings | Holdout accuracy test |
| profile | activity | GET /activity (paged) | Affinity builds |
| recommender | api | POST /auth/login, GET /similarity/export | Catalogue build |
| recommender | profile | GET /affinities (paged), GET /customers/{id}/affinities | Crowd build, batch affinity source |
Solution layout
src/
Kaleido.Taxonomy.Api REST endpoints, MCP tools, GRE gateway, SignalR hub
Kaleido.Taxonomy.Application Use-case project (reserved; logic lives in Infrastructure today)
Kaleido.Taxonomy.Domain Entities: Game, TaxonomyNode, GameCharacteristic, runs, providers, users
Kaleido.Taxonomy.Infrastructure EF Core, similarity, AI tagging, importers, safe HTTP
Kaleido.Gre.Contracts Event and result records shared by GRE services (no dependencies)
Kaleido.Gre.Hosting X-Api-Key middleware
Kaleido.Gre.Telemetry OpenTelemetry setup, metric definitions, trace headers
Kaleido.Gre.Stream Kafka publisher, formats, Redis profile store, decayed counters
Kaleido.Gre.Activity Event store service
Kaleido.Gre.Profile Batch affinity service
Kaleido.Gre.Recommender Scoring service
Kaleido.Gre.Ingest Kafka to Redis service
Kaleido.Gre.Simulator Synthetic customers, streaming load, evaluation
web/ React front end
deploy/ Containerfiles, compose, deploy and verify scripts, OTel and SigNoz config
tests/ Kaleido.Taxonomy.Tests, Kaleido.Gre.Tests