Personopplysninger

|

React applikasjon som skal gi brukeren innsikt i informasjonen Nav har lagret.

Komme i gang

Hent repoet fra github

git clone https://github.com/navikt/personopplysninger.git

Installer nødvendige pakker:

npm install

Kopier environment-variabler fra eksempel-filen:

'' cp .env.sample .env ''

Start dekoratøren og mocks: Autentiser på Github container-registry hvis du ikke har gjort det allerede (Merk: --password-stdin hindrer at access token havner i diverse logger):

echo DIN_GITHUB_ACCESS_TOKEN | docker login docker.pkg.github.com -u DITT_GITHUB_BRUKERNAVN --password-stdin

Start dekoratøren og mocks:

docker-compose up -d

Start applikasjonen lokalt:

npm start

Mock-serveren

Ved enkelte post-kall vil mock-serveren alltid returnere en feilet case. Se feks /clients/apiMock/app/post/endre-kontonr.json. For å teste andre TPS-svar, endre denne json tilsvarende.

Tester

Tester ligger under /src/__tests__. Disse kan kjøres med kommandoen npm test.

Snapshot-tester

En del av testene er snapshot-tester. Hensikten med disse testene er å avdekke utilsiktede endringer i UIet. En typisk snapshot test rendrer en komponent, tar et snapshot og sammenligner dette med en referanse-snapshot som er lagret i repoet. Testen vil feile dersom de to snapshotene ikke er like. Man kan oppdatere snapshotet i repoet ved å kjøre kommandoen npm test -- -u.

Deployering

Merk: Bruk develop-branchen når vi deployer til dev.

Dev

1. Opprett en PR mot develop. Sett den gjerne til DRAFT hvis du vil signalisere at den ikke er klar for test.
2. Besøk https://github.com/navikt/personopplysninger/actions
3. Velg workflow Deploy-to-web, velg develop-branchen og deretter Run workflow.

eller

Benytt Github CLI for å deploye via kommandolinjen:

gh workflow run workflow_dispatch -b develop

Prod

• Lag en PR til main, og merge inn etter godkjenning (En automatisk release vil oppstå ved deploy til main)

Om semver

npm version patch vil bumpe versjon fra feks v1.1.1 til v1.1.2. Diskuter med teamet om versjonen er en minor eller kun en patch. Hvis minor bruker du npm version minor istedet. Du kan lese mer på semver.org

Logging

Feil ved API-kall blir logget via frontendlogger og vises i Kibana
https://logs.adeo.no

Henvendelser

Spørsmål knyttet til koden eller prosjektet kan rettes mot https://github.com/orgs/navikt/teams/min-side

For Nav internt

Interne henvendelser kan sendes via Slack i kanalen #team-minside.