18.0 mig base tier validation

.pre-commit-config.yaml

@@ -20,6 +20,8 @@ exclude: |
   /tests/samples/.*|
   # You don't usually want a bot to modify your legal texts
   (LICENSE.*|COPYING.*)
+  # Modules
+  ^base_tier_validation/static/src/components/.*$|
 default_language_version:
   python: python3
   node: "22.9.0"

base_tier_validation/README.rst

@@ -0,0 +1,295 @@
+====================
+Base Tier Validation
+====================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:1d286dc389232f0cc60fd6012ae72c5eaf918284c9e7ef73da914cd6691cf822
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Mature-brightgreen.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Mature
+.. |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%2Fserver--ux-lightgray.png?logo=github
+    :target: https://github.com/OCA/server-ux/tree/18.0/base_tier_validation
+    :alt: OCA/server-ux
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/server-ux-18-0/server-ux-18-0-base_tier_validation
+    :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/server-ux&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Validating some operations is a common need across different areas in a
+company and sometimes it also involves several people and stages in the
+process. With this module you will be able to define your custom
+validation workflows for any Odoo document.
+
+This module does not provide a functionality by itself but an abstract
+model to implement a validation process based on tiers on other models
+(e.g. purchase orders, sales orders, budgets, expenses...).
+
+**Note:** To be able to use this module in a new model you will need
+some development.
+
+See
+`purchase_tier_validation <https://github.com/OCA/purchase-workflow>`__
+as an example of implementation.
+
+Additionally, if your state field is a (stored) computed field, you need
+to set ``_tier_validation_state_field_is_computed`` to ``True`` in your
+model Python file, and you will want to add the dependent fields of the
+compute method in ``_get_after_validation_exceptions`` and
+``_get_under_validation_exceptions``.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To configure this module, you need to:
+
+1. Go to *Settings > Technical > Tier Validations > Tier Definition*.
+2. Create as many tiers as you want for any model having tier validation
+   functionality.
+
+**Note:**
+
+- If check *Notify Reviewers on Creation*, all possible reviewers will
+  be notified by email when this definition is triggered.
+- If check *Notify reviewers on reaching pending* if you want to send a
+  notification when pending status is reached. This is usefull in a
+  approve by sequence scenario to only notify reviewers when it is their
+  turn in the sequence.
+- If check *Comment*, reviewers can comment after click Validate or
+  Reject.
+- If check *Approve by sequence*, reviewers is forced to review by
+  specified sequence.
+
+To configure Tier Validation Exceptions, you need to:
+
+1. Go to *Settings > Technical > Tier Validations > Tier Validation
+   Exceptions*.
+2. Create as many tiers validation exceptions as you want for any model
+   having tier validation functionality.
+3. Add desired fields to be checked in *Fields*.
+4. Add desired groups that can use this Exception in *Groups*.
+5. You must check *Write under Validation*, *Write after Validation* or
+   both.
+
+**Note:**
+
+- If you don't create any exception, the Validated record will be
+  readonly and cannot be modified.
+- If check *Write under Validation*, records will be able to be modified
+  only in the defined fields when the Validation process is ongoing.
+- If check *Write after Validation*, records will be able to be modified
+  only in the defined fields when the Validation process is finished.
+- If check *Write after Validation* and *Write under Validation*,
+  records will be able to be modified defined fields always.
+
+Known issues / Roadmap
+======================
+
+This is the list of known issues for this module. Any proposal for
+improvement will be very valuable.
+
+- **Issue:**
+
+  When using approve_sequence option in any tier.definition there can be
+  inconsistencies in the systray notifications.
+
+  **Description:**
+
+  Field can_review in tier.review is used to filter out, in the systray
+  notifications, the reviews a user can approve. This can_review field
+  is updated **in the database** in method review_user_count, this can
+  make it very inconsistent for databases with a lot of users and
+  recurring updates that can change the expected behavior.
+
+- **Migration to 15.0:**
+
+  The parameter \_tier_validation_manual_config will become False, on
+  14.0, the default value is True, as the change is applied after the
+  migration. In order to use the new behavior we need to modify the
+  value on our expected model.
+
+Changelog
+=========
+
+17.0.1.0.0 (2024-01-10)
+-----------------------
+
+Migrated to Odoo 17. Merged module with tier_validation_waiting. To
+support sending messages in a validation sequence when it is their turn
+to validate.
+
+14.0.1.0.0 (2020-11-19)
+-----------------------
+
+Migrated to Odoo 14.
+
+13.0.1.2.2 (2020-08-30)
+-----------------------
+
+Fixes:
+
+- When using approve_sequence option in any tier.definition there can be
+  inconsistencies in the systray notifications
+- When using approve_sequence, still not approve only the needed
+  sequence, but also other sequence for the same approver
+
+12.0.3.3.1 (2019-12-02)
+-----------------------
+
+Fixes:
+
+- Show comment on Reviews Table.
+- Edit notification with approve_sequence.
+
+12.0.3.3.0 (2019-11-27)
+-----------------------
+
+New features:
+
+- Add comment on Reviews Table.
+- Approve by sequence.
+
+12.0.3.2.1 (2019-11-26)
+-----------------------
+
+Fixes:
+
+- Remove message_subscribe_users
+
+12.0.3.2.0 (2019-11-25)
+-----------------------
+
+New features:
+
+- Notify reviewers
+
+12.0.3.1.0 (2019-07-08)
+-----------------------
+
+Fixes:
+
+- Singleton error
+
+12.0.3.0.0 (2019-12-02)
+-----------------------
+
+Fixes:
+
+- Edit Reviews Table
+
+12.0.2.1.0 (2019-05-29)
+-----------------------
+
+Fixes:
+
+- Edit drop-down style width and position
+
+12.0.2.0.0 (2019-05-28)
+-----------------------
+
+New features:
+
+- Pass parameters as functions.
+- Add Systray.
+
+12.0.1.0.0 (2019-02-18)
+-----------------------
+
+Migrated to Odoo 12.
+
+11.0.1.0.0 (2018-05-09)
+-----------------------
+
+Migrated to Odoo 11.
+
+10.0.1.0.0 (2018-03-26)
+-----------------------
+
+Migrated to Odoo 10.
+
+9.0.1.0.0 (2017-12-02)
+----------------------
+
+First version.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-ux/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/server-ux/issues/new?body=module:%20base_tier_validation%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
+-------
+
+* ForgeFlow
+
+Contributors
+------------
+
+- Lois Rilo <[email protected]>
+- Naglis Jonaitis <[email protected]>
+- Adrià Gil Sorribes <[email protected]>
+- Pimolnat Suntian <[email protected]>
+- Pedro Gonzalez <[email protected]>
+- Kitti U. <[email protected]>
+- Saran Lim. <[email protected]>
+- Carlos Lopez <[email protected]>
+- Javier Colmeiro <[email protected]>
+- bosd
+- Evan Soh <[email protected]>
+- Manuel Regidor <[email protected]>
+- Eduardo de Miguel <[email protected]>
+- `XCG Consulting <https://xcg-consulting.fr>`__:
+
+  - Houzéfa Abbasbhay
+
+- Stefan Rijnhart <[email protected]>
+
+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-LoisRForgeFlow| image:: https://github.com/LoisRForgeFlow.png?size=40px
+    :target: https://github.com/LoisRForgeFlow
+    :alt: LoisRForgeFlow
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-LoisRForgeFlow| 
+
+This module is part of the `OCA/server-ux <https://github.com/OCA/server-ux/tree/18.0/base_tier_validation>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

base_tier_validation/__init__.py

@@ -0,0 +1,4 @@
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from . import models
+from . import wizard

base_tier_validation/__manifest__.py

@@ -0,0 +1,37 @@
+# Copyright 2017-24 ForgeFlow S.L. (https://www.forgeflow.com)
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+{
+    "name": "Base Tier Validation",
+    "summary": "Implement a validation process based on tiers.",
+    "version": "18.0.1.0.0",
+    "development_status": "Mature",
+    "maintainers": ["LoisRForgeFlow"],
+    "category": "Tools",
+    "website": "https://github.com/OCA/server-ux",
+    "author": "ForgeFlow, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "application": False,
+    "installable": True,
+    "depends": ["mail"],
+    "data": [
+        "data/mail_data.xml",
+        "security/ir.model.access.csv",
+        "security/tier_validation_security.xml",
+        "views/res_config_settings_views.xml",
+        "views/tier_definition_view.xml",
+        "views/tier_review_view.xml",
+        "views/tier_validation_exception_view.xml",
+        "wizard/comment_wizard_view.xml",
+        "templates/tier_validation_templates.xml",
+    ],
+    "assets": {
+        "web.assets_backend": [
+            "/base_tier_validation/static/src/components/tier_review_menu/tier_review_menu.esm.js",  # pylint: disable=no-undef
+            "/base_tier_validation/static/src/components/tier_review_menu/tier_review_menu.xml",
+            "/base_tier_validation/static/src/components/tier_review_widget/tier_review_widget.esm.js",
+            "/base_tier_validation/static/src/components/tier_review_widget/tier_review_widget.scss",
+            "/base_tier_validation/static/src/components/tier_review_widget/tier_review_widget.xml",
+            "/base_tier_validation/static/src/js/services/tier_review_service.esm.js",
+        ],
+    },
+}

base_tier_validation/data/mail_data.xml

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<odoo noupdate="1">
+    <record
+        id="mt_tier_validation_requested"
+        model="mail.message.subtype"
+        forcecreate="1"
+    >
+        <field name="name">Tier Validation Requested</field>
+        <field name="default" eval="True" />
+        <field name="internal" eval="True" />
+        <field name="hidden" eval="True" />
+    </record>
+    <record
+        id="mt_tier_validation_accepted"
+        model="mail.message.subtype"
+        forcecreate="1"
+    >
+        <field name="name">Tier Validation Accepted Notification</field>
+        <field name="default" eval="True" />
+        <field name="internal" eval="True" />
+        <field name="hidden" eval="True" />
+    </record>
+    <record
+        id="mt_tier_validation_rejected"
+        model="mail.message.subtype"
+        forcecreate="1"
+    >
+        <field name="name">Tier Validation Rejected Notification</field>
+        <field name="default" eval="True" />
+        <field name="internal" eval="True" />
+        <field name="hidden" eval="True" />
+    </record>
+    <record
+        id="mt_tier_validation_restarted"
+        model="mail.message.subtype"
+        forcecreate="1"
+    >
+        <field name="name">Tier Validation Restarted</field>
+        <field name="default" eval="True" />
+        <field name="internal" eval="True" />
+        <field name="hidden" eval="True" />
+    </record>
+</odoo>