dp-saksbehandling-frontend - Saksbehandlingsflate for Dagpenger

Komme i gang

Appen er basert på Remix

npm install
cp .env.example .env
npm run generate-token
npm run dev

Kjøre mot dev-APIer i localhost

Vi trenger access_token for å kunne kjøre requester mot backend endepunkter. Vi må ha et token per tjeneste og Env-variabelen USE_MSW="false" må også være satt.

For å generere nye tokens, kjør:

npm run generate-token

Følg instruksjoner scriptet gir. Scriptet vil oppdaterer nødvendige tokens og .env filen vil se f.eks slik ut.

USE_MSW="false"
DP_SAKSBEHANDLING_TOKEN="annenLangStrengHerFraAccess_token"
DP_BEHANDLING_TOKEN="enTredjeLangStrengHerFraAccess_token"

Disse tokenene vil vare i en time før du må generere et nytt token.

Manuelt oppdatering av lokalt Azure tokens

Logg på med en testbruker. Hent ut verdien fra access_token, rediger .env og endre DP_SAKSBEHANDLING_TOKEN, DP_BEHANDLING_TOKEN til det matchende genererte tokenet.

dp-saksbehandling, dp-behandling,

Tester

Vi har to testrammeverk som vi brukes til ulike formål.

Vitest

Vitest brukes til unit testing av eksempelvis komponenter, loaders og actions.

// Kjør testene som vanlig
npm run test

// Generer test coverage
npm run test-coverage

// Kjør testene med watch
npm run test -- --watch

Playwright

Playwright brukes til e2e (ende til ende) testing, og er et veldig fint verktøy for å teste flyt og samspillet mellom de ulike delene av løsningen.

//Hvis du ikke har playwright fra før
npx install playwright

// Kjør vanlig playwright i kommandolinjen
npm run playwright

// Kjør med UI inkludert
npm run playwright:ui

Vanlige problemer med oppsett

Hvis du ikke lager .env og kopierer innholdet fra .env.example får du sannsynligvis få denne feilmeldingen:

TypeError: Invalid URL
    at new NodeError (node:internal/errors:393:5)
    at URL.onParseError (node:internal/url:565:9)
    at new URL (node:internal/url:645:5)
    [...]

Ikke slett .env.example eller legg denne filen inn i .gitignore da det er nødvendig for oppsettet av løsningen.

Henvendelser

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

• André Roaldseth, [email protected]

For NAV-ansatte

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

Vanlig oppstart av prosjektet (når alt er satt opp)

1. Start opp Naisdevice (den må bli grønn)
2. $ git pull
3. $ nvm use
4. $ npm install
5. $ npm run generate-token
6. $ npm run dev
7. Gå til http://localhost:3000/saksbehandling
8. Ferdig!

Potensielle errorer

Feil node versjon

npm ERR! engine Unsupported engine
npm ERR! engine Not compatible with your version of node/npm: [email protected]
npm ERR! notsup Not compatible with your version of node/npm: [email protected]
npm ERR! notsup Required: {"node":"^14.18.0 || ^16.14.0 || >=18.0.0"}
npm ERR! notsup Actual: {"npm":"9.6.3","node":"v16.13.0"}

npm ERR! A complete log of this run can be found in: /Use

Kjør $ nvm use og det burde løse problemet.

Manglende autentisering ved installasjon av @navikt npm pakker

npm ERR! code E401
npm ERR! 401 Unauthorized - GET https://npm.pkg.github.com/download/@navikt/dp-auth/0.3.7/5c5965d82448aa24ef9c53430a745429555e153f - unauthenticated: User cannot be authenticated with the token provided.

npm ERR! A complete log of this run can be found in: /Users/<user>/.npm/\_logs/2023-09-05T08_44_38_897Z-debug-0.log

Github token er utdatert.

1. Gå til Github
2. Trykk Profil ikon
3. Trykk Settings
4. Trykk Developer settings
5. Trykk Personal access token
6. Trykk Tokens (classic)
7. Trykk Generate new token --> Generate new token (classic)
8. Skriv noe som NAV IT under Note
9. Velg hvor lenge du vil at det skal vare under Expiration
10. Under Select scope velg repo og read:packages
11. Trykk Generate token
12. Kopier ghp_x... tokenet og putt det i .npmrc filen på maskinen din
13. Trykk Configure SSO
14. Trykk Authorize på navikt
15. Ferdig!