Skip to main content

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​

ContainerImage or projectPort (host)Depends onState it holds
webweb/ built into nginx5173apiNone
apisrc/Kaleido.Taxonomy.Api8080postgrespublic schema, raw HTML volume rawhtml
activitysrc/Kaleido.Gre.Activity8081postgresactivity schema
simulatorsrc/Kaleido.Gre.Simulator8082postgres, activity, apisimulator schema
profilesrc/Kaleido.Gre.Profile8083postgres, activityprofile schema
recommendersrc/Kaleido.Gre.Recommender8084postgres, profile, api, redisrecommender schema, in-memory catalogue
ingestsrc/Kaleido.Gre.Ingest8085kafka, redisRedis c:* and cfg:ingest:* keys
postgrespgvector/pgvector:pg175434Volume pgdata
kafkaapache/kafka:3.9.09094Volume kafkadata, 7-day retention, 48 partitions per topic
redisredis:7.46380Volume redisdata, append-only file
otel-collectorotel/opentelemetry-collector-contrib4327, 4328None
kafka-uiprovectuslabs/kafka-ui8088kafkaNone (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).

CallerCalleeEndpointWhy
apievery GRE service/{path} under /gre/{service}/Gateway for signed-in users
api (PipelineSampler)simulator, ingest, activity, profile, recommenderstreams, stats, runs, buildsLive pipeline view over SignalR
simulatorapiPOST /auth/login, GET /similarity/exportGame pool for a simulated world
simulatoractivityPOST /events/transactions, POST /events/sessionsBatch runs
simulatoringestGET /internal/sources/{id}/connectionKafka connection to write test messages
simulatoractivity, profile, recommenderstats, customers/{id}/activity, builds, recommend, settingsHoldout accuracy test
profileactivityGET /activity (paged)Affinity builds
recommenderapiPOST /auth/login, GET /similarity/exportCatalogue build
recommenderprofileGET /affinities (paged), GET /customers/{id}/affinitiesCrowd 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