« TimeKeepR » : différence entre les versions

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
Aucun résumé des modifications
Liam (discussion | contributions)
Aucun résumé des modifications
 
(27 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
<languages/>
<translate>
<!--T:1-->
{| class="wikitable"  
{| class="wikitable"  
|- style="vertical-align:top;"  
|- style="vertical-align:top;"  
| [[File:TimeKeepR-250x250.png]]
| [[File:TimeKeepR-250x250.jpg]]


|TimeKeepR est un module Dolibarr permettant la saisie et le suivi des temps planifiés et réalisés sur des éléments autres que les tâches de projet, tout en conservant une logique de saisie homogène avec le standard Dolibarr.
<!--T:2-->
|TimeKeepR est un module permettant la saisie et le suivi des temps planifiés et réalisés sur des éléments autres que les tâches de projet, tout en conservant une logique de saisie homogène avec le standard Dolibarr.


<!--T:3-->
Ce module étend les capacités natives de gestion du temps sur les éléments suivant :
Ce module étend les capacités natives de gestion du temps sur les éléments suivant :
* Fiche d'intervention
* Fiche d'intervention
Ligne 12 : Ligne 17 :
* Equipement
* Equipement


Le but est de permettre une saisie de temps planifiées et réalisées uniforme afin d'offrir une vision mensuelle consolidée des temps
|}
<!--T:4-->
= Éléments compatibles =
{| class="wikitable"
|-
! Élément !! Onglet de saisie !! Rapport mensuel !! Saisie des temps à la volée
|-
| Fiche d'intervention || ✅ || ✅ || ✅
|-
| Ticket || ✅ || ✅ || ⛔
|-
| Ordre de Fabrication natif || ✅ || ✅ || ✅
|-
| [https://www.dolistore.com/product.php?id=2035&title=factory-la-gpao-avancee-pour-dolibarr&l= Factory (plugin)] || ✅ || ✅ || ✅
|-
| [https://www.dolistore.com/product.php?id=2216&title=equipement-tracabilite-et-serialisation-produits&l= Equipement (plugin)] || ✅ || ✅ || ✅
|}
|}


== Configuration ==
= Configuration du plugin TimeKeepR =
Dans le paramétrage du module vous aurez la possibilité de choisir plusieurs mode de fonctionnement :
Le plugin TimeKeepR s'active depuis la page de configuration des plugins de Dolibarr, et permet également la saisie des temps à la volé si la fonction activé.


{| class="wikitable"  
{| class="wikitable"  
|- style="vertical-align:top"  
|- style="vertical-align:top;"  
| width="300px" | [[File:ExtraExpense_parametrage.png |600px]]
| [[File:timekeepr settings 1.png|700px]]
|
| Activation de TimeKeepR depuis la page : '''Home -> Configuration -> Modules/Applications'''
* Désactiver : le module n'est pas actif, la gestion de la TVA des notes de frais fonctionne par défaut
|}
* Active - si sélection TVA à zéro : le module est active et permet de saisir le TTC et le HT si la TVA est à zéro
{| class="wikitable"  
* Active - TVA à zéro par défaut : idem que précédemment, mais le taux de TVA à zéro est présélectionné
|- style="vertical-align:top;"
* Active - sans saisie de la TVA : La sélection de la TVA est supprimée et l'on fonctionne en saisie de TTC et HT obligatoirement
| [[File:timekeepr settings 2.png|700px]]
 
| Activation de la fonction de saisie des temps à la volée.
'''Il est possible de configurer le temps d'arrêt après duquel la fonction de temps à la volée s'arrête :'''
* Aucun
* Heure
* Jour
* Semaine
* Mois
'''Règle d'arrêt au lancement :'''
* N'arrête rien
* Mise en pause
* Arrête le temps
|}
|}


== Utilisation & Fonctionnalités ==
<!--T:5-->
Lors de la création ou de l’édition d’une note de frais (via le formulaire de gestion des notes de frais), la '''gestion des taux de TVA''' est automatiquement prise en charge afin d’éviter toute erreur de calcul.
= Onglet de saisie des temps =
Sur chaque élément compatible, le module ajoute un onglet dédié permettant :
* La saisie des temps planifiés
* La saisie des temps réalisés
* La saisie des temps à la volée
* La consultation de l'historique des temps saisis


=== Fonctionnement de base ===
<!--T:6-->
'''Gestion du taux de TVA''' :
L'interface reprend la logique standard de Dolibarr pour une prise en main immédiate.
Lorsque vous modifiez le taux de TVA d’une ligne, un mécanisme interne désactive les événements clavier sur les champs de prix afin '''d’empêcher la saisie simultanée''' des valeurs '''HT''' et '''TTC'''.


Cela garantit la cohérence des calculs et évite les erreurs de saisie.
<!--T:7-->
== Saisir un temps planifié ==
# Ouvrir l'élément concerné (intervention, ticket, etc.)
# Cliquer sur l'onglet '''TimeKeepr'''
# Renseigner les champs :
#* Date prévue
#* Durée planifiée
#* Utilisateur concerné
#* Commentaire (optionnel)
# Valider avec le bouton '''Ajouter'''


'''Exemple concret :''' 
<!--T:8-->
Si vous modifiez le taux de TVA d’une ligne (par exemple de '''0 %''' à '''20 %''' ou autre), les champs '''Prix HT''' et '''Prix TTC''' seront automatiquement liés.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:001-crea task.png|700px]]
| Obligation de crée une intervention ou autre à la base de la fiche dans le cas contraire l’ajout via le sous onglet '''Time''' ne sera pas possible.
|}


