Enforcer/clean-architecture
62.6
Adequate · 22 September 2026
2.5k
lines of production code
Python
primary language
7
measurements over time
What this system is
This system is an auctioning platform that manages the end-to-end lifecycle of online auctions, including bid placement, winning bid processing, and payment handling. It integrates with external services like Stripe for payments and provides shipping and customer relationship management features. The architecture is built on a domain-driven design with separate modules for auctions, payments, and shipping, supported by a foundation library and SQL-based persistence.
Features
Add user and role models to the web\_app\_models package
The web\_app\_models package now includes SQLAlchemy models for User and Role, including a many-to-many relationship table (RolesUsers) to link users to their roles. These models are defined using Flask-Security and SQLAlchemy, enabling the application to manage user authentication and authorization data within the auctioning platform.
_auctioning\platform · high confidence
Initial shipping module structure and domain models
The shipping module has been introduced with a new domain model for addresses (including a UUID, street, city, etc.) and a package status value object. An application layer was added with a ShippingPackage use case, a GetNextPackage query, and an AddressRepository interface, all wired into a new Shipping injector module. The module also includes placeholder files for events and exceptions, along with the necessary test directory structure.
_auctioning\platform/shipping · high confidence
Introduce SQL-based persistence for auctions
The auctioning platform now includes a new \auctions\_infrastructure\ module that provides SQL-based persistence for auctions. This adds a \SqlAlchemyAuctionsRepo\ for saving and loading auction entities, along with \SqlGetActiveAuctions\ and \SqlGetSingleAuction\ queries to fetch auction data from the database. The module also defines the \auctions\ and \bids\ database table models and registers the infrastructure components via an \injector\ module, enabling the application to interact with the database for auction operations.
_auctioning\_platform/auctions\infrastructure · high confidence
Introduce auction domain model and application use cases
The auctioning platform now includes a complete domain model and application layer for managing auctions. This includes the \Auction\ and \Bid\ entities with logic for placing bids, withdrawing bids, and handling auction lifecycle events (e.g., \AuctionBegan\, \WinningBidPlaced\). The application layer introduces use cases for starting an auction, placing bids, and withdrawing bids, all wired via dependency injection. Tests have been added to verify the behavior of these use cases and domain entities.
_auctioning\platform/auctions · high confidence
Introduce customer relationship module and web app scaffolding
The platform now includes a new customer\_relationship module that handles customer data and sends email notifications for overbids, winning bids, and successful payments. The web\_app is restructured with blueprints for /auctions and /shipping, a custom JSON encoder for serializing domain objects, and a security setup for Flask-Login and Flask-Security. Input validation is standardized using marshmallow\_dataclass, and request-scoped database sessions are managed via a context manager to ensure proper transaction handling.
_auctioning\_platform/web\app · medium confidence
Introduce foundation library with value objects and event bus
Adds the \foundation\ library containing core domain primitives: a \Money\ value object with currency support, serialization utilities for dataclasses, an \EventBus\ for domain events, and a \Lock\ protocol. Includes tests for the \Money\ class.
_auctioning\platform/foundation · high confidence
Introduce payments module with Stripe integration
Added a new payments module containing the core payment logic, including a PaymentsFacade that orchestrates payment lifecycle (start, charge, capture, fail) and interacts with the external Stripe API via an ApiConsumer. The implementation includes data access objects for database operations, event definitions for payment status changes, and a database model for the payments table. Tests have been added to verify the facade's behavior and the API consumer's interaction with Stripe.
_auctioning\platform/payments/payments · high confidence
Introduce process manager for handling auction win payments
A new process manager implementation for handling the flow of a winning bid, including initiating payment, sending winning notifications, and managing state transitions (PAYED\_STARTED, TIMED\_OUT, FINISHED). The change adds the core business logic in \PayingForWonItem\ and its handler \PayingForWonItemHandler\, along with a data repository for persisting process state. Tests are added to verify the payment initiation, email notifications, and timeout behavior.
_auctioning\platform/processes · high confidence
Introduce shipping infrastructure with fake address repository
Added a new shipping infrastructure module that provides a fake address repository for development and testing. The module includes a SQLAlchemy model for a 'packages' table with a GUID primary key, a 'FakeAddressRepository' that generates mock address data using the 'faker' library, and an injector module to wire the fake repository. This allows the application to function with simulated shipping data rather than a real database or external service.
_auctioning\_platform/shipping\infrastructure · high confidence
Payments module initialization and configuration
The payments module is initialized with a standard Python package structure, including a setup.py that declares dependencies on injector, sqlalchemy, stripe, requests, and db\_infrastructure. Configuration files are added for isort (defining the 'payments' package) and pytest (excluding 'stripe' marked tests by default).
_auctioning\platform/payments · high confidence
Behavioural changes
Introduce request-scoped dependency injection and async task handling
The application now uses a \RequestScope\ to manage the lifecycle of request-scoped dependencies like database connections and sessions, ensuring they are properly closed when a request ends. This is implemented via a context manager that wraps the execution of asynchronous tasks, guaranteeing that resources are cleaned up correctly. Additionally, the main module bootstraps the application by setting up the dependency injection container with all necessary modules, including Redis, RQ, and various business logic components.
_auctioning\platform/main · medium confidence
Dependencies
Initial dependency specification for all modules
Added requirements.txt and requirements-dev.txt files for each module (auctions, customer\_relationship, db\_infrastructure, foundation, main, payments, processes, shipping, shipping\_infrastructure, web\_app, web\_app\_models) and the root project. These files pin specific versions of dependencies such as Flask, SQLAlchemy, and Stripe, establishing the baseline environment for the application.
(dependencies) · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 61 → 63 (+1.9)
- Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.
Lenses
- Code Health 100 → 99 (-0.9)
- Architecture 100 → 94 (-6.2)
- Maturity 50 → 53 (+2.8)
- Readiness 50 → 52 (+2.7)
- Security 77 → 80 (+3.0)
- Domain Modelling 100 → 100 (-0.0)
Resolved (21)
- Coverage not included — suite not readable by the collector
- Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/payments/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements-dev.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: PYSEC-2026-2132 (auctioning_platform/requirements.txt)
- Medium IaC: CKV_DOCKER_3 (Dockerfile)
- No exposed public API
- Test reliability not included
- …and 1 more
New (82)
- Banned license: text-unidecode
- Documentation: no installation or build instructions (README.md)
- Documentation: no project overview (README.md)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- High IaC: WD-COMPOSE-0002 (docker-compose.yml)
- High IaC: WD-DOCKER-0001 (Dockerfile)
- High: security finding (details withheld)
- High: security finding (details withheld)
- Low IaC: DS-0026 (Dockerfile)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/payments/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- Medium CVE: [GHSA redacted] (auctioning_platform/requirements.txt)
- …and 62 more
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
Enforcer/clean-architecture 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 22 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit f0c1c0a8364996d309e7381b44933807529200b1 — the exact code this score is about.
- Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-821afab8930d.