OvaholDeveloper documentation

Multi-tenant healthcare equipment management — architecture, platform rules, and the way we ship.

Run it locally

Docker Compose brings up the API, scheduler, worker, Valkey and PostgreSQL. The frontend runs on the host with Vite.

Getting started

A modular monolith with 13 business modules, enforced import boundaries, and an architecture test in every module.

Architecture

Every facility owns a PostgreSQL schema, selected per request by the tenancy middleware.

Multi-tenancy

Three role scopes — global, organization, facility — with the facility context passed on every tenant request.

Roles and access

One plan row per tier, a price row per billing interval, and a lifecycle scheduler that never lets a term lapse silently.

Billing and plans

Feature branches into dev, batched releases into main, and a Coolify deploy that follows the main branch.

Release process

If you are new to the codebase, read in this order:

The API reference is generated from api/openapi.yaml; it is never hand-maintained.