Architecture¶

Revel's backend is a Django application that uses Django Ninja for the API layer, Celery for async tasks, and PostgreSQL (with PostGIS) for storage. The codebase follows a clear separation between controllers (API endpoints), services (business logic), and models (data layer).

graph LR
    Client -->|HTTP/JWT| API[Django Ninja API]
    API --> Controllers
    Controllers --> Services
    Services --> Models
    Services --> Celery[Celery Tasks]
    Celery --> Services
    Models --> PostgreSQL[(PostgreSQL)]
    Celery --> Redis[(Redis)]

Core Principles¶

• Service layer owns business logic: controllers are thin, models are data-only
• Hybrid service pattern: functions for stateless ops, classes for stateful workflows
• Explicit over magic: no DI container, no framework lock-in beyond Django Ninja
• Type safety: strict mypy, typed schemas, model enums as source of truth

Sections¶