Indholdsfortegnelse
Introduktion
Formål
Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af MHD, kan sættes op, samt hvordan koden bygges, deployes og testes.
Først beskrives de softwaremæssige krav, der er til miljøet, samt hvordan kode hentes og bygges. Dernæst beskrives deployment-miljøet.
Kodestrukturen, kodemæssige afhængigheder til tredjeparts moduler og de forskellige servicemodulers ansvar og design beskrives sidst i dette dokument sammen med testdesign.
Sammenhæng med øvrige dokumenter
Dette dokument er en del af den samlede dokumentation for MHD.
Dokumentets relation til de øvrige dokumenter er beskrevet i dokumentationsoversigten for MHD.
Læsevejledning
Læser forventes at have kendskab til ....
Introduktion til MHD
MHD Snitfladen er defineret i en ...
MHD er Java baserede komponenter, der baserer sig på Java 21 og ??? frameworket.
Design og arkitektur er beskrevet: ....
Opsætning af udviklingsmiljø
I det følgende antages at koden er hentet fra git: https://git.nspop.dk/scm/bff/min-graviditet-backend-for-frontend.git
Krav til software
MHD deployeres vha. ...
Derudover er der krav til de anvendte udviklingsværktøjer:
- Maven ??? eller højere anvendes.
Bygge komponeten
Man skal bruge Maven til at bygge MHD, hvilket gøres ved at køre kommandoen
|
Efter byg kan WAR filer findes her:
|
Afvikling
Efter byg kan MHD afvikles vha. .... Til dette formål findes ....
For at starte MHD afvikles følgende kommando:
Udviklers workstation
Når man udvikler kan det være praktisk at foretage lokal deployment.
Dette kan gøres vha. ....:
Når MHD er startet, svarer den på:
- Services: Se ...
Beskrivelse af systemdesign
Systemdesign er beskrevet i MHD - Design- og arkitekturbeskrivelse.
Beskrivelse af kildekodens strukturering og design
Kode strukturering
Kildekoden bygges vha Maven, og kildekoden er struktureret som Maven moduler. MHD består af følgende moduler:
Beskrivelse af testsetup
Unittests
??? anvendes til implementering af unit tests. Der er kontinuert gennemført unit tests på alle komponenter i projektet.
Unit tests afvikling under byg vha ??? plugin for Maven, men kan separat afvikles ved at køre:
|
Hvis der derimod laves en verify, så vil der også blive genereret code coverage, hvor fremkommende rapport kan ses i testreport/target/site/jacoco-aggregate/index.html
Integrationstests
Integrationstests ligger i modulet ??? og kan afvikles med:
|
Dette forudsætter at alle services er startet som angivet i ??? setuppet
Hvis man ønsker af afvikle testen op mod en andet miljø f.eks. test1 eller test2 henvises til MHD - Testvejledning.
Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |