MES Hulpverleningstool

Laravel-applicatie (Livewire, Flux, Reverb) voor het plannen en uitvoeren van evenementenhulpverlening.

Lokaal ontwikkelen

De app draait lokaal op Laravel Herd met sqlite.

composer setup      # eenmalig: dependencies, .env, key, migraties, assets
composer run dev    # reverb, serve, queue, pail en vite in één keer
composer test       # pint, phpstan en Pest — draai dit vóór elke deploy

Deployen

Productie is een Docker Compose-stack op één server. Deployen gaat altijd vanaf een bijgewerkte main:

./deploy.sh              # sync, image bouwen op de server, stack herstarten
./deploy.sh --no-build   # alleen sync + herstart (nginx-/compose-wijzigingen)

Het script synct de werkmap (niet een git-revisie) en weigert bij ongecommitte wijzigingen. De one-shot migrate-service draait de migraties voordat de overige services starten.

De .env op productie aanpassen

De productie-.env staat op de server in de stackmap, naast docker-compose.yml. Die wordt nooit door deploy.sh overschreven of gesynct. Wijzigingen doe je daarom altijd met de hand, op de server zelf.

1. Log in op de server en ga naar de stackmap.
2. Maak een back-up voordat je iets wijzigt:

   cp .env .env.backup-$(date +%Y%m%d-%H%M%S)
   

3. Pas de waarde aan met een editor (bijv. nano .env). Gebruik .env.docker.example in de repo als naslag. Daarin staan alle sleutels die productie nodig heeft, met uitleg.
4. Laat de containers de nieuwe waarden inlezen. Een gewone restart is niet genoeg: de omgevingsvariabelen worden bij het aanmaken van een container ingelezen, en de entrypoint draait bij elke start config:cache. Maak de containers daarom opnieuw aan:

   docker compose up -d --force-recreate
   

5. Controleer of alles weer draait:

   docker compose ps
   docker compose logs --tail=50 app migrate
   

Valkuilen

• Schrijf elke waarde volledig uit. Compose geeft de .env als env_file letterlijk door aan de containers, dus verwijzingen als "${APP_NAME}" worden niet uitgevouwen.
• VITE_*-variabelen vragen om een nieuwe build. Die worden bij het bouwen in de JavaScript-bundle gebakken. Na een wijziging is een herstart niet genoeg: draai ./deploy.sh (of docker compose build gevolgd door docker compose up -d op de server).
• Wijzig APP_KEY nooit op een draaiende omgeving. Daarmee worden sessies ongeldig en zijn versleutelde gegevens (o.a. chatberichten en opgeslagen koppelingsgeheimen) niet meer te lezen.
• Nieuwe sleutels uit een feature komen niet vanzelf op productie. Zet ze vóór of direct na de deploy in de server-.env, anders draait config:cache met de standaardwaarden. Neem ze ook op in .env.docker.example, zodat de volgende beheerder ze kan vinden.
• Zet geen geheimen in git. De echte .env hoort alleen op de server te staan.