Onderwerp
Nog niet bevestigd door een mens. Eigenaar: vdo89. Bron in de atlas
De catalogus is het aanbod waaruit een team kiest. Per dienst staan er een beschrijving, de varianten, de afspraken per profiel, het aanvraagformulier, documentatie en een status. De dienstsjablonen staan als genummerde versies in de opslagplaats Catalogus; het portaal toont ze en gebruikt ze om een aanvraag te maken.
Een klein aanbod met vaste varianten maakt aanvragen voorspelbaar en laat beheerders de keuzes vooraf goedkeuren. Omdat formulier en toetsing hetzelfde schema per sjabloonversie gebruiken, wordt een aanvraag niet achteraf op vorm afgewezen. Versies met een overstaptermijn houden bestaande diensten op een actuele standaard, zonder dat teams onverwacht moeten overstappen.
De indeling van de catalogus, de overstaptermijn en het moment van de assistent zijn een voorstel.
In de eerste levering bevat de catalogus twee diensten, beide in het profiel ontwikkelen en beproeven: een applicatiecluster en een beheerde database in een applicatiecluster van het team, elk met een sjabloon, documentatie, voorwaarden en beperkingen.
Zie Clusters als dienst, Beheerde databases en groeipadstap 1. Een beperkt aanbod met een groeipad beproeft eerst de gemeenschappelijke basis.
Het aanbod in de catalogus groeit langs het groeipad: reguliere productie per dienst na vrijgave, virtuele servers en datawetenschap en AI in groeipadstap 3, en in groeipadstap 4 de applicatieomgeving voor containers, containers die met de vraag meegroeien, functies op aanvraag en werkstromen als dienst.
Zie groeipadstap 3 en groeipadstap 4. Ook toegelaten SaaS-diensten kunnen in de catalogus komen.
Iedere dienst in de catalogus bestaat uit deze onderdelen, elk met een eigenaar.
| Onderdeel | Inhoud | Eigenaar |
|---|---|---|
| Beschrijving | Wat de dienst levert, voor wie zij bedoeld is en wat erbij hoort | Productverantwoordelijke |
| Varianten | Keuzes uit het sjabloon en vaste waarden, zoals de varianten van het applicatiecluster en van de beheerde database | Platform |
| Afspraken per profiel | Beschikbaarheid, ondersteuning, onderhoudsvensters en herstel; de waarden voor reguliere en bedrijfskritische productie gelden pas na vrijgave van de dienst voor dat profiel | Productverantwoordelijke |
| Aanvraagformulier | Velden van de dienstbeschrijving met invoerregels en uitleg; de toetsing gebruikt dezelfde regels | Platform |
| Documentatie | Aan de slag, voorbeelden, veelgestelde vragen en bekende beperkingen | Platform |
| Status | Proef, beschikbaar of uitfasering, met de datum van de volgende wijziging; ‘beschikbaar’ geldt per profiel en alleen na vrijgave | Productverantwoordelijke |
De documentatie verschijnt per gepubliceerde versie van het sjabloon.
Iedere dienst en iedere variant heeft een eigenaar en een versie. ‘Beschikbaar’ geldt per profiel en pas na vrijgave van de dienst voor dat profiel.
Er is geen belofte zonder vrijgave; het vrijgavebesluit is het bewijs.
De opslagplaats Catalogus heeft per dienst een map diensten/<dienst>/ met de onderdelen van de dienst, het schema met de invoerregels en het cryptografieoverzicht, gepubliceerd onder een versielabel <dienst>-vN. Pijplijnsjabloon en register van toegelaten software staan in eigen mappen; de vrijgegeven versie van de standaardinrichting komt uit de opslagplaats Beleid.
Formulier en toetsing gebruiken hetzelfde schema. Pijplijnsjabloon en register horen bij het domein softwarelevering.
Nieuwe leveringen gebruiken de actuele sjabloonversie. Iedere bestaande dienstbeschrijving krijgt een automatisch overstapvoorstel; de oudere versie blijft 90 dagen na haar opvolger bruikbaar, net als een versie van het pijplijnsjabloon, en een versie met een beveiligingsfout wordt direct ingetrokken.
Platformbeheer publiceert of trekt een versie in met een voorstel in de Catalogus, dat de productverantwoordelijke beoordeelt; daarna wordt de zichtbaarheid in het portaal gecontroleerd.
De digitale assistent in het portaal, Developer Lightspeed, staat in de eerste levering uit, omdat hij een gekoppeld taalmodel en een beoordeling vraagt. Hij komt in groeipadstap 3, met taalmodellen via de LLM Gateway.
Ontwikkelomgeving en digitale assistent zijn alleen als goedgekeurd hulpmiddel in gebruik. De assistent wijzigt niets en zoekt alleen in bronnen die de gebruiker mag zien.
Zo gaat er geen RWS-code naar externe diensten. Ze staan in de lijst van goedgekeurde hulpmiddelen; zie het domein softwarelevering.
Vanaf groeipadstap 4 heeft het ontwikkelaarsportaal ook een API-catalogus voor API-beheer, gepubliceerd via de applicatie-ingang. Zij beheert contracten, versies en afnemers van API’s.
Afnemers worden per API vastgelegd; de publicatie loopt via een API-gateway achter de clusteringang. Zie API-beheer.