n1nj4t4nuk1/python-ddd-skeleton
58.0
Adequate · 9 November 2026
663
lines of production code
Python
primary language
7
measurements over time
What this system is
This system is a Python-based application skeleton built on Domain-Driven Design, Hexagonal Architecture, and CQRS patterns. It provides shared infrastructure for persistence (MinIO, MongoDB) and messaging, along with foundational domain classes for value objects, aggregates, and error handling. The codebase also includes a test suite and standard logging utilities to support rapid development of event-sourced services.
Features
Adds shared infrastructure implementations for CQRS, logging, and persistence
The shared infrastructure layer now includes in-memory implementations for the Command and Query buses, an in-memory event bus, and a console logger. For persistence, it adds repositories and client factories for Minio and MongoDB (PyMongo), along with parsers to translate criteria into MongoDB queries and dictionary formats into filter criteria. An environment variable manager and UUID validation utility are also introduced.
src/contexts/shared/Infrastructure · high confidence
Initial project scaffolding and build configuration
The repository was initialized with core project infrastructure, including a Python 3.10 Dockerfile, a Makefile for managing dependencies and tests, and a .gitignore file covering Python, IDE, and build artifacts. The project is defined as a Python DDD skeleton using Hexagonal Architecture, CQRS, and Event Sourcing, with the main entry point (main.py) and a MIT license file added.
(repo-wide) · high confidence
Introduce CQRS and Event Sourcing domain abstractions
The application now includes foundational domain classes for Command, Query, and Event Sourcing patterns. This adds abstract interfaces and base classes for Command and Query handling (including their respective buses and handlers), as well as domain event structures and an event bus, enabling the implementation of a CQRS architecture and event-driven communication within the shared domain layer.
src/contexts/shared/domain/criteria · high confidence
Introduce base domain classes for value objects and aggregates
Added new base classes for domain modeling: a ValueObject abstract class that stores and exposes a value, an AggregateRoot abstract class defining a to\_primitives method, and a ValueObjectValidationError exception class that includes a specific error ID and serialization logic. These files establish the foundational structure for value objects and aggregates within the shared domain context.
src/contexts/shared/domain/valueobj · high confidence
Introduce shared domain base classes and error types
Added new shared domain classes including BaseObject, DomainError, Interface, Metadata, Response, and UncontrolledError. These provide foundational abstractions for domain modeling, error handling, and serialization (to\_primitives) across the application.
src/contexts/shared/domain · high confidence
Introduces a shared logging interface
A new abstract Logger interface is added to the shared domain layer, defining standard logging methods (debug, info, warning, error, critical) to standardize how the application records messages across different contexts.
src/contexts/shared/domain/logger · high confidence
Test coverage
Added test utilities and sample tests
Added new test files including a sample unit test and utility helpers. The changes introduce a test structure with a sample test case and utility modules for async test execution and random word generation.
tests · high confidence
Dependencies
Added Python dependencies for FastAPI, MinIO, and PyMongo
The project now explicitly declares its Python dependencies in a requirements.txt file, pinning versions for FastAPI (0.115.12), MinIO (7.2.15), PyMongo (4.13.0), sniffio (1.3.1), and typing\_extensions (4.14.0).
(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 58 → 58 (-0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 78 → 78 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 41 → 41 (+0.0)
- Readiness 67 → 67 (+0.0)
- Security 93 → 91 (-2.1)
- Performance 100 → 100 (+0.0)
Resolved (1)
- High CVE: [GHSA redacted] (requirements.txt)
New (1)
- High CVE: [GHSA redacted] (requirements.txt)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
n1nj4t4nuk1/python-ddd-skeleton 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 bceb39f4320ce2c2c4a99adaf2e5c45f44120889 — 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.