52 lines
1.8 KiB
Python
52 lines
1.8 KiB
Python
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
|