Overordnet løsningsdesign af DFDG

Følgende giver en gennemgang af den tekniske løsning, der er udviklet for at understøtte forretningsfunktionaliteten.

Applikationsdesign

DFDG er udviklet, så det understøtter en lagdelt webapplikation, som registrerer data direkte i DFDG’s database. DFDG er udviklet efter normal best practice for Microsoft.NET platformen for sådanne applikationer, dog præget af at udviklingen af DFDG har stået på i en del år. Det er en arkitektur med fire logiske applikationslag som vist på tegningen herunder, suppleret med en række delte komponenter og klasser. DFDG har ikke egen brugergrænseflade, så Præsentationslaget i nedenstående er ikke en del af DFDG men en del af de applikationer, der anvender DFDG.

Figur 4: Lagdelt opbygning af DFDG, dog er brugergrænsefladen ikke en del af DFDG

DFDG implementerer følgende lag:

• Servicelag – udstilling af forretningslaget via webservices samt besked-kø
• Forretningslag – forretningskomponenter (dog uden brug af Microsoft workflow logik)
• Datalag – adgangslag til datakilder som databaser og eksterne services

Systemet udvikles i Microsoft.NET teknologi i programmeringssproget C#, med anvendelse af enkelte støttekomponenter til f.eks. logning, e-mail afsendelse, sms-afsendelse (NemSMS), dannelse af pdf-dokumenter, osv.

Som en del af den løbende modernisering af DFDG er det besluttet at påbegynde en fysisk kodemæssig opsplitning af kodebasen. Et af de primære formål er at gøre DFDG's kodebase mindre samt mere overskuelig, hvilket forventes at medføre lettere vedligeholdelse og videreudvikling. Udledt af ovenstående er der p.t. opbygget to nye selvstændige kodebaser – kaldet siloer, som hver især skal rumme kode, som er relateret til et meget velafgrænset forretningsområde. De nye siloer er set fra DFDG's eksterne aftagere stadig en del af DFDG. Dermed er siloerne – udover at have eget service endpoint udadtil – en intern implementeringsdetalje. Da siloerne er udviklet i en helt ny teknologistak, er detaljerne beskrevet i hhv.

• Underbilag W - DFDG.JobSearch
• Underbilag X – DFDG.Taxonomy
• Underbilag X2 - DFDG.BorgerKommunikation
• Underbilag X3 - DFDG.Ydelsesundstilling

Siloerne udveksler data via forretningshændelser via en EventBroker (RabbitMQ), som er implementeret i Q1 2021. Bemærk at STAR's interne EventBroker ikke udstiller hændelser til eksterne. Det er alene en STAR-intern komponent. Eksterne forretningshændelser udstilles via WSRM.

Hver silo har egen database.

Det er STAR's ambition, at der fortsat skal udtrækkes funktionalitet ud af DFDG og placeres i egne siloer i takt med, at øvrig forretningsdrevet funktionalitet implementeres, eller i forbindelse med gennemførelse af moderniseringsprojekt i 2022-2025..

Servicelaget

Servicelaget er en tynd skal oven på forretningslaget. Servicelaget målrettes forretningsbehovene i de enkelte forretningsapplikationer og skærmer disse mod forretningslogikken og domænemodellen, som anvendes i forretningslaget.

De fleste services udstilles som SOAP webservices, og der skrives WSDL kontrakter via CodeFirst arbejdsformen med anvendelse af delte typer (Shared-Types), herunder bl.a. OIO typer. WSDL-kontrakten beskriver syntaks for de enkelte felter, samt kardinalitet. Alle kald valideres. Ved fejl kastes en SOAP Fault.

Webservices er udviklet via Microsoft Windows Communication Foundation (WCF) rammeværket.

Alle webservices er beskyttes via server-certifikater til kryptering af kommunikationen og klient OCES funktionscertifikater til autentificering. Forretningslaget sikrer også, at aftagere kun får adgang til de services og data, som aftager må modtage.

DFDG er ved at omlægge services fra SOAP (WCF) til REST/Json/WebApi. I første fase er det kun services i de nye forretningssiloer, som overgår til REST, men efterhånden som DFDG's interne komponenter bliver modne til at udstille i REST, vil resterende eksisterende service gradvist overgå til REST.

Services i DFDG kan logisk opdeles i fire typer:

1. Forretningsservices
   1. Disse services foretager en forretningshandling, som kan resultere i en eller flere registreringer af data i DFDG, men også resultere i kald til andre systemer. Sådanne services er typisk tænkt som del af en specifik forretningsgang.
2. Dataservices
   1. Disse services arbejder direkte på en enkelt entitet og stiller typisk et CRUD (Create, Read, Update og Delete) interface til rådighed. Read operationen er typisk stillet til rådighed via den brede PersonStatusService eller mere målrettede status-services, der returnerer mange centrale data omkring borgeren, og Delete operationen er i flere tilfælde udeladt men understøttet som en blød sletning via Update operationen.
3. Hændelsesservices
   1. Disse services returnerer data om hændelser, som udsendes via WSRM køen i DFDG. WSRM køen er en hændelseskø for hver aftagertype (dvs. organisation, forretningsenhed, osv.), f.eks. et Jobcenter eller en Kommune. Hændelseskøen underretter aftagerne om, hvilke hændelser der kan være relevante for denne aftager.
4. Infrastrukturservices
   1. Disse services er en del af rammeværket og understøtter f.eks. hændelseskøen, logning, sikkerhed eller andet.

Webservicekatalog

DFDG tilbyder en række webservicekataloger med et antal webservices i hver, som kan tilgås af eksterne applikationer.

Der findes i dag:

• Omkring 230 webservices, der hver tilbyder en eller flere operationer

