Arbeidspuls/README.md
2026-05-28 07:37:42 +00:00

9.3 KiB

Arbeidspuls

Read this README in English

Arbeidspuls er en lett, personvernvennlig webapp for egenrapportering av arbeidsevne, funksjon, energi, symptomer og belastning over tid.

Tjenesten er laget for praktiske situasjoner der en person skal dokumentere faktisk funksjon i en arbeidssituasjon, for eksempel ved arbeidsutprøving, gradvis tilbakeføring, langvarig sykdom, utmattelse eller andre forhold som påvirker kort- og langtidskapasitet.

Arbeidspuls er rask å bruke fra telefonen, men gir samtidig veiledere en ryddig måte å gjennomgå trender, rapportdetaljer, oppfølginger og notater på.

Arbeidspuls er et verktøy for strukturert egenrapportering og gjennomgang. Det erstatter ikke medisinsk vurdering, arbeidsmedisinsk utredning eller formelle vedtak.


Hvorfor hoste Arbeidspuls?

Arbeidspuls passer for aktører som ønsker en enkel og lavterskel løsning for arbeidsevnerelatert egenrapportering uten å måtte drifte et tungt fagsystem eller en sentral database.

Tjenesten er særlig relevant for:

  • arbeidsutprøving
  • oppfølging over tid
  • gradvis tilbakeføring til arbeid
  • dokumentasjon av funksjon, belastning og restitusjon
  • veiledere, rådgivere eller fagpersoner som skal gjennomgå rapporter
  • miljøer der dataminimering og lokal lagring er viktig

Arbeidspuls er bygget som en statisk webapp/PWA. Det betyr at den normalt kan hostes som vanlige statiske filer.

Den krever normalt ikke:

  • serverdatabase
  • innlogging
  • backend-API
  • Node-prosess i produksjon
  • sentral lagring av sensitive rapporter

Brukeren eier dataene sine lokalt i nettleseren og deler dem aktivt ved å eksportere en JSON-fil.


Hovedfunksjoner

  • rask egenrapportering fra telefon
  • 1-5-skalaer for sentrale funksjonsområder
  • valgfrie detaljer for arbeidssted, arbeidstid, oppgavetype, begrensninger og tilrettelegging
  • oppfølging etter arbeidsøkt for å fange forsinket forverring/restitusjon
  • oversikt med tidsbasert trendgraf
  • lokal import/eksport av JSON
  • veiledervisning for gjennomgang av eksporterte rapporter
  • veiledernotater per bruker, rapport og oppfølging
  • fullskjerm grafanalyse for veileder
  • lokal integritetskontroll av rapporter
  • norsk og engelsk brukergrensesnitt
  • kan installeres som PWA/WebApp på telefon og nettbrett

Skjermbilder

Skjermbildene ligger i screenshots/.

Registrer rapport

Registrer rapport

Brukeren kan registrere en rapport med få trykk. Hovedfeltene er raske 1-5-valg, mens valgfrie detaljer kan åpnes ved behov.

Oppfølging

Oppfølging

Oppfølging brukes etter en arbeidsøkt, for eksempel samme dag, dagen etter eller senere. Dette kan være nyttig når symptomer eller utmattelse kommer forsinket.

Oversikt og trend

Oversikt og trend

Oversikten viser rapporter, oppfølginger, totalscore, kategoriscore og trend over tid. Grafen bruker faktisk tidsavstand mellom rapporter.

Rapportdetaljer

Rapportdetaljer

Brukeren kan åpne en rapport for å se detaljer og eventuelt slette lokale rapporter.

Personvern og datahåndtering

Personvern og datahåndtering

Personvernsiden forklarer lokal lagring, eksport/import, deling med veileder og sletting av lokale data.

Veiledergjennomgang

Veiledergjennomgang

Veiledervisningen lar en veileder importere JSON-filer fra brukere, se rapporter, lese detaljer, legge inn egne notater og sammenligne utvikling over tid.

Fullskjerm grafanalyse

Fullskjerm grafanalyse

I veiledervisning kan grafen åpnes i fullskjerm for mer presis gjennomgang, tidsfiltrering og inspeksjon av konkrete datapunkter.


For brukere

Åpne tjenesten

Gå til:

https://arbeidspuls.rolfsvaag.no

Arbeidspuls fungerer på telefon, nettbrett og PC. Den er laget phone-first, slik at rapportering skal være raskt og lite belastende.

Installer som app på telefon eller nettbrett

Arbeidspuls kan installeres som en PWA/WebApp.

På Android/Chrome:

  1. åpne Arbeidspuls i Chrome
  2. trykk på menyen
  3. velg Installer app eller Legg til på startsiden

På iPhone/iPad/Safari:

  1. åpne Arbeidspuls i Safari
  2. trykk på delingsknappen
  3. velg Legg til på Hjem-skjerm

Etterpå kan Arbeidspuls åpnes som en vanlig app fra startskjermen.

Lagre en rapport

Velg Registrer, fyll ut hovedfeltene og trykk Lagre rapport.

Hovedfeltene er:

  • arbeidsevne akkurat nå
  • energinivå
  • mental klarhet / konsentrasjon
  • symptombelastning
  • anstrengelse / belastning
  • om du kan fortsette, trenger pause, trenger enklere oppgave eller ønsker å stoppe

