Skip to content
CAI
Software that uses CAICheck a score

Enforcer/clean-architecture

62.6

Adequate · 22 September 2026

2.5k

lines of production code

Python

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.