Speil

Saksbehandlerverktøy for sykepenger.

Kodeformatering

Dette repoet bruker prettier med eslint-config-prettier for å sikre at all koden er på likt format. Hvordan utviklerne velger å overholde disse reglene er opp til den enkelte, men Prettier kan settes opp til å formatere kode automatisk on-save. Hvordan dette konfigureres avhenger av IDE / Editor.

Gi tilgang til Speil i dev (aka preprod) via AD:

Vedkommende som ønsker tilgang må:

• Være medlem av minst en av gruppene som er spesifisert under spec.azure.application.claims.groups

Forutsetninger

Sett opp tilgang til Github Package Registry

For å kunne laste dependencies fra Github Package Registry må du ha et Github Personal Access satt i miljøvariabelen NPM_AUTH_TOKEN.

Dette tokenet trenger scopet read:packages. Husk å trykke Configure SSO for navikt.

Legg til følgende i ~/.bashrc eller ~/.zshrc:

export NPM_AUTH_TOKEN=<token>

Utvikle lokalt

1. Sørg for at du har riktig versjon av node (se package.json), f.eks. med nvm eller mise.
2. Installer prosjektet - pnpm install
3. Kjør Speil lokalt med next dev server - pnpm run dev

Default i lokal utvikling er at Apollo går mot spesialist-mock på /api/spesialist.

Kjør precommit hooks manuelt - .husky/pre-commit

Legge til en testperson lokalt:

1. Kjør pnpm run import-testperson og følg instruksjonene

Bygge for produksjon lokalt

Dersom du vil teste produksjonsbygget lokalt, må du først flytte over tilhørende miljøvariabler til .env.production i root.

cp envs/.env.dev .env.production

eller

cp envs/.env.production .env.production

Deretter kan nextjs produksjonsbygg kjøres med:

pnpm run build

Hente og oppdaterte GraphQL-typer

Schema hentes fra spesialist på lokal maskin. Før man kjører skriptet for å generere GraphQL-typer, må man starte spesialist på lokal maskin (se etter fila LocalApp.kt). generate-graphql henter først et token fra spesialist og gjør deretter et autentisert introspection-kall.

For å generere DocumentNodes som brukes i apollo queries og mutations må man først skrive en GraphQL spørring i GraphQL mappen.

Kommando for å oppdatere GraphQL-typer:

pnpm run generate-graphql

Oppdatere REST-typer og genererte Tanstack Query-hooks

OpenAPI-spec hentes fra spesialist på lokal maskin. Først må man starte spesialist på lokal maskin (se etter fila LocalApp.kt). OpenAPI-spec'en når man kjører lokalt krever ikke autentisering.

Kjør så kommandoen:

pnpm run generate-rest

Henvendelser

Spørsmål knyttet til koden eller prosjektet kan stilles som issues her på GitHub.

Interne henvendelser kan sendes via Slack i kanalen #team-bømlo-værsågod.