Valgfrie detaljer kan brukes hvis du vil legge til mer kontekst, for eksempel arbeidssted, arbeidstid, fysisk/mental energi, oppgavetype, begrensninger, hva som hjalp og kort kommentar.

Lagre en oppfølging

Velg Oppfølging for å registrere hvordan du har det etter en arbeidsøkt.

Dette kan brukes for å dokumentere:

  • om du er verre enn før arbeidsøkten
  • forsinkede symptomer
  • restitusjon
  • kort kommentar

Oppfølging er særlig nyttig dersom reaksjonen kommer senere enn selve arbeidsøkten.

Se oversikt

Velg Oversikt for å se tidligere rapporter, oppfølginger og trendgraf.

Oversikten viser blant annet:

  • totalscore
  • arbeidsevne
  • energi
  • mental klarhet
  • symptomer
  • belastning
  • oppfølginger knyttet til rapporter

Eksporter data til veileder

Hvis en veileder eller annen person skal gjennomgå rapportene dine:

  1. gå til Personvern
  2. velg Eksporter JSON
  3. send JSON-filen til veilederen, for eksempel via e-post eller annen avtalt kanal

JSON-filen kan inneholde sensitive helse- og funksjonsrelaterte opplysninger. Del den bare med personer som faktisk skal ha tilgang.

Importer tidligere data

Hvis du har byttet enhet, byttet nettleser eller mistet lokale data, kan du importere en tidligere eksportert JSON-fil via Personvern.


For veiledere

Veiledervisningen finnes på:

https://arbeidspuls.rolfsvaag.no/veileder

eller:

https://arbeidspuls.rolfsvaag.no/evaluator

Importere rapporter

  1. Be brukeren eksportere JSON fra Personvern
  2. Åpne veiledervisningen
  3. Velg JSON-filen
  4. Gi brukeren et navn eller en intern identifikator

Dataene lagres lokalt i veilederens nettleser. Arbeidspuls sender ikke rapportene til en sentral server.

Gjennomgå rapporter

Veileder kan:

  • se trendgraf for valgt bruker
  • filtrere på tidsperiode
  • åpne fullskjerm grafanalyse
  • lese rapportdetaljer
  • lese oppfølginger
  • se totalscore og kategoriscore
  • skrive generelt notat for bruker
  • skrive notat per rapport
  • skrive notat per oppfølging
  • eksportere/importere veilederbackup

Score og funksjonsnivå

Arbeidspuls viser totalscore og kategoriscore som interne funksjonsindikatorer.

Score er ment for oversikt og trend, ikke som medisinsk fasit.

I veiledervisning brukes scoreband som:

  • Særdeles høyt funksjonsnivå
  • Forventet funksjonsnivå
  • Moderat redusert funksjon
  • Betydelig redusert funksjon
  • Svært lav funksjon

75 % tilsvarer omtrent et forventet/godt rapportert funksjonsnivå, mens 100 % tilsvarer særdeles høyt funksjonsnivå.

Integritetskontroll

Rapporter kan inneholde lokal integritetsmetadata. Dersom en rapport mangler verifisering eller ser ut til å være endret, vises et varsel i veiledervisningen.

Dette er en teknisk kontroll. Det er ikke en juridisk garanti og sier ikke noe om medisinsk sannhet i rapporten.


Personvern og lokal lagring

Arbeidspuls lagrer data lokalt i nettleseren på enheten som brukes.

Det betyr:

  • rapporter sendes ikke automatisk til en server
  • standardappen bruker ingen sentral database
  • data blir liggende på brukerens enhet/nettleser
  • sletting av nettleserdata kan slette rapportene
  • bytte av enhet eller nettleser krever eksport/import

Brukeren må selv eksportere JSON dersom data skal deles med veileder eller tas med til en annen enhet.


Teknisk oversikt

Arbeidspuls er en statisk React/Vite-app med lokal nettleserlagring.

Typisk produksjonsbygg:

npm ci
npm run build

Innholdet i dist/ hostes deretter som statiske filer.

For en SPA bør webserveren ha fallback til index.html, for eksempel i Nginx:

location / {
    try_files $uri $uri/ /index.html;
}

Teknologi

  • React
  • TypeScript
  • Vite
  • PWA-manifest
  • service worker
  • lokal lagring i nettleser
  • JSON import/eksport
  • lokal veiledervisning
  • norsk/engelsk UI

Produksjon

Arbeidspuls krever normalt bare statisk hosting. Det er ikke nødvendig å kjøre en Node-server i produksjon.


Utvikling

Installer avhengigheter:

npm ci

Kjør utviklingsserver:

npm run dev

Bygg produksjonsfiler:

npm run build

Kjør tester:

npm test

Viktig presisering

Arbeidspuls er et hjelpemiddel for strukturert egenrapportering og gjennomgang. Tjenesten skal ikke brukes som eneste grunnlag for medisinske, juridiske eller arbeidsrettslige beslutninger.

Totalscore og kategoriscore er interne funksjonsindikatorer for oversikt og trend. De er ikke medisinsk validerte testresultater.


Lisens

Se LICENSE.