De PadelOS Kennisbank is de centrale informatieomgeving voor iedereen die PadelOS gebruikt, beheert, ontwikkelt, test, ondersteunt of verder helpt uitbouwen. De kennisbank brengt functionele, technische, sportinhoudelijke en organisatorische kennis samen in één herkenbare structuur.
Gebruikers moeten niet afhankelijk zijn van losse berichten, persoonlijke uitleg, verouderde documenten of kennis die alleen bij één ontwikkelaar of trainer aanwezig is. Handleidingen, procedures, begrippen, tutorials, technische specificaties en release-informatie worden daarom centraal vastgelegd, gecontroleerd en actueel gehouden.
De kennisbank ondersteunt de huidige PadelOS-omgeving met Google Apps Script, Google Sheets en Google Sites. Tegelijkertijd vormt zij de documentatiebasis voor de doorgroei naar CAMTE en uiteindelijk CAMTESI: de internationale, meertalige en multi-tenant cloudarchitectuur van PadelOS.
PadelOS beschouwt documentatie niet als een bijproduct van softwareontwikkeling, maar als een zelfstandig en essentieel onderdeel van het platform. Een functie is pas werkelijk bruikbaar en overdraagbaar wanneer duidelijk is:
wat de functie doet;
voor wie de functie bedoeld is;
hoe de functie wordt gebruikt;
welke gegevens worden verwerkt;
welke rollen en rechten van toepassing zijn;
welke beperkingen en risico’s bestaan;
hoe problemen worden opgelost;
wie verantwoordelijk is voor onderhoud;
bij welke softwareversie de uitleg hoort.
De visie is één betrouwbare kennisbron waarin mensen snel de juiste informatie kunnen vinden, zonder eerst de volledige technische of organisatorische structuur van PadelOS te hoeven kennen.
De kennisbank moet uiteindelijk functioneren volgens het principe van een gecontroleerde “single source of truth”: één centrale, herleidbare en versiegebonden bron per onderwerp.
Naarmate PadelOS groeit, neemt ook de hoeveelheid kennis snel toe. Zonder centrale structuur ontstaan gemakkelijk:
verschillende versies van dezelfde handleiding;
verouderde schermafbeeldingen en instructies;
onduidelijkheid over beschikbare en geplande functies;
technische kennis die alleen bij ontwikkelaars aanwezig is;
terugkerende supportvragen;
afwijkende definities van tabellen, velden en KPI’s;
onvoldoende overdracht aan nieuwe trainers, beheerders en partners;
fouten door verkeerd uitgevoerde procedures;
documentatie zonder eigenaar of controledatum;
onduidelijkheid over privacy-, security- en beheerafspraken.
De PadelOS Kennisbank voorkomt dat informatie verspreid raakt over e-mails, chats, documenten, spreadsheets, websites en persoonlijke notities. Externe documenten kunnen blijven bestaan, maar worden vanuit een centrale index geregistreerd en ontsloten.
De inhoud wordt afgestemd op verschillende gebruikersgroepen. Iedere doelgroep krijgt een eigen ingang, taalniveau en informatiediepte.
Spelers vinden uitleg over accounts, profielen, planning, aanwezigheid, lessen, betalingen, privacy en meldingen.
Trainers krijgen toegang tot handleidingen voor lesvoorbereiding, oefeningen, planning, evaluaties, spelersontwikkeling, rapportages en de verantwoorde inzet van de AI Coach.
Beheerders vinden procedures voor gebruikersbeheer, organisaties, locaties, rollen, gegevenskwaliteit, imports, facturatie, rapportages, back-ups en incidenten.
Technische documentatie behandelt architectuur, Apps Script, Registry-onderdelen, gegevensmodellen, API-endpoints, authenticatie, deployments, logging, testen en integraties.
Deze doelgroepen krijgen testinstructies, acceptatiecriteria, bekende problemen, storingsprocedures, foutcodes, diagnosevragen en escalatieroutes.
Zij werken met redactierichtlijnen, terminologielijsten, vertaalstatussen, versies, controleprocessen en publicatievoorwaarden.
Organisaties krijgen informatie over onboarding, inrichting, gegevensbeheer, rollen, lokale procedures, samenwerking en toekomstige tenantconfiguratie.
De PadelOS Kennisbank bevat verschillende documenttypen, die ieder een herkenbaar doel en format krijgen.
Documenttype
Doel
Snelstartgids
Een gebruiker snel met een onderdeel laten beginnen
Gebruikershandleiding
Een functie stap voor stap leren gebruiken
Installatie-instructie
Een omgeving technisch installeren of configureren
Beheerprocedure
Een terugkerende beheertaak veilig uitvoeren
Technische documentatie
Architectuur, code, gegevens en afhankelijkheden uitleggen
API-documentatie
Endpoints, verzoeken, antwoorden en foutcodes beschrijven
Tutorial
Leren door een concrete praktijksituatie uit te voeren
FAQ
Veelgestelde vragen kort en begrijpelijk beantwoorden
Probleemoplossing
Fouten herkennen, onderzoeken en herstellen
Begrippenlijst
Definities en afkortingen uniform vastleggen
Beleidsdocument
Afspraken, verantwoordelijkheden en kaders beschrijven
Release-informatie
Nieuwe, gewijzigde en vervallen functies registreren
Beslisdocument
Een ontwerp- of beleidskeuze en de argumentatie vastleggen
Bekend probleem
Een geconstateerde fout en tijdelijke oplossing beschrijven
Trainingsmateriaal
Gebruikers, trainers en beheerders gericht opleiden
Elk document krijgt metadata, zoals eigenaar, doelgroep, onderwerp, taal, status, versie, softwareversie, controledatum en publicatiedatum.
De kennisbank sluit aan op de vaste PadelOS-structuur. Hierdoor kan documentatie zowel per doelgroep als per platformonderdeel worden gevonden.
De hoofdindeling bestaat uit:
00🏛️ PadelOS Master Index;
1🧭 Strategie & Roadmap;
2🗄️ Database, Registry & CRUD;
3🧩 Enterprise Portal & UX;
4🔐 Accounts, Rollen & Security;
5📅 Planning, Lessen & Banen;
6🎾 Lesvoorbereiding & Oefeningen;
7💶 Facturatie & Betalingen;
8🏢 Clubs, Locaties & Organisaties;
9🔌 API, Integraties & Import/Export;
10🤖 AI Coach & Automatisering;
11📊 Dashboard & Rapportages;
12🌍 Community, Partners & Pilots;
13📐 Blueprint & Architectuur;
14🧪 Testen & Acceptatie;
15☁️ Deployment & Cloud;
16⚙️ DevOps & Monitoring;
17📚 Kennisbank;
18🛟 Support & Service;
19⚖️ Governance, Privacy & Compliance;
20🚀 Innovatie, Internationalisatie & Groei.
Een kennisartikel kan aan meerdere onderdelen worden gekoppeld. Een artikel over het importeren van spelersgegevens hoort bijvoorbeeld bij Database, Import/Export, Security, Testen en Support.
De kennisbank moet op verschillende manieren toegankelijk zijn. Niet iedere gebruiker kent de officiële naam van een module of weet onder welk PadelOS-onderdeel een onderwerp valt.
Daarom worden meerdere navigatieroutes aangeboden:
zoeken op woorden en zinnen;
bladeren per PadelOS-onderdeel;
bladeren per doelgroep;
bladeren per taak, zoals plannen, factureren of importeren;
bladeren per documenttype;
zoeken op foutcode;
selecteren van een softwareversie;
selecteren van een taal;
bekijken van nieuwe en recent gewijzigde artikelen;
openen van gerelateerde artikelen vanuit het PadelOS-portaal.
Belangrijke artikelen kunnen rechtstreeks vanuit een scherm, formulier, tabel, foutmelding of helpknop worden geopend. Een gebruiker die in de module BETALINGEN werkt, hoeft daardoor niet eerst handmatig door de volledige kennisbank te navigeren.
De zoekfunctie moet meer doen dan alleen exacte woorden vergelijken. Zij moet rekening houden met titels, samenvattingen, hoofdtekst, trefwoorden, foutcodes, tabelnamen, veldnamen, synoniemen en veelgebruikte gebruikersvragen.
Voorbeelden van zoekopdrachten zijn:
“Hoe voeg ik een speler toe?”
“Trainer kan planning niet wijzigen”
“CSV-import mislukt”
“Wat betekent TenantID?”
“Factuur staat nog open”
“Hoe herstel ik een verwijderd record?”
“API 401 fout”
“Les exporteren naar PDF”
Zoekresultaten worden bij voorkeur gerangschikt op relevantie, actualiteit, taal, toegangsrecht en overeenkomst met de gebruikersrol.
Voor de huidige Google Sites-omgeving kan worden begonnen met overzichtspagina’s, vaste categorieën, interne links, zoektermen en een centrale index in Google Sheets. In CAMTESI kan dit doorgroeien naar volledige tekstindexering, filters, zoekstatistieken, synoniemenbeheer en eventueel een gecontroleerde AI-zoekassistent.
Om artikelen herkenbaar en vergelijkbaar te maken, gebruikt PadelOS een vaste artikelopbouw.
Een volledig kennisartikel bevat waar relevant:
titel;
korte samenvatting;
doelgroep;
toepasselijke rol of rechten;
PadelOS-onderdeel;
doel van de procedure;
voorwaarden en benodigdheden;
stapsgewijze instructie;
verwacht resultaat;
waarschuwingen en veiligheidsinformatie;
voorbeelden;
schermafbeeldingen of video;
veelgemaakte fouten;
probleemoplossing;
gerelateerde artikelen;
software- en documentversie;
auteur en reviewer;
datum van laatste controle;
wijzigingsgeschiedenis;
mogelijkheid om feedback te geven.
Korte FAQ-antwoorden hoeven niet alle velden zichtbaar te tonen, maar blijven achter de schermen wel voorzien van de noodzakelijke metadata.
Gebruikershandleidingen beschrijven concrete taken vanuit het perspectief van de gebruiker. Zij volgen niet uitsluitend de technische modulestructuur, maar vooral herkenbare werkzaamheden.
Voorbeelden zijn:
een account activeren;
een speler registreren;
een trainer aan een organisatie koppelen;
een locatie en baan toevoegen;
een terugkerende lesreeks plannen;
aanwezigheid registreren;
een lesvoorbereiding samenstellen;
een SMART-leerdoel vastleggen;
een factuur aanmaken;
een CSV-bestand importeren;
een rapport exporteren;
een fout melden;
toestemming of privacyvoorkeuren wijzigen.
Tutorials werken met praktijksituaties en voorbeeldgegevens. Daarbij worden de afgesproken neutrale voorbeelden gebruikt, zoals TRAINER VOORNAAM 1, TRAINER ACHTERNAAM 1 en SPELER 1. Test- en voorbeeldgegevens mogen niet verward kunnen worden met echte persoonsgegevens.
Instructies moeten ook geschikt zijn voor mobiele gebruikers. Daarom zijn korte stappen, duidelijke knoppennamen, schermafbeeldingen en waarschuwingen belangrijk.
De technische documentatie maakt PadelOS overdraagbaar aan ontwikkelaars, architecten, integratiepartners en beheerders. Zij beschrijft zowel de huidige implementatie als de toekomstige architectuur.
Onderwerpen zijn onder andere:
Google Apps Script-projecten;
Google Sheets als tijdelijke gegevenslaag;
Google Sites en het Enterprise Portal;
Module Registry;
Table Registry;
Field Registry;
Relation Registry;
Metadata Registry;
CRUD-processen;
gegevensmodellen en unieke ID’s;
validatieregels;
authenticatie en autorisatie;
imports, exports en migraties;
deployments en omgevingen;
logging, monitoring en foutafhandeling;
afhankelijkheden en configuratie;
CAMTE- en CAMTESI-architectuur.
API-documentatie vermeldt per endpoint minimaal:
doel en URL-patroon;
methode;
vereiste authenticatie;
rollen en rechten;
parameters;
verzoekstructuur;
antwoordstructuur;
status- en foutcodes;
validatieregels;
limieten;
voorbeeldverzoeken;
voorbeeldantwoorden;
API-versie;
status: concept, test, pilot of productie.
API-sleutels, wachtwoorden, tokens en andere geheimen worden nooit in openbare documentatie opgenomen.
Veelgestelde vragen worden kort, taakgericht en in gewone taal beantwoord. Wanneer een onderwerp meer uitleg vereist, verwijst het antwoord naar een uitgebreide handleiding of procedure.
Foutoplossingsartikelen helpen gebruikers en supportmedewerkers om systematisch te werken:
stel vast welke handeling werd uitgevoerd;
controleer rol en toegangsrechten;
noteer datum, tijd en omgeving;
registreer de foutmelding of foutcode;
controleer invoer en verplichte velden;
controleer verbindingen en afhankelijkheden;
raadpleeg logs wanneer dit is toegestaan;
probeer alleen goedgekeurde herstelstappen;
voorkom dat gegevens onbedoeld worden overschreven;
escaleer wanneer het probleem niet veilig kan worden opgelost.
Bekende problemen krijgen een eigen status, zoals:
onderzoek gestart;
oorzaak vastgesteld;
tijdelijke oplossing beschikbaar;
oplossing in test;
opgelost in een release;
gesloten of niet reproduceerbaar.
Een tijdelijke oplossing moet duidelijk herkenbaar zijn en mag niet worden gepresenteerd als een definitieve oplossing.
PadelOS combineert software-, organisatie-, financiële en padelinhoudelijke begrippen. Een centrale begrippenlijst voorkomt dat dezelfde term op verschillende manieren wordt gebruikt.
Voorbeelden zijn:
account, gebruiker en persoon;
speler, trainer en administrator;
organisatie, club, locatie en tenant;
les, lesreeks, planning en bijeenkomst;
factuur, betaling, restitutie en uitbetaling;
record, veld, tabel, Registry en CRUD;
CAMTE en CAMTESI;
hoofdspelsituatie, bedoeling, tactiek en techniek;
incident, probleem, wijziging en release;
concept, prototype, pilot en productie.
Per begrip worden een voorkeursnaam, definitie, context, eventuele synoniemen en ongewenste alternatieve benamingen vastgelegd.
Ook de schrijfwijze van tabelnamen, veldnamen, rollen, knoppen, foutmeldingen en productnamen wordt centraal beheerd. Dit verbetert handleidingen, interfaces, vertalingen, zoekresultaten en support.
Niet iedere gebruiker mag alle kennis publiceren of wijzigen. PadelOS werkt daarom met een gecontroleerd redactiemodel.
Rol
Verantwoordelijkheid
Lezer
Gepubliceerde informatie raadplegen
Bijdrager
Voorstellen, opmerkingen en conceptteksten indienen
Auteur
Nieuwe artikelen schrijven en bestaande artikelen bijwerken
Vakinhoudelijk reviewer
Inhoud op juistheid en bruikbaarheid controleren
Technisch reviewer
Technische claims, code en versies controleren
Privacy- of securityreviewer
Gevoelige inhoud en risico’s beoordelen
Vertaler
Een goedgekeurde bronversie vertalen
Redacteur
Structuur, taal, stijl en metadata bewaken
Publiceerder
Een goedgekeurde versie publiceren
Archivaris
Verouderde inhoud gecontroleerd archiveren
Kennisbeheerder
Structuur, rechten, kwaliteit en actualiteit bewaken
Bij kleine teams kan één persoon meerdere rollen hebben. Kritieke procedures, zoals beveiliging, gegevensherstel, financiële verwerking en productie-deployment, worden bij voorkeur altijd door een tweede deskundige gecontroleerd.
Nieuwe content doorloopt een vaste levenscyclus:
onderwerp of kennisbehoefte registreren;
eigenaar en doelgroep bepalen;
concept schrijven volgens het sjabloon;
voorbeelden en media toevoegen;
vakinhoudelijke controle uitvoeren;
technische of juridische controle uitvoeren indien nodig;
taal, toegankelijkheid en metadata controleren;
artikel goedkeuren;
publiceren;
feedback en gebruik volgen;
periodiek herbeoordelen;
bijwerken, vervangen of archiveren.
Mogelijke documentstatussen zijn:
idee;
concept;
in beoordeling;
aanpassing vereist;
goedgekeurd;
gepubliceerd;
actualisatie nodig;
verouderd;
gearchiveerd.
Alleen de laatst goedgekeurde versie wordt standaard aan eindgebruikers getoond. Concepten en eerdere versies blijven uitsluitend beschikbaar voor bevoegde medewerkers.
Iedere publicatie moet herleidbaar zijn tot een documentversie en, waar relevant, een PadelOS-release. Zo wordt voorkomen dat instructies voor een oude interface worden toegepast op een nieuwe versie.
Belangrijke metadata zijn:
ArtikelID;
titel;
documentversie;
toepasselijke PadelOS-versie;
status;
auteur;
eigenaar;
reviewer;
taal;
publicatiedatum;
laatste controledatum;
volgende controledatum;
wijzigingsreden;
vervangend artikel;
archiefstatus.
Een wijzigingsgeschiedenis vermeldt wat inhoudelijk is veranderd. Kleine taalcorrecties kunnen als redactionele wijziging worden geregistreerd. Wijzigingen in procedures, rechten, beveiliging, gegevensstructuren of gebruikershandelingen vereisen een nieuwe inhoudelijke versie.
Verouderde artikelen worden niet zonder registratie verwijderd. Zij worden gearchiveerd en, indien nodig, gekoppeld aan hun opvolger. Hierdoor blijft ook bij audits, incidentonderzoek en oudere installaties duidelijk welke instructie op een bepaald moment van toepassing was.
De kennisbank moet bruikbaar zijn voor mensen met verschillende achtergronden, talen en technische niveaus.
Daarom gelden de volgende uitgangspunten:
korte en actieve zinnen;
één duidelijke handeling per stap;
consistente knoppen- en veldnamen;
uitleg van technische termen;
goede koppenstructuur;
voldoende kleurcontrast;
bediening met toetsenbord;
beschrijvende linkteksten;
alternatieve tekst bij afbeeldingen;
ondertiteling of transcriptie bij video;
geen essentiële uitleg uitsluitend via kleur;
tabellen die ook op mobiele schermen begrijpelijk blijven.
Nederlands kan als eerste brontaal worden gebruikt. Voor internationale groei worden ten minste taalcode, vertaalstatus, bronversie en controledatum vastgelegd.
Een vertaling wordt gekoppeld aan een specifieke goedgekeurde bronversie. Wanneer de brontekst wijzigt, krijgt de vertaling automatisch of handmatig de status “hercontrole nodig”. Machinevertaling kan ondersteuning bieden, maar publicatie vereist menselijke controle, zeker bij juridische, financiële, technische en veiligheidsgerelateerde inhoud.
Niet alle PadelOS-kennis is openbaar. De kennisbank maakt daarom onderscheid tussen:
openbare documentatie;
documentatie voor geregistreerde gebruikers;
organisatiegebonden documentatie;
interne beheerinformatie;
technische partnerdocumentatie;
vertrouwelijke security- en incidentinformatie.
Artikelen mogen geen echte persoonsgegevens, wachtwoorden, API-sleutels, toegangstokens, geheime configuraties of onnodige systeemdetails bevatten. Schermafbeeldingen worden gecontroleerd op namen, e-mailadressen, telefoonnummers, factuurgegevens en andere gevoelige informatie.
Voorbeelden gebruiken fictieve of duidelijk gemarkeerde testgegevens. Productielogs en foutmeldingen worden alleen opgenomen wanneer persoonsgegevens en beveiligingsgevoelige gegevens zijn verwijderd.
Toegang wordt uiteindelijk gekoppeld aan rol, organisatie, tenant, documentstatus en vertrouwelijkheidsniveau. In CAMTESI moet bovendien worden voorkomen dat organisaties elkaars interne procedures, configuraties of documentatie kunnen bekijken.
Binnen de bestaande Google-omgeving kan de PadelOS Kennisbank stapsgewijs worden opgebouwd met:
Google Sites als publicatieomgeving;
Google Drive voor bronbestanden;
Google Docs voor uitgebreide handleidingen;
Google Sheets als centrale artikel- en metadataregistratie;
vaste sjablonen voor handleidingen en procedures;
handmatig versiebeheer en reviewstatussen;
koppelingen vanuit de PadelOS Master Index;
PDF- en TXT-export voor offline gebruik;
een centraal formulier voor feedback en wijzigingsvoorstellen.
Deze aanpak is geschikt voor ontwikkeling, pilots en gecontroleerde samenwerking. De belangrijkste voorwaarde is dat publicatie, eigenaarschap en controledatums consequent worden bijgehouden.
Binnen CAMTE kan de kennisbank worden uitgebreid met:
een eigen artikelendatabase;
rolgebonden toegang;
geïntegreerde zoekfunctie;
categorieën en trefwoorden;
revisies en goedkeuringsstromen;
koppelingen met softwareversies;
geïntegreerde helpknoppen;
gebruiks- en zoekstatistieken;
meldingen bij verouderde content;
gecontroleerde vertaalprocessen.
In CAMTESI groeit de kennisbank door naar een meertalig multi-tenant kennisplatform met:
algemene internationale PadelOS-documentatie;
organisatiegebonden kennisruimten;
lokale aanvullingen per land, bond of organisatie;
versiegebonden documentatie;
tenantisolatie;
geavanceerd zoeken;
centrale terminologie;
publicatie-API’s;
documentatie als onderdeel van releases;
auditlogs;
automatische actualiteitscontroles;
gecontroleerde AI-ondersteuning.
AI kan in de toekomst helpen bij zoeken, samenvatten, vertalen en het voorstellen van gerelateerde artikelen. AI-antwoorden moeten verwijzen naar goedgekeurde bronnen, de gebruikte versie tonen en duidelijk aangeven wanneer betrouwbare informatie ontbreekt.
De ontwikkeling van de PadelOS Kennisbank kan gefaseerd worden uitgevoerd.
bestaande documenten en webpagina’s verzamelen;
dubbele en verouderde informatie herkennen;
doelgroepen en eigenaren vastleggen;
centrale begrippenlijst starten;
prioritaire handleidingen bepalen.
categorieën en metadata vaststellen;
artikelsjablonen maken;
schrijf- en reviewrichtlijnen publiceren;
rollen en publicatierechten bepalen;
vaste koppeling met de onderdelen 00 tot en met 20 aanbrengen.
snelstartgidsen publiceren;
kernhandleidingen opstellen;
FAQ en probleemoplossing toevoegen;
technische basisdocumentatie ontsluiten;
feedbackkanaal activeren.
versiebeheer invoeren;
controle- en vervaldatums bewaken;
wijzigingsgeschiedenis vastleggen;
toegankelijkheid toetsen;
documentatie koppelen aan releases en acceptatietests.
contextuele hulp in het Enterprise Portal toevoegen;
zoekfunctie verbeteren;
foutcodes aan supportartikelen koppelen;
gebruikersstatistieken en zoekgedrag analyseren;
ontbrekende kennis systematisch registreren.
meertalige publicatieprocessen invoeren;
organisatiegebonden kennisruimten ondersteunen;
vertaalbeheer automatiseren;
documentatie-API’s ontwikkelen;
gecontroleerde AI-ondersteuning onderzoeken en testen.
PadelOS nodigt gebruikers, trainers, ontwikkelaars, testers, supportmedewerkers, vertalers, clubs, opleiders en technische partners uit om bij te dragen. Dat kan door:
ontbrekende onderwerpen te melden;
onduidelijke instructies te verbeteren;
tutorials of voorbeelden aan te leveren;
technische documentatie te controleren;
FAQ’s en foutoplossingen uit te werken;
vertalingen te verzorgen;
toegankelijkheid te testen;
documentatie tijdens pilots te beoordelen;
begrippen en definities te valideren;
kennisartikelen periodiek te actualiseren.
Iedere bijdrage wordt geregistreerd, beoordeeld en gekoppeld aan een eigenaar. Publicatie vindt pas plaats nadat de inhoud voldoende is gecontroleerd.
De PadelOS Kennisbank moet uitgroeien tot het collectieve geheugen van het platform: begrijpelijk voor nieuwe gebruikers, praktisch voor trainers en beheerders, nauwkeurig voor ontwikkelaars en betrouwbaar voor organisaties. Daarmee wordt kennis niet alleen bewaard, maar actief ingezet om PadelOS veiliger, toegankelijker, beter overdraagbaar en internationaal schaalbaar te maken.