0 Samenvatting
4 fases om alle bestaande Bossuyt apps samen te brengen in één serviceplatform.
Doel
De huidige apps — bossuyt_service_next (techniekers), vanventory-app (stockbeheer) en ocr-demo (werkbon scanning) — worden verbonden via een centrale Core API met gedeelde database en Keycloak authenticatie. Dynamics NAV blijft de master voor klant- en materiaaldata.
1 Architectuur
Gekozen aanpak: Progressive Integration / Hub & Spoke — bestaande apps blijven intact, Core API laag wordt er bovenop gebouwd.
Dynamics NAV
Klanten, materiaal, orders
⟷
🧠 Core API
Node.js / PostgreSQL
⟷
🔑 Keycloak
auth.fixassistant.com
↕
📱 Service App
Techniekers / mobiel
📦 Vanventory
Stockbeheer
📄 OCR Demo
Werkbon scanning
↕
🖥️ Admin Portal
Centrale beheer interface
✅ Waarom Hub & Spoke
- Bestaande apps blijven werken tijdens de migratie
- Elke app kan onafhankelijk worden aangepast
- Core API groeit incrementeel mee
- Minder risico dan een volledige rewrite
⚠️ Aandachtspunten
- NAV heeft geen REST API → CSV export workflow nodig
- Keycloak al geconfigureerd → reuse, niet herbouwen
- Data consistentie tussen apps via shared DB
- Offline-first voor techniekers blijft prioriteit
2 Tijdlijn — 22 Weken
Visueel overzicht van alle fases en taken per week.
Maand 1
Maand 2
Maand 3
Maand 4-5
Import service + sync jobs
3 Fase Details
Klik op een fase om de taken uit te klappen.
Setup van de centrale laag waarop alle andere fases bouwen. De bestaande apps blijven onaangeroerd.
🐳
Core API project opzetten
Node.js + TypeScript + Express/Fastify, Docker container, Traefik routing op api.bossuyt.fixassistant.com
W1–W2
🗄️
Shared PostgreSQL schema
Tabellen: technicians, customers, equipment, work_orders, sync_log. Separate schema's per app als naamruimte.
W2–W3
🔑
Keycloak JWT middleware
Core API valideert tokens van bestaand Keycloak op auth.fixassistant.com. Rollen: admin, technician, dispatcher.
W3–W5
✅
Health check + basis endpoints
GET /health, GET /api/v1/technicians, GET /api/v1/customers — readonly, hardcoded testdata
W4–W5
🚀
CI/CD pipeline
GitHub Actions of lokale deploy script: build → test → docker push → traefik reload
W5
Deliverable: Core API draait op server, Keycloak auth werkt, DB schema aangemaakt, basis endpoints beschikbaar.
NAV heeft geen REST API. Aanpak: periodieke CSV export uit NAV → import service in Core API → shared DB. Synchronisatie kan manueel starten of via cron job.
📤
NAV CSV export formaat definiëren
Met Bossuyt afstemmen welke velden geëxporteerd worden: klanten, apparatuur, open orders. NAV rapport of manuele export.
W6
⚙️
Import service bouwen
Node.js script: CSV inlezen → validatie → upsert in shared DB. Idempotent (meerdere runs = zelfde resultaat).
W6–W7
🔄
Sync scheduler
Cron job (bijv. dagelijks 06:00) of webhook trigger. Sync log bijhouden in DB met timestamp, #records, errors.
W7–W8
✅
Data validatie + conflict handling
Wat als klant in NAV verwijderd wordt? Soft delete strategie. Duplicate detectie op klantnummer.
W8–W9
Deliverable: NAV data (klanten, apparatuur) beschikbaar via Core API endpoints. Sync log zichtbaar.
React/Vite frontend als centraal beheerpaneel. Inloggen via Keycloak. Beheer van techniekers, sync status en gebruikersrechten.
⚛️
Admin Portal scaffolding
React + Vite + TypeScript. Auth via Keycloak PKCE flow. Routing: /dashboard, /technicians, /sync, /settings.
W10–W11
👤
Technicien beheer module
Overzicht alle techniekers, Keycloak rol toewijzing, actief/inactief zetten. Koppeling met NAV technician data.
W11–W12
📊
Sync dashboard
Overzicht laatste NAV syncs: datum, #records, errors. Manuele sync knop. Alert bij sync failure.
W12–W13
🔒
Rechten & audit log
Wie heeft wat gedaan? Audit trail voor admin acties. Role-based zichtbaarheid van menu items.
W13–W14
Deliverable: Admin portal live op admin.bossuyt.fixassistant.com. Technicien beheer + sync monitoring werkt.
Elke bestaande app wordt aangepast om data van de Core API te gebruiken i.p.v. eigen hardcoded data. Apps blijven zelfstandig werken als fallback.
📱
Service App → Core API
bossuyt_service_next: klantdata + apparatuur ophalen uit Core API. Werkbonnen opslaan via API. Keycloak login gebruiken.
W15–W17
📦
Vanventory → Core API
Stockbewegingen synchroniseren naar shared DB. Materiaal op werkbon koppelen aan Vanventory stock items.
W17–W19
📄
OCR Demo → Core API
Gescande werkbonnen opslaan in Core API als work_order records. LLM-geparsde velden direct in DB. Koppelen aan klant via NAV klantnummer.
W19–W22
✅
End-to-end test + acceptatie
Technician scant werkbon → OCR → Core API → zichtbaar in Admin Portal. Vanventory stock bijgewerkt. NAV sync werkt na update.
W21–W22
Deliverable: Alle 3 apps praten met Core API. Volledig end-to-end werkbon workflow operationeel.
4 Tech Stack
Wat blijft, wat is nieuw, wat is al aanwezig.
✅ Behouden
React + Vite (apps)
Keycloak
Docker + Traefik
PostgreSQL
Python/Flask (OCR)
Google Vision API
Claude Haiku (LLM)
🆕 Nieuw toe te voegen
Node.js/TypeScript (Core API)
Fastify of Express
CSV import service
Cron scheduler
Audit log middleware
React Admin Portal
🏗️ Infrastructure domeinen (voorstel)
api.bossuyt.fixassistant.com
admin.bossuyt.fixassistant.com
service.bossuyt.fixassistant.com
auth.fixassistant.com (bestaand)
5 Risico's & Mitigatie
Gekende risico's geïdentificeerd vanuit de brainstorm.
🔴 NAV heeft geen REST API
CSV export is manueel of vereist rapport customisatie in NAV. Mitigatie: vroeg afstemmen met Bossuyt welk formaat haalbaar is, ook ODBC/OData als alternatief verkennen.
🔴 Offline-first voor techniekers
Service app moet werken zonder internet (op klantlocatie). Mitigatie: lokale opslag + sync bij reconnect. Fase 4 prioriteit.
🟡 Keycloak rol-migratie
Bestaande gebruikers moeten de juiste rollen krijgen. Mitigatie: admin approval flow al gebouwd in family-ai-hub — hergebruiken.
🟡 Data duplicatie tussen apps
Klantdata staat nu verspreid. Mitigatie: Core API als enige bron van waarheid, apps lezen altijd uit Core API.
🟢 OCR fouten op moeilijke werkbonnen
LLM post-processing is al geïmplementeerd en getest (41/41 tests). Risico is laag.
6 Plan Analyse — Sterktes & Risico's
Kritische beoordeling van het plan door Claude + OMC.
✅ Wat goed is
✓
Progressive integration is de juiste keuze
Alles tegelijk herschrijven zou eindeloos duren en wat nu werkt kapotmaken. Hub & Spoke geeft je de tijd om stap voor stap te migreren zonder downtime.
✓
Keycloak hergebruiken is slim
Al geconfigureerd op auth.fixassistant.com en battle-tested. Nieuwe auth laag bouwen zou weken kosten voor nul meerwaarde.
✓
OCR is al klaar — gratis quick win in Fase 4
41/41 tests groen, LLM post-processing geïmplementeerd. Koppelen aan Core API is het enige dat rest.
✓
22 weken is realistisch (voor één deeltijdse developer)
Fases zijn goed gedimensioneerd. Niet te ambitieus, niet te conservatief.
⚠️ Aandachtspunten & Suggesties
🔴
NAV is de grootste onbekende — valideer dit EERST
Heel Fase 2 staat of valt met wat Bossuyt effectief kan exporteren. Als NAV oud of zwaar gecustomiseerd is, kan een bruikbare CSV export weken kosten. Aanbeveling: vraag nu al een echte CSV export op en valideer of je die kunt parsen — vóór je ook maar één regel code schrijft.
🔴
Offline-first is onderschat
Service App op week 15–17 is optimistisch als techniekers volledige offline ondersteuning nodig hebben. Lokale opslag + sync-bij-reconnect is op zichzelf al een 3–4 weken taak. Plan hier extra tijd voor in of beslis bewust dat offline een latere fase is.
🟡
Wie onderhoudt dit systeem?
Het plan vermeldt niet of jij dit alleen bouwt als side project, of Bossuyt een eigen developer heeft. Dat bepaalt hoeveel abstractie, documentatie en "ops-vriendelijkheid" je inbouwt. Klaar stellen vóór je begint.
🟡
Fase 4 heeft 3 parallelle integraties — te riskant
Service App + Vanventory + OCR lopen deels gelijktijdig. Als één blokkeert, slip je de hele fase. Beter strikt sequentieel: Service App volledig af → dan Vanventory → dan OCR.
💡 Concrete eerste stap:
Stuur Bossuyt een e-mail deze week en vraag een testexport uit NAV: klanten + apparatuur als CSV. Dat valideer je in een paar uur. Als het lukt → Fase 2 wordt een stuk eenvoudiger. Als het niet lukt → weet je vroeg genoeg dat je een andere strategie nodig hebt (ODBC, OData, of manueel).
Bossuyt ERP Masterplan · Gegenereerd April 2026 · Gebaseerd op Gemini brainstorm sessie · Finalized met Claude + OMC