Ga naar inhoud

GitHub Codespaces

Deze repository bevat een devcontainer voor een Replit-achtige ontwikkelomgeving in GitHub Codespaces.

Repository: https://github.com/freestatesystems/erp-nl

Eerste Start

Open de repository in GitHub Codespaces. De container installeert automatisch:

  • Python 3.13 dependencies in .pythonlibs
  • Node dependencies via npm ci
  • Codex CLI via npm install -g @openai/codex
  • PostgreSQL in dezelfde devcontainer

De devcontainer zet standaard APP_ENV=development, staat setup- en demo-seed jobs toe, en gebruikt CODEX_HOME=/home/runner/workspace/codex-user.

De database start leeg. Bij het starten van de backend voert de bestaande applicatie-startup automatisch migraties uit en maakt de bootstrap-admin aan. De standaard lokale login is:

Gebruiker: local-admin
Wachtwoord: local-admin

De applicatie start je via de VS Code task Start ERP NL of:

bash scripts/codespaces/start.sh

De frontend draait op poort 5000; de backend API op poort 8000.

Demo data is optioneel. Laad die via de VS Code task Seed demo data of:

bash scripts/codespaces/seed-demo-data.sh

Codex CLI Login

Log één keer in met je ChatGPT-account:

codex --login

De setup maakt CODEX_HOME aan op /home/runner/workspace/codex-user en koppelt ~/.codex daaraan, zodat Codex-state buiten de repository blijft.

Database Behoud

PostgreSQL draait binnen de devcontainer. Maak voor zekerheid een dump voordat je de Codespace verwijdert of de container opnieuw opbouwt:

bash scripts/codespaces/db-backup.sh

Restore de laatste dump met:

bash scripts/codespaces/db-restore.sh

Een verwijderde Codespace verwijdert ook lokale database- en Codex-state. Bewaar belangrijke dumps buiten de Codespace als je ze later opnieuw nodig hebt.