Timesheets
Temps et facturation
À quoi elle sert
Record time spent on project tasks in minutes, mark it billable and run it through an approval step. Needs the Projects package.
Ce que fait et ne fait pas le paquet
Time spent on project tasks, entered in minutes, with a billable flag and an approval step. Needs the Projects package. A worker sees and edits only their own entries; timesheets.manager sees all.
Détails du module
- Version:
0.3.0 - Auteur: SpaceCorps
- Licence: AGPL-3.0-or-later
- Noyau requis:
^0.2(le noyau actuel est 0.2.0) - Maturité: Bêta
- Catégories: Services
Modèles
timesheets_entry
Time one person spent on one task on one day
Groupe de lecture: timesheets.user. Groupe d'écriture: timesheets.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
task_id | ref → projects_task | none | non | timesheets.user | en clair | The task worked on |
worker | text | internal | oui | timesheets.user | masqué | User name of the person who did the work; the person who creates the entry unless set otherwise |
worked_on | date | none | non | timesheets.user | en clair | Day the work was done (YYYY-MM-DD) |
minutes | number | none | non | timesheets.user | en clair | Time spent, in minutes |
billable | bool | none | non | timesheets.user | en clair | Whether the time can be charged to the customer |
description | text | none | non | timesheets.user | en clair | What was done |
cost_rate | money | financial | oui | timesheets.cost_viewer | non communiqué | Internal hourly cost of the worker at the time of entry (minor currency units, e.g. cents) |
state | select (draft, submitted, approved) | none | non | timesheets.user | en clair | Entry status: draft, submitted, approved |
Flux de travail
timesheets_entry
| Action | Transition | Qui peut l'exécuter | Approbation |
|---|---|---|---|
timesheets_entry.submit | state: draft → submitted | timesheets.user | non |
timesheets_entry.approve | state: submitted → approved | timesheets.manager | non |
timesheets_entry.reject | state: submitted → draft | timesheets.manager | non |
Groupes de permissions
Groupes utilisés par cette application :
timesheets.cost_viewertimesheets.managertimesheets.user
Étapes d'approbation
Aucune étape de cette application ne requiert d'approbation, hormis la suppression d'enregistrements.
Ce que les agents peuvent et ne peuvent pas faire
Un agent peut lire, rechercher, créer et modifier les enregistrements de cette application, et exécuter les actions qui ne requièrent pas d'approbation, dans les limites des groupes de permissions de son jeton.
Il ne peut que proposer ces étapes, qu'une personne doit approuver : timesheets_entry.delete.
Les données personnelles sont masquées sous forme de jetons de substitution : timesheets_entry.worker.
Ces champs ne sont pas communiqués aux agents : timesheets_entry.cost_rate.
Dépendances
Chaque dépendance indique les versions qu’elle accepte. Les applications intégrées suivent les versions du noyau : une exigence à leur égard est donc vérifiée par rapport à la version du noyau.
- Project:
>=0.3, <1
Installer cette application depuis la place de marché installe aussi les dépendances manquantes, dans un seul plan à confirmer une fois.
Installation
Installez-la depuis l'application Customize (Place de marché), ou en ligne de commande :
obop modules install-from timesheetsNécessite une base de données et des droits d'administrateur.
Créer la vôtre
Le guide des modules montre comment sont écrites les applications de ce type