---
title: "Timesheets"
description: "Työaika ja laskutus. Jokainen sovellus on moduuli samalla tietomallilla."
canonical: "https://obop-platform.sliplane.app/fi/apps/timesheets/"
lang: "fi"
---

# Timesheets

## Mihin se on tarkoitettu

Record time spent on project tasks in minutes, mark it billable and run it through an approval step. Needs the Projects package.

## Mitä paketti tekee ja mitä ei

Time spent on project tasks, entered in minutes, with a billable flag and an approval step. Needs the Projects package.

## Mallit

### `timesheets_entry`

Time one person spent on one task on one day

Lukuryhmä: `timesheets.user`. Kirjoitusryhmä: `timesheets.user`.

| Kenttä | Tyyppi | Tietoluokka | Henkilötieto | Ryhmä | Agentit näkevät | Kuvaus |
|---|---|---|---|---|---|---|
| `task_id` | ref → projects_task | `none` | ei | `timesheets.user` | selkoisena | The task worked on |
| `worker` | text | `internal` | kyllä | `timesheets.user` | maskattu | Name of the person who did the work |
| `worked_on` | date | `none` | ei | `timesheets.user` | selkoisena | Day the work was done (YYYY-MM-DD) |
| `minutes` | number | `none` | ei | `timesheets.user` | selkoisena | Time spent, in minutes |
| `billable` | bool | `none` | ei | `timesheets.user` | selkoisena | Whether the time can be charged to the customer |
| `description` | text | `none` | ei | `timesheets.user` | selkoisena | What was done |
| `cost_rate` | money | `financial` | kyllä | `timesheets.cost_viewer` | pidätetty | Internal hourly cost of the worker at the time of entry (minor currency units, e.g. cents) |
| `state` | select (draft, submitted, approved) | `none` | ei | `timesheets.user` | selkoisena | Entry status: draft, submitted, approved |

## Työnkulut

### `timesheets_entry`

| Toiminto | Siirtää | Kuka voi suorittaa | Hyväksyntä |
|---|---|---|---|
| `timesheets_entry.submit` | state: draft → submitted | `timesheets.user` | ei |
| `timesheets_entry.approve` | state: submitted → approved | `timesheets.manager` | ei |
| `timesheets_entry.reject` | state: submitted → draft | `timesheets.manager` | ei |

## Käyttöoikeusryhmät

Tämän sovelluksen käyttämät ryhmät:

- `timesheets.cost_viewer`
- `timesheets.manager`
- `timesheets.user`

## Hyväksyntävaiheet

Mikään tämän sovelluksen vaihe ei vaadi hyväksyntää tietueiden poistamista lukuun ottamatta.

## Mitä agentit voivat ja eivät voi tehdä

Agentti voi lukea, hakea, luoda ja päivittää tämän sovelluksen tietueita sekä suorittaa toiminnot, jotka eivät vaadi hyväksyntää, tunnisteensa käyttöoikeusryhmien rajoissa.

Se voi vain ehdottaa näitä vaiheita, ja ihmisen on hyväksyttävä ne: `timesheets_entry.delete`.

Henkilötiedot maskataan paikkamerkeiksi: `timesheets_entry.worker`.

Nämä kentät pidätetään agenteilta kokonaan: `timesheets_entry.cost_rate`.

## Riippuvuudet

- `projects`

## Asennus

Asenna se Customize-sovelluksesta (Marketplace) tai komentoriviltä:

```bash
obop modules install-from timesheets
```

Vaatii tietokannan ja ylläpitäjän oikeudet.

## Tee oma

[Moduulioppaassa näytetään, miten tällaiset sovellukset kirjoitetaan](/fi/docs/reference/module-manifest/)