Kimss System Architecture

Multi-tenant AI orchestration across auth, credit governance, assistant runtime, and asynchronous telemetry pipelines on Azure.

expand_more

EXPLORE SYSTEM

01 Identity & Auth

Session + Key Security

Entra OAuth, Kimss session JWT, and API key fallback with role mapping.

fingerprintEntra ID
badgeSession Token
keyAPI Keys
02 Clients & edge

Web, docs & API clients

Vite SPA at /app, public landing and /docs, and SDK or REST clients call the same FastAPI surface.

languageKimss SPA /app
menu_bookLanding & docs
terminalSDK & REST
03 API Orchestration Core

FastAPI + kimssapi_functions

Routing, agent lifecycle, tool execution, guardrails, report rendering, and usage enforcement.

hubfoundry_resolver
factoryclient_factory
play_arrowrun_runner
gaveltool_registry
tollcredit_pool_cache
04 State & Persistence

Operational State

Tenant/user metadata, audit and usage rows, cache keys, and support artifacts.

databasePostgreSQL
memoryRedis
folderBlob Storage
05 AI Runtime Plane

Agent Execution Layer

Assistants, threads, vector stores, and model deployment routing.

neurologyAzure AI Foundry
folder_dataVector Stores
model_trainingModel Deployments

06 Telemetry & Governance Pipeline

APIM (opt-in) → Log Analytics audit; app + ingest function → PostgreSQL usage, execution logs, billing ledger.

routeAPIM (optional)
monitoringLog Analytics
functionsTelemetry ingest
analyticsExecution logs