Søknadsosialhjelp

Frontend for søknad om sosialhjelp.

Kjøring lokalt mot lokal utviklingsbackend

Miljøvariabler

NEXT_PUBLIC_DIGISOS_ENV="localhost"

Miljøvariabelen NEXT_PUBLIC_DIGISOS_ENV velger konfigurasjonsprofiler.

Gyldige profiler er "localhost" til lokal utvikling, "mock" til mock-ekstern, "dev-sbs" til dev og "prod-sbs" til prod.

Konfigurasjonsprofiler og feature-toggles utledes fra disse modi i src/lib/config.ts.

Bakenforliggende tjenester

Eksempel ihht «Oppsett av lokalt utviklingsmiljø» i digisos-repoet:

cd ../digisos-docker-compose
docker-compose up \
                  sosialhjelp-mock-alt \
                  sosialhjelp-mock-alt-api \
                  sosialhjelp-soknad-api

Github package registry

Vi bruker Github sitt package registry for npm pakker, siden flere av Nav sine pakker kun blir publisert her.

For å kunne kjøre npm install lokalt må du logge inn mot Github package registry:

• Lag/forny access token med repo og read:packages rettigheter i github ( under developer settings). husk enable sso
• Login på npm med npm login --auth-type=legacy --scope=@navikt --registry=https://npm.pkg.github.com og benytt github brukernavn, epost og tokenet du nettopp genererte

Frontend

npm --include=dev install # Hent avhengigheter
npm run fetch-api # Hent OpenAPI definition for soknad-api fra mock-miljø og lagrer i soknad-api.json
npm run orval # Genererer API-kode
npm run dev # Bygger less og starter dev-server
npm test # Kjør enhetstestene

Oppgradering av avhengigheter

En snarvei for oppgradering av avhengigheter er:

npm run checkUpdates

Eventuelle unntak (f. eks. når man er låst til en tidligere major) kan konfigureres i .ncurc.js.

Bygg og deploy

Image bygges vha Github Actions,

• dev: https://github.com/navikt/sosialhjelp-soknad/actions/workflows/build.yml
• prod: https://github.com/navikt/sosialhjelp-soknad/actions/workflows/build_prod_image.yml

Siden appen ikke kjører på nais lengre, se ikke-nais deploy for informasjon om deploy.

Manuell deploy til dev (NB: gjelder kun dev-gcp)

Deploy til dev-gcp gjøres via Github Actions, se: https://github.com/navikt/sosialhjelp-soknad/actions/workflows/deploy_dev.yml

Logge inn i dev-gcp med mock-alt

Da må appen gå via proxy. Url er https://digisos.ekstern.dev.nav.no/sosialhjelp/soknad

Henvendelser

Spørsmål knyttet til koden eller prosjektet kan rettes mot:

• https://github.com/orgs/navikt/teams/digisos

For Nav-ansatte

Interne henvendelser kan sendes via Slack i kanalen #team_digisos.

Hvordan komme i gang

Felles dokumentasjon for våre frontend apper

Kodestil

Dette prosjektet bruker formatering av kode med prettier. Det er lagt inn automatisk formatering av kode med en pre-commit hook. Detaljer rundt dette ligger i package.json. Konfigurasjon av prettier ligger i .prettierrc.mjs.

Dersom du i tillegg ønsker å sette opp formatering av kode i IntelliJ slik at koden blir formatert før du committer kan det gjøres slik:

• Installer Prettier plugin i IntelliJ
• Trykk ⌥⇧⌘P for å formatere kode
• Optional: Sette opp filewatcher og automatisk formatering. Se her https://prettier.io/docs/en/webstorm.html#running-prettier-on-save-using-file-watcher