Våra koncerngemensamma komponenter
Våra koncerngemensamma komponenter designas med uppskalning i åtanke - de skall vara möjiga att återanvända för samtliga förvaltningar och bolag. Detta uppnår vi genom att fokusera på generiska funktioner. En komponent har ett väl avgränsat ansvarsområde, och helhetslösningar uppnår vi genom att integrera våra komponenter med varandra.
Bilden nedan visar de koncerngemensamma komponenter som finns idag, implementerade i enlighet med vår API-strategi. Varje komponent är som en förmåga som kan nyttjas av mer eller mindre obegränsat antal system eller processer.
Komponenter
Våra komponenter är byggda i olika tekniker, men har det gemensamt att de är nåbara via standardiserade REST-APIer i vår API-infrastruktur. Vår ambition är att exponera så många som möjligt av våra komponenter som öppen källkod.
Nedan beskrivs samtliga befintliga komponenter på en mer detaljerad nivå, har du frågor om komponenter så kan du ta kontakt med diggin@sundsvall.se.
Observera!
Vi kommer från nu (juni -22) kontinuerligt fylla på vår externa API-katalog med beskrivningar av våra APIer (och mer) - komponenter som inte finns i listan nedan finner ni i stället här
Länk till annan webbplats, öppnas i nytt fönster.!
Beskrivning
Metakatalogen är vår centrala källa för information om våra medborgare, kommunkoncernens organisation, våra anställda, elever samt kommunens företag och organisationer.
Lösningsarkitektur
Beskrivning
Vi hanterar vår sensordata i Diwise (https://diwise.io/ Länk till annan webbplats, öppnas i nytt fönster.). Diwise implementerar ett subset av NGSI-LD
Länk till annan webbplats., eller ETSI GS CIM 009 som det också heter, och använder sig av datamodeller från Smart Datamodels (tidigare FIWARE) för att ta emot och leverera ut data.
Diwise integrerar dessutom med ett flertal andra datakällor för att, i kombination med sensor-data, skapa mer värdeskapande APIer.
Öppen data
Vissa av Diwise levererade API:er har även DCAT-AP-SE-formaterat metadata exponerat via en dcat-endpoint, som kan användas av Sveriges Dataportal för skördning. Respektive dataset i den exponerade katalogen pekar i sin tur på en proxytjänst för öppet data som tar hand om att hämta data via NGSI-LD och transformera det till det format som önskas av klienten.
Lösningsarkitektur
Källkod
Beskrivning
Incident hanterar registrering av felanmälningar. Vår första version hanterar felanmälningar mot systemet ISYCase (samhällsbyggnadskontoret), men planen är att gå mot en generisk ingång som fördelar ärenden mot olika förvaltningar/bolag och dess system. Vi planerar dessutom att på lite sikt addera text- och bildanalys av felanmälningar för att på så sätt styra dessa mot rätt verksamhet.
Lösningsarkitektur
Källkod
Beskrivning
Messaging är ett ekosystem i sig och hanterar utskick av SMS, e-post och digital post till våra medborgare och företagare.
Funktionen integrerar mot FeedbackSettings för att hämta en intressents (medborgare eller företagare) registrerade kontaktuppgifter, men fungerar även för engångsutskick till okända intressenter där vi bara känner till e-postadress (för e-postutskick) och mobiltelefonnummer (för SMS-utskick). För utskick av digital post behöver vi mottagarens personnummer.
WebMessageSender publicerar meddelanden från våra ärendeprocesser till vår e-tjänsteplattform så att våra intressenter kan ta del av information där. Andra kanaler kan också visa dessa meddelanden genom att hämta dem vid behov.
Lösningsarkitektur
Källkod
Beskrivning
FeedbackSettings är vår centrala hantering av våra intressenters kontaktuppgifter (för utskick av e-post och SMS). Vi ser en fördel att hantera dessa kontaktuppgifter centralt - det finns alltför många inaktuella uppgifter utspridda inom koncernen idag.
Lösningsarkitektur
Källkod
Beskrivning
Disturbances hanterar driftstörningar från våra förvaltningar och bolag - i en första release (under utveckling) driftstörningar från elnät med fler leverantörer av driftstörningar i plan. En intressent kan som registrerat sig för återkoppling kommer att meddelas om driftstörningars statusförändringar via Messaging (via e-post eller SMS).
Lösningsarkitektur
Källkod
Beskrivning
CaseManagement är en generisk funktion för hantering av digital ärenderegistrering och ärendeuppdatering. Nuvarande version hanterar ärenden för bygglov och miljökontoret (med integration mot ByggR och Ecos2), men den är designad för att relativt enkelt kunna skalas upp med fler ärendetyper.
Lösningsarkitektur
Källkod
Beskrivning
CaseStatus är en generisk funktion för att leverera ärende- och felanmälanstatus till våra intressenter. Den hanterar i dag ärendestatusar på ärenden från ByggR, Ecos2 och Open-E samt felanmälanstatus från ISYCase.
Lösningsarkitektur
Källkod
Beskrivning
Första versionen av BusinessEngagements integrerar med Bolagsverket och hämtar vilka företag en privatperson har rätt att företräda.
Lösningsarkitektur
Källkod
Beskrivning
RemindAndInform hanterar påminnelser till privatpersoner och företagare - en intressent registrerar när de vill få sin påminnelse (vilket kan vara kopplat till ett specifikt sökbart ärende) och utskick hanteras av Messaging. Funktionen är designad så att den även kan skicka information till våra intressenter som är initierade från andra funktioner i koncernen.
Lösningsarkitektur
Källkod
Beskrivning
Archive fungerar som en abstraktion mot vårt e-arkiv och utgör en grundsten i vårt arbete med att kontinuerligt skala upp e-arkivering generellt inom koncernen.
Lösningsarkitektur
Källkod
Beskrivning
I en första version av notes hanteras anteckningar kopplade till en organisation eller en intressent. Funktionen är designad så att samtliga inom koncernen ska kunna hämta, uppdatera och lagra anteckningar.
Lösningsarkitektur
%20notes.png)
Källkod
Beskrivning
Skolresekollen tillhandahåller för närvarande två olika funktioner för att understödja de som handlägger ärenden för skolskjuts respektive elevresor hos barn- och utbildningskontoret på kommunen:
- Avstämningar mellan beslutade ärenden för skolskjuts och elevresa och adressändringar.
Det handlar om att göra kontroller vid detekterad flytt av elever och vårdnadshavare; har de beviljad skolskjuts, och har de i så fall fortfarande rätt till skolskjuts? Detta så att vi kan dra in tidigare beviljade skolskjutsar där man inte längre uppfyller kraven och på så sätt dra ner på kostnader för busskort och skoltaxiresor. - Påminnelser till vårdnadshavare att ansöka om skolskjuts i de fall att ett beslutat ärende löper ut innan höstterminens start. Innan utskick kontrolleras om eleven fortfarande är berättigad såklart.
Förhoppningen är att detta kommer att avlasta verksamheten och jämna ut den puckel av ansökningar vi får in i dag precis i slutet av ansökanperioden, samt att det förstås är en bra service för våra medborgare.
Lösningsarkitektur
Historik
Våra komponenter är byggda i olika tekniker, men har det gemensamt att de är nåbara via standardiserade REST-APIer i vår API-infrastruktur. Vår ambition är att exponera så många som möjligt av våra komponenter som öppen källkod.
Vid sidan av utveckling av funktionalitet lägger vi kontinuerligt tid på att förbättra våra utvecklingsprocesser och verktyg/ramverk - detta tas inte upp nedan.
Juni 2022
- Första versionen av följande tjänster produktionssatta (en del sedan ett tag), och utveckling av första kanalapplikationen mot tjänsterna pågår för fullt; dataLake, party, customer, agreement, invoices samt measurementData
Maj 2022
- Första versionen av digitalMailSender (utskick av digital post till Kivra m fl brevlådeaktörer) satt i produktion. Användes första gången för ett massutskick från Lantmäterikontoret, och drygt hälften av alla mottagare kunde nås digitalt - en fin tid- och kostnadsbesparing jämfört med att skicka allt via snigel-post.
- Vi har bytt CMS för våra webbar på kommunen (från Wordpress till Sitevision), och i migreringsarbetet har RPA hjälpt oss genom att flytta över 2 000 sidor till vårt nya CSM - en perfekt uppgift för en robot som besparat oss många timmars manuellt arbete.
- En första version av Mina Sidor för Företag är produktionssatt för alpha-test av ett antal företag - applikationen integrerar med ett flertal av våra APIer, som till exempel FeedbackSettings, RemindAndInform, Notes, BusinessEngagements
April 2022
- Skolresekollen vidareutvecklad. Första körningen av påminnelser till vårdnadshavare som har barn vars period för beviljad skolresa löper ut innan höstterminens har körts.De påminns om att ansöka om skolresa inför höstterminen i god tid - detta för att jämna ut puckeln av ansökningar som i regel kommer in precis innan skolstart annars, och gör livet lite enklare för handläggarna
- Version 2 av Messaging satt i produktion - innehåller hantering av externa referenser, hantering av metadata för meddelanden samt koppling mot WebMessageSender (mer information om denna komponent finner ni under Messaging ovan)
- Uppskalning av CaseManagement pågår kontinuerligt - nu hanteras även registrering av avlopps- värmepumps- och hälsoskyddsärenden via den tjänsten
Mars 2022
- Metakatalogens API LegalEntity dyker upp i API Manager
- Första versionen av komponenten BusinessEngagement satt i produktion
- Första versionen av komponenten Archive satt i produktion
- Första versionen av komponenten Notes satt i produktion
- Lyckad demo av PoC på att koppla ihop Verksamt med kommunens ärenderegistrering
(Open-E->CaseManagement->Ecos2)
Februari 2022
- Flöde för automatisk felrapportering av vattenmätare i produktion
(vattenmätare->diwise->incident->felhantering) - Ärendestatus från Open-E adderat till CaseStatus
- Första versionen av komponenten WebMessageSender satt i produktion
Januari 2022
- Första versionen av komponenten RemindAndInform satt i produktion
- Skolresekollen (funktion som detekterar flyttar och kontrollerar om tidigare beslutade skolskjutsärenden och elevreseärenden skall omprövas)
December 2021
- Första bygglovsärendet registreras via CaseManagement
- Första versionen av komponenten Disturbances satt i produktion
November 2021
- Första miljökontorsärendet registreras via CaseManagement
- Första versionen av komponenten Messaging satt i produktion
- Första versionen av komponenten FeedbackSettings satt i produktion
September 2021
- Första versionen av komponenten CaseManagement satt i produktion
- Första versionen av komponenten CaseStatus satt i produktion
Juni 2021
- Diwise API dyker upp i API Manager
- OpenData dyker upp i API Manager, inklusive exponering av API:ets metadata på dataportal.se
April 2021
- Metakatalogens API Student dyker upp i API Manager
- Metakatalogens API FoundationObjects dyker upp i API Manager
- Första versionen av komponenten Incident satt i produktion
Mars 2021
- Metakatalogens API Employee dyker upp i API Manager
- Anläggningsregistrets API Facilities dyker upp i API Manager
Februari 2021
- Metakatalogens API Citizen dyker upp i API Manager
Hösten 2020
- Arbete med att sätta upp infrastruktur för API Management kickar igång, parallellt med att API-utveckling smyger igång.
Kontakt
Digitalisering och Innovation, Sundsvalls kommun
Norrmalmsgatan 4, 851 85 Sundsvall
E-post: diggin@sundsvall.se
Utveckling.Sundsvall
Se alla våra filmer på Youtube
