feat: persist and edit versioned workflow definitions

src/govoplan_workflow/backend/schemas.py

@@ -1,11 +1,15 @@
 from __future__ import annotations
 
 import math
+from datetime import datetime
 from typing import Any, Literal
 
 from pydantic import BaseModel, Field, field_validator
 
 
+WorkflowDefinitionStatus = Literal["draft", "active", "archived"]
+
+
 class WorkflowPosition(BaseModel):
     x: float = 0
     y: float = 0
@@ -35,6 +39,7 @@ class WorkflowEdge(BaseModel):
 
 
 class WorkflowGraph(BaseModel):
+    schema_version: Literal[1] = 1
     nodes: list[WorkflowNode] = Field(default_factory=list, max_length=150)
     edges: list[WorkflowEdge] = Field(default_factory=list, max_length=300)
 
@@ -91,3 +96,70 @@ class WorkflowNodeLibraryResponse(BaseModel):
     version: str
     allows_cycles: bool
     nodes: list[WorkflowNodeTypeResponse]
+
+
+class WorkflowDefinitionRevisionResponse(BaseModel):
+    id: str
+    revision: int
+    schema_version: int
+    graph: WorkflowGraph
+    content_hash: str
+    library_id: str
+    library_version: str
+    created_by: str | None
+    created_at: datetime
+
+
+class WorkflowDefinitionResponse(BaseModel):
+    id: str
+    tenant_id: str
+    key: str
+    name: str
+    description: str | None
+    status: WorkflowDefinitionStatus
+    current_revision: int
+    active_revision: int | None
+    metadata: dict[str, Any]
+    created_by: str | None
+    updated_by: str | None
+    created_at: datetime
+    updated_at: datetime
+    revision: WorkflowDefinitionRevisionResponse
+
+
+class WorkflowDefinitionListResponse(BaseModel):
+    definitions: list[WorkflowDefinitionResponse]
+
+
+class WorkflowDefinitionRevisionListResponse(BaseModel):
+    revisions: list[WorkflowDefinitionRevisionResponse]
+
+
+class WorkflowDefinitionCreateRequest(BaseModel):
+    key: str | None = Field(
+        default=None,
+        min_length=1,
+        max_length=120,
+        pattern=r"^[A-Za-z0-9][A-Za-z0-9_-]*$",
+    )
+    name: str = Field(min_length=1, max_length=300)
+    description: str | None = Field(default=None, max_length=4_000)
+    graph: WorkflowGraph
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class WorkflowDefinitionUpdateRequest(BaseModel):
+    name: str = Field(min_length=1, max_length=300)
+    description: str | None = Field(default=None, max_length=4_000)
+    graph: WorkflowGraph
+    metadata: dict[str, Any] = Field(default_factory=dict)
+    expected_revision: int = Field(ge=1)
+
+
+class WorkflowDefinitionActivateRequest(BaseModel):
+    revision: int | None = Field(default=None, ge=1)
+
+
+class WorkflowDefinitionDeleteResponse(BaseModel):
+    deleted: bool
+    definition_id: str