Skip to content
CAI
Software that uses CAICheck a score

bitloops/ddd-hexagonal-cqrs-es-eda

51.2

Adequate · 9 November 2026

9.6k

lines of production code

TypeScript

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a monorepo-based application for managing todo items, structured around a Domain-Driven Design architecture with CQRS and Event Sourcing patterns. It consists of a NestJS backend handling authentication via Keycloak and real-time updates through NATS, a React frontend using Redux Toolkit for state management, and a Go-based telemetry consumer for observability. The platform supports full lifecycle operations for todos, including creation, modification, and deletion, with changes propagated in real-time to the client.

Features

Adopts Keycloak for OIDC authentication and introduces real-time SSE updates for todos

The backend now uses Keycloak as the identity provider, replacing previous authentication mechanisms with an OIDC-based flow that validates access tokens via JWKS and reconciles user identities in PostgreSQL. Additionally, a new Server-Sent Events (SSE) endpoint allows clients to subscribe to real-time todo lifecycle events (added, completed, deleted, modified, uncompleted), which are propagated from the domain layer via a NATS pub-sub integration event bus.

backend/src · high confidence

Backend initialization with NestJS, OIDC, and development tooling

The backend directory is initialized as a NestJS application using TypeScript (ES2023) and pnpm. It introduces OpenID Connect (OIDC) authentication via Keycloak, with configuration provided in \.template-env\ and \frontend-development.docker-compose.yml\. The API exposes REST endpoints for Todo management and Server-Sent Events (SSE) for real-time updates, documented in \swagger.json\. Development is supported by Docker Compose files for local infrastructure (PostgreSQL, NATS, Keycloak, Prometheus, Grafana, Jaeger), ESLint and Prettier configuration, and a multi-stage Dockerfile for containerized builds.

backend · high confidence

Frontend application scaffolded with new architecture and UI components

The frontend source code has been restructured to introduce a new application foundation. This includes a new \App.tsx\ entry point that initializes authentication via Redux and manages routing, alongside a new \Events.ts\ module providing a typed event bus for application-wide communication. A generated API client layer (\@hey-api/openapi-ts\) has been added to \frontend/src/api\, providing typed SDK functions for authentication and todo operations. The UI has been rebuilt using Chakra UI components, introducing new layout structures such as \Header\, \Heading\, and a \TodoPanel\ with entry-level components for managing todo items.

frontend/src · high confidence

Initial project scaffolding and documentation

Established the repository with foundational configuration files including .gitignore, .dockerignore, and pnpm-workspace.yaml, alongside comprehensive project documentation (README, CHANGELOG, CONTRIBUTING, CODE\_OF\_CONDUCT, SECURITY) and Kubernetes deployment manifests (K8s.md, apply\_k8s\_files.sh) to support the initial release of the DDD-hexagonal-cqrs-es-eda application.

(repo-wide) · high confidence

Introduce Go-based telemetry consumer for NATS, Prometheus, and Jaeger

Adds a new telemetry consumer service written in Go (targeting Go 1.25) that subscribes to NATS JetStream subjects to process observability data. The component exports metrics to a Prometheus Push Gateway (tracking commands, queries, domain/integration events, handlers, and controllers) and sends distributed traces to Jaeger, including logic to reconstruct span hierarchies from incoming trace events.

telemetry-consumer · high confidence

Behavioural changes

Added Grafana configuration file with default admin credentials

A new configuration file for Grafana has been added, setting the default admin username to 'admin' and password to 'changeme', and disabling user sign-up.

grafana · high confidence

Frontend foundation modernized with Vite, TypeScript, and Keycloak authentication

The frontend application has been rebuilt on a modern stack, replacing the previous architecture with Vite as the build tool and bundler, and TypeScript (ES2022/ES2023 targets) for type safety. The UI state management now uses Redux Toolkit with an MVVM-style arrangement (controllers, repositories, services) and an anti-corruption layer for data mapping. Authentication has been implemented using \oidc-client-ts\ for OpenID Connect Authorization Code Flow with PKCE, integrating with Keycloak for login, registration, and SSO session management. The application is containerized with a multi-stage Dockerfile (Node.js build, Nginx production) and includes ESLint configuration for code quality.

frontend · high confidence

Test coverage

Added Cucumber behavior tests and unit tests for the todo reducer and mapper

Added a new test suite in \frontend/tests\ that includes Cucumber scenarios (\todo.feature\) and TypeScript step definitions to verify the Redux todo reducer's handling of state transitions (initialization, add, delete, complete, uncomplete, and title modification). Additionally, added unit tests (\todoMapper.test.ts\) to validate the anti-corruption layer's mapping of backend events to UI state, ensuring correct translation of fields like \completed\ to \isCompleted\ and proper handling of lifecycle events.

_frontend/tests, frontend/tests/features/step\definitions · high confidence

Dependencies

Initial dependency manifests for backend, frontend, and telemetry-consumer

The project now includes explicit dependency definitions for its three main components. The backend (NestJS/Fastify) specifies Node 24 and libraries including NestJS 11, Fastify 5, NATS, and PostgreSQL. The frontend (React/Vite) targets React 19 and Redux Toolkit 2. The telemetry consumer (Go) requires Go 1.25 and libraries for NATS, OpenTelemetry, and Prometheus. A root \package.json\ establishes pnpm as the package manager and defines build/lint/test scripts for the monorepo.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 51 → 51 (-0.1)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 58 → 58 (+0.0)
  • Architecture 81 → 80 (-0.5)
  • Maturity 67 → 72 (+4.4)
  • Readiness 40 → 40 (+0.0)
  • Security 70 → 71 (+1.1)
  • Domain Modelling 70 → 70 (+0.0)
  • Accessibility 55 → 53 (-1.4)
  • Performance 100 → 100 (+0.0)

Resolved (6)

  • High CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Off-boarding risk: anonymized user #1
  • utils.createQuerySerializer::querySerializer (cognitive 25) (frontend/src/api/client/utils.ts)

New (12)

  • Low CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: GO-2026-6865 (telemetry-consumer/go.mod)
  • Off-boarding risk: anonymized user #1
  • redundant comment (backend/src/lib/bounded-contexts/todo/todo/application/command-handlers/index.ts)
  • redundant comment (frontend/src/infra/repositories/todo/TodoRepository.ts)
  • utils.createQuerySerializer.querySerializer (cognitive 25) (frontend/src/api/client/utils.ts)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

bitloops/ddd-hexagonal-cqrs-es-eda was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 9 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 11100016452b0e164e3ebb9b9026f99b901b0b47 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-bb0cb800cd0f.