Verzoek Type Catalogus

StyleCI github

De verzoektype catalogus biedt een overzicht van mogelijke door de gebruiker te starten verzoeken en de te verwachte afhandeling. Zij laat zich in deze het best vergelijken met een digitale beschrijving van een formulier, waarbij zij zich zuiver beperkt tot de definiëring van de eindwaarde. Ze bevat in deze dus een reeks van velden en de voorwaarde waaraan deze moeten voldoen.



Lees meer Bekijk repository bekijk documentatie

Verzoek Registratie Component

StyleCI github

De verzoeken catalogus bevat zowel het eind als tussenresultaat van een proces. Of om het iets simpeler te zeggen een proces schrijft bij iedere stap zijn variabelen weg naar een verzoek. Daarmee is het proces stateless en het verzoek stateful. In deze zin is een verzoek vergelijkbaar met een proces token in bijvoorbeeld BPMN- engines.

Hierdoor is het mogelijk om verzoeken uit te wisselen tussen processen. Het is bijvoorbeeld mogelijk om via een chatbot een proces te draaien dat het verzoektype verhuizen gebruikt om een verzoek aan te maken, maar het ondertekenen van dit verzoek te laten doen via het webformulier.




Lees meer Bekijk repository bekijk documentatie

Proces Type Catalogus

StyleCI github

De Proces Type Catalogus beschrijft de gebruikersreis, waarmee een verzoek tot stand komt. Of om het simpel te zeggen het neemt een verzoektype en deelt deze op in stappen en secties. Hierbij moet het eindresultaat van een proces een geldig verzoek zijn. Het is dus mogelijk om properties vanuit een verzoek niet uit te vragen (ofwel niet op te nemen in een stap of sectie), mits deze property vanuit het verzoek type niet verplicht is.




Lees meer Bekijk repository bekijk documentatie

Memo Component

StyleCI github

Het memo component biedt de generieke mogelijkheid om gebruikers memo’s (notities) te laten aanmaken of resources (bijvoorbeeld Common Ground resources). Deze functionaliteit is bewust abstract opgezet. In wezen kan elke gebruiker over alles een memo aanmaken. Dat biedt ook de mogelijkheid om voor elke willekeurige resource het component te bevragen en te zien of er memo’s voor staan.

Memo’s worden in principe gezien als organisatie-intern en zijn nadrukkelijk geen communicatiekanaal met de klant, daarvoor zijn ‘contactmomenten’ beschikbaar.




Bekijk repository bekijk documentatie

Queue Component

StyleCI github

Het Queue Component bevat een lijst van later uit te voeren taken, dat wil zeggen in dit component kunnen taken worden aangemaakt die door andere componenten op een later tijdstip moeten worden uitgevoerd. Dit lijkt op het versturen van notificaties met een paar afwijkingen:




Lees meer Bekijk repository bekijk documentatie

Portfolio Component

StyleCI github

Het Portfolio Component vormt een Common Ground implementatie van de e-portfolio-norm (die op haar beurt weer voortkomt uit e-HRM) en stelt gebruikers (of contactpersonen ) in staat om een portfolio op te bouwen. Een portfolio kan een een HRM toepassing zijn, waarbij voor de medewerker vaardigheden en competenties worden bijgehouden, eventueel voorzien van bewijsstukken en gekoppeld is aan ontwikkelingsdoelen en eventuele functies. Het portfolio kan ook een meer traditionele invulling hebben van gedaan werk, ofwel een showcase-functie, zoals men die bij kunstenaars en andere zelfstandige beroepen vaak tegenkomt.




Lees meer Bekijk repository bekijk documentatie

Contact Moment Component

StyleCI github

Het Contactmomenten Component biedt de generieke mogelijkheid om contactmomenten rondom resources, bijvoorbeeld Common Ground resources, vast te leggen. Deze functionaliteit is bewust abstract opgezet.




Lees meer Bekijk repository bekijk documentatie

