ERP-NL

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.14;
  • PostgreSQL;
  • Git.

Dependencies installeren ​

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

bash
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:

env
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 ​

bash
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 ​

bash
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.

Eerste login ​

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

Documentatiesite lokaal draaien ​

bash
npm run docs:dev

Valideer de documentatie met:

bash
npm run docs:build