[ADD] contract_timesheet_monitoring

Author: victor-champonnois

contract_timesheet_monitoring/README.rst

@@ -0,0 +1,69 @@
+=============================
+Contract timesheet monitoring
+=============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:00fb3cdc565442ffcd3351e97d0516ce6f4ceb55402981b183f7e717a1e23173
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Production/Stable
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-coopiteasy%2Faddons-lightgray.png?logo=github
+    :target: https://github.com/coopiteasy/addons/tree/16.0/contract_timesheet_monitoring
+    :alt: coopiteasy/addons
+
+|badge1| |badge2| |badge3|
+
+Context
+=======
+
+This module was developped for clients paying a subscription fee for
+functional support. We wanted to invoice a fixed amount per period, but
+invoice excess time. This module provide a way for the clients and the
+service provider to monitor the time spent to compare it with the
+threshold.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Known issues / Roadmap
+======================
+
+Add a table to show the time spent on the previous periods. It should
+probably be easier to do this using the invoice lines from the contract,
+rather than the contract lines.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/coopiteasy/addons/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/coopiteasy/addons/issues/new?body=module:%20contract_timesheet_monitoring%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* Coop IT Easy SC
+
+Maintainers
+-----------
+
+This module is part of the `coopiteasy/addons <https://github.com/coopiteasy/addons/tree/16.0/contract_timesheet_monitoring>`_ project on GitHub.
+
+You are welcome to contribute.

contract_timesheet_monitoring/__init__.py

@@ -0,0 +1 @@
+from . import models

contract_timesheet_monitoring/__manifest__.py

@@ -0,0 +1,19 @@
+# Copyright 2017 Tecnativa - Luis M. Ontalba
+# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
+
+{
+    "name": "Contract timesheet monitoring",
+    "summary": "Compute time spent on service contracts",
+    "version": "16.0.1.0.0",
+    "category": "Sales",
+    "author": "Coop IT Easy SC, Odoo Community Association (OCA)",
+    "website": "https://github.com/coopiteasy/addons",
+    "depends": ["contract", "hr_timesheet"],
+    "development_status": "Production/Stable",
+    "data": [
+        "views/contract.xml",
+        "views/contract_portal_templates.xml",
+    ],
+    "license": "AGPL-3",
+    "installable": True,
+}

contract_timesheet_monitoring/models/__init__.py

@@ -0,0 +1 @@
+from . import contract_line

contract_timesheet_monitoring/models/contract_line.py

@@ -0,0 +1,34 @@
+from odoo import fields, models
+
+
+class ContractLine(models.Model):
+    _inherit = "contract.line"
+
+    time_spent = fields.Float(
+        string="Time Spent this Period", compute="_compute_time_spent"
+    )
+
+    def _compute_time_spent(self):
+        if self.analytic_distribution:
+            for analytic_account, percentage in self.analytic_distribution.items():
+                analytic_account_id = int(analytic_account)
+                analytic_account_lines = (
+                    self.env["account.analytic.account"]
+                    .browse(analytic_account_id)
+                    .line_ids
+                )
+                line_ids_time_spent = analytic_account_lines.filtered(
+                    # ensure the uom is the same as the one configure for the project
+                    # timesheets (hours or day)
+                    lambda x: (
+                        x.encoding_uom_id == x.project_id.timesheet_encode_uom_id
+                    )
+                )
+                period_start_date = self.last_date_invoiced or self.date_start
+                line_ids_time_spent_in_period = line_ids_time_spent.filtered(
+                    lambda x: (x.date >= period_start_date)
+                ).mapped("unit_amount")
+                # todo : account for percentage in analytic distribution
+                self.time_spent = sum(line_ids_time_spent_in_period)
+        else:
+            self.time_spent = False

contract_timesheet_monitoring/readme/DESCRIPTION.md

@@ -0,0 +1,6 @@
+# Context
+
+This module was developped for clients paying a subscription fee for functional support. We wanted to invoice a fixed amount per period, but invoice excess time.
+This module provide a way for the clients and the service provider to monitor the time spent to compare it with the threshold.
+
+

contract_timesheet_monitoring/readme/ROADMAP.md

@@ -0,0 +1 @@
+Add a table to show the time spent on the previous periods. It should probably be easier to do this using the invoice lines from the contract, rather than the contract lines.