Author: meynier Date: 2013-08-14 17:19:41 +0200 (Wed, 14 Aug 2013) New Revision: 385 Url: http://chorem.org/projects/chorem/repository/revisions/385 Log: Added the calculation documentation Added: trunk/src/site/rst/calculations.rst Modified: trunk/src/site/site_fr.xml Added: trunk/src/site/rst/calculations.rst =================================================================== --- trunk/src/site/rst/calculations.rst (rev 0) +++ trunk/src/site/rst/calculations.rst 2013-08-14 15:19:41 UTC (rev 385) @@ -0,0 +1,199 @@ +======================== +Gestion de projet Chorem +======================== +-------------------------------------------------- +Outil de gestion et de suivi de projet dans Chorem +-------------------------------------------------- + +.. contents:: + +1. Bilan projet +=============== + +Le bilan de projet présente divers calculs financiers liés aux projets. + +Un certain nombre d'éléments sont à saisir manuellement, les champs en italique sont nécéssaires pour les calculs présent dans le bilan/tableau de bord : + +1.1. Quotation +-------------- + +:*Interval*: l'intervalle de temps sur lequel se déroule le devis +:description: description du devis +:*estimatedDays*: nombre de jours-homme estimés +:*amount*: montant facturé au client +:VAT: taxe à appliquer au montant +:conversionHope: pourcentage de réussite du projet +:supplier: personne chargée du dossier dans l'entreprise +:customer: personne chargée du dossier coté client +:project: projet lié au devis +:category: catégorie du devis + +Pour chaque devis, un ensemble de tâche est associé. Les calculs effectués sur les tâches sont les mêmes que ceux des devis, seul le calcul de certains éléments diffèrent. +Les champs à saisir manuellement des tâches est : + +1.2. Task +--------- + +:*Interval*: l'intervalle de temps sur lequel se déroule la tâche +:description: description de la tâche +:*dayExtension*: jours supplémentaire nécéssaires pour finir la tâche +:*price*: prix facturé pour la tâche +:*estimatedDays*: nombre de jours-homme estimés +:name: nom de la tâche +:*status*: statut de la tâche, devant être actualisé à chaque modification de statut +:*quotation*: devis lié à la tâche + +1.3. Calculs +------------ + +Les calculs sont effectués grâce à la classe **Calculation** présente dans le package *org.chorem.project*. C'est une classe abstraite qui factorise les calculs des Task et des Quotation. Les classes **QuotationCalculation** et **TaskCalculation** définissent les méthodes spécifiques au type d'objet. + +1.3.1. TJM [1]_ estimé +~~~~~~~~~~~~~~~~~~~~~~ + +Le TJM (ou ADR) est ce qui facturé au client par jour:: + + adr = amount / estimatedDays + +1.3.2. TJM réel +~~~~~~~~~~~~~~~ + +Le TJM réel est calculé en fonction du nombre de `jours réels`_ :: + + adr = amount / realDays + +.. _`jours réels`: + +1.3.3. Jours réels +~~~~~~~~~~~~~~~~~~ +La méthode realDays() permet de calculer le nombre de jours réels qu'a pris le projet. Cette méthode est abstraite dans **Calculation**. La durée réelle d'un devis est la somme de la durée de ses tâches. +Le calcul de la durée réelle est effectuée de deux manières différentes, si le devis est terminé ou non. + +a. Devis non terminé +____________________ + +Si le devis n'est pas terminé, le nombre de jours réels est égal au nombre de jours éstimé plus le nombre de jours supplémentaire:: + + realDays = estimatedDays + dayExtension + +b. Devis terminé +________________ + +Si le devis est terminé, le nombre de jours réels est égal à la somme des temps passés sur la tâche (objets Time):: + + realDays = Σ time + +Le temps est divisé en jours, en prenant comme diviseur l'horaire journalier de l'employé concerné.:: + + time = hours / employee.dailyHoursWorked + +1.3.4. Différence estimation/réel +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Simple soustraction entre le nombre de jours estimés et `jours réels`_:: + + deltaDays = realDays - estimatedDays + +.. _`CJM estimé`: + +1.3.5. CJM [2]_ estimé +~~~~~~~~~~~~~~~~~~~~~~ + +Moyenne des CJM (ou ADC) des employés en fonction du pourcentage estimé (pour un devis, un calcul du pourcentage moyen par employé est effectué au préalable):: + + estimatedAdc = Σ (employee.adc*task.estimatedPercentage(employee)) + +.. _`CJM réel`: + +1.3.6. CJM réel +~~~~~~~~~~~~~~~ + +Moyenne des CJM (ou ADC) des employés en fonction du temps réel passé:: + + estimatedAdc = Σ (employee.adc*employee.timeSpent) + +1.3.7. Gain attendu +~~~~~~~~~~~~~~~~~~~ + +Le gain attendu est calculé à partir du montant, du nombre de jours estimés et du `CJM estimé`_ :: + + expectedProfit = amount - (estimatedDays * estimatedAdc) + +1.3.7. Gain ou perte réelle +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Gain ou perte réalisée à la fin du projet, calculée à partir du nombre de `jours réels`_ et du `CJM réel`_ :: + + lossOrProfit = amount - (realDays * realAdc) + +1.4. Alertes des tâches +----------------------- + +En cas de dépassement des délais ou autre déroulement non prévu, des alertes sont affichées sur le tableau de bord. Voici la liste des évenements déclenchant, pour l'instant, des alertes : + + * La tâche devrait avoir commencé (statut "SCHEDULED" alors que la date de début est passée) + * La tâche a été commencé en avance (statut "STARTED" alors que la date de début n'est pas passée) + * La tâche devrait être finie (statut "STARTED" alors que la date de fin est passée) + * La tâche a été finie en avance (statut "FINISHED" alors que la date de début n'est pas passée) + +2. Gestion des employés +======================= + +2.1 Calcul du CJM +----------------- + +La classe **AdcCalculation** dans le package *org.chorem.project* gère le calcul du CJM [2]_ (ou ADC). +Il existe deux types de CJM : le CJM réel est le CJM estimé. Une seule variable du calcul change : le temps productif sur l'année. +Dans le cas du CJM estimé, ce temps est calculé à partir du temps journalier et du taux de productivité. +Dans le cas du CJM réel, il est calculé à partir des objets Time de l'année concernée.:: + + adc = ( (expenses * employeeCost) / totalCompanyCost ) / productiveDays; + +2.1.1 Dépenses totales +~~~~~~~~~~~~~~~~~~~~~~ + +Les dépenses totales sont la somme des paiements (FinancialTransaction) effectués par l'entreprise sur l'année. Une simple requête Wikitty est effectué afin de récupérer ces objets FinancialTransaction afin d'effectuer la somme des montants HT:: + + totalExpenses = Σ expense + +2.1.2 Coût annuel de l'employé +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Le coût annuel de l'employé est le salaire à temps plein multiplié par le nombre de jours travaillé durant l'année:: + + employeeCost = ( employee.salary + employee.otherPayments) * employee.partialTime * productiveDays + + +2.1.3 Nombre de jours travaillés +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +En fonction du CJM souhaité, la méthode de calcul du nombre de jours productifs dans l'année est différente. + +CJM estimé +__________ + +Dans le cas du CJM estimé, on prend le nombre de jours ouvrés dans une année, puis on le multiplie par le taux de travail et de productivité de l'employé.:: + + productiveDays = workingDaysInAYear * partialTime * productivityRate + +CJM réel +________ + +Dans le cas du CJM réel, on additionne tous les temps réalisés par l'employé avant de diviser par son horaire journalier et son taux de productivité.:: + + productiveDays = ( Σ(times(employee)) / dailyHoursWorked ) * productivityRate + +2.1.4 Coût annuel de l'entreprise +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Le coût annuel de l'entreprise est la somme des coûts annuels des employés productifs.:: + + totalCompanyCost = Σ employeeCost(company.employees) + + +.. [1] Taux Journalier Moyen (ADR : Average Daily Rate) +.. [2] Coût Journalier Moyen (ADC : Average Daily Cost) + + + + Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2013-08-14 14:17:38 UTC (rev 384) +++ trunk/src/site/site_fr.xml 2013-08-14 15:19:41 UTC (rev 385) @@ -84,6 +84,7 @@ <item name="Accueil" href="index.html"/> <item name="CDC" href="chorem-cdc.html"/> <item name="requisite" href="requisite.html"/> + <item name="calculs" href="calculations.html"/> </menu> <menu ref="reports"/>