CloverRateBackend Documentation

Code-annotated documentation for the implemented FastAPI modular monolith.

Runtime Map

Request Flows

Routes and Controllers

Where FastAPI registers endpoints, how transport handlers map request data, and where errors become API responses.

Modules and Domains

How transport, application services, domain policies, adapters, contracts, and repositories chain together.

Persistence and RLS

How unit-of-work factories open tenant-scoped SQLAlchemy sessions and set PostgreSQL execution context.

Contracts and Models

How request schemas, response payload builders, application models, domain entities, and ORM rows stay separated.

Workers and Outbox

How committed outbox rows become Redis signals or Celery tasks and how worker handlers dispatch domain work.

Documentation Portals

CloverRate Spec DocumentationRequirements, design constraints, architecture decisions, and platform specifications.CloverRate Frontend DocumentationFrontend implementation portal, currently pending source code.

How To Read These Docs

These pages annotate the backend code that exists under backend/app. They do not restate requirements or prescribe future implementation work; those concerns live in the spec docs.

Implementation pages use short code snippets with captions like backend/app/main.py:9 so you can jump directly to the source. Links to requirements, design docs, and ADRs point outward instead of duplicating their content.