RaconWorks Integratie Blauwdruk & API Architectuur
Versie 1.0 - Architectuur Visie
1. Managementsamenvatting
RaconWorks fungeert als het "System of Engagement" (Gebruikerslaag) voor de technische dienst,
en overbrugt de kloof tussen rigide "Systems of Record" (zoals SAP, Ultimo, Maximo) en moderne
"Intelligence Layers" (zoals AI/Bedrock).
Deze blauwdruk beschrijft hoe RaconWorks klanten in staat stelt hun bestaande ERP/CMMS te behouden als de "enige
bron van waarheid" voor assets en voorraad, terwijl RaconWorks wordt ingezet als intuïtief platform voor
efficiënte uitvoering,
data-verrijking en AI-gereedheid.
2. Architectuur op Hoofdlijnen
RaconWorks is ontworpen om te draaien in een On-Premise of Hybride omgeving. Dit waarborgt
data-soevereiniteit terwijl moderne connectiviteit mogelijk blijft.
graph TD
subgraph Client_Secure_Environment ["Klant Veilige Omgeving (On-Premise)"]
direction TB
CMMS[("Legacy CMMS (SAP / Ultimo / Maximo) System of Record")]
AI[(" AI & Intelligentie (AWS Bedrock / Azure
OpenAI) Private Modellen")]
middleware[" Integratielaag (RaconWorks Connector)"]
end
subgraph The_Edge ["De Werkvloer (Edge)"]
App[" RaconWorks App (PWA / Mobiel) System
of Engagement"]
end
CMMS <--> middleware
middleware <--> App
middleware --> AI
AI --> App
classDef box fill:#e1f5fe,stroke:#01579b,stroke-width:2px;
classDef storage fill:#fff3e0,stroke:#e65100,stroke-width:2px;
class CMMS,AI storage;
class middleware,App box;
3. Data Integratie Strategie (De "Stekkers")
RaconWorks maakt gebruik van een lichtgewicht Middleware Connector die vertaalt tussen
de
specifieke API van het CMMS van de klant en de geoptimaliseerde JSON-structuur van RaconWorks.
Inkomende Stromen (CMMS ->
RaconWorks)
Doel: De monteur voorzien van context zonder zoekwerk.
Data Object
Bron
Frequentie
Doel
Werkorders
CMMS
Real-time / Elk uur
Taken direct in de inbox van de gebruiker. Geen handmatige invoer.
Asset Boom
CMMS
Dagelijkse Sync
Zorgt dat de asset-structuur (Locatie > Machine > Onderdeel) klopt met ERP.
Voorraad
ERP/WMS
Real-time (On-demand)
Live check: "Is lager SKF-6204 op voorraad?"
Historie
Data Lake
On-demand
Toon de laatste 5 interventies aan dit asset voor diagnose-context.
Uitgaande Stromen (RaconWorks ->
CMMS)
Doel: Administratie automatiseren en het archief verrijken.
Data Object
Bestemming
Trigger
Rijkheid
Status Update
CMMS
Knopdruk
"Gestart", "Gepauzeerd", "Gereed".
Bewijs Document
DMS / Ultimo
Bij Afronding
PDF Rapportage met getekende checklist, foto's en metingen.
Tijdreg.
HR / SAP
Bij Afronding
Exacte 'sleuteltijd' (wrench time) versus administratieve tijd.
Meeste "AI in Onderhoud"-projecten falen door slechte datakwaliteit ("Garbage In, Garbage Out").
RaconWorks
fungeert als de rigoureuze Data Verzamelaar die AI levensvatbaar maakt.
Vectoriseren: RaconWorks middleware verwerkt deze "rijke context" (bijv. "Pomp
trilling
hoog" + Foto van uitlijning).
Leren: Deze data voedt het Private Bedrock Model van de Klant.
Assisteren: De volgende keer dat een monteur bij Pomp 302 staat, vraagt
RaconWorks
aan AI: "Wat gaat hier meestal kapot?".
AI Antwoord: "Controleer de koppeling-uitlijning; gebaseerd op 4 eerdere rapporten uit
2024 is
dit in 80% van de gevallen de bronoorzaak."
5. Beveiliging & Compliance (Enterprise Ready)
Data Soevereiniteit: De app-container kan worden uitgerold binnen de
on-premise omgeving
van de klant. Data verlaat nooit hun beheer.
Authenticatie: Integratie met Single Sign-On (SSO) zoals Azure AD of Okta.
Offline First: De app creëert een lokaal versleutelde database. Cruciaal voor
compliance in
"dode zones" (ATEX bunkers, kelders), zodat auditors altijd toegang hebben tot werkplannen, zelfs
zonder internet.
6. Implementatiefasen
Fase 1 (Standalone): RaconWorks als "Zijwieltje". Handmatige CSV import/export.
Directe
winst in gebruiksgemak.
Fase 2 (Geverifieerde Integratie): Eenrichtingsverkeer. Werkorders komen BINNEN.
PDF
rapportages gaan er UIT naar het archief.
Fase 3 (Het Platform): Tweerichtings API-sync + Live Voorraad Check + AI Assistent
integratie.