<!--T:9-->
{| class="wikitable"  
{| class="wikitable"  
|- style="vertical-align:top"  
|- style="vertical-align:top;"  
| width="300px" | Fonction basique
| [[File:002-time planif.png|700px]]
[[File:ExtraExpense_fonction_sans_extraexpense_001.png |300px]]
| Dans cette onglet vous devrez remplir les champs suivants :
* Date & Heur prévue
* Élément affecté
* Réalisé Par...
* Note (optionnel)
* Temps de réalisation prévue
|}


[[File:ExtraExpense_fonction_sans_extraexpense_result_001.png |300px]]
<!--T:10-->
|
== Saisir un temps réalisé ==
* Si '''TVA = 20 %''' et que le '''Prix HT = 100 €''', vous ne pourrez pas remplir la case '''TTC'''.
# Depuis l'onglet '''TimeKeepr''' de l'élément
La case '''TTC''' sera automatiquement calculée lors de la '''validation de la ligne'''.
# Renseigner les champs :
#* Date de réalisation
#* Durée réalisée
#* Utilisateur ayant réalisé la tâche
#* Commentaire (optionnel)
# Valider avec le bouton '''Ajouter'''
 
<!--T:11-->
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:003-time planif spend.png|700px]]
| Dans cette onglet vous devrez remplir les champs suivants :
* Date & Heur réalisé
* Élément affecté
* Réalisé Par...
* Note (optionnel)
* Temps de réalisation effectué
|}
|}


<!--T:12-->
{| class="wikitable"  
{| class="wikitable"  
|- style="vertical-align:top"  
|- style="vertical-align:top;"  
| width="300px" | Fonction avec ExtraExpense
| [[File:004-time planif & spend data view.png|700px]]
[[File:ExtraExpense_fonction_avec_extraexpense.png |300px]]
| Le haut de page vous permettra de visualiser les données de la fiche notamment le temps de réalisation & celui qui aura était planifié.
|}


[[File:ExtraExpense_fonction_avec_extraexpense_result.png |300px]]
== Saisie de temps à la volée ==
|
Possibilité de saisir des temps à la volée.
Si '''TVA = 0 %''' et que le '''Prix HT = 50 €''', vous pouvez également saisir la case '''TTC''' avec un autre montant.


Le montant de la TVA est déterminé à partir de la différence des deux montants (ici 30€ soit un taux de 60% de TVA)
Voire ci-dessous pour plus de détails.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:004-1-flytime ex.png|700px]]
|}
|}


