[18.0][MIG] project_timesheet_time_control

project_timesheet_time_control/README.rst

@@ -0,0 +1,178 @@
+==============================
+Project timesheet time control
+==============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:79fd416fe32b5f66051581268833fd8479c5dd9a8904a4e5a7f563f9862deb07
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |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-OCA%2Fproject-lightgray.png?logo=github
+    :target: https://github.com/OCA/project/tree/18.0/project_timesheet_time_control
+    :alt: OCA/project
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/project-18-0/project-18-0-project_timesheet_time_control
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/project&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Allow to track the exact moment when a timesheet line is started (not
+only the day, but also the minute and second) and let users start and
+stop timers easily.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Installation
+============
+
+This module depends on modules found in these repositories:
+
+- `OCA/timesheet <https://github.com/OCA/timesheet>`__
+- `OCA/web <https://github.com/OCA/web>`__
+
+Usage
+=====
+
+You can access via timesheets:
+
+1.  Go to *Timesheets > Timesheet > All Timesheets*.
+2.  Create a new record.
+3.  You will see now that the *Date* field contains also time
+    information.
+4.  If you don't select any "project", you will be able to select any
+    "task", opened or not.
+5.  Selecting a "task", the corresponding "project" is filled.
+6.  Selecting a "project", tasks are filtered for only allow to select
+    opened tasks for that project. Remember that an opened task is a
+    task whose stage doesn't have "Closed" mark checked.
+7.  At the end of the line, you will see a stop button.
+8.  When you press this button, the difference between *Date* field and
+    the current time is saved in the "Duration" field.
+9.  You can modify the *Date* field for altering the computation of the
+    duration.
+10. After a record is stopped, you see a *Resume* button, which will
+    open a wizard that inherits all relevant values from that timesheet
+    line and lets you duplicate it to indicate you start working in the
+    same thing.
+11. If you didn't stop the timer, but still hit *Resume* in any other,
+    the wizard will tell you that you have a running timer and that
+    starting a new one will stop the other one that is running.
+
+To access the wizard directly:
+
+1. Go to *Timesheet > Timesheet > Start work*.
+2. You will be able to enter a new timesheet line from scratch, but by
+   using this wizard, you avoid problems with old or duplicate running
+   timers.
+
+Or via projects:
+
+1. Go to *Project > Projects*.
+2. If a project has a running timesheet line, it will display a *Stop*
+   button.
+3. Other projects that have enabled timesheets will display a *Start*
+   button that will open the same wizard as the timesheet lines, but
+   duplicating project's last timesheet line without a task.
+4. You can see the same in list and form views.
+
+Or via tasks:
+
+1. Go to *Project > All Tasks*.
+2. If a task has a running timesheet line, it will display a *Stop*
+   button.
+3. Other tasks that have enabled timesheets will display a *Start*
+   button that will open the same wizard as the timesheet lines,
+   duplicating task's last timesheet line.
+4. You can see the same in list view.
+5. Click on any existing task or create a new one.
+6. You can see the same feature in the action buttons box.
+7. On the *Timesheets* page, you will be able to handle records the same
+   way as you do in the above explanation (except the task selection
+   part, which in this case doesn't appear as it's the current one).
+
+Note: All the *Start/Resume/Stop* features are disabled if you don't
+belong to the *Timesheets/User* group or if you are viewing a timesheet
+that belongs to another user.
+
+Known issues / Roadmap
+======================
+
+- Rename to ``hr_timesheet_time_control``.
+- Move to `OCA/timesheet <https://github.com/OCA/timesheet>`__.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/project/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/OCA/project/issues/new?body=module:%20project_timesheet_time_control%0Aversion:%2018.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
+-------
+
+* Tecnativa
+
+Contributors
+------------
+
+- `Tecnativa <https://www.tecnativa.com>`__:
+
+     - Pedro M. Baeza
+     - Antonio Espinosa
+     - Carlos Dauden
+     - Sergio Teruel
+     - Luis M. ontalba
+     - Ernesto Tejeda
+     - Jairo Llopis
+     - Carlos Roca
+
+- `Sygel <https://www.sygel.es>`__:
+
+     - Valentín Vinagre
+     - Roger Sans
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+.. |maintainer-ernestotejeda| image:: https://github.com/ernestotejeda.png?size=40px
+    :target: https://github.com/ernestotejeda
+    :alt: ernestotejeda
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-ernestotejeda| 
+
+This module is part of the `OCA/project <https://github.com/OCA/project/tree/18.0/project_timesheet_time_control>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

project_timesheet_time_control/__init__.py

@@ -0,0 +1,5 @@
+# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
+
+from . import models
+from . import wizards
+from .hooks import post_init_hook

project_timesheet_time_control/__manifest__.py

@@ -0,0 +1,27 @@
+# Copyright 2016 Tecnativa - Antonio Espinosa
+# Copyright 2016 Tecnativa - Sergio Teruel
+# Copyright 2016-2018 Tecnativa - Pedro M. Baeza
+# Copyright 2018 Tecnativa - Ernesto Tejeda
+# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
+
+{
+    "name": "Project timesheet time control",
+    "version": "18.0.1.0.0",
+    "category": "Project",
+    "author": "Tecnativa," "Odoo Community Association (OCA)",
+    "maintainers": ["ernestotejeda"],
+    "website": "https://github.com/OCA/project",
+    "depends": [
+        "hr_timesheet",
+    ],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/account_analytic_line_view.xml",
+        "views/project_project_view.xml",
+        "views/project_task_view.xml",
+        "wizards/hr_timesheet_switch_view.xml",
+    ],
+    "license": "AGPL-3",
+    "installable": True,
+    "post_init_hook": "post_init_hook",
+}

project_timesheet_time_control/hooks.py

@@ -0,0 +1,13 @@
+# Copyright 2016-2017 Tecnativa - Pedro M. Baeza
+# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
+
+
+def post_init_hook(env):
+    """Put the date with 00:00:00 as the date_time for the line."""
+    env.cr.execute(
+        """UPDATE account_analytic_line
+        SET date_time = to_timestamp(date || ' 00:00:00',
+                                     'YYYY/MM/DD HH24:MI:SS')
+        WHERE date(date_time) != date
+        """
+    )