Systembeskrivning Boss
Innehåll 1 Inledning 3 1.1 Sammanfattning 3 1.2 Revisionshistoria 4 1.3 Referenser 4 1.4 Terminologi 5 2 Generell systembeskrivning 5 3 Funktionsbeskrivning översikt 7 3.1 Beskrivning av arbetsflödet 7 3.2 Roller och behörighet 7 3.2.1 Roller 7 3.2.2 Behörighet 7 3.3 Gränssnitt 8 3.3.1 Login 8 3.3.2 Sök 8 3.3.3 Trädmenyn 9 3.3.4 Menyraden 21 4 Teknisk systembeskrivning 31 4.1 Webbtjänst för datadistribution 31 4.2 Klienten 31 4.2.1 Synkronisering av basdatatabeller 31 4.2.2 Synkronisering av statistik 32 4.3 Datalagret 32 5 Arkitekturell beskrivning 32 5.1 Boss 33 5.1.1 BusinessLogic 34 5.1.2 BusinessLogicTest 34 5.1.3 Controls 34 5.1.4 Data 35 5.1.5 PDFWriter 35 5.1.6 PDFWriterTest 36 5.1.7 Statistics 36 5.1.8 Utils 37 5.1.9 Windows 37 5.1.10 WindowsTest 38 5.1.11 Windows Installer 38 5.2 Boss SyncService 38 6 Utvecklingsmiljö 39 6.1 Projektuppdelning 39 6.2 Nödvändig mjukvara 39 6.3 Kodkommentering 39 7 Databas 40 7.1 Databasmodell 40 7.2 Tabellbeskrivning 40
1 Inledning 1.1 Sammanfattning Budget och skuldsaneringssystemet (Boss) är en Windows klient applikation för att stödja Kommunernas verksamhet kring budgetrådgivning och skuldsanering. Systemet består av klient applikationen, en synkroniseringsservice och två MS SQL Server databaser. Figur 1 visa översiktligt systemets beståndsdelar för en mer detaljerad bild se Figur 2. Konsumentverket 2.0 1.1 1.0 Kommun Klient applikation Inbyggd synkroniserings klient Synkroniserings tjänst Deplyment Manifest Web server Pekar ut aktuell version Klient applikation Figur 1 Systemets delar Systemets databaser lagrar 3 typer av information, dessa beskrivs i Tabell 1. Informationstyp Skapas av Beskrivning Ärende Användare av systemet på kommuner. Representerar all ärende specifik information Grunddata Administratör på Konsumentverket Grunddata är generella data för alla ärenden. Innefattar: konstanter för beräkningar i systemet, kategorier för att klassificera skulder, rådsökande etc Statistikdata Automatiskt av systemet Stora delar av
Tabell 1 Informationsslag baserat på ärendedata och grunddata vi bestämda tidpunkter i ärendets livscykel. informationen om ett ärende avpersonifieras och lagras för att möjliggöra statistiks uppföljning. Applikationen distribueras med hjälp av Microsofts ClickOnce teknologi, samt som msi-paket. För att möjligöra automatisk distribution av grunddata och insamling av statistikunderlag kommunicerar klientapplikationen med en webtjänst på Konsumentverket. För att göra statistisk uppföljning möjlig både på lokal nivå så lagras avpersonifierad information om alla ärenden i en separat databas hos användaren. Den statistik grundande informationen skickas automatiskt till Konsumentverket i för att möjligöra statistik för riket. 1.2 Revisionshistoria Version Datum Författare Kommentar 0.1D 2010-06-10 Magnus Första utkast Einarsson/Logica 1.0 2010-10-21 Karin Uppdatering Bared/Logica 1.0 2011-03-20 Åsa Uppdatering Hagelin/Logica 1.1 2012-11-15 Anna Petersen, Konsumentverket Uppdatering 1.3 Referenser [2] Vägledning för kommuner: Personuppgift er och e- förvaltning [3] Microsoft ADO.net http://www.datainspektionen.se/documents/vaglednin g-eforvaltning.pdf Nummer Title Källa [1] Microsoft http://msdn.microsoft.com/enus/library/142dbbz4.aspx ClickOnce http://msdn.microsoft.com/enus/library/aa697427(vs.80).aspx
Entity Framework [4] Microsoft SQL Server 2008 [5] Crystal Reports [6] Microsoft.NET Framework 3.5 http://www.crystalreports.com/ http://msdn.microsoft.com/enus/sqlserver/bb671064.aspx http://msdn.microsoft.com/enus/library/zw4w595w.aspx 1.4 Terminologi Term Boss IIS Definition Budget- och skuldsaneringssystem Internet Information Server 2 Generell systembeskrivning Boss är byggt som en fet klient där all applikationslogik ligger i klienten. På server-sidan finns endast databasservern och synkroniseringstjänsten för distribution av grunddata och leverans av statistikgrundande data.
Figur 2 Systemöversikt
3 Funktionsbeskrivning översikt 3.1 Beskrivning av arbetsflödet Applikationen skall användas av kommunernas budget- och skuldrådgivare samt generera statistik som används både lokalt av kommunerna och centralt av Konsumentverket. Handläggare vid kommunerna hjälper rådsökande att se över deras finansiella situation och vidta eventuella åtgärder för att minska deras skuldsättning. Det finns i applikationen stöd för att registrera budget, skulder, inkomster, utgifter mm för att få en översikt över den rådsökandes finanser. Det är sedan möjligt att skapa förslag till återbetalningsplan, ackord och göra ansökan om skuldsanering till Kronofogden. Konsumentverket förvaltar systemet och ser till att centrala stödtabeller är uppdaterade. Statistikrapporter kan tas ut både lokalt hos kommunen och av Konsumentverket. Hos Konsumentverket finns statistik från alla Bossinstallationer från kommunerna. 3.2 Roller och behörighet 3.2.1 Roller Boss hanterar tre olika roller: HANDLÄGGARE Dessa användare kommer åt att arbeta med ärenden, arbetsuppgifter och ta ut statistikrapporter. Under menyn Administration kommer användaren åt att hantera adressregister, brevmallar, importera ärenden från Boss, konvertera ärenden från HEP samt hantera sina egna inloggningsuppgifter. ADMINISTRATÖR Utöver rättigheterna för handläggare får dessa användare tillgång till en utökad Administrationsmeny. Här kan administratören hantera alla användares inloggningsuppgifter, hantera behörigheter för ärenden, flytta ärenden mellan användare, gallra ärenden, samt åtkomst till lokala stödtabeller. ADMINISTRATÖR KONSUMENTVERKET Utöver rättigheterna för handläggare och administratör kommun får dessa användare åtkomst till ytterligare centrala stödtabeller. För att en administratör ska få denna roll krävs att databasen är initierad som Konsumentverkets databas. 3.2.2 Behörighet Begränsad behörighet kan anges för ärenden, om ingen begränsad behörighet är angiven har alla handläggare åtkomst till ärendet. I ett ärende kan användaren ange
begränsad behörighet och ange för varje användare i systemet om de har läs-, läsoch skrivbehörighet eller ingen behörighet till ärendet. Användare som inte har behörighet till ett ärende får inte upp det ärendet på Sök-sidan. Administratörer kan ändra begränsad behörighet för ett eller flera ärenden samtidigt genom att gå in i Behörighet under Administrationsmenyn. I detta formulär har administratören åtkomst till alla ärenden som har begränsad behörighet angivet. 3.3 Gränssnitt 3.3.1 Login Formuläret används för inloggning i systemet. Registrering och val av databas. 3.3.2 Sök Startformulär när man loggat in i Boss. Söker ut ärenden från aktuell databas enligt angivna sökkriterier. Default visas den inloggade handläggarens ej avslutade ärenden.
3.3.3 Trädmenyn PERSON Formulär för att registrera namn och adressuppgifter om den sökande. Vald mantalsskrivningsort ger aktuella skattesatser i formuläret Inkomst. En person som ges egenskapen Fiktiv genererar ingen statistikdata. ÄRENDE Grunduppgifter till den rådsökandes ärende. Händelser på ärendet och anteckningar till det kan registreras. När datumangivelserna Inkom, Påbörjat och Avslutat sätts genereras statisktiköverföring, liksom registrerade Händelser.
Ärenden kan kopieras och spegelvändas (rådsökandes sambo blir i spegelvända ärenden ny rådsökande). Behörighet till aktuellt ärende kan begränsas. BUDGET Ett ärende har minst en budget. En budget måste utgöra underlag för automatiska beräkningar, från denna budget hämtas uppgifter till de olika åtgärder som kan vidtas för en person. Budgeten i sig består av hushållet, inkomster, utgifter, boendeuppgifter samt skulder och lån.
HUSHÅLLET Hanterar hushållets medlemmar. Hushållsmedlemmar under 20 år måste ha en boendestatus, såvitt de inte är markerade som sammanboende. För sådana medlemmar görs också beräkning av barnbidrag eller studiestöd om sådan egenskap har angivits. INKOMSTER Hushållets inkomster anges per person och inkomstslag. Beräkning görs av barnbidrag och preliminärskatt. Manuell ändring av de beräknade beloppen kan göras. Om inga skattesatser angivits manuellt så visas aktuella skattesatser för den mantalsskrivningsort som finns registrerad för den rådsökande.
UTGIFTER Hushållets utgifter anges per person och utgiftsslag. Schablonkostnader för vissa utgiftsslag kan visas och också hämtas in till budgetens utgifter. BOSTAD Sammanställning av bostäder och boendekostnader för aktuellt hushåll. Bostad anges, med ägarandel för småhus och bostadsrätt samt taxeringsvärde för beräkning av fastighetsavgift för småhus. Hushållets driftkostnader för respektive bostad anges.
Hushållets bolån anges. Funktion för beräkning av bostadsbidrag finns.
SKULDER och lån Sammanställning av hushållets skulder och lån. Tabellen innehåller alla uppgifter om respektive skuld/lån inkl fordringsägares och ombuds adressuppgifter. Funktioner för ändring av ränta och amorteringar för ett eller flera markerade lån. Hushållets skulder och lån anges med koppling till fordringsägare och ombud i adressregister. Ränteberäkning med eller utan referensränta. Skulder och lån som inte betalas tas inte med i sammanställningar av hushållsbudgeten.
TOTALA UTGIFTER Ingen registrering, endast en sammanställning av de utgifter som angetts i modulerna Utgifter, Bostad och Skulder och Lån. RESULTAT Ingen registrering. En sammanställning över hushållets genomsnittliga inkomster och utgifter för en månad. Visas för samtliga hushållsmedlemmar (kan välja att dölja en eller flera), totalt för respektive rubrik eller i detalj på varje inkomst- /utgiftsslag.
ÅRS SAMMANSTÄLLNING Årssammanställningen består av två delar, en årssammanställning och ett buffertsparande. I årssammanställningen görs ingen registrering. Här visas en sammanställning över hushållets inkomster och utgifter för varje månad under året. Visas totalt på rubriknivå eller i detalj på varje inkomst-/utgiftsslag. Behov av buffertsparande för respektive månad visas i nedre delen. Här beräknas behov av insättningar och uttag ur buffert automatiskt. Handläggare kan ändra dessa siffror. BETALNINGSUTRYMME Ingen indatering (inmatning). Betalningsutrymme beräknas utifrån inregistrerade värden i Boss budgetmoduler. Uppställning och beräkning görs på motsvarande sätt som Kronofogdemyndighetens e-tjänst för beräkning av förbehållsbelopp.
Eget betalningsutrymme följer samma beräkningsprinciper, men handläggaren anger värden själv. ÅTGÄRDER Från detta formulär skapas de åtgärder som kan vidtas på ett ärende. Här görs också insolvensberäkning. NEDSKRIVNING MED BETALPLAN Samtliga skulder och lån som inte är bolån visas i betalplanen. Genom att ange återbetalningsbelopp och återbetalningsregler beräknas en betalplan. DETALJERAD BETALPLAN Detaljerna i betalplanen visas för respektive månad. Beloppen kan justeras. Lägsta betalningsbelopp kan anges.
ACKORD Samtliga skulder och lån som inte är bolån visas i Ackord. Genom att ange ackordsbelopp eller ackordslikvid skapas ett ackordsförslag. ANSÖKAN OM SKULDSANERING Handläggaren kan välja att hämta in uppgifter från ärendet till skuldsaneringsblanketten, eller fylla i manuellt. Dock kan skulder och lån inte uppdateras i blanketten, utan måste hämtas från Boss budgetmodul för skulder och lån. Blanketten sparas i databasen. Vid utskrift används Kronofogdemyndighetens blankett för ansökan av skuldsanering samt eventuellt bilaga C till denna (om antal skulder är fler än nio).
OMPRÖVNING AV SKULDSANERING Handläggaren kan välja att hämta in uppgifter från ärendet till skuldsaneringsblanketten, eller fylla i manuellt. Blanketten sparas i databasen. Vid utskrift används Kronofogdemyndighetens blankett för ansökan av skuldsanering. BREV OCH DOKUMENT Formulär där de brev och dokument som kopplats till ärendet visas. Nytt brev eller dokument kan läggas till. Funktion för kopplade utskrifter, dvs en brevmall kopplas till ärendet och brev till fordringsägare/ombud kan skapas/skrivas ut. Funktion för att skapa e-postlista utifrån fordringsägares/ombuds e-postadresser. Funktion för att skriva ut adressetiketter till de fordringsägare/ombud som är aktuella för ärendet.
ANTECKNINGAR Formulär för anteckningar till ärendet. KREDITRÅD Ingen registrering i detta formulär, visar sammanställning inlagda krediter med kreditkostnad, kredittid, effektiv ränta mm.
Registrering av kredit med beräkning av ränta, amortering, kreditkostnad och inbetalning för resp period under kredittiden. 3.3.4 Menyraden ARKIV Funktioner för att skapa Ny (Person, Ärende eller Budget), visa eller dölja trädmenyn, utloggning samt avsluta Boss.
ÄRENDE Funktioner för att byta ägare på ett ärende och exportera ärende. Menyn visas bara om handläggaren är inne på ett ärende i Boss, alltså har markerat ett ärende eller underliggande nivå i trädmenyn. Byt ägare Funktion för att byta handläggare på aktuellt ärende Exportera Funktion för att exportera ärenden ur Boss. Sparar ärendet och de brev och dokument som hör till i en zip-fil, som sedan kan importeras i en annan Bossdatabas. ARBETSUPPGIFTER Funktion för att registrera arbetsuppgift som inte tillhör ärende.
ADMINISTRATION Innehåller administrativa funktioner till Boss. Innehållet i menyn beror på handläggarens behörighet, samt om installationen är en kommuninstallation eller en Konsumentverksinstallation. För en handläggare utan administratörsrättigheter visas bara Adressregister, Brevmallar, Handläggare, Import av ärende från Boss samt Konvertera ärende från HEP. För en handläggare med administratörsrättigheter på en Konsumentverksinstallation visas följande Administrationsmeny:
Administrationsmenyn för handläggare med administratörsrättigheter i en kommuninstallation saknar menyvalen Importera LKF-fil och Stödtabeller för Avgift, Beräkningar och Bostad. Dessutom innehåller undermenyn för Stödtabeller färre val. Adressregister Samlat adressregister för fordringsägare och ombud. Visning i egen dialog, uppdateringsmöjligheter i underdialog.
Behörighet Hantering av behörigheter för ärenden som har fått särskild behörighet. Brevmallar Editor för att skapa egna brevmallar med märkord som vid utskrift byts ut mot uppgifter i ärendet.
Byt handläggare för ärende Funktion för att byta handläggare för flera ärenden. Gallring av ärenden Funktion för att gallra ut ärenden som markerats för gallring. Handläggare Funktion för hantering av handläggare. Endast administratörer kan se och uppdatera andra handläggare än den egna. Visas i lista, uppdateras i underdialog.
Importera LKF-fil Funktion för import av fil från skattemyndigheten, innehållande kommunalskattesatser, kyrkoavgifter och begravningsavgifter för Sveriges samtliga kommuner och församlingar. Hanterar en excelfil med visst utseende. Importera ärende från Boss Funktion för import av ärenden från Boss. Läser in en zip-fil som skapats i annan Bossinstallation. Konvertera ärende från HEP Funktion för att konvertera ärenden från HEP. Läser in en hsh-fil som skapats i HEP. Stödtabeller Funktion för att underhålla de stödtabeller som används i systemet. Administratörer på en kommuninstallation har alternativen Arbetsuppgiftstyp, Händelsetyp, Skuldtyp och Utgiftsslag i sin meny. Arbetsuppgiftstyp används i funktionen för registrering av arbetsuppgifter.
Driftkostnadstyp används i budgetens Bostadsmodul för registrering av driftkostnader för bostad. Fastighetsskatt innehåller skattesatser och gränsvärden för beräkning av fastighetsskatt (används f n ej). Händelsetyp används i Ärendemodulen vi d registrering av händelse. Kompletterande uppgift används i Ärendemodulen. Kontakttyp används i Ärendemodulen Referensränta används i budgetens Skulder och lån-modul. Schablonkostnad innehåller schablonkostnader för olika utgiftsslag i kombination med kön och ålder, alternativt i kombination med antal hushållsmedlemmar. Används i budgetens Utgiftmodul. Skuldtyp innehåller skuldtyper och används i budgetens Skulder och lån-modul. Skuldtyper som registrerats hos Konsumentverket visas som Skuldtyp och skuldtyper som registrerats i kommunen visas som Skuldtyp 2. Utgiftsslag används i budgetens Utgiftsmodul för registrering av utgifter för resp hushållsmedlem. Stödtabeller Avgift Funktion för att underhålla de stödtabeller som används i systemet för olika typer av avgifter. Finns endast i Konsumentverksinstallation. Egenavgifter innehåller de olika egenavgifter som betalas om man har inkomst av näringsverksamhet. Används f n inte. Fastighetsavgift innehåller skattesats och gränsvärden för beräkning av fastighetsavgift. Används i budgetens Bostadsmodul. Pensionsavgift innehåller procentsats och gränsvärden, används vid skatteberäkningen i budgetens Inkomstmodul. Stödtabeller Beräkningar Funktion för att underhålla de stödtabeller som används i systemet för olika beräkningar.
Barnbidrag innehåller barnbidragsbelopp, flerbarnstilläggsbelopp och studiestödsbelopp som används vid beräkning av barnbidrag i budgetmodulen Inkomster. Basbelopp används vid skatteberäkning i budgetens Inkomstmodul. Grundavdrag innehåller gränsvärden, grundavdragsbelopp och procent. Används vid skatteberäkning i budgetmodulen Inkomster. Grundavdrag, Pensionär innehåller gränsvärden, grundavdragsbelopp och procent. Används vid skatteberäkning i budgetmodulen Inkomster. Jobbskatteavdrag innehåller gränsvärden, belopp och procentsatser. Används vid skatteberäkning i budgetmodulen Inkomster. Jobbskatteavdrag, Pensionär innehåller gränsvärden, belopp och procentsatser. Används vid skatteberäkning i budgetmodulen Inkomster. Kapitalskatt innehåller gränsvärden och skattesats för beräkning av kapitalskatt, som görs i budgetens Inkomstmodul. Normalbelopp för betalningsutrymme innehåller beloppsvärden för vuxna samt barn i olika ålder och med olika boendestatus. Används i modulen Betalningsutrymme. Skatteavdrag innehåller belopp för olika skatteavdrag som görs vid skatteberäkning i budgetmodulen Inkomster. Statlig skatt innehåller beloppsgränser för beräkning av statlig skatt som görs vid skatteberäkning i budgetmodulen Inkomster. Stödtabeller Bostad Funktion för att underhålla de stödtabeller som används i systemets bostadsmodul.
Garantinivå, bostadsbidrag innehåller olika garantinivåbelopp i kombination med antal barn. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. Inkomstgräns för bostadsbidrag innehåller gränsvärden och reduktionsvärden i kombination med antal barn. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. Kostnadsgräns för bostadsbidrag innehåller gränsvärden i kombination med antal barn. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. Kostnadsgräns för bostadsbidrag, unga innehåller gränsvärden och bidragsandelar. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. Kvadratmeterpris för bostad innehåller pris per kvm i kombination med bostadszon. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. Särskilt bidrag, bostadsbidrag innehåller belopp i kombination med antal barn. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. Umgängesbidrag, bostadsbidrag innehåller belopp i kombination med antal barn. Används vid beräkning av bostadsbidrag i budgetmodulen Bostad. STATISTIK Funktion för uttag av statistikrapporter. För varje fast rapport kan urval av olika parametrar göras.
HJÄLP Funktion för online-hjälp, utskrift av logfiler och information om systemet. 4 Teknisk systembeskrivning 4.1 Webbtjänst för datadistribution Boss använder en webbtjänst för att hantera distribution av grunddata från Konsumentverket och inleverans av statistikgrundande data från kommunerna. Webbtjänsten körs som en applikation i Internet Information Server (IIS). Webbtjänsten stödjer kommunikation med http och https, vilket som används konfigureras i IIS och klientens app.config. Om https skall användas så krävs certifikat i IIS för SSL. 4.2 Klienten 4.2.1 Synkronisering av basdatatabeller När man loggar in i applikationen startas en trådad process för att synkronisera basdata från KOV databasen. Denna process öppnar ett separat, minimerat fönster där information om vilka tabeller som synkas kan ses. Går allt bra så stängs detta fönster några sekunder efter synkroniseringen är klar och om något fel uppstår så visas detta för användaren innan fönstret stängs.
Applikationen håller reda på när senaste synkronisering gjordes och endast data som skapats/ändrats sen senaste synktillfälle hämtas. 4.2.2 Synkronisering av statistik När man loggar ut/stänger ner applikationen startas en trådad process för att föra över statistik till KOV. Likt synkroniseringsprocessen i 4.2.1 öppnas ett fönster där information visas om förloppet. 4.3 Datalagret I Boss-applikationen används Entity Framework som dataförmedlare/objektmodell mellan databasen och applikationen. En edmx- modell ger en grafisk presentation av de klasser som används för hantering av data inom applikationen. Denna modell är en spegling av de tabeller som finns i den databas som modellen pekar på (det finns två sådana modeller i Boss projektet, BossModel.edmx och BossStatistikModell.edmx) 5 Arkitekturell beskrivning För att ge flexibilitet i implementationen av användargränssnittet används en arkitektur som isolerar användargränssnittet från applikationslogik och data Presentationslagret är ett grafiskt gränssnitt konstruerat med hjälp av Windows Forms. Logiklagret tillhandahåller tjänster till presentationslagret. Datalagret implementerar lagring av det data som logiklagret arbetar med. Presentation Logik Data Windows Forms Service Applikations Logik ADO.Net SQL Server Express Loggning/felhantering Säkerhet/Behörighetskontroll Boss är uppbyggt av följande komponenter och ramverk.
Vi använder Microsoft standardramverk Microsoft.NET Framework 3.5 Microsoft ADO.net Entity Framework Microsoft Sync Framework Microsoft Enterprise Library De tredjepartsprodukter som ingår är Crystal Reports Microsoft SQL Server 2008 Express Crystal Reports används för rapporter ur Boss. Microsoft SQL Server 2008 Express används av de Bossanvändare som inte har/vill ha en gemensam databas på en SQL Server 2005 eller 2008. Detta rekommenderas inte i produktion utan endast för test och utbildning. Budget- och skuldsaneringssystemet Boss består av två solutions, en för själva applikationen och en för synkservicen. Den senare kan också ses som ett av Boss olika projekt. Applikationen är i sin tur uppdelad i ett antal projekt. Varje del beskrivs närmare nedan. 5.1 Boss Huvudspåret, Boss solution, innehåller alla de funktioner som utgör applikationen Boss. Den består av ett antal olika projekt som beskrivs närmare nedan.
5.1.1 BusinessLogic I BusinessLogic-projektet finns de beräkningar som används i applikationen. I Berakning.cs finns bland annat de skatteberäkningar som anropas från olika delar i applikationen. 5.1.2 BusinessLogicTest BusinessLogicTest innehåller de unittester som finns för beräkningarna i projektet BusinessLogic. Det är fram för allt de beräkningar som inte är beroende av stödtabeller i databasen som det finns unittester för. 5.1.3 Controls Controls innehåller de anpassade kontroller som skapats för applikationen. DataGridViewSelectableColumns är en anpassning av DataGridView där användaren bland annat kan välja vilka kolumner som ska visas med en popupmeny. Användarspecifika inställningar för tabeller lagras och hämtas nästa gång tabellen används. ComboboxMedRensa högerklick ger menyval med möjlighet att ta bort valt objekt i komboboxen. DatePicker är en anpassad kontroll för att välja datum mha kalender. Default är den tom, vilket skiljer den från kontrollen DateTimePicker som alltid innehåller ett datum. RTFEditor är den editor som används för att skapa och anpassa brevmallar som används i applikationen. I det här projektet finns även färdiga kontroller för rubriker som används i alla formulär
5.1.4 Data Projekt Data innehåller applikationens koppling till och hantering av data i databasen Boss BossModell är Entity Framework-modellen med koppling till databasen. I DataSet finns de dataset som används för rapporter i Boss. Under Partials finns klasser för de olika klasserna i datamodellen med olika metoder för att hämta poster från databasen utifrån olika kriterier. Konstanter som används i applikationen finns under mappen Constants. DataHelper innehåller hjälpfunktioner som används av applikationen för att hämta, uppdatera, ta bort och kopiera data. UpdateScript innehåller de script som körs för att uppdatera databasen om så behövs, när nya versioner av Boss installeras. 5.1.5 PDFWriter Projektet PDFWriter innehåller en funktion för att skriva till en pdf-blankett. Funktionen används av Boss modul för ansökan om skuldsanering.
5.1.6 PDFWriterTest Innehåller unittester för projektet PDFWriter. 5.1.7 Statistics Projekt Statistics innehåller applikationens koppling till och hantering av data i databasen BossStatistik. BossStatistikModell är Entity Framework-modellen med koppling till databasen. I mappen Partials finns partialklasser för de olika klasserna i datamodellen. Konstanter som används i applikationen finns under mappen Constants. BossStatistikDataSet innehåller de dataset som används för att ta fram statistikrapporterna. Mappen TableAdapters innehåller funktioner för att fylla datasetet med data som uppfyller sökvillkoren. StatisticsHelper innehåller hjälpfunktioner som används av applikationen vid synkronisering av statistik till Konsumentverket. UppdateraStatistik innehåller de funktioner som används för att lagra lokal statistik i samband med att ärende eller arbetsuppgift sparas i applikationen. Exceptions innehåller de exceptions som tas om hand i statistikfunktionen. I GlobalSuppressions finns de globala undertryckningar från den statiska kodanalysen som gjorts i statistikprojektet.
5.1.8 Utils Projektet Utils innehåller några hjälpfunktioner till applikationen. Här finns programmen till funktionerna för konvertering av gamla HEP-ärenden, export och import av ärenden från och till Boss. Även hanteringen av brevmallarnas märkord finns här. 5.1.9 Windows Projektet Windows innehåller huvuddelarna i Bossapplikationen. ServiceReferences består av referenserna till de två synktjänster som körs, dels när Boss startas, dels när Boss avslutas. Själva synkningstjänsten finns i Boss SyncService solution. Administration innehåller de dialoger som anropas i Boss administrativa rutiner. Under Common finns hjälpfunktioner till Bossmodulen Skuldsanering. I Constants finns konstanter för namnsättning av gridar. Dialog innehåller de dialoger som anropas från någon av Boss olika moduler (UCs). InheritableItem innehåller de dialoger och UserControls som de dialoger och UserControls som finns under Administration, Dialog och Page ärver från. Utseende, knappar, rubriker och grundfunktioner för ex sparande och borttag ligger i dessa dialoger och UCs. Page innehåller de UserControls som utgör de olika modulerna i Boss. I Pdf finns de tre av Kronofogdemyndigheten fastställda blanketterna för skuldsanering. Under Report finns de rapporter som används i Boss. Under Resource och Resources finns de olika bilder och ikoner som används i applikationen. Scripts innehåller script för skapande av databas och tabeller. De används när en applikation startas på en maskin där användaren valt att köra SQL Server Express och ingen databas finns skapad.
I Sync finns programmen för synkning som körs vid inloggning resp utloggning ur Boss. Under Webhelp ligger html-filer och övrigt som används för Boss online-hjälp. ApplicationHelper innehåller olika hjälpmetoder som övriga program använder. I BossDBConfiguration ligger en klass som används av app.config. DataBaseInit klass som skapar databasen utifrån de script som finns i Scripts. I GlobalSuppressions finns de globala undertryckningar från den statiska kodanalysen som gjorts i Windowsprojektet. HandleCommandLineOptions är en klass som tolkar kommandoraden och utför de aktiviteter som anges. MdiParent är klassen för huvudfönstret. Program är den klass som startar Boss. ValidationHelpers innehåller metoder som används av andra klasser vid validering. 5.1.10 WindowsTest Projektet WindowsTest innehåller unittester av Windowsprojektet. 5.1.11 Windows Installer Projektet Windows installer används för att skapa msi-paket för installation. 5.2 Boss SyncService Boss SyncService solution är ett projekt i Boss. SyncService delar projekten BusinessLogic, Data, Utils och Statistics med Boss solution. Dessutom ingår projektet SyncServiceLibrary. Detta projekt innehåller två ServiceContract som används för att skicka basdata till Boss klienter samt ta emot statistik från dessa. I detta projekt finns klasserna BossService, BossStatisticsService, IBossService och IBossStatisticsService. IBossService och BossService används för synkronisering av grunddata när användare loggar in i Boss. Uppkoppling sker då mot Konsumentverkets server och grunddata i den lokala databasen kollas mot grunddata i servern. Om uppdateringar
skett sedan senaste synkningsdatum (endast datum, ej tid) hämtas ny data från servern. IBossStatisticsService och BossStatisticsService används för synkronisering av statistikdata när användare loggar ur från Boss. Uppkoppling sker mot Konsumentverkets server och ärenden som ska föras över till Konsumentverkets statistikdatabas skickas över. Samtidigt görs också en överföring av statistik till användarens lokala statistikdatabas. 6 Utvecklingsmiljö Boss är utvecklat som en Windowsklient mha Visual Studio 2008, Windows Forms,.NET Framework 3.5 och med Visual C# som programmeringsspråk. Standardalternativet för databasmotor är Microsoft SQL Server 2008 Express, vid större installationer står valet mellan Microsoft SQL Server 2005/2008 Standard eller Enterprise edition. 6.1 Projektuppdelning Lösningen Konsumentverket.Boss är uppdelad på följande 12 projekt; BusinessLogic beräkningar som används i applikationen BusinessLogicTest unittester för projektet BusinessLogic Controls anpassade kontroller för applikationen Data koppling till och hantering av data i databasen Boss PDFWriter - funktioner för att fylla pdf-blanketter med data PDFWriterTest unittester för projektet PdfWriter Statistics - applikationens koppling till och hantering av data i databasen BossStatistik. Utils - ett antal hjälpfunktioner som används av applikationen Windows - gränssnittet för applikationen WindowsTest unittester för projektet Windows BossInstaller skapar installationspaket för Boss SyncServiceLibrary - två ServiceContract som används för att skicka basdata till Boss klienter samt ta emot statistik från dessa SyncServiceSite - används för att installera SyncServiceLibrary i IIS Projekten och dess innehåll beskrivs närmare under punkterna 5.1 och 5.2 ovan. 6.2 Nödvändig mjukvara Följande mjukvara behövs vid förvaltning och förändring av systemet: - Visual Studio 2008 - SQL Server 2005/2008 - Crystal Reports 2008 6.3 Kodkommentering Metoder och events har kommenterats med xml-kommentering, där en summering av vad metoden används till, samt ingående parametrar och returvärden anges. XML-kommenteringen kan skrivas ut till en xml-fil.
Se exempel nedan. /// <summary> /// Validerar rakt lån /// </summary> /// <param name="visafelmarkering">visafelmarkering sätts till true om valideringen görs vid spara, annars till false</param> /// <returns>returnerar true om valideringen är ok, annars false</returns> private bool ValideraRaktLan(bool visafelmarkering) 7 Databas 7.1 Databasmodell Applikationen använder två databaser Boss och BossStatistik. Boss innehåller all data som används och skapas vid hantering av ärenden och arbetsuppgifter. BossStatistik innehåller den avpersonifierade statistikdatan. 7.2 Tabellbeskrivning Tabellnamn Ackord AckordSkuld Adress Anteckning ArbetsUppgift ArbetsUppgiftTyp Arende Innehåll Övergripande information om ackordsförslag för ett ärende. Information om vilka skulder som ingår i respektive ackordsförslag Adressuppgifter om fordringsägare och ombud för skulder. Anteckningar kopplade till ärende Fristående arbetsuppgifter som inte är kopplade till specifikt ärenden Stödtabell för typer av arbetsuppgift. Administreras av KoV och distribueras med KovID sätts vid skapande av poster hos Konsumentverket. Tabellen kan även uppdateras lokalt. Information om ärendet med koppling till Radsokande. Innehåller aktivbudgetid som pekar på den budget som ska ligga till grund för beräkningar och åtgärder. Vid förändring av InkomDatum, PaborjatDatum och AvslutatDatum sparas även avpersonifierad information till statistikdatabasen BehorighetsKontroll anger om ärendet har begränsad
ArendeBehorighet ArendeKompl AtgardStatusTyp BarnBidrag Basbelopp Betalplan BetalplanAterBetProcent BetalplanBetUtrymme BetalplanPeriod behörighet satt (se ArendeBehorighet). Information om begränsad behörighet. Om Arende.BehorighetsKontroll = 1 och användaren inte är ägare till ärendet, så sker en kontroll om användaren finns med i tabellen ArendeBehorighet och med vilken behörighetstyp. Detta styr om användaren får läsa, läsa/skriva eller inte alls se ett ärende. Information om vilka kompletterande uppgifter som finns registrerade för ett ärende. Stödtabell med statusar för åtgärder (skuldsanering, betalplan och ackord). När en användare ändrar status för en åtgärd skapas även en händelse på ärendet. BossID används för att styra vilka statusar som hör till vilken åtgärd, samt vilken händelsetyp som ska skapas på ärendet. Finns inget gränssnitt för uppdatering Stödtabell som innehåller information om storleken på barnbidrag kopplat till antal barn. Används för att beräkna barnbidraget i formuläret Inkomst. Stödtabell som innehåller basbelopp. Används vid beräkning av preliminärskatt Övergripande information om betalplan för ett ärende. Har koppling till BetalPlanSkuldTyp i två fält, ProportionTill och AndelAv. AktivBudgetId Innehåller information om vilken budget som var aktiv när betalplanen sparades. Om det har ändrats när användaren öppnar formuläret igen fås ett meddelande om att betalplanen nollställs då den inte längre baseras på aktiv budget. Information om återbetalning i procent som angivits för betalplan. Procentsatserna kan läggas på olika skuldtyper. Koppling till Betalplan görs med BetalPlanID. Innehåller de betalningsutrymmen som finns registrerade i en viss betalplan. BetalPlanID är kopplingen till Betalplan. Tabellen innehåller information om startdatum, längd och belopp (per månad). Innehåller den periodiserade återbetalningen som
BetalplanSkuld BetalplanSkuldAterbet BetalplanSkuldTyp BetUtrymmeEget BetUtrymmeKommentar BoendeStatustyp Bostad BostadAgare BostadBostadYta finns i formuläret Detaljerad betalplan. För varje BetalPlanSkuld som har Ingar = 1 skapas BetalPlanPeriod med information om vilket belopp som återbetalas för varje period. Innehåller koppling mellan en specifik betalplan och de skulder som ingår i den. Om användaren har angett en annorlunda periodisering av återbetalningen än den som finns för hela betalplanen så finns det lagrat i FranPeriod och TillPeriod. Om dessa är null så gäller den periodisering som finns i BetalPlan. Tabell för hantering av återbetalningsbelopp per skuld som ingår i betalplanen samt de betalplanperioder skulden betalas av i. Stödtabell med de olika skuldtyper som används i Betalplan. Innehåller Totalskuld, Kapitalskuld, Ränteskuld och Kostnader. Finns inget gränssnitt för att uppdatera. Innehåller ett eget betalningsutrymme för ärendet i de fall användaren manuellt har skapat ett sådant utöver det betalningsutrymme som beräknas utifrån information i den aktiva budgeten. För beräknade betalningsutrymmen kan användaren lägga till en kommentar Stödtabell med de olika boendestatusar som kan anges för barn i hushållet. Innehåller Heltidsboende, Växelvis boende och Umgängesbarn. Finns inget gränssnitt för uppdatering. Används vid beräkning av bland annat bostadsbidrag och hämtas då mha BossId. Innehåller information bostäder som finns registrerade för ett ärende. För varje ärende kan en bostad vara markerad som permanentbostad och det är den bostaden som används vid beräkning av bostadsbidrag och vid beräkning av boendekostnad vid ansökan om skuldsanering. För varje bostad lagras vem som är ägare och till hur stor andel. För bostadsrätt och småhus anger användaren ägarfördelningen, för övriga bostadstyper sätter systemet den rådsökande till ägare till 100%. Stödtabell som innehåller gränsvärden för bostadsyta kopplat till antal barn i hushållet. Används vid beräkning av bostadsbidrag
BostadGarantiNiva BostadInkomstGrans BostadKostnadGrans BostadKostnadGransUnga BostadKvmPris BostadRanteKostn BostadSarskiltBidrag BostadTyp Stödtabell som innehåller garantinivå för bostadsbidrag med koppling till antal barn i hushållet. Används vid beräkning av bostadsbidrag. Stödtabell som innehåller gränsvärden för inkomster för att styra med hur mycket bostadsbidraget reduceras. Används vid beräkning av bostadsbidrag. Stödtabell som innehåller gränsvärden för hur mycket bostaden får kosta i kombination med antal barn i hushållet för att man ska vara berättigad till bostadsbidrag. Används vid beräkning av bostadsbidrag. Stödtabell som innehåller gränsvärden för bostadskostnader samt de procentsatser som används vid beräkning av bostadsbidrag för personer som ej fyllt 29 år. Används vid beräkning av bostadsbidrag Stödtabell som innehåller gränsvärden för kvadratmeterpris för bostäder fördelat på olika bostadszoner. Används vid beräkning av bostadsbidrag Stödtabell som innehåller andelsprocentsatser som används vid beräkning av boendekostnader i bostadsbidragsberäkningen. Stödtabell som innehåller bidragsbelopp för heltidsboende barn kopplat till antal barn. Används vid beräkning av bostadsbidrag Stödtabell med de olika boendetyper som används vid registrering av bostad. Innehåller Småhus, Bostadsrätt, Hyresrätt förstahandskontrakt, Hyresrätt andrahandskontrakt, Inneboende, Studentlägnhet/-
BostadUmgangesBidrag BostadZon Budget Buffert Dokument DriftKostnad DriftKostnadPeriod DriftKostnadTyp EgenAvgift FastighetsAvgift FastighetsSkatt rum, Saknar bostad och Annat. Går bara att uppdatera sorteringsordning i gränssnittet. Används vid beräkning av bostadsbidrag och hämtas då mha BossId Stödtabell som innehåller bidragsbelopp för visstidsboende barn kopplat till antal barn. Används vid beräkning av bostadsbidrag Stödtabell som kopplar ihop varje kommun med bostadszon. Skapas och uppdateras vid inläsning av lkf-tabell hos KoV och distribueras med Används vid beräkning av bostadsbidrag Information om budget för ett ärende. Det kan finnas många budgetar kopplat till ett ärende, men bara ett som är markerat som det aktiva och som används som underlag för bl a åtgärder. Innehåller manuellt angivna buffertbelopp/månad för angiven budget. Innehåller sökväg och filnamn till de dokument som finns kopplade till ett ärende Information om vilka driftkostnader som finns registrerade för en bostad. Innehåller periodiseringar av driftkostnader om det finns angivna Stödtabell som innehåller vilka typer av driftkostnader som finns för bostäder. Stödtabell som innehåller egenavgifter. Finns inga poster i denna tabell i nuläget, eftersom det inte finns några inkomstslag som egenavgift ska beräknas för. Stödtabell som innehåller gränsvärden och skattesatser per fastighetstyp. Används vid beräkning av fastighetsavgift Stödtabell som innehåller skattesatser per fastighetstyp.
FastighetsTyp FritextSok GrundAvdrag GrundavdragPension Handelse HandelseStatus HandelseTyp Handlaggare HandlaggareTyp HushallMedlem Används vid beräkning av fastighetsskatt Stödtabell med de olika typer av fastigheter som kan anges för en bostad. Innehåller Småhus, Hyreshus, Småhus på lantbruksenhet och Ägarlägenhet. Finns inget gränssnitt för uppdatering. Används vid beräkning fastighetsavgift och hämtas då mha KovID. Innehåller de sparade fritextsökningar som handläggarna gjort. Stödtabell som innehåller procentsatser, belopp och gränsvärden för grundavdrag. GränsvärdeMin och GränsVärdeMax innehåller de värden som ska multipliceras med basbeloppet för att få fram gränsvärdesbeloppen. Används vid beräkning av preliminärskatt Stödtabell som innehåller procentsatser, belopp och gränsvärden för det förhöjda grundavdraget för pensionärer. GränsvärdeMin och GränsVärdeMax innehåller de värden som ska multipliceras med basbeloppet för att få fram gränsvärdesbeloppen. Används vid beräkning av preliminärskatt Innehåller de händelser som finns registrerade för ett ärende. Dels skapas händelser med automatik av systemet i samband med olika förändringar av ärendet och dels registrerar handläggaren händelser. Stödtabell med de olika statusar som kan anges för en händelse. Innehåller Inskickad, Inledande, Förslag, Avslutad, Beviljad, Avslag, Återkallad och Under utredning. Finns inget gränssnitt för uppdatering. Stödtabell som innehåller de händelsetyper som kan anges för en händelse. Administreras dels av KoV och distribueras med synkningen och dels av kommunerna som kan registrera lokala händelsetyper. Händelsetypen Systemhändelse kan inte ändras via applikationen. Innehåller de handläggare som finns registerade. Stödtabell med de olika typer av handläggare som kan anges för en handläggare. Innehåller Handläggare och Administratör. Finns inget gränssnitt för uppdatering. Innehåller de hushållsmedlemmar som finns
Inkomst InkomstPeriod InkomstSlag InkomstTyp Insolvens JobbskatteAvdrag JobbSkatteAvdragPension KapitalSkatt KomplUppgift KontaktTyp registrerade för en budget. När en budget skapas så lagras den rådsökande med automatik som hushållsmedlem. Information om vilka inkomster, skattesatser, underlag för skatteberäkning samt preliminärskatt som finns registrerade för en hushållsmedlem. Innehåller periodiseringar av inkomster om det finns angivna Stödtabell som innehåller de inkomstslag som inkomster kan registreras för. Finns inget gränssnitt för uppdatering, då en förändring av inkomstslagen innebär att skatteberäkning måste ses över. Alla inkomstslagen används vid preliminärsktteberäkningen och hämtas via BossID. Stödtabell som innehåller de olika typer av inkomstslag som finns. Innehåller Inkomster, Underlag för skatteberäkning, Skattesatser % och Preliminärskatt. Finns inget gränssnitt för uppdatering. Innehåller det betalningsutrymme som handläggaren vill beräkna insolvens utifrån. Stödtabell som innehåller gränsvärden, procentsatser samt tilläggsbelopp för jobbskatteavdrag. MinBelopp och MaxBelopp innehåller de värden som ska multipliceras med basbeloppet för att få fram gränsvärdesbeloppen. Används vid beräkning av preliminärskatt Stödtabell som innehåller gränsvärden, procentsatser samt tilläggsbelopp för jobbskatteavdraget för pensionärer. Administreras av KoV och distribueras med Används vid beräkning av preliminärskatt Stödtabell som innehåller gränsvärden och procentsatser för kapitalskatt. Används vid beräkning av preliminärskatt Stödtabell som innehåller de kompletterande uppgifter som kan anges för ett ärende. Stödtabell som innehåller på vilket sätt den
Kredit KreditPeriod KreditTyp Lan Lkf NormalBelopp OrsakTyp PensionsAvgift Radsokande RefRanta rådsökande fick kontakt. Detta kan anges för ett ärende. Innehåller de krediter som finns registrerade för ett ärende. Stödtabell som innehåller de olika typer av periodicitet som kan anges för en kredit. Innehåller Månad, Kvartal, Halvår och År. Finns inget gränssnitt för uppdatering. Stödtabell som innehåller de olika typer av krediter som kan registreras. Innehåller Annuitetslån och Lån med rak amortering. Finns inget gränssnitt för uppdatering. Vid beräkning av krediter används BossID Stödtabell som innehåller alla Län och dess länskod. Finns inget gränssnitt för uppdatering. Används vid inläsning av Lkf-filen, då denna inte innehåller benämningar på län, utan bara länskod. Stödtabell som innehåller de län, kommuner och församlingar som finns i Sverige samt aktuella skattesatser för dessa. Tabellen fylls på och uppdateras med inläsning av en fil från Skatteverket. Stödtabell som innehåller normalbelopp för ensamstående vuxen, sambos samt heltids- eller deltidsboende barn över och under 6 år. Används vid beräkning av betalningsutrymme. Stödtabell som innehåller avslutsorsaker för ärenden. Stödtabell som innehåller gränsvärden och skattesats för beräkning av pensionsavgift. Används vid beräkning av preliminärskatt Innehåller information som registrerats för den rådsökande. Stödtabell som innehåller referensränta.
Schablon SchablonMedlem SchablonProp SkattAvdrag Skuld SkuldSanering SkuldSanering2 SkuldSaneringBostadTyp SkuldSaneringOm SkuldTyp SkuldTyp2 StatligSkatt SystemParameter Används vid beräkning av räntekostnader för skulder Stödtabell som innehåller schablonbelopp per utgiftslag, kopplat till kön och ålder eller hushållets storlek. Innehåller information om schablonbelopp för aktuell hushållsmedlem ska omräknas enligt angiven procentandel. Innehåller information om manuellt angivna utgiftsbelopp ska skrivas över med schablonbeloppen. Stödtabell som innehåller gränsvärden för avdragsrätt för resor, övrigt och pensionsförsäkring. Används vid beräkning av preliminärskatt. Innehåller information om de skulder som finns registrerade kopplat till hushållsmedlem. Både FordringsAgareID och OmbudID går mot adressregistret, som innehåller både ombud och fordringsägare. Innehåller information som registrerats i Ansäkan om skuldsanering för ett ärende Innehåller ytterligare information som registrerats i Ansökan om skuldsanering för ett ärende Stödtabell som innehåller de olika bostadstyper som finns med i blanketten för ansökan om skuldsanering. Innehåller Hyr bostad, Bor i egen fastighet, Bor i egen bostadsrätt och Annat. Finns inget gränssnitt för uppdatering. Innehåller den information som registrerats i Omprövning av skuldsanering för ett ärende Stödtabell som innehåller de typer av skulder som KoV följer upp på. Stödtabell som innehåller de typer av skulder som lagts upp lokalt. Stödtabell som innehåller skiktvärden och skattesatser för beräkning av statlig skatt. Används vid beräkning av preliminärskatt Innehåller information om databasversion, om det är en KoV-installation och när senaste synkning skedde.
UtbildningTyp Utgift UtgiftPeriod UtgiftSlag Stödtabell som innehåller de olika typer av utbildning som finns med i blanketten för ansökan om skuldsanering. Innehåller Grundskola, Gymnasium, Högskola/universitet och Annat. Finns inget gränssnitt för uppdatering. Information om vilka utgifter som finns registrerade för en hushållsmedlem. Innehåller periodiseringar av utgifter om det finns angivna Stödtabell som innehåller de utgiftsslag som utgifter kan registreras för. Administreras dels av KoV och distribueras med synkningen och dels av kommunerna som kan registrera lokala utgiftsslag.