=== Validité de la ligne ===
<!--T:13-->
= Onglet Temps à la volée =
La saisie du temps à la volé permet d'ajouter du temps passé directement sur le temps en cours de réalisation.
 
Ce temps d'ajouts ce définit directement depuis les paramètres du plugin TimeKeepr.
 
Il y a un menu dédié pour la saisie des temps à la volée (voir ci-dessous), mais il est aussi possible dé réaliser cette saisie depuis l'onglet de saisie des temps
 
<!--T:14-->
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:005-flying time.png|700px]]
| Si Fonction Activée il es possible de définir l'ajout en :
* Heur
* Jours
* Semaines
* Mois
|}


<!--T:15-->
{| class="wikitable"  
{| class="wikitable"  
|- style="vertical-align:top"  
|- style="vertical-align:top;"  
| width="300px" | Saisie des temps planifiés et réalisés sur d'autres éléments
| [[File:006-flying time exemple.png|700px]]
[[File:ExtraExpense_validite_ligne.png |300px]]
|}
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
{| class="wikitable"  
|-
|- style="vertical-align:top;"  
! colspan="7" | '''Calcul du Montant de la TVA'''
| [[File:006-1-flying time exemple.png|700px]]
|-
| En cliquant sur '''Start''' cela active le temps à la volée, et lance ainsi un chronomètre qui enregistrera le temps jusqu’à son arrêt définitif via le bouton '''Stop'''.
| 20 || + || 20 || + || 30 || = || '''70'''
|}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:006-2-flying time exemple.png|700px]]
| Une fois le temps à la volée définitivement arrêté, il apparaîtra dans les temps d'interventions réalisé.
|}
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants : 
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€ 
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€ 
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€


Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.
<!--T:16-->
= Menu de rapport mensuelle =
Dans chaque menu gauche associé à un élément, un nouveau menu '''Rapport TimeKeepr'''
est ajouté permettant d'accéder à une vue globale des temps sur un mois :
* Affichage des temps planifiés
* Affichage des temps réalisés
* Filtrage par type d'élément (interventions, tickets, etc.)
* Visualisation sur une période mensuelle


<!--T:17-->
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:007-rapport timekeepr.png|700px]]
| L'onglet rapport TimeKeepr vous affichera sous forma de tableau les temps planifiés et réalisés sur un mois, ainsi que les écarts entre les deux.<br>
Vous pourrez également filtrer les données par type périodique (mois, semaine, jour, etc.) ; catégoriser d'utilisateurs ou bien utiliser directement.
|}
|}
<!--T:18-->
Cette vue facilite :
* Le pilotage de l'activité
* L'analyse des écarts planifié / réalisé
* Le suivi de la charge de travail
</translate>

Dernière version du 18 mai 2026 à 17:32

TimeKeepR est un module permettant la saisie et le suivi des temps planifiés et réalisés sur des éléments autres que les tâches de projet, tout en conservant une logique de saisie homogène avec le standard Dolibarr.

Ce module étend les capacités natives de gestion du temps sur les éléments suivant :

  • Fiche d'intervention
  • Ticket
  • Ordre de Fabrication natif
  • Factory
  • Equipement


Le but est de permettre une saisie de temps planifiées et réalisées uniforme afin d'offrir une vision mensuelle consolidée des temps

Éléments compatibles

Élément Onglet de saisie Rapport mensuel Saisie des temps à la volée
Fiche d'intervention
Ticket
Ordre de Fabrication natif
Factory (plugin)
Equipement (plugin)

Configuration du plugin TimeKeepR

Le plugin TimeKeepR s'active depuis la page de configuration des plugins de Dolibarr, et permet également la saisie des temps à la volé si la fonction activé.

Activation de TimeKeepR depuis la page : Home -> Configuration -> Modules/Applications
Activation de la fonction de saisie des temps à la volée.

Il est possible de configurer le temps d'arrêt après duquel la fonction de temps à la volée s'arrête :

  • Aucun
  • Heure
  • Jour
  • Semaine
  • Mois

Règle d'arrêt au lancement :

  • N'arrête rien
  • Mise en pause
  • Arrête le temps

Onglet de saisie des temps

Sur chaque élément compatible, le module ajoute un onglet dédié permettant :

  • La saisie des temps planifiés
  • La saisie des temps réalisés
  • La saisie des temps à la volée
  • La consultation de l'historique des temps saisis

L'interface reprend la logique standard de Dolibarr pour une prise en main immédiate.

Saisir un temps planifié

  1. Ouvrir l'élément concerné (intervention, ticket, etc.)
  2. Cliquer sur l'onglet TimeKeepr
  3. Renseigner les champs :
    • Date prévue
    • Durée planifiée
    • Utilisateur concerné
    • Commentaire (optionnel)
  4. Valider avec le bouton Ajouter
Obligation de crée une intervention ou autre à la base de la fiche dans le cas contraire l’ajout via le sous onglet Time ne sera pas possible.
Dans cette onglet vous devrez remplir les champs suivants :
  • Date & Heur prévue
  • Élément affecté
  • Réalisé Par...
  • Note (optionnel)
  • Temps de réalisation prévue

Saisir un temps réalisé

  1. Depuis l'onglet TimeKeepr de l'élément
  2. Renseigner les champs :
    • Date de réalisation
    • Durée réalisée
    • Utilisateur ayant réalisé la tâche
    • Commentaire (optionnel)
  3. Valider avec le bouton Ajouter
Dans cette onglet vous devrez remplir les champs suivants :
  • Date & Heur réalisé
  • Élément affecté
  • Réalisé Par...
  • Note (optionnel)
  • Temps de réalisation effectué
Le haut de page vous permettra de visualiser les données de la fiche notamment le temps de réalisation & celui qui aura était planifié.

Saisie de temps à la volée

Possibilité de saisir des temps à la volée.

Voire ci-dessous pour plus de détails.

Onglet Temps à la volée

La saisie du temps à la volé permet d'ajouter du temps passé directement sur le temps en cours de réalisation.

Ce temps d'ajouts ce définit directement depuis les paramètres du plugin TimeKeepr.

Il y a un menu dédié pour la saisie des temps à la volée (voir ci-dessous), mais il est aussi possible dé réaliser cette saisie depuis l'onglet de saisie des temps

Si Fonction Activée il es possible de définir l'ajout en :
  • Heur
  • Jours
  • Semaines
  • Mois
En cliquant sur Start cela active le temps à la volée, et lance ainsi un chronomètre qui enregistrera le temps jusqu’à son arrêt définitif via le bouton Stop.
Une fois le temps à la volée définitivement arrêté, il apparaîtra dans les temps d'interventions réalisé.

Menu de rapport mensuelle

Dans chaque menu gauche associé à un élément, un nouveau menu Rapport TimeKeepr est ajouté permettant d'accéder à une vue globale des temps sur un mois :

  • Affichage des temps planifiés
  • Affichage des temps réalisés
  • Filtrage par type d'élément (interventions, tickets, etc.)
  • Visualisation sur une période mensuelle
L'onglet rapport TimeKeepr vous affichera sous forma de tableau les temps planifiés et réalisés sur un mois, ainsi que les écarts entre les deux.

Vous pourrez également filtrer les données par type périodique (mois, semaine, jour, etc.) ; catégoriser d'utilisateurs ou bien utiliser directement.

Cette vue facilite :

  • Le pilotage de l'activité
  • L'analyse des écarts planifié / réalisé
  • Le suivi de la charge de travail