Fase 4: Documentatie & Generatie

Fase 4 is de automatiseringsfase van PDM. Waar de voorgaande fasen gericht waren op het empirisch verzamelen en analyseren van organisatiekennis, staat in deze fase de geautomatiseerde generatie van inzichtelijke, doelgroepgerichte weergaven en documenten centraal.

In deze fase schrijven we geen handmatige handboeken of statische dossiers; we compileren de tot stand gekomen SSoT rechtstreeks vanuit de Markdown-bronbestanden naar de dynamische Hugo-kennishub.

Belangrijk

Centrale vraag in deze fase

Hoe genereren we uit de centrale modelbron foutloos en consistent de juiste documentatie en weergaven voor de verschillende organisatorische doelgroepen?

Kernactiviteiten van de Model Steward

In deze fase voert de Procesdocumentalist (in de rol van Model Steward) vier programmatische hoofdtaken uit om de kwaliteit en consistentie van de output te waarborgen:

Modelbevriezing & Front-matter Audit: We controleren of alle objecten de status pdm_status: "Gerealiseerd" hebben bereikt en of de verplichte metadata-attributen (zoals pdm_bouwsteen, id, title en unieke relatiekeys) volledig en foutloos zijn ingevuld.
Generatie van Projecties & Diagrammen: We compileren de Markdown-bestanden in Hugo, waarbij de ingebedde Mermaid.js-diagrammen en relationele shortcodes automatisch worden gerenderd tot interactieve, visuele proceskaarten en stroomdiagrammen.
Geautomatiseerde Documentatie-extractie: We draaien de scripts die op basis van de SSoT-data direct de gewenste operationele views (zoals taakgerichte werkinstructies en Rolprofielen) genereren.
Syntactische Validatie: We runnen de geautomatiseerde integriteitscontroles om te verifiëren dat het netwerk voldoet aan alle syntactische regels (zoals nul zwevende objecten, strikte processtap-isolatie en een 100% mathematisch sluitende RACI-matrix).

Status van de 8 PDM-Bouwstenen in de realisatie-stand

In Fase 4 bereiken alle 8 bouwstenen hun definitieve rijpheidsniveau binnen het netwerk:

