Timeføring
This content is not available in your language yet.
Hours are the inventory of tjenesteytende SMB-er. The minimal honest core (#38): integer minutes, a month lock that turns hours into evidence, and a fakturagrunnlag that bills through the ordinary invoice path.
Guarantees
Section titled “Guarantees”- Minutes are integers (1..=1440 per entry) — no floats, same discipline as øre. Displayed hours are presentation.
- Editable until locked or billed, then immutable — enforced in the
database. Entries are working data (edit/delete freely, own
entries;
TIMER_SKRIV_ALLEcorrects anyone’s) until either:- the month lock passes them:
timesheet_lockis an insert-only history exactly like period_lock (newest row wins, reopening is an audited insert), and a trigger rejects insert/update/delete of entries dated on or before the lock — independently of the API; or - they are fakturert: the invoice link is one-way, and the same trigger rejects any later change. The only change allowed on a locked entry is the pure billing marker (lock hours for lønn, then bill them).
- the month lock passes them:
- Fakturagrunnlaget bills through the ordinary path: unbilled billable hours group per (prosjekt, timesats) into invoice lines — quantity in milli-hours (90 min → 1,5 t), the prosjekt dimension carried onto the revenue line (docs/dimensjoner.md) — issued via the normal atomic invoice transaction (gap-free number, KID, posting, stored PDF), with every entry marked fakturert in that same transaction. Nothing is ever billed twice.
- Prosjekt references must be active dimensions (avsluttet rejects, as everywhere).
- The project owns the billing rules (migration 0052).
fakturerbar_defaultsits on the prosjekt; the RATE lives inprosjekt_sats— dated, insert-only rows in the satsregister pattern (per prosjekt,person_idfor a person’s own rate, null for the project default). An entry resolves its rate on ITS date: the owner’s personal rate first, the project default second — and a caller withoutTIMER_SATS_SKRIVgets the register’s rate no matter what the request says. An explicit rate is honored only with the right. Billable hours with no rate anywhere fail loudly — a silent 0 would flow into an invoice. Recorded hours keep the rate they were logged at (time_entry.timesats_oreis evidence, never re-priced).
Web API (the rettigheter decide — docs/auth.md)
Section titled “Web API (the rettigheter decide — docs/auth.md)”| Endpoint | Purpose | Rettighet |
|---|---|---|
GET /companies/{id}/timesheet?from=&to= |
entries in range + lock status | TIMER_LES_EGNE — own rows only unless TIMER_LES_ALLE |
POST /companies/{id}/timesheet |
record (dato, minutter, beskrivelse?, prosjekt?, fakturerbar? — absent = project default, timesats_ore? — honored only with the right) | TIMER_SKRIV_EGNE (+TIMER_SATS_SKRIV for an explicit rate) |
PUT/DELETE …/timesheet/{eid} |
correct/remove an entry | TIMER_SKRIV_EGNE (own) / TIMER_SKRIV_ALLE (anyone’s) |
GET/POST …/dimensions/prosjekt/{code}/satser |
the dated rate history / set a rate (person_id? = null for the project default) | TIMER_SATS_SKRIV |
GET …/timesheet/summary?from=&to= |
per-prosjekt totals + unbilled value | TIMER_RAPPORT_LES |
GET …/timesheet/unbilled |
fakturagrunnlaget, grouped, w/ per-person breakdown | TIMER_RAPPORT_LES |
POST …/timesheet/invoice |
bill (party_no; optional prosjekt/through/entry_ids/vat_code/dates) | TIMER_FAKTURER |
GET/PUT …/timesheet/lock |
månedslås (insert-only history) | TIMER_LES_EGNE / TIMER_LAAS |
An ansatt therefore sees only their own hours; TIMER_LES_ALLE
(bokforing, revisor, admin — hours are billing evidence, the audit
reads everyone’s like lønn) unlocks the whole team. The _ALLE →
_EGNE implication holds for company-defined roles too — it is a
property of the rettighet, not of the role kind.
Billing lives under Faktura in the portal (user decision
2026-08-04): everything fakturerbart is gathered where the person
responsible for invoicing works. The grunnlag card (per-person lines,
checkboxes, «Fakturer valgte») sits in the Faktura section, and «Ny
faktura» can take a selection of unbilled hours onto an ordinary
invoice — ONE invoice carrying product lines AND hour lines
(timer_entry_ids on POST …/invoices, requires TIMER_FAKTURER on
top of FAKTURA_SKRIV; the entries are marked fakturert in the same
transaction as the invoice, docs/faktura.md). The Timer section keeps
the per-prosjekt totals and points at Faktura.
Unbilled groups carry the project’s kunde when the dimension is
linked (#80, docs/dimensjoner.md) — a suggested recipient, never
automation: billing still takes an explicit party_no from the caller.
Each group also names whose hours it holds (per-person minutter +
entry ids), and entry_ids on the invoice call bills exactly that
selection: every chosen id must still be billable and unbilled (a stale
selection fails whole, never silently bills less), and the entries are
marked fakturert in the invoice transaction itself — selection and
lock are one step, there is never a chosen-but-editable window. For
approval AHEAD of billing, the månedslås is the tool: lock the month,
then bill (billing locked hours is the one allowed change).
Portal: the Timer section opens with ukegridet — rows are
prosjekter, columns are the days, a cell is that day’s hours. The
heading names the week («Uke 46 · 9.–15. november 2026») with
«Forrige uke» / «Denne uken» / «Neste uke»; the week lives in the
address (?uke=), and «today» is the LOCAL date, so the page opens on
the right week also between midnight and 01:00. Cells save themselves
on blur through the ordinary entry endpoints (flexible input: 7,5 /
7.5 / 7:30, at most 24 t), Enter and arrow keys move like a
spreadsheet and skip locked and billed cells. An arrow key past Sunday
(or before Monday) carries on into the next (previous) week, in the
same project row — added to that week if it has no hours there yet —
and saves the cell it leaves first; it stops at a week that is locked
all through. Page Down / Page Up change week, from a cell (keeping row
and day) or from anywhere on the page. Rows pre-populate from last week’s projects and «Kopier
forrige uke» fills an empty week; locked days render disabled, billed
cells show their faktura. Every cell carries a spoken name (project,
day, and what the styling says: locked, several lines, has a
description). Beskrivelse/fakturerbar/sats per line live in the panel
under the grid for the selected cell, and each field saves when you
leave it, like the cells — there is no «Lagre» to forget. The sats
field renders only with TIMER_SATS_SKRIV; everyone else sees the
register’s rate as text. Clearing a cell that holds a description, or
deleting a line, asks first. On small screens the grid collapses to a
one-day view with day buttons that show each day’s hours.
Two ordering rules keep the grid honest. Only the NEWEST load may replace what is on screen — an older answer landing late would put one week’s hours under another week’s heading — and while a new week loads, the old one stays visible, dimmed. Saves are queued per cell: a second edit of the same cell waits for the first save and the reload after it, so it updates the line the first one created instead of creating a second. After a save only the week and its summary are re-read; last week and the project register cannot change from a cell edit. Below: per-prosjekt totals, with billing itself under Faktura (see above). Project-shaped cards link to the Prosjekter section, and with an empty registry the project picker says so rather than disappearing (docs/dimensjoner.md).
Deliberately not (yet)
Section titled “Deliberately not (yet)”- Bemanningsplanlegging and attestering-flyt — the lock covers the integrity need first (the issue’s own scoping).
- Multi-currency rates — satsene er i NOK (timelinjer avvises på valutafaktura).
- Per-project access (a “prosjektleder” who may only see/bill ONE
project’s hours): rights are company-scoped; a custom role holding
TIMER_LES_ALLE+TIMER_FAKTURERcovers the person, not the project boundary. If a real need arrives it is a new scoping on the rettighet model, not a bundle tweak.
Where it is tested
Section titled “Where it is tested”regnmed-api/tests/grupper/timesheet.rs(real Postgres, also CI) — record/ edit/delete over HTTP, validation (sats required when fakturerbar, unknown/avsluttet prosjekt), week view and summary sums, the month lock rejecting changes at BOTH the API and the trigger layer, billing locked hours into an invoice whose revenue entry carries the prosjekt dimension (chain verifies), fakturerte timer immutable and never rebilled, invoice link visible in the week view. The rights test (timer_rights_mean_what_they_say, seen failing before the guards landed) pins visibility (egne vsTIMER_LES_ALLE), correction via a custom role holdingTIMER_SKRIV_ALLE, andTIMER_FAKTURERon billing. Selective billing (a_selection_of_the_basis_bills_and_locks_exactly_itself) pins the per-person grunnlag, billing one person’s hours while the rest stay unbilled, the DB lock on the selection, and that a stale selection fails whole. The rate model (the_project_owns_the_rate_and_the_default, guards seen failing when sabotaged) pins the resolution order, the ignored client rate, the honored override, and the loud failure without a rate; the combined path (an_invoice_carries_products_and_selected_hours) pins products+hours on one invoice, the TIMER_FAKTURER guard, the lock and the emptied grunnlag.