User Component

StyleCI github

Het user component voert het beheer over gebruikersaccount en hun autorisaties. Hierbij kan in de traditionele zin worden gedacht aan aan een gebruik die behoort tot bepaald groepen die op hun beurt weer beschikken over bepaalde rechten. Waarbij het component tevens het bijhouden en valideren van wachtwoorden ondersteund (ten einde inlog mogelijkheden op bijvoorbeeld een dashboard of applicatie te faciliteren) maar in de wat abstracte context ondersteund het ook algemene inlogs systematieken.




Lees meer Bekijk repository bekijk documentatie

Environment Component

StyleCI github

Het Environment Component heeft als doel om Common Ground-omgevingen te beheren. Hierbij kan het kubernetes clusters inregelen, voorzien van de juiste en benodigde ondersteunende software, zoals ingres controllers, certificaten en installaties via Helm-bestanden. Het kan ook op afstand volledige kubernetes clusters opstarten wat werken in de cloud ten goede komt.Denk hierbij aan een Common ground-cluster bij populaire cloud-aanbieders Fuga, Cyso, Digital Ocean, Google en Amazon.

Als tweede functionaliteit kan het component andere componenten installeren, configureren en implementeren. Het bevat met andere woorden alle noodzakelijke functionaliteit die nodig is om een Common Ground omgeving te kunnen maken en te beheren zonder dat daarvoor kennis van Common Ground of de onderliggende infrastructuur nodig is.




Bekijk repository

Taken Component

StyleCI github

Het Taken Component biedt de generieke mogelijkheid om taken te registreren van de ene resource op een andere resource (bijvoorbeeld Common Ground resources). Deze functionaliteit is bewust abstract opgezet. In de meest voorkomende vorm zal bijvoorbeeld een medewerker of gebruiker (resource) een taak hebben op een zaak of order (resource), maar in abstracte vorm kan ook een burger (BRP resource) een taak hebben of kunnen zelfs applicaties of processen (zoals opgenomen in het PC) een taak hebben. Het Taken Component geeft in die zin zowel invulling aan taken, als in het agenda calendar concept “todo”, als het bpmn concept “task”. Echter moeten zowel het onderwerp van de taak, als de uitvoerder van de taak identificeerbaar zijn aan de hand van een URL.




Lees meer Bekijk repository bekijk documentatie

Locatie Component

StyleCI github

Het Locatie Component implementeert de places en accommodations strategie vanuit schema.org. Het vormt daarmee de basis voor het bijhouden en verhuren van ruimtes en kan in de meest simpele configuratie worden gebruikt voor planningsvraagstukken. Bijvoorbeeld bij gebouwen rondom te reserveren ruimtes zoals (vergader)zalen. Dit component is nadrukkelijk ontworpen om samen met het PDC het commercieel verhuren van gehele gebouwen, of ruimtes daarin te faciliteren. Hiermee kan het de technische basis vormen voor appartementen/kamerverhuur platforms, hotel-software of zelfs camping- software.




Bekijk repository bekijk documentatie

Berichtenservice

StyleCI github

De Berichtenservice faciliteert het versturen van berichten (bijvoorbeeld aan de hand van WRC sjablonen) en het rapporteren daarover. Hiervoor levert het zowel bulk-capaciteiten (voor bijvoorbeeld het versturen van mailings), als opvolg-capaciteiten (voor het controleren van bijvoorbeeld het aankomen van emails).

Vooralsnog ondersteunt de Berichtenservice het versturen van mails en smsberichten, maar er wordt nagedacht over het toevoegen van een post route en chatfunctionaliteit (social media). Het kan hierbij zowel zelfstandig opereren, als een front leveren voor functionaliteit van derden (mailgun, mailchimp, messagbird etc).




Bekijk repository bekijk documentatie

Adresservice

StyleCI github

