workflows.services.executors.approval
=====================================

.. py:module:: workflows.services.executors.approval

.. autoapi-nested-parse::

   Approval step executor.





Module Contents
---------------

.. py:class:: ApprovalExecutor

   Bases: :py:obj:`workflows.services.executors.factory.AbstractStepExecutor`


   Approval step executor.

   First encounter (no signal) → AWAITING (AwaitingApproval).

   - On "reject" → REJECTED (terminal).
   - On "approve":
       • If this is the last Approval step → APPROVED.
       • Otherwise → PASSED.


   .. py:method:: do_execute(instance, signal)

      Execute the approval step and return the resulting state.

      :param instance: Workflow instance being processed.
      :param signal: External decision signal such as ``approve`` or ``reject``.

      :returns: ExecutorResult describing the new workflow state and step context.