[ADD] dev_zero_stock_blockage: implemented zero stock approval task

Ensure that Sales Orders cannot be confirmed without Zero Stock Approval,
restricting Sales Users from modifying the field while allowing only
Sales Administrators to approve orders.

--> Inherited Model
- Inherited the main model  sale order.
- Added a new boolean field zero stock approval in the sale order model.
- Overridden fields get() to make the field  read-only  for Sales Users
(sales person)
- Made action confirm() to restrict order confirmation unless
zero stock approval  is checked.
- Implemented  sale order views xml to display  zero stock approval
after payment term id.

Access Rights
- Sales Administrator -  Can edit the field.
- Sales User : Read-only access.

- Created a boolean field 'zero_stock_approval' to allow admins to approve orders
  with low stock
- Only Sales Manager can edit this field; others see it as readonly
- If any product has demand > available stock and the user is not a manager,
  they must get admin approval
- Blocked order confirmation if quantity is less than available and no approval
  is given
- Skipped stock check for service and combo products (only checked
  consu {goods} type)
- Added a warning message popup when admin gives approval for a product
  with low stock

Ensures better control over order confirmation based on stock approval.

Author: agir-odoo

dev_zero_stock_blockage/__init__.py

@@ -0,0 +1 @@
+from . import models

dev_zero_stock_blockage/__manifest__.py

@@ -0,0 +1,16 @@
+{
+    'name': 'Dev Zero Stock Blockage',
+    'version': '1.0',
+    'summary': 'Add zero stock blockage feature to sale order',
+    'description': """
+        Add zero stock blockage feature to sale order
+    """,
+    'author': 'Raghav Agiwal',
+    'depends': ['sale_management', 'stock'],
+    'data': [
+        'views/sale_order_views.xml',
+    ],
+    'installable': True,
+    'application': True,
+    'license': 'LGPL-3'
+}

dev_zero_stock_blockage/models/__init__.py

@@ -0,0 +1 @@
+from . import sale_order

dev_zero_stock_blockage/models/sale_order.py

@@ -0,0 +1,60 @@
+from odoo import api, models, fields
+from odoo.exceptions import UserError
+
+
+class SaleOrder(models.Model):
+    _inherit = 'sale.order'
+
+    zero_stock_approval = fields.Boolean(
+        string="Approval",
+    )
+
+    @api.onchange('zero_stock_approval')
+    def _onchange_zero_stock_approval(self):
+        if self.zero_stock_approval and self.env.user.has_group('sales_team.group_sale_manager'):
+            for line in self.order_line:
+                if line.product_id.type in ['consu', 'product'] and line.product_uom_qty > line.product_id.qty_available:
+                    return {
+                        'warning': {
+                            'title': "Heads Up!",
+                            'message': (
+                                f"Just a quick reminder..!! You are approving this order where product '{line.product_id.display_name}' "
+                                f"has demand {line.product_uom_qty} > available {line.product_id.qty_available}."
+                            )
+                        }
+                    }
+
+    @api.model
+    def fields_get(self, allfields=None, attributes=None):
+        fields = super().fields_get(allfields=allfields, attributes=attributes)
+        if not self.env.user.has_group('sales_team.group_sale_manager'):
+            if "zero_stock_approval" in fields:
+                fields['zero_stock_approval']['readonly'] = True
+        return fields
+
+    def action_confirm(self):
+        for order in self:
+            for line in order.order_line:
+                demand_qty = line.product_uom_qty
+                available_qty = line.product_id.qty_available
+
+                # if demand_qty <= 0:
+                #         raise UserError(
+                #         f"You cannot confirm this Sale Order.\n"
+                #         f"Product '{line.product_id.display_name}' has a quantity of {demand_qty}.\n"
+                #         f"Quantity must be greater than zero."
+                # )
+
+                if (
+                line.product_id.type == 'consu'
+                and demand_qty > available_qty
+                and not self.env.user.has_group('sales_team.group_sale_manager')
+                and not order.zero_stock_approval
+                ):
+                    raise UserError(
+                        f"Cannot confirm this Sale Order.\n"
+                        f"Product '{line.product_id.display_name}' has only {available_qty} in stock, "
+                        f"but {demand_qty} is requested.\n"
+                        f"Approval is required to proceed."
+                    )
+        return super().action_confirm()

dev_zero_stock_blockage/views/sale_order_views.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <record id="view_sale_order_form" model="ir.ui.view">
+        <field name="name">sale.order.form</field>
+        <field name="model">sale.order</field>
+        <field name="inherit_id" ref="sale.view_order_form"/>
+        <field name="arch" type="xml">
+            <xpath expr="//field[@name='payment_term_id']" position="after">
+                <field name="zero_stock_approval"/>
+            </xpath>
+        </field>
+    </record>
+
+</odoo>