1. Indholdsfortegnelse
2. Indledning
Front-end er opdelt i 2 dele. Facade og klient. Guide til klienten findes her: NADM - NAK (Web App) - Guide til udviklere
2.1. Formål og sammenhæng med andre dokumenter
Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af NADM-NAF Web Facade skal sættes op, kodens struktur, samt hvordan koden bygges, deployeres og testes.
Dette dokument er en del af den samlede dokumentation for NADM-NAF web facade.
Dokumentet er udformet, så det i videst muligt omfang opfylder sit formål uafhængigt af de øvrige dokumenter.
2.2. Forudsætninger
Krav til software:
Software |
Version |
---|---|
Java | 8 |
Docker Engine | 18.02.0+ |
Git | 2.30.0+ |
Maven | 3.5+ |
3. Udvikling
Kildekoden til NAF findes på https://git.nspop.dk/scm/com/nsp-administrationsfacade.git og checkes ud med:
git clone https://git.nspop.dk/scm/com/nsp-administrationsfacade.git
Følgende forhold gør sig gældende:
- Der udvikles på
develop
branch, features laves som feature branches på develop. - Under udvikling bygges og deployeres der ved hjælp af docker.
Før første deployment skal der oprettes to netværk, dette skal kun udføres første gang, eller hvis netværket er blevet fjernet:
docker network create nadm_net docker network create nsp_net
NAF til udviklings formål bygges og startes med:
mvn package docker-compose -f compose/development/docker-compose.yml build docker-compose -f compose/development/docker-compose.yml up
For at kunne logge ind via SEB integration i development skal man tilføje følgende til maskinens /etc/hosts
fil:
127.0.0.1 dev.nadm.dk
Denne fil ligger i roden af *nix filsystemet.
På Mac kan du eks få adgang via: sudo nano /etc/hosts
API'et kan efter opsætning f.eks. tilgås på følgende adresse:
https://dev.nadm.dk:8080/nadm/api/person/1111111111
Certifikatet, der anvendes under udvikling er udsted automatisk af Caddy, som indgår i docker compose setup'et. Dette skal accepteres af browseren.
Herefter kan guide til klienten findes her: NADM - NAK (Web App) - Guide til udviklere
3.1. Mocking
Det kan være praktisk at mocke diverse backends, da man derved kan starte NAK op og se NADM i funktion, uden videre setup.
I filen naf.properties kan følgende linjer indsættes:
backend.security.mock=true # Mock som indeholder hardcoded liste af roller backend.sces.mock=true backend.consent.mock=true backend.organdonor.mock=true backend.treatmentwill.mock=true backend.donotresuscitate.mock=true