Repair Angel v2 — Installatiehandleiding

🤏

RepairAngel

Reparatie Beheersysteem

v2.0

Installatiehandleiding

Serverinstallatie • Configuratie • Integraties • Updates

Versie 2.0 — Maart 2026 — Vertrouwelijk document

Inhoudsopgave

Vereisten
Server Installatie (eerste keer)
Laravel Configuratie (.env)
Opslag rechten
Cron instellen
Post-installatie seeding
Eerste login
Integraties configureren
Medewerkers configureren
Updates uitrollen

1 Vereisten

Component	Minimale versie	Aanbevolen
PHP	8.2	8.3
Composer	2.x	Laatste stabiel
MySQL / MariaDB	5.7 / 10.4	8.0 / 10.6
Node.js	18	20 LTS
PHP-extensies	`pdo_mysql`, `mbstring`, `openssl`, `fileinfo`, `curl`, `zip`, `gd`

Shared hosting (cPanel)

Selecteer PHP 8.2+ via de PHP Selector (MultiPHP of CloudLinux).
Zet alle benodigde extensies aan in de PHP-instellingen van cPanel.
Zorg dat SSH-toegang actief is voor Artisan-commando's.
Controleer of Cron Jobs beschikbaar zijn onder Advanced → Cron Jobs.

ℹ

De frontend (dist/) is een statische Vue 3-build en vereist geen Node op de server — Node is alleen nodig op de ontwikkelmachine bij bouwen.

2 Server Installatie (eerste keer)

Upload de volgende mappen/bestanden via FTP (FileZilla) of de cPanel Bestandsbeheerder:

Lokale bron	Uploaddoel op server
`api/`	`/public_html/repair-angel-v2/api/`
`dist/*` inhoud	`/public_html/repair-angel-v2/`
`.htaccess`	`/public_html/repair-angel-v2/.htaccess`

⚠

Upload de inhoud van dist/ (niet de map zelf) rechtstreeks naar /public_html/repair-angel-v2/. De index.html moet dus op /public_html/repair-angel-v2/index.html staan.

Installeer daarna de PHP-dependencies via SSH:

cd /public_html/repair-angel-v2/api
composer install --no-dev --optimize-autoloader

3 Laravel Configuratie (.env)

Kopieer het voorbeeldbestand:
cp api/.env.example api/.env
Open api/.env en vul de databasegegevens in:

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=jouw_database_naam
DB_USERNAME=jouw_db_gebruiker
DB_PASSWORD=jouw_db_wachtwoord

APP_URL=https://yourdomain.com/repair-angel-v2
APP_ENV=production
APP_DEBUG=false

Genereer de applicatiesleutel:
```
php artisan key:generate
```
Voer de databasemigraties uit:
```
php artisan migrate
```
Vul de basistabellen (rollen, instellingen, etc.):
```
php artisan db:seed
```

Cache de configuratie voor productie:

php artisan config:cache
php artisan route:cache

✓

Controleer na migrate in de database of de tabel migrations correct gevuld is. Als er fouten optreden, verifieer dan eerst de DB-verbinding via php artisan db:show.

4 Opslag rechten

Stel de juiste schrijfrechten in op de storage-mappen en maak de symbolische link aan:

chmod -R 775 api/storage
chmod -R 775 api/bootstrap/cache
php artisan storage:link

⚠

Op sommige shared hosting-omgevingen is 775 niet voldoende en is 777 tijdelijk nodig. Gebruik 777 alleen als 775 niet werkt en herstel dit daarna naar 775.

5 Cron instellen

De Laravel Scheduler is vereist voor:

Automatische SLA-statusupdates en escalaties
Terugkerende facturen / abonnementen
Geplande e-mail- en SMS-notificaties

Voeg de volgende cron job toe (cPanel → Advanced → Cron Jobs, of via crontab -e):

* * * * * cd /home/gebruiker/public_html/repair-angel-v2/api && php artisan schedule:run >> /dev/null 2>&1

ℹ

Pas /home/gebruiker/ aan naar het werkelijke pad van jouw hostingaccount. Controleer het volledige pad via pwd in de SSH-sessie vanuit de api/-map.

6 Post-installatie seeding Eenmalig

Na de eerste login (zie stap 7) moet je twee endpoints aanroepen met een admin-token om de standaardinhoud te laden. Gebruik een API-client (bijv. Postman, Insomnia of curl):

Tutorials laden

POST https://yourdomain.com/repair-angel-v2/api/tutorials/seed
Authorization: Bearer <admin-token>

Brieftemplates laden

POST https://yourdomain.com/repair-angel-v2/api/letter-templates/seed
Authorization: Bearer <admin-token>

✓

Het admin-token is op te halen na inloggen via Mijn Profiel → API Tokens in de applicatie.

7 Eerste login

URL: https://yourdomain.com/repair-angel-v2/
E-mailadres: admin@repairangel.nl
Wachtwoord: Admin@123

⚠

Verander het standaardwachtwoord direct na de eerste login!
Ga naar Mijn Profiel → Wachtwoord wijzigen. Gebruik een sterk, uniek wachtwoord.

8 Integraties configureren

Ga naar Systeem → Integraties in het beheermenu.

Integratie	Benodigde gegevens	Status
UPS	Client ID Client Secret Rekeningnummer Verkrijgbaar via UPS Developer Portal → Apps	Optioneel
Twilio	Account SID Auth Token Van-nummer (E.164 formaat)	Optioneel
Mollie	API-sleutel (`live_...` of `test_...`)	Optioneel
OpenAI	API-sleutel (`sk-...`) Model kiezen (bijv. `gpt-4o`)	Optioneel
SnelStart	Abonnementssleutel Client ID	Optioneel

ℹ

Integraties zijn onafhankelijk van elkaar. Het systeem werkt ook zonder externe koppelingen — activeer alleen wat je daadwerkelijk gebruikt.

9 Medewerkers configureren

Ga naar Systeem → Medewerker Instellingen.

Per medewerker instellen

Telefonische extensie — 3CX-extensienummer (voor koppeling met telefooncentrale)
Mobiel nummer — voor Twilio SMS-notificaties
E-mailaccount — kies het type:
- SMTP — host, poort, gebruikersnaam, wachtwoord, SSL/TLS
- Outlook / Microsoft 365 — OAuth2, koppel via Microsoft-inlogknop
- Google Workspace — OAuth2, koppel via Google-inlogknop

✓

Gebruik de Test e-mail sturen-knop na het opslaan van de e-mailinstellingen om te bevestigen dat de verbinding werkt.

10 Updates uitrollen

Backend update (via SSH)

cd /public_html/repair-angel-v2/api
git pull
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

Frontend update (op ontwikkelmachine)

# Bouw de nieuwe versie lokaal
npm run build

# Upload daarna de inhoud van dist/ naar de server
# Via FTP: /public_html/repair-angel-v2/ (overschrijf bestaande bestanden)

⚠

Voer backend-updates altijd uit buiten piekuren. De opdracht php artisan migrate --force is vereist in productieomgeving (Laravel vraagt anders om bevestiging).

⚠

Maak altijd een databaseback-up vóór een update met migraties. Gebruik cPanel → Databases → phpMyAdmin → Exporteren, of via SSH:
mysqldump -u gebruiker -p database_naam > backup_$(date +%Y%m%d).sql