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
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.