Arbeidspuls

Les denne README-en på norsk

Arbeidspuls is a lightweight, privacy-friendly web app for self-reporting work ability, function, energy, symptoms and strain over time.

It is designed for practical situations where a person needs to document actual function in a work setting, such as work trials, gradual return-to-work processes, long-term illness, fatigue or other conditions that affect short-term and long-term capacity.

Arbeidspuls is quick to use from a phone, while still giving advisors a structured way to review trends, report details, follow-ups and notes.

Arbeidspuls is a tool for structured self-reporting and review. It does not replace medical assessment, occupational health evaluation or formal decisions.

---

Why host Arbeidspuls?

Arbeidspuls is suitable for organizations or professionals who need a simple, low-friction way to collect work-function self-reports without operating a heavy case management system or central database.

It is especially relevant for:

• work-fitness evaluations
• work trials
• gradual return-to-work processes
• documenting function, strain and recovery
• advisors, case workers or professionals reviewing reports
• environments where data minimization and local storage matter

Arbeidspuls is built as a static web app/PWA. It can normally be hosted as ordinary static files.

It normally does not require:

• a server database
• login
• a backend API
• a production Node process
• central storage of sensitive reports

The user owns their data locally in the browser and actively shares it by exporting a JSON file.

---

Key features

• quick self-reporting from a phone
• 1-5 scales for core function areas
• optional details for workplace, work time, task type, limitations and accommodations
• follow-up after a work session to capture delayed worsening/recovery
• overview with time-based trend graph
• local JSON import/export
• advisor view for reviewing exported reports
• advisor notes per user, report and follow-up
• fullscreen graph analysis for advisors
• local report integrity checks
• Norwegian and English user interface
• installable as a PWA/WebApp on phones and tablets

---

Screenshots

Screenshots are located in screenshots/. Please note that screenshots are only in Norwegian.

Register report

The user can save a report with only a few taps. Core fields use quick 1-5 choices, while optional details can be opened when needed.

Follow-up

Follow-up is used after a work session, for example later the same day, the next day or later. This is useful when symptoms or fatigue appear after a delay.

Overview and trend

The overview shows reports, follow-ups, total score, category scores and trend over time. The graph uses the actual time distance between reports.

Report details

The user can open a report to review details and optionally delete local reports.

Privacy and data management

The privacy page explains local storage, export/import, sharing with an advisor and deletion of local data.

Advisor review

The advisor view lets an advisor import JSON files from users, view reports, read details, add notes and compare development over time.

Fullscreen graph analysis

In advisor mode, the graph can be opened in fullscreen for more precise review, time filtering and inspection of individual data points.

---

For users

Open the service

Go to:

https://arbeidspuls.rolfsvaag.no

Arbeidspuls works on phones, tablets and desktop computers. It is phone-first, so reporting should be quick and low effort.

Install it as an app on a phone or tablet

Arbeidspuls can be installed as a PWA/WebApp.

On Android/Chrome:

1. open Arbeidspuls in Chrome
2. open the browser menu
3. choose Install app or Add to Home screen

On iPhone/iPad/Safari:

1. open Arbeidspuls in Safari
2. tap the share button
3. choose Add to Home Screen

After this, Arbeidspuls can be opened like a normal app from the home screen.

Save a report

Choose Register, fill in the core fields and press Save report.

The core fields are:

• current work ability
• energy level
• mental clarity / concentration
• symptom burden
• effort / strain
• whether you can continue, need a break, need an easier task or want to stop

Optional details can be used if you want to add more context, such as workplace, work time, physical/mental energy, task type, limitations, what helped and a short comment.

Save a follow-up

Choose Follow-up to record how you are doing after a work session.

This can be used to document:

• whether you are worse than before the work session
• delayed symptoms
• recovery
• a short comment

Follow-up is especially useful if the reaction comes after the work session itself.

View overview

Choose Overview to see previous reports, follow-ups and the trend graph.

The overview shows, among other things:

• total score
• work ability
• energy
• mental clarity
• symptoms
• strain
• follow-ups linked to reports

Export data to an advisor

If an advisor or another person needs to review your reports:

1. go to Privacy
2. choose Export JSON
3. send the JSON file to the advisor, for example by email or another agreed channel

The JSON file may contain sensitive health and function-related information. Only share it with people who should have access.

Import earlier data

If you have changed devices, changed browser or lost local data, you can import a previously exported JSON file from Privacy.

---

For advisors

Advisor mode is available at:

https://arbeidspuls.rolfsvaag.no/veileder

or:

https://arbeidspuls.rolfsvaag.no/evaluator

Import reports

1. Ask the user to export JSON from Privacy
2. Open advisor mode
3. Choose the JSON file
4. Give the user a name or internal identifier

The data is stored locally in the advisor's browser. Arbeidspuls does not send the reports to a central server.

Review reports

Advisors can:

• view a trend graph for the selected user
• filter by time period
• open fullscreen graph analysis
• read report details
• read follow-ups
• view total score and category scores
• write a general note for the user
• write notes per report
• write notes per follow-up
• export/import advisor backup

Score and function level

Arbeidspuls shows total score and category scores as internal function indicators.

Scores are intended for overview and trend support, not as a medical conclusion.

Advisor mode uses score bands such as:

• Exceptionally high function level
• Expected function level
• Moderately reduced function
• Significantly reduced function
• Very low function

75% roughly corresponds to an expected/good reported function level, while 100% corresponds to an exceptionally high function level.

Integrity checks

Reports may contain local integrity metadata. If a report is missing verification or appears to have been changed, a warning is shown in advisor mode.

This is a technical check. It is not a legal guarantee and does not prove the medical truth of a report.

---

Privacy and local storage

Arbeidspuls stores data locally in the browser on the device being used.

This means:

• reports are not automatically sent to a server
• the standard app uses no central database
• data remains on the user's device/browser
• clearing browser data may delete reports
• changing device or browser requires export/import

The user must export JSON to share data with an advisor or move data to another device.

---

Technical overview

Arbeidspuls is a static React/Vite app with local browser storage.

Typical production build:

npm ci
npm run build

The contents of dist/ are then hosted as static files.

For an SPA, the web server should fall back to index.html, for example in Nginx:

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

Technology

• React
• TypeScript
• Vite
• PWA manifest
• service worker
• local browser storage
• JSON import/export
• local advisor view
• Norwegian/English UI

Production

Arbeidspuls normally only requires static hosting. Running a Node server in production is not required.

---

Development

Install dependencies:

npm ci

Run the development server:

npm run dev

Build production files:

npm run build

Run tests:

npm test

---

Important note

Arbeidspuls is a tool for structured self-reporting and review. It should not be used as the sole basis for medical, legal or employment-related decisions.

Total score and category scores are internal function indicators for overview and trends. They are not medically validated test results.

---

License

See LICENSE.