Import ClientFlow production v4928.1.5.132.4

app/domain/opportunity_flow/decision.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+from dataclasses import asdict, dataclass, field
+from typing import Any
+
+
+@dataclass(frozen=True)
+class WorkflowAction:
+    code: str
+    label: str
+    description: str = ""
+    priority: str = "normal"
+    target_url: str | None = None
+    can_execute: bool = True
+    reason_if_blocked: str | None = None
+    document_id: str | None = None
+    document_number: str | None = None
+
+    def to_dict(self) -> dict[str, Any]:
+        return asdict(self)
+
+
+@dataclass(frozen=True)
+class OpportunityDecision:
+    """Single operational decision consumed by UI, tasks and audits."""
+
+    next_action: WorkflowAction
+    reason: str
+    available_actions: list[WorkflowAction] = field(default_factory=list)
+    blocked_actions: list[WorkflowAction] = field(default_factory=list)
+    warnings: list[str] = field(default_factory=list)
+    commercial_stage: str = "REVIEW"
+    financial_state: str = "unknown"
+    physical_state: str = "unknown"
+    ui_hints: dict[str, Any] = field(default_factory=dict)
+    decision_version: str = "opportunity-flow-engine-v1"
+    profile_name: str = "default"
+
+    def to_dict(self) -> dict[str, Any]:
+        data = asdict(self)
+        # Backward-compatible aliases used by older UI/service code.
+        data["action_code"] = self.next_action.code
+        data["label"] = self.next_action.label
+        data["description"] = self.next_action.description or self.reason
+        data["priority"] = self.next_action.priority
+        data["target_url"] = self.next_action.target_url
+        data["can_execute"] = self.next_action.can_execute
+        data["reason_if_blocked"] = self.next_action.reason_if_blocked
+        data["document_id"] = self.next_action.document_id
+        data["document_number"] = self.next_action.document_number
+        return data