Hver service underordnes et versionsnummer. Versionsnummer tælles op for hver servicegeneration. Beskrivelse af de enkelte services kan findes her:

https://starwiki.atlassian.net/wiki/spaces/FYS/pages/1638408/DFDG+Services

Hovedkataloget i DFDG er PjakTass, hvor de fleste webservices fremadrettet oprettes. Derudover er der en række mindre kataloger, hvoraf en del forventes nedlukket med tiden. PjakTass blev i sin tid oprettet for at understøtte Pilot Jobcentrenes A-kasse Kommunikation (PJAK) samt Tilmelde, Afmelde og Status Service (TASS) i både kommuner, a-kasser og på Jobnet.

Webservices, der tilgås af eksterne aftagere og af VITAS, JobAG og Jobnet er beskrevet i STAR’s webservice WIKI: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/1638408/DFDG+Services

Forretningslaget

Forretningslaget indeholder forretningskomponenter for de forskellige applikationer. Forretningslaget kan kalde andre services via serviceagenter.

DFDG er opdelt i en række applikationsmoduler, som har hver sine egne forretningsmoduler. Applikationsmodulet PjakTass er f.eks. opdelt i ca. 75 forretningsmoduler med hvert sit ansvar.

Forretningsmodulerne foretager forretningsmæssig validering af kaldene, og der returneres fejl. Alle forretningsfejl er nummereret. Fejl kan findes ud fra kodeliste i CodeListService.

Batchjobs

DFDG indeholder en del forretningslogik, som afvikles som batchjob. Afviklingen for DFDG er omfattende, og der afvikles mere end 70 batchjob, hvoraf hovedparten afvikles alle ugens dage.

Beskrivelserne af DFDG batchjobs er fordelt på:

• STAR’s webservice WIKI: https://starwiki.atlassian.net/wiki/spaces/CITY/pages/36765906/DFDG+BatchJobs STAR Dokumentationsarkiv (kræver login)

https://dokumentationsarkiv.star.dk/Lists/Batch%20Dokumentation/AllItems.aspx

Her er den overordnede gruppering af jobs:

Datalaget

Dataadgangslaget i DFDG håndterer helt klassisk adgangen til databaser og eksterne services og tilbyder et abstraktionslag mod data/services, så forretningslaget kan anvende og gemme data uafhængigt af kilden.

Data access

Under DFDG opsamles data i en række databaser. De enkelte DFDG databaser anvender alt overvejende Stored Procedures som adgang til tabeller og data. Hoveddatabasen under DFDG er BrokerServices. Denne indeholder mange hundrede Stored Procedures.

Databaserne er listet i det følgende:

Service agents

DFDG kalder eksterne services, her kan kort nævnes:

Miljøer

Følgende er en kort introduktion til de anvendte miljøer.

Produktionsmiljø

DFDG eksekveres i dag i en webfarm med en række webservere og et database-cluster som illustreret på følgende:

Figur 5: Driftsarkitektur (produktion)

Serverne er Microsoft Windows Baserede og anvender følgende serversoftware:

• Windows Server
• SQL Server 

Miljøet afvikles i en to-center drift konfiguration. Miljøet kører samtidig i begge centre med fælles kapacitet.

Følgende observeres omkring to-center konfigurationen:

• Data er placeret i et SAN, der er fuldt redundant.
• AD er redundant ved, at hver AD Server står i hvert sit driftscenter-site.
• SQL Cluster er redundant via en active-passive konfiguration.
• SQL serverne for henholdsvis produktionsmiljøet og præ-produktion er placeret i hvert sit driftscenter-site.
• Web servere er redundant ved at disse er jævnt fordelt på hvert driftscenter-site.

Driftsleverandøren er KMD på driftsaftale indgået gennem Statens IT.

Testmiljø

Internt og eksternt rettede testmiljøer hostes hos KMD på driftsaftale indgået gennem Statens IT. Testmiljøerne indeholder både DFDG, Jobnet og andre af STAR’s løsninger.

Der tilbydes en lang række miljøer, som er opdelt i forhold til de forskellige spor og test pass, som koden løber igennem. Det er miljøer til:

• Kundetest
• Ekstern integrationstest
• Intern integrationstest
• Leverandørtest
• Udviklingstest

DFDG releases til de enkelte miljøer med faste intervaller eller efter behov, afhængigt af miljø.

Anvendte teknologier og værktøjer

Løsningen er Microsoft baseret og vedligeholdes for det væsentligste med Microsoft standardværktøjer, fra Microsoft Web Platformen.

Udviklingen foregår primært med anvendelse af:

• Visual Studio 2019 Professional
• Github

Og ved anvendelse af følgende teknologier:

• NET Framework 4.7.2 (C#)
• WCF
• EntityFramework (minimalt)
• T-SQL Stored Procedures (hovedpart)

Samt følgende væsentlige .NET biblioteker:

• Log4net

Data- og trafikmængder

Datamængder

Der registreres årligt en lang række data i DFDG. Datamængden kan ses som en funktion af antallet af personer, som er i berøring med beskæftigelsessystemet. Nedenfor er angivet antallet af berørte personer og antal fuldtidspersoner fordelt på en række af de målgrupper, der behandles oplysninger om i DFDG.

Data samles i DFDG’s underliggende databaser, primært BrokerServices databasen. Den samlede datamængde i produktionsmiljøet er:

• DFDG databaser: ca. 430 GB data
• DFDG programværk: ca. 500 MB filer

DFDG indeholder data om ca. 7.500.000 borgere.

Trafikmængder

Samlet set gennemføres dagligt ca. 7-9 mio. servicekald mod DFDG, og trafikken forventes at være stigende.