Teknisk dokumentation - Myndighetsutövning Parkeringstillstånd

Webb-appen

Webb-appen ligger i samma gemensamma repo som webb-apparna för generisk ärendehantering. Repot innehåller flera webb-appar ("drakar") som byggs från en gemensam kodbas, och parkeringstillstånd är en av dem - den aktiveras genom att appen byggs med konfigurationen PT. Frontend är byggd med Next.js/React och backend i Node.js/Express. Backend sköter inloggning via SAML mot kommunens identitetsleverantör (IdP) och all kommunikation med de underliggande API:erna via kommunens API-gateway (WSO2), där applikationen autentiserar sig med OAuth2 (client key/secret).

Till skillnad från de webb-appar i repot som bygger på SupportManagement (generisk ärendehantering) bygger parkeringstillstånd på CaseData - ett kärn-API för myndighetsutövning - och en processmotor (Camunda) som driver ärendet genom processens fastställda steg. Vilka API-versioner webb-appen förväntar sig framgår av README-filen i webb-appens repo (tabellen för PT).

github.com/Sundsvallskommun/web-app-draken-public

Lösningsarkitektur

Översikt över hur webb-appen, kärn-API:erna, processmotorn, master-data och externa system hänger ihop. Pilarna visar anrop. Bilden är härledd från webb-appen, API-listan och respektive API:s beskrivning av vad det i sin tur anropar.

API:er som lösningen integrerar med

Webb-appen anropar ett antal API:er via API-gatewayn. Navet är CaseData, som lagrar ärenden, intressenter, utredningar och beslut, medan processmotorn pw-parking-permit (byggd på Camunda) driver ärendet genom processens steg. De flesta API:er finns som öppna repon på Sundsvalls kommuns GitHub. Tabellen nedan beskriver vad varje API gör och länkar till källkoden.

API	Typ	Beskrivning	Källkod
CaseData	Kärn-API	Navet i lösningen – lagrar och hanterar myndighetsärenden med intressenter, bilagor, utredningar, beslut, anteckningar och full ärendehistorik.	api-service-case-data
PartyAssets	Kärn-API	Register över utfärdade tillstånd och andra engagemang en person har hos kommunen – här registreras beviljade parkeringstillstånd.	api-service-party-assets
Messaging	Kärn-API	Skickar meddelanden via e-post, SMS, digital brevlåda och fysiska brev – används för återkoppling till sökande.	api-service-messaging
Templating	Kärn-API	Lagrar och renderar mallar till text och PDF – används bland annat för beslutsdokument.	api-service-templating
CaseStatus	Kärn-API	Levererar aktuell statusinformation om ärenden från underliggande system.	api-service-case-status
Relations	Kärn-API	Lagrar relationer och kopplingar mellan ärenden och andra resurser, till exempel mellan ett förnyelseärende och det ursprungliga tillståndet.	api-service-relations
Contract	Kärn-API	Generisk tjänst för hantering av avtal av olika typer.	api-service-contract
JsonSchema	Kärn-API	Tillhandahåller JSON-Schema och validering av data, till exempel ärendenas extrafält.	api-service-json-schema
PwParkingPermit	Processmotor	Integrerar mot processmotorn Camunda och driver parkeringstillståndsprocesserna – innehåller processdefinitioner och affärslogik som uppdaterar ärendena i CaseData.	pw-parking-permit
SimulatorServer	Testverktyg	Simulatorserver för att testa olika svar (status, fördröjning och svarsinnehåll).	api-service-simulator-server

Master-data API:er utan publikt repo

Följande API:er hanterar kommun-specifik master-data och har därför inget publikt repo. För att få dessa på plats krävs en utvecklingsinsats anpassad efter den egna kommunens källsystem.

API	Beskrivning
Citizen	Medborgarinformation – uppslag och grunddata om privatpersoner, till exempel folkbokföringsadress.
ActiveDirectory	Användar- och behörighetsinformation från katalogtjänsten.
Employee	Medarbetarinformation, till exempel uppgifter om handläggare.
LegalEntity	Information om organisationer och juridiska personer.