Quick Start¶

Deze pagina beschrijft een minimale lokale start van ERP-NL voor ontwikkeling of evaluatie.

Vereisten¶

Installeer lokaal:

Node.js met npm;
Python 3.13 aanbevolen, Python 3.11 minimaal ondersteund;
PostgreSQL;
Git.

Dependencies installeren¶

Installeer de Python- en Node-dependencies vanuit de repositoryroot:

python -m pip install -r backend/requirements-dev.txt
npm install

Database configureren¶

ERP-NL gebruikt PostgreSQL. Zet minimaal een databaseconnectie via DATABASE_URL.

Voor lokale ontwikkeling kan de backend met een ontwikkelfallback draaien wanneer deze variabelen zijn gezet:

APP_ENV=development
ALLOW_INSECURE_DEV_DB_FALLBACK=true
DATABASE_URL=postgresql://user:password@localhost:5432/erp_nl

Voor productieachtige omgevingen hoort de applicatie met een expliciete runtime database-rol te draaien. De startup weigert superuser- en BYPASSRLS-rollen.

Backend starten¶

uvicorn backend.main:app --host 0.0.0.0 --port 8000 --reload

Bij startup voert de backend migraties uit, maakt indien nodig standaardbeheeraccounts aan, valideert de runtime database-rol en start payment worker loops.

Frontend starten¶

npm run dev

De Vite frontend draait lokaal op poort 5000. Requests naar /api worden via vite.config.ts geproxied naar http://127.0.0.1:8000.

Samen starten¶

bash start.sh

Bij een lege database maakt de applicatie een beheerder aan. Raadpleeg de README voor de actuele lokale bootstrapgegevens en omgevingsspecifieke instellingen.

Documentatiesite lokaal draaien¶

python -m pip install -r requirements-docs.txt
mkdocs serve

Valideer de documentatie met:

mkdocs build --strict