mirror of
https://github.com/bringout/oca-project.git
synced 2026-04-18 11:42:06 +02:00
🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
172 lines
6.4 KiB
ReStructuredText
172 lines
6.4 KiB
ReStructuredText
.. 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.
|