src/
├── cache/       # Redis client, rate limiting
├── daemons/     # background worker entrypoints (BaseDaemon, registry)
├── database/    # DB CRUD operations
├── errors/      # HTTP errors
├── logging/     # queue-based logging infra + HTTP middleware
├── messaging/   # RabbitMQ client, producers, consumers, topology
├── migrations/  # Alembic migrations
├── models/      # Pydantic and SQLAlchemy models, configs, RabbitMQ topology
├── reports/     # reports
├── service/     # business logic (auth, users_crud, email sending)
└── web/         # routes (protected_routes)

Layers are connected top to bottom: web → service → database → models.

Background workers (RabbitMQ)

Email sending (welcome / password-reset) runs as separate daemon processes, decoupled from the web API via a RabbitMQ topic exchange:

main.py / daemon_run.py → apply_topology() → RabbitMQ ("email" exchange)
                                                   ├── queue_welcome_email → WelcomeEmailConsumer
                                                   └── queue_reset_email  → ResetEmailConsumer

Each queue has a matching dead-letter queue for messages that fail permanently (bad data, non-retryable errors) instead of retrying forever. Run a worker locally with:

python daemon_run.py welcome_email   # single daemon
python daemon_run.py --all           # all daemons enabled in configs/daemons.json

Authentication

JWT access + refresh tokens
Refresh token is stored in the DB as a SHA256 hash, with rotation and revocation support
Passwords are hashed with bcrypt
RBAC: direct user permissions + permissions via groups, checked through require_permissions()

Testing

tests/
├── unit/
├── integrated/
└── e2e/

Uses pytest, pytest-asyncio, pytest-cov, pytest-mock, allure-pytest.

Allure report

make allure needs the Allure command-line tool (Java-based, not a pip package) — allure-pytest only writes raw result files, the CLI turns them into an HTML report.

Download Allure 2.44.0 from github.com/allure-framework/allure2/releases.
Extract it into .venv/allure-2.44.0/ so that .venv/allure-2.44.0/bin/allure exists — this matches the ALLURE variable already set in makefile.
If you install it somewhere else (or on Windows), update the ALLURE variable at the top of makefile to point to your actual allure binary path — the Windows path is already there, commented out.

make test     # runs pytest, writes results to tests/allure-results/reports
make allure   # builds tests/allure-results/html/index.html from those results

Installation

Requires Poetry itself to be installed first (it's a global tool, not a project dependency). Recommended via pipx:

pipx install poetry

or via the official installer:

curl -sSL https://install.python-poetry.org | python3 -

Then install the project dependencies:

poetry install

Running migrations

alembic upgrade head

CI/CD

Pipeline is set up via Gitea Actions (.gitea/workflows/ci.yml).

Deployment

The repository includes ready-made docker/ and ansible/ configs for containerization and deployment.

License

MH.Dmitrii's project