Werkdomein: Volledig gedefinieerd als de overkoepelende navigatiestructuur en thematische taxonomie binnen de Hugo-kennishub.
Proces: Voorzien van een uniek ID, een formele Proceseigenaar en helder gedefinieerde start- en eindcriteria (Triggers en Eindstatus).
Processtap: Ingebed in een logische chronologie via het front-matter parameter volgnummer. Actief, werkwoordgestuurd taalgebruik is overal consistent doorgevoerd conform Regel M9 (Actieve schrijfwijze) De naam van een processtap volgt de structuur: `[Actief Werkwoord in infinitief] + [Zelfstandig Naamwoord]` (bijv. "Controleren Factuur"). Bij een stap met een gateway-functie weerspiegelt de naam de beslissingsactiviteit (bijv. "Beoordelen Storingsprioriteit").(bijv. “Valideer aanvraag”, niet “Validatie aanvraag”).
Informatieobject: Zuiver gekoppeld als expliciete input of output aan de processtappen ( Regel M10 (Passieve informatie) Een informatieobject of fysiek object beschrijft puur de status of het materiaal (bijv. "Geverifieerd P1-ticket" of "Houten pallet") en bevat geen actiewerkwoord.en Regel P5 (Informatie-afhankelijkheid) Chronologie in de processtroom is altijd een gevolg van databeschikbaarheid. Stap B start pas als de benodigde input van stap A beschikbaar is.. Ieder informatieobject heeft een gedefinieerde fysieke of systemische drager.
Fysiek object: Volledig relationeel gemodelleerd binnen de materiële stromen en direct gekoppeld als fysieke in- of output aan de desbetreffende stappen.
Rol: Generieke, persoonsonafhankelijke rollen die via inkomende relatie-assen direct de correcte RACI-indicatoren (zoals R voor Responsible) op de processtappen activeren ( Regel B1 (Rollen boven personen) Er worden uitsluitend abstracte, generieke operationele entiteiten (Rollen) vastgelegd, nooit de namen van specifieke medewerkers. Dit houdt het model onafhankelijk van personele wisselingen.en Regel M13 (Geen persoonsnamen) Persoonsnamen in metadata of objectnamen zijn verboden. Dit leidt tot directe afkeuring (dus geen "Excel van Jan", maar "Sjabloon Productieplanning").).
Hulpmiddel: Systemen, applicaties of specifieke templates die conform Regel M4 (Hulpmiddel-isolatie) Een Hulpmiddel koppelen we nooit rechtstreeks aan een informatieobject of fysiek object, maar altijd aan een specifieke processtap (`Hulpmiddel --> processtap`) ten behoeve van de ketenimpact en system ketenimpact.strikt als ondersteunend instrument aan processtappen zijn gekoppeld, volledig ontdaan van dubbele registraties.
Regel / KPI: Wetgeving en interne kaders die als dwingende randvoorwaarde aan processtappen zijn gekoppeld ( Regel M8 (KPI-koppeling) Een KPI is uitsluitend gekoppeld aan een proces (aggregatieniveau) of een processtap (operationeel niveau). Directe koppelingen met hulpmiddelen of rollen zijn uitgesloten.en Regel M14 (Kaderbepaling) Een regel legt uitsluitend via een inkomende verbinding (`regel --> processtap`) prescriptieve, dwingende randvoorwaarden op aan een processtap, zonder de processtroom fysiek te onderbreken of te splitsen., inclusief de gekoppelde KPI-statuswijzers voor procesmeting ( Regel P6 (Geen live-metingen) Het kaderoverzicht (KPI's en regels) registreert uitsluitend vooraf vastgestelde definities, normen en kaders. Er worden binnen PDM geen live-metingen verricht om rust en voorspelbaarheid te borgen.).

Geautomatiseerde resultaten & opleverproducten

Het grote voordeel van de PDM-methodiek is dat er geen handmatige documenten meer worden geschreven. De volgende publicatiestukken rollen met één druk op de knop consistent en realtime uit de brondata:

Procesbeschrijvingen: Het tactische overzicht van het werkdomein ten behoeve van procesbesturing en governance.
Dynamische Werkinstructies: De microscopische handleiding voor de werkvloer, direct gegenereerd door alle in- en uitgaande objecten (Informatie, Hulpmiddelen, Regels) rondom de processtappen chronologisch onder elkaar te presenteren.
Rolprofielen: Dynamische overzichten die per generieke Rol inzichtelijk maken welke taken deze uitvoert, welke Hulpmiddelen hiervoor nodig zijn en welke Regels in acht genomen moeten worden ( Regel B1 (Rollen boven personen) Er worden uitsluitend abstracte, generieke operationele entiteiten (Rollen) vastgelegd, nooit de namen van specifieke medewerkers. Dit houdt het model onafhankelijk van personele wisselingen.).
Model-berekende RACI-matrices: Een onomstotelijk en sluitend overzicht van de taakverdeling, live uitgelezen uit de actieve relaties in de SSoT.
Impactanalyses: Een direct gegenereerd overzicht dat laat zien welke processen, regels of rollen worden geraakt zodra een specifiek Hulpmiddel of Informatieobject wijzigt.

Veelvoorkomende valkuilen in Fase 4

Valkuil op de werkvloer	Hoe lossen we het op?
Het model wordt een statisch plaatje. Men focust te veel op het handmatig uittekenen van een visuele flowchart in Visio of Miro. Een PDM-diagram is echter een projectie van data, nooit een handgetekende tekening.	Data-driven rendering: We voeren uitsluitend gestructureerde data in. De visualisatie (via Mermaid.js of Hugo-shortcodes) is een automatisch gegenereerd bijproduct van het netwerk.
Handmatige correcties (bronvervuiling). De neiging om typefouten of lay-outfouten direct in de gegenereerde HTML- of PDF-exports aan te passen.	Houd de bron zuiver: Elke wijziging, hoe klein ook, wordt altijd in het Markdown-bronbestand doorgevoerd. De SSoT regeert; handmatige aanpassingen in exports zijn ten strengste verboden.
Overmodellering. De microscopische werkelijkheid tot in het absurde willen vangen (bijv. elke afzonderlijke muisklik of toetsaanslag modelleren). Dit verhoogt de onderhoudslast enorm.	Houd de helikopterview: We modelleren processtappen uitsluitend op het niveau van een functionele transformatie (Regel M9). Knoppen en schermen horen thuis in systeemhandleidingen, niet in het procesmodel.
Hulpmiddelen verwarren met processen. Een processtap een naam geven als “Inloggen in Salesforce” of “Excel openen”. Dit zijn handelingen binnen een applicatie, niet de functionele processtap zelf.	Functionele naamgeving: Geef processtappen een functionele, systeem-onafhankelijke naam conform Regel T1. Het specifieke softwarepakket wordt er via Regel M4 als los Hulpmiddel aan gekoppeld.

Validatie 4: Oplevervalidatie

De overgang van Fase 4 naar Fase 5 (Validatie & Oplevering) markeert het ultieme kwaliteitsmoment van de Procesdocumentalist. Voordat de gegenereerde kennishub breed in de organisatie wordt gedeeld voor de validatieronde, voert de Model Steward bij Validatie 4: Oplevervalidatie de ultieme PDM-Integriteitstoets uit:

graph LR
    F4(Fase 4: Documentatie & Generatie) --> G4(Validatie 4: Oplevervalidatie) --> F5(Fase 5: Validatie & Oplevering)

Belangrijk

De PDM-Integriteitstoets

“Als ik nu de ID of de titel van één enkel Informatieobject of Hulpmiddel in de centrale Markdown-bron aanpas, verandert deze naam dan automatisch, direct en foutloos mee in álle gegenereerde projecties én in alle dynamisch gegenereerde documenten?”

Is het antwoord Nee? Dan ben je platte, statische tekst aan het typen in plaats van relaties te modelleren. De publicatie wordt direct afgekeurd.
Is het antwoord Ja? Dan is het model bewezen consistent, is de data-integriteit geborgd en is de publicatieset klaar voor de formele, finale validatieronde in Fase 5.

Zodra de front-matter vlag op Validatie_status: APPROVED wordt gezet, is de modelfase afgerond en start de menselijke validatie in de lijnorganisatie.

Gelinkte pagina’s en navigatie

Titel	Beschrijving
Processtroom	De primaire, dynamische weergave van de operationele keten. Toont hoe het werk en de informatie zich puur op basis van logische afhankelijkheid door de organisatie bewegen. Ideaal voor proceseigenaren en analisten.
RACI Matrix	Formaliseert en structureert organisatorische verantwoordelijkheden binnen het netwerk. Leidt beslissings- en uitvoeringsrechten objectief af uit de gemodelleerde relaties, vrij van politieke discussie. Voor auditors en managers.
Rollenmatrix	Kantelt het model naar het perspectief van één specifieke, persoonsonafhankelijke functionaris of rol. Toont een zuiver overzicht van operationele taken, informatiestromen en hulpmiddelen voor lijnmanagers en teams.
Systeemimpact	Projecteert applicaties en software rechtstreeks op de afhankelijkheden in de keten. Toont bij een IT-outage of migratie direct welke processen stagneren en waar de operationele impact landt. Voor IT-architecten en incident managers.
Ketenimpact	Maakt de netwerkhiërarchie en wiskundige dwarsverbanden van het model expliciet zichtbaar. Toont direct welke processen en rollen geraakt worden bij wijzigingen in hulpmiddelen of regels. Cruciaal voor change-regisseurs.
Kaderoverzicht	Koppelt handboeken, bedrijfsregels en KPI’s rechtstreeks aan de specifieke processen die zij normeren. Toont bij een procesaudit of normwijziging direct welke operationele stappen en actoren hiermee te maken hebben.
Procesbeschrijving	Het tactische overzicht van de procesketen. Beschrijft de logische ordening van de processtappen, de informatiestromen en de betrokken rollen, met focus op de onderlinge samenhang en overdrachtsmomenten.
Risico Matrix	Projecteert conditionerende regels, risico’s en compliance-eisen rechtstreeks op de kwetsbare punten in de operationele keten. Maakt de impact van veranderende wetgeving direct inzichtelijk voor risk-officers.
Rolprofiel	Het complete taken- en verantwoordelijkhedenpakket van een specifieke, persoonsonafhankelijke rol. Direct afgeleid uit het model, met een zuiver overzicht van alle uit te voeren stappen en benodigde hulpmiddelen.
Validatie 4 - Oplevervalidatie	De finale kwaliteitsdrempel vóór ingebruikname. Een fijnmazige toetsing waarbij de gegenereerde documentatie, projecties en diagrammen 100% worden gespiegeld aan het initiële scopeakkoord en de PDM-kwaliteitsnormen.
Werkinstructie	De operationele verdieping op het laagste niveau. Een gedetailleerde, stapsgewijze handleiding die de uitvoerder handmatig voorschrijft hoe een specifieke processtap exact en foutloos moet worden volbracht.