Personnummerkontrollapplikation

En enkel C#-konsolapplikation för att verifiera giltigheten av svenska personnummer och hämta kön.

Lokal körning och testning

Steg 1: Installera .NET Core

Besök dotnet-webbplatsen och hämta och installera den senaste versionen av .NET Core passande för ditt operativsystem.

Steg 2: Klona projektet

git clone https://github.com/AxelLofberg/gruppuppgiftCI_CD.git
cd gruppuppgiftCI_CD

Kör personnummerkontrollapplikationen

För att köra personnummerkontrollapplikationen, följ dessa steg:

1. Öppna terminalen och navigera till projektets rotmapp:

   cd gruppuppgiftCI_CD

2. Kör applikationen med följande kommando:

   dotnet run

Kör enhetstester

För att köra enhetstester, använd följande steg:

1. Öppna terminalen och navigera till testmappens rotmapp:

   cd gruppuppgiftCI_CD.Tests

2. Kör enhetstesterna med följande kommando:

   dotnet test

Docker

För att köra personnummerkontrollapplikationen i en Docker-container, följ dessa steg:

1. Installera Docker:

   Besök Docker-webbplatsen och ladda ner Docker Desktop.

2. Bygg Docker-image:

   cd gruppuppgiftCI_CD
   docker build -t gruppuppgift-ci_cd .

3. Kör Docker-container:

   docker run -it gruppuppgift-ci_cd

Om du redan har en Docker Hub-repositorium:

Om du redan har publicerat ditt Docker-image på Docker Hub,kommandon:

docker pull axellofberg/gruppuppgift-ci_cd
docker run -it axellofberg/gruppuppgift-ci_cd

Information om svenskt personnummer

Detta projekt ger information om formatet för svenskt personnummer och hur man identifierar kön baserat på den personliga koden.

Format

Formatet för svenskt personnummer är ÅÅMMDD-XXXX, där:

• ÅÅ representerar de två sista siffrorna i födelseåret.
• MM representerar månaden.
• DD representerar dagen.
• XXXX representerar den fyrsiffriga personliga koden.

Det sista tecknet kan vara antingen en kontrollsiffra eller "-".

Identifiering av kön

För att avgöra kön kan du titta på den näst sista siffran i den personliga koden (XXXX). Jämna siffror representerar kvinnor, medan udda siffror representerar män.

Exempel

• 1234: Kvinna
• 5679: Man

Personnummer projekt Github/Docker

Vi inledde projektet genom att skapa ett repository på GitHub som alla medlemmar i gruppen klonade. Därefter använde vi terminalen eller bash för att navigera till projektet, vilket genomfördes enligt nedan.

För personen som ska klona projektet: gå till projektet tryck på code och kopiera länken för att klona projektet gå till någon lämplig mapp via terminal skriv git clone och klistra in länken som du kopierade från github sedan skriver du git pull (för att uppdatera till senaste versionen)

git checkout main → så att vi vet att vi är på mainbranchen (huvudgrenen)

git pull → dra ner alla uppdateringar, nu har projektet uppdaterats enligt github

git checkout -b “branch_namn” → namnge din branch/gren (används om flera jobbar på samma kod/projekt)

När alla hade anslutit sig till projektet skapade varje gruppmedlem en egen gren (branch) för att kunna arbeta separat och parallellt. Eftersom projektet var kopplat till GitHub kunde vi enkelt övervaka testerna som kördes och aktiviteten i projektet. Vi använde terminalen för att pusha koden som gjordes, sedan mergades detta via github.

Ett exempel på hur det kan se ut efter ändringar gjorts och ny kod ska pushas upp:

(skriv ny kod: git add . → git commit -m “new code” → git push origin “ny_branch_namn”

skapa pull request → merge pull request )

Enhetstesterna gjordes via ramverket xUnit. För att underlätta testning skapade vi en projektfil med XUnit-ramverket installerat. Detta gjordes för att kunna köra omfattande tester på vår kod. Själva koden låg i en fil, medan testkoden som kontrollerade inmatad information låg i en separat fil. Dessa tester automatiserades via Github actions, vilket gjorde att vår kod testades vart efter våra ändringar.

En dockerfile gjordes för att göra applikationen still en Docker-container. Github actions användes för att kunna skapa och köra en docker-container. För att skapa vår Docker-image integrerade vi GitHub-projektet med DockerHub. Därefter kopplade vi DockerHub till den lokala Docker-servern på våra datorer. Detta gjorde vi genom att dels använda terminalen för att integrera projektet med Dockern.

docker build -t anvandarnamn/personnummerkontroll docker pull anvandarnamn/personnummerkontroll docker run -it anvandarnamn/personnummerkontroll

Ramverk för svenskt personnummer De 2 första siffrorna anger vilket århundrade personen är född och de två följande siffrorna anger födelseår De två siffror som följer årtalet representerar månaden och de följande representerar kalenderdagen man är född

Dessa representerar alltså personens födelsedag.

Den tionde siffran är en kontrollsiffra för att kunna skilja på de personer som föddes samma dag. Elfte siffran för att verifiera giltigheten av personnumret Den tolfte för att identifiera kön på personen, jämn siffra = tjej och ojämn siffra=kille.

Applikationen Vår applikation funkar på så sätt att man startar den och anger ett personnummer på 12 siffror. Sedan skriver man dotnet run och därefter körs den och ger ett resultat om det är ett giltigt personnummer eller inte.