.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

==============================
Project timesheet time control
==============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:a6cc4690ae91d7c775ac1c42e58b371f391a6f17ca9ba61440a0589c770f947e
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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/16.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-16-0/project-16-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=16.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:

#. Go to *Timesheets > Timesheet > All Timesheets*.
#. Create a new record.
#. You will see now that the *Date* field contains also time information.
#. If you don't select any "project", you will be able to select any "task",
   opened or not.
#. Selecting a "task", the corresponding "project" is filled.
#. 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.
#. At the end of the line, you will see a stop button.
#. When you press this button, the difference between *Date* field and the
   current time is saved in the "Duration" field.
#. You can modify the *Date* field for altering the computation of the
   duration.
#. 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.
#. 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:

#. Go to *Timesheet > Timesheet > Start work*.
#. 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:

#. Go to *Project > Projects*.
#. If a project has a running timesheet line, it will display a *Stop* button.
#. 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.
#. You can see the same in list and form views.

Or via tasks:

#. Go to *Project > All Tasks*.
#. If a task has a running timesheet line, it will display a *Stop* button.
#. 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.
#. You can see the same in list view.
#. Click on any existing task or create a new one.
#. You can see the same feature in the action buttons box.
#. 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:%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
~~~~~~~

* 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

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/16.0/project_timesheet_time_control>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
