Operations System architecture
Connecting to APISYNTHETIC DATAOP
CREDITOPS AI / architecture

System architecture

The components and boundaries behind an evidence-grounded diagnostic platform.

Persisted demo telemetry
Architecture / independent synthetic infrastructure

The diagnostic path

User / operations engineer

Session-scoped browser demo · no public login

same-origin API / diagnostic client

Next.js web console

Typed REST client · SSE trace · same-origin proxy

MCP diagnostic interface

Official SDK · stdio + HTTP · bounded read-only tools

validated read-only requests

FastAPI diagnostic API

Validated schemas · rate limits · sanitized evidence

AI investigator

Evidence-adaptive loop · explicit MCP / direct adapters · bounded claim validation

bounded diagnostic retrieval

PostgreSQL / pgvector

Immutable evidence · persisted timelines · lexical retrieval fallback

Kafka / Redpanda

Real event streaming locally · persisted telemetry in public demo

Synthetic FIX simulator

Heartbeats · reconnects · sequence gaps · acknowledgements

observability & operational knowledge

Prometheus / Grafana

Local metrics collection & provisioned dashboards

Runbooks / historical incidents

Synthetic operational knowledge · treated as untrusted data

Docker Compose

Real locally

  • PostgreSQL with optional pgvector
  • Redpanda event publication and consumption
  • Prometheus and Grafana provisioning
  • FastAPI, MCP, and synthetic FIX simulation
Predictable, bounded cost

Public demo

  • Persisted synthetic telemetry adapter
  • Accelerated deterministic incident clock
  • Three selected recordings from completed model-assisted development runs
  • Application-selected initial MCP checks, recorded model proposal, and local validation
  • Keyless replay: no new model, embedding, or recorded-tool calls
  • Legacy deterministic MCP demonstration remains separately labeled
Explicit configuration

Optional integrations

  • Protected OpenAI or Anthropic live provider
  • Neon PostgreSQL deployment
  • Embeddings and vector retrieval
  • Vercel frontend and container backend hosting
CreditOps AI intentionally exposes diagnostic capabilities only. AI recommendations are advisory. Production mutation tools are excluded by design.
Connecting to the diagnostic API…