Deployment

Deze pagina beschrijft de hoofdlijnen voor deployment van ERP-NL. Details kunnen per omgeving verschillen.

Build

De frontend wordt gebouwd met:

npm run build

Wanneer dist/public aanwezig is, kan de backend de React SPA statisch serveren.

Backend runtime

De backend draait als FastAPI-app. Bij startup voert de applicatie migraties uit, maakt indien nodig standaardbeheeraccounts aan, valideert de runtime database-rol en configureert achtergrondworkers.

Belangrijke productie-eisen:

• gebruik een vaste AUTH_SECRET_KEY;
• gebruik een expliciete runtime database-rol via ERP_APP_DB_USER en ERP_APP_DB_PASSWORD;
• laat runtimeverkeer niet via superuser- of BYPASSRLS-rollen lopen;
• configureer DATABASE_URL of migratieconnecties bewust per omgeving;
• zet demo seed jobs alleen expliciet aan waar dat veilig is.

Externe afhankelijkheden

Afhankelijk van de omgeving kunnen deze services nodig zijn:

• PostgreSQL;
• Keycloak/OIDC;
• bankconnectoren;
• KvK en VIES;
• object storage voor attachments;
• ingress/reverse proxy voor HTTPS en API-routing.

Documentatiebuild

De documentatiesite wordt gevalideerd met:

python -m pip install -r requirements-docs.txt
mkdocs build --strict

Deze PR voegt alleen build-validatie toe. Automatische deployment van de documentatiesite is nog niet inbegrepen.