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

=====================================
Project Task Stage Change Restriction
=====================================

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

.. |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_task_stage_change_restriction
    :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_task_stage_change_restriction
    :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|

This module allows specifying which users or groups can move a task to a
specific stage.

**Table of contents**

.. contents::
   :local:

Use Cases / Context
===================

There may be cases where you want to prevent certain users from moving a
task into specific stages. For example, developers can move tasks to the
"Review" stage, but only a project manager can move a task to the "Done"
or "Cancel" stages.

Configuration
=============

The **Task Stages** menu is only visible when Odoo is in developer mode.
Please turn on developer mode before proceeding.

Go to "Project > Configuration > Task Stages" and select or create a new
task stage. Configure the following fields in the "Stage Change
Restriction" group:

- **Assigned Only**
  If enabled, only users assigned to the task can move it into this
  stage.
- **Project Manager**
  If enabled, only the manager of the project this task belongs to can
  move it.
- **Group Members**
  Select groups whose members can move tasks into this stage.

Please be advised, that selected conditions are evaluated using the "OR"
principle. So, a user should satisfy any of the selected conditions.

NB: restrictions are not applied if a stage is being changed by a
superuser.

Usage
=====

| Try to move a task to a restricted stage. If your user doesn't satisfy
  the stage-allowance conditions, the following access error will be
  raised:
| "Sorry, you are not allowed to move the task '<task_name>' into the
  stage '<stage_name>'."

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_task_stage_change_restriction%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
-------

* Cetmix

Contributors
------------

Cetmix <cetmix.com> Ivan Sokolov Andrei Loukachov

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.

This module is part of the `OCA/project <https://github.com/OCA/project/tree/16.0/project_task_stage_change_restriction>`_ project on GitHub.

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