Indholdsfortegnelse
Introduktion
Formål
Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af DPA, 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 DPA.
Dokumentets relation til de øvrige dokumenter er beskrevet i dokumentationsoversigten for DPA.
Læsevejledning
Læser forventes at have kendskab til ....
Introduktion til DPA
DPA Snitfladen er defineret i en ...
DPA 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
DPA 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 DPA, hvilket gøres ved at køre kommandoen
|
Efter byg kan WAR filer findes her:
|
Afvikling
Efter byg kan DPA afvikles vha. .... Til dette formål findes ....
For at starte DPA 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 DPA 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. DPA 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 |