De Adresservice biedt een koppelvlak met de BAG API (V1), waardoor het mogelijk is om aan de hand van postcode huisnummer combinaties adressen (en bijbehorende bag ID’s) te suggereren. Het vormt hiermee de kernfunctionaliteit voor formulieren waarin klanten adressen kunnen opgeven aan de hand van huisnummer- postcode combinatie.




Bekijk repository bekijk documentatie

Docparser

StyleCI github

De docParser is een developers tool die aan de hand van redoc documentatie (en optioneel api toegang) controleert tot in hoeverre een api zich aan de binnen common ground geldende standaarden houdt (zoals nl apis strategie).




Bekijk repository bekijk documentatie

Order Registratie Component

StyleCI github

Het Orderregistratie component verzorgt de afhandeling van bestellingen met uitzondering van facturatie en en betalingen. Het biedt in samenwerking met het PDC een multi-tenant en omnichannel oplossing voor het verkopen van producten en diensten. Hierbij worden offers (te kopen resources vanuit het PC) toegevoegd aan een order, waarbij het Order Component de geldigheid van de aanbieding controleert en een eventuele prijs en betaling berekeningen uitvoert.




Lees meer Bekijk repository bekijk documentatie

Agenda Service

StyleCI github

Het Agenda Component faciliteert agenda functionaliteit. Hiermee kunnen er resources gekoppeld worden aan een agenda. Een resource kan daarbij een persoon uit het Contacten Component of een medewerker vanuit het Medewerkers Component zijn, maar is daar technisch niet toe beperkt. Het is dus ook mogelijk om agenda’s te voeren voor locaties, zalen en kamers in de zin van boekingen of bijvoorbeeld voertuigen. Hierbij zit een logisch doch niet dwingend verband met het PDC en ORC met betrekking tot kostprijsberekening etc. Naast agenda’s als objecten bevat het component uiteraard mogelijkheden tot het blokkeren of juist beschikbaar stellen van agenda ruimtes, het maken van afspraken en zoeken naar vrije ruimte binnen één of meer agenda’s.




Bekijk repository bekijk documentatie

Stuf Component

StyleCI github

Het StuF component faciliteert een bidirectionele koppeling tussen Common Ground en “oude” StuF koppelingen. Dat doet het door het vertalen van API-vragen naar StuF, de antwoorden op deze StuF-berichten indien nodig te verrijken met andere StuF-berichten en dit resultaat weer terug te geven als API- resultaat (bijvoorbeeld JSON). Op deze manier is het mogelijk om “oude” applicaties tijdelijk het Common Ground landschap in te trekken indien dit nodig is .

Het component ondersteunt ook het bevragen van Common Ground API’s via StuF-berichten, in dat geval fungeert het als een soort van broker die tevens vertaalt.




Bekijk repository bekijk documentatie

Medewerker Catalogus

StyleCI github

Het Mederwerker Registratie Component bevat medewerkers en de daarbij behorende HRM systematiek, hierbij kan bijvoorbeeld worden gedacht aan contractmanagement en functie of competentie overzichten. Deze functionaliteit wordt eigenlijk onttrokken aan de e-HRM-norm (ofwel de HR-XML standaard, in Nederland losjes geïmplementeerd als SETU), waarbij het stuk portfolio-opbouw is losgetrokken en in Portfolio Component zit ( om de e-portfolio norm te ondersteunen).




Lees meer Bekijk repository bekijk documentatie

Betaal Service

StyleCI github

Het Betalen Component handelt, bij voorkeur in samenwerking met het Orderregistratie Component, betalingen af. Hiervoor maakt het facturen aan en meldt deze (indien gewenst) bij een payment provider aan. Als laatste worden de resultaten van de payment provider verwerkt, waarmee een invoice overzicht wordt gecreëerd dat kan worden gebruikt door zowel organisatie als klanten.

Indien gewenst kan het Betalen Component in samenwerking met het WRC (sjablonen), BS (mail en sms ) en het Queue Component, worden ingezet voor de opvolging van betalingen in de trant van herinneringen en aanmaningen.




Bekijk repository bekijk documentatie

Challenge Component

StyleCI github

Het Challenge Component ondersteunt het generiek uitzetten van challenges en verzamelen van reacties daarop. Het biedt aan de andere kant de mogelijkheid tot het opstellen van pitches en al dan niet indienen daarvan op challenges. Hoewel beide optioneel in samenwerking met het PDC en ORC ook een tender proces ondersteunen, is deze functionaliteit primair geschreven voor het ondersteunen van citychallenges en startup in residence challenges aan de ‘challenge’- kant en kickstarter-achtige functionaliteit aan de ‘pitch’- kant .



Lees meer Bekijk repository bekijk documentatie

Instemming Service

StyleCI github

Het Instemmingen Registratie Component heeft als doel om instemmingen vast te leggen ten opzichte van resources. Hierbij wordt de instemming verleend door een rechtspersoon. Instemmingen kunnen zowel specifiek zijn (dit verzoek mag namens mij worden ingediend), rol gebonden (ik ga er mee akkoord getuige voor dit huwelijk te zijn) als generiek. Generieke instemmingen worden afgegeven aan een (rechts)persoon ten opzichte van een verzoektype (deze persoon mag namens mij meldingen openbare ruimte doen).

Instemmingen fungeren hiermee zowel als een digitale handtekening, als mandaat.




Bekijk repository bekijk documentatie

Producten En Diensten Catalogus

StyleCI github

De Producten en Diensten Catalogus heeft als doel het geheel aan af te nemen producten en/of diensten in kaart te brengen. Hierbij wordt uitgegaan van afname door klanten vanuit een organisatie, maar er is geen technische beperking om het ook als inkoopsysteem te gebruiken.




Lees meer Bekijk repository bekijk documentatie

Contact Catalogus

StyleCI github

Het Contacten Component bevat lijsten van contact personen, hiermee heeft het vanuit bron perspectief doorgaans een aanvullende of vervangende taak ten opzichte van het BRP. Met andere woorden in het Contacten Component vinden we personen die we niet uit het BRP halen. Dat kan zijn, omdat deze personen niet in het BRP staan, we nog niet weten wat het BSN van een persoon is of omdat we simpelweg geen rechten of toegang hebben tot het BRP vanuit het proces waar we mee bezig zijn.




Lees meer Bekijk repository bekijk documentatie

Landelijke Tabellen Catalogus

StyleCI github

Het landelijke tabellen componenten voorziet in het ontsluiten van de landelijke index tabellen van BZK (NL dus) waar je bijvoorbeeld gemeenten nummers kan terugvinden het voorziet in die zin in het via API beschikbaar stellen van niet common ground bronnen.




Bekijk repository bekijk documentatie

BRP Service

StyleCI github

Het Basis Registratie Personen component is een implementatie van de door Haal Centraal ontwikkelde API-specificatie in de vorm van een Common Ground container. Dat betekent dat het ten opzichte van die referentie een aantal extra opties kent (zoals extended en filteren van data). Dit Common Ground component kan op twee manieren worden ingezet. Om te beginnen kan het aan de achterkant worden voorzien van datafixtures in de vorm van een excel sheet. Op deze manier kan er een “specifieke” mock worden gecreëerd voor het testen van applicaties (al dan niet in combinatie met Digispoof). Het is echter ook mogelijke om het BRP Component in te zetten in samenhang met het StuF component, in dat geval worden API-verzoeken op het BRP vertaald naar StuF berichten op GBA of GBAV aansluiting en levert het component daadwerkelijk een BRP koppeling.




Bekijk repository bekijk documentatie

Review Component

StyleCI github

Het Review Component faciliteert reviews van resources, hoewel we hierbij in eerste instantie denken aan producten vanuit het PDC zou een resource in feite alles kunnen zijn.

Onder een review verstaan we een gebruikerservaring, deze ervaring kan zowel worden aangeduid met een cijfer als een een texturele beschrijving. Additioneel biedt het component ondersteuning voor “likes” en het berekenen van totale gemiddelde review resultaten op resources.




Bekijk repository bekijk documentatie

Commonground Registratie Component

StyleCI github

Het Common Ground Registratie Component houdt een register bij van alle op Common Ground aangeboden componenten en services.




Bekijk repository bekijk documentatie
cgrc

Web Resource Catalogus

StyleCI github

Het WRC bevat de resources die nodig zijn voor het draaien van een applicatie zoals sjablonen, routing, menu’s en afbeeldingen. Het heeft hierbij de doelstelling om te fungeren als een “headless CMS” ofwel een CMS als API die losstaat van enige vorm van weergave. Voor het bewerken van de CMS content leunt het WRC dan ook op de Dashboard (een implementatie van de Proto Applicatie), en het fungeert zelf als een bron voor een Applicatie.




Lees meer Bekijk repository bekijk documentatie

Proto Component Commonground

StyleCI github

Het Proto Component vormt zowel de gemeenschappelijke basis onder alle componenten, als een “template” voor het maken van nieuwe componenten.




Bekijk repository bekijk documentatie

Common Ground Dashboard

StyleCI github

Het Common Ground dashboard biedt basale beheer- en behandelmogelijkheden op Common Ground componenten en voegt vooral veel waarde toe in ontwikkel-context, waarbij data in componenten moet worden aangepast of moet worden ingezien voor testdoeleinden. In combinatie met het EVC component biedt het dashboard echter ook de mogelijkheid om Common Ground omgevingen in te richten en te beheren. Hierbij kan bijvoorbeeld worden gedacht aan het installeren en configureren van containers.




Bekijk repository

Proto Applicatie NL Design System

StyleCI github

De Proto Applicatie levert een vooringerichte versie van het Symfony PHP framework waarbij de NL Design System componenten zijn voorzien van template widgets. Oftewel het is mogelijk om vanuit je PHP/HTML templates direct gebruik te maken van NL Design Elementen. De business logica van de Proto Applicatie wordt geleverd door de generieke Common Ground Bundle.




Lees meer Bekijk repository Demo

Export Component

StyleCI github

Het export component heeft als doel om data binnen Common Ground beschikbaar te maken als non-API data. Bijvoorbeeld als een Excel- of CSV- lijst.

In samenhang met het Queue Component voor geautomatiseerde taken en het wrc voor sjablonen, kan dit bijvoorbeeld worden gebruikt voor het draaien en versturen van een dagelijkse rapportage.




Bekijk repository
ec

Digispoof

StyleCI github

Digispoof is een SAML applicatie voor het testen van DigiD (en op termijn AIDAS) inlogmethodes. De gedachte hierbij is dat Digispoof technisch uitwisselbaar is met DigiD (dus exact hetzelfde werkt met betrekking tot API’s), maar doordat het gebruik maakt van het BRP (in mock-vorm) geen echte burgergegevens ontsluit. Het geeft echter wel een BSN nummer terug dat bestaat in het mock BRP. Dat betekent dat ontwikkelaars de mogelijkheid hebben om hun applicatie te testen met DigiD en BPR toegang zonder deze daadwerkelijk te hoeven aanvragen (waarvoor zelfs in demo-versies een PKI overheidscertificaat nodig is). Het is dan ook puur een development tool.




Bekijk repository bekijk demo
ec

Geintresserd? en wil je graag verder meedoen met dit onderwerp?

Praat mee!

Image

Blijf je graag op de hoogte van onze Common Ground projecten?

Inschrijven nieuwsbrief

Inschrijven

Conduction blauw past bij jou!

Ook werken of stage bij Conduction?

Wij zijn altijd op zoek naar gedreven, originele vakfanaten, pioniers en creatievelingen (to be). Voel je je aangesproken? Neem vooral contact met ons op! :)