Implement FastAPI Temporal MVP pipeline

app/workers/activities/export_activities.py

@@ -0,0 +1,20 @@
+"""Export mock activity."""
+
+from temporalio import activity
+
+from app.domain.enums import AssetType
+from app.workers.activities.tryon_activities import execute_asset_step
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+@activity.defn
+async def run_export_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock final asset export."""
+
+    return await execute_asset_step(
+        payload,
+        AssetType.FINAL,
+        filename="final.png",
+        finalize=True,
+    )
+

app/workers/activities/face_activities.py

@@ -0,0 +1,15 @@
+"""Face mock activity."""
+
+from temporalio import activity
+
+from app.domain.enums import AssetType
+from app.workers.activities.tryon_activities import execute_asset_step
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+@activity.defn
+async def run_face_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock face enhancement."""
+
+    return await execute_asset_step(payload, AssetType.FACE)
+

app/workers/activities/fusion_activities.py

@@ -0,0 +1,19 @@
+"""Fusion mock activity."""
+
+from temporalio import activity
+
+from app.domain.enums import AssetType
+from app.workers.activities.tryon_activities import execute_asset_step
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+@activity.defn
+async def run_fusion_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock face and body fusion."""
+
+    return await execute_asset_step(
+        payload,
+        AssetType.FUSION,
+        extra_metadata={"face_asset_id": payload.selected_asset_id},
+    )
+

app/workers/activities/qc_activities.py

@@ -0,0 +1,69 @@
+"""Quality-control mock activity."""
+
+from temporalio import activity
+
+from app.domain.enums import AssetType, OrderStatus, StepStatus
+from app.infra.db.models.asset import AssetORM
+from app.infra.db.session import get_session_factory
+from app.workers.activities.tryon_activities import create_step_record, jsonable, load_order_and_run, mock_uri, utc_now
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+@activity.defn
+async def run_qc_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock automated quality control."""
+
+    async with get_session_factory()() as session:
+        order, workflow_run = await load_order_and_run(session, payload.order_id, payload.workflow_run_id)
+        step = create_step_record(payload)
+        session.add(step)
+
+        order.status = OrderStatus.RUNNING
+        workflow_run.status = OrderStatus.RUNNING
+        workflow_run.current_step = payload.step_name
+        await session.flush()
+
+        try:
+            passed = not payload.metadata.get("force_fail", False)
+            candidate_asset_ids: list[int] = []
+            candidate_uri: str | None = None
+
+            if passed:
+                candidate = AssetORM(
+                    order_id=payload.order_id,
+                    asset_type=AssetType.QC_CANDIDATE,
+                    step_name=payload.step_name,
+                    uri=mock_uri(payload.order_id, payload.step_name.value, "candidate.png"),
+                    metadata_json=jsonable({"source_asset_id": payload.source_asset_id}),
+                )
+                session.add(candidate)
+                await session.flush()
+                candidate_asset_ids = [candidate.id]
+                candidate_uri = candidate.uri
+
+            result = MockActivityResult(
+                step_name=payload.step_name,
+                success=True,
+                asset_id=candidate_asset_ids[0] if candidate_asset_ids else None,
+                uri=candidate_uri,
+                score=0.95 if passed else 0.35,
+                passed=passed,
+                message="mock success" if passed else "mock qc rejected",
+                candidate_asset_ids=candidate_asset_ids,
+                metadata={"source_asset_id": payload.source_asset_id},
+            )
+
+            step.step_status = StepStatus.SUCCEEDED if passed else StepStatus.FAILED
+            step.output_json = jsonable(result)
+            step.error_message = None if passed else "QC rejected the asset"
+            step.ended_at = utc_now()
+            await session.commit()
+            return result
+        except Exception as exc:
+            step.step_status = StepStatus.FAILED
+            step.error_message = str(exc)
+            step.ended_at = utc_now()
+            order.status = OrderStatus.FAILED
+            workflow_run.status = OrderStatus.FAILED
+            await session.commit()
+            raise

app/workers/activities/review_activities.py

@@ -0,0 +1,117 @@
+"""Review state management mock activities."""
+
+from sqlalchemy import select
+
+from temporalio import activity
+
+from app.domain.enums import OrderStatus, ReviewDecision, ReviewTaskStatus, StepStatus, WorkflowStepName
+from app.infra.db.models.review_task import ReviewTaskORM
+from app.infra.db.models.workflow_step import WorkflowStepORM
+from app.infra.db.session import get_session_factory
+from app.workers.activities.tryon_activities import jsonable, load_order_and_run, utc_now
+from app.workers.workflows.types import (
+    ReviewResolutionActivityInput,
+    ReviewWaitActivityInput,
+    WorkflowFailureActivityInput,
+)
+
+
+@activity.defn
+async def mark_waiting_for_review_activity(payload: ReviewWaitActivityInput) -> None:
+    """Mark a workflow as waiting for a human review."""
+
+    async with get_session_factory()() as session:
+        order, workflow_run = await load_order_and_run(session, payload.order_id, payload.workflow_run_id)
+        review_step = WorkflowStepORM(
+            workflow_run_id=payload.workflow_run_id,
+            step_name=WorkflowStepName.REVIEW,
+            step_status=StepStatus.WAITING,
+            input_json=jsonable(payload),
+            started_at=utc_now(),
+        )
+        session.add(review_step)
+        session.add(
+            ReviewTaskORM(
+                order_id=payload.order_id,
+                status=ReviewTaskStatus.PENDING,
+                selected_asset_id=payload.candidate_asset_ids[0] if payload.candidate_asset_ids else None,
+                comment=payload.comment,
+            )
+        )
+
+        order.status = OrderStatus.WAITING_REVIEW
+        workflow_run.status = OrderStatus.WAITING_REVIEW
+        workflow_run.current_step = WorkflowStepName.REVIEW
+        await session.commit()
+
+
+@activity.defn
+async def complete_review_wait_activity(payload: ReviewResolutionActivityInput) -> None:
+    """Resolve the current waiting-review step before the next branch runs."""
+
+    async with get_session_factory()() as session:
+        order, workflow_run = await load_order_and_run(session, payload.order_id, payload.workflow_run_id)
+        step_result = await session.execute(
+            select(WorkflowStepORM)
+            .where(
+                WorkflowStepORM.workflow_run_id == payload.workflow_run_id,
+                WorkflowStepORM.step_name == WorkflowStepName.REVIEW,
+                WorkflowStepORM.step_status == StepStatus.WAITING,
+            )
+            .order_by(WorkflowStepORM.started_at.desc(), WorkflowStepORM.id.desc())
+        )
+        review_step = step_result.scalars().first()
+        if review_step is not None:
+            review_step.step_status = (
+                StepStatus.FAILED if payload.decision == ReviewDecision.REJECT else StepStatus.SUCCEEDED
+            )
+            review_step.output_json = jsonable(payload)
+            review_step.error_message = payload.comment if payload.decision == ReviewDecision.REJECT else None
+            review_step.ended_at = utc_now()
+
+        if payload.decision == ReviewDecision.REJECT:
+            order.status = OrderStatus.FAILED
+            workflow_run.status = OrderStatus.FAILED
+        else:
+            order.status = OrderStatus.RUNNING
+            workflow_run.status = OrderStatus.RUNNING
+
+        workflow_run.current_step = WorkflowStepName.REVIEW
+        await session.commit()
+
+
+@activity.defn
+async def mark_workflow_failed_activity(payload: WorkflowFailureActivityInput) -> None:
+    """Mark the persisted workflow state as failed."""
+
+    async with get_session_factory()() as session:
+        order, workflow_run = await load_order_and_run(session, payload.order_id, payload.workflow_run_id)
+
+        step_result = await session.execute(
+            select(WorkflowStepORM)
+            .where(
+                WorkflowStepORM.workflow_run_id == payload.workflow_run_id,
+                WorkflowStepORM.step_name == payload.current_step,
+            )
+            .order_by(WorkflowStepORM.started_at.desc(), WorkflowStepORM.id.desc())
+        )
+        workflow_step = step_result.scalars().first()
+        if workflow_step is None:
+            workflow_step = WorkflowStepORM(
+                workflow_run_id=payload.workflow_run_id,
+                step_name=payload.current_step,
+                step_status=StepStatus.FAILED,
+                input_json=jsonable(payload),
+                started_at=utc_now(),
+            )
+            session.add(workflow_step)
+
+        workflow_step.step_status = StepStatus.FAILED
+        workflow_step.error_message = payload.message
+        workflow_step.output_json = jsonable({"message": payload.message, "status": payload.status.value})
+        workflow_step.ended_at = workflow_step.ended_at or utc_now()
+
+        order.status = payload.status
+        workflow_run.status = payload.status
+        workflow_run.current_step = payload.current_step
+        await session.commit()

app/workers/activities/scene_activities.py

@@ -0,0 +1,19 @@
+"""Scene mock activity."""
+
+from temporalio import activity
+
+from app.domain.enums import AssetType
+from app.workers.activities.tryon_activities import execute_asset_step
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+@activity.defn
+async def run_scene_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock scene replacement."""
+
+    return await execute_asset_step(
+        payload,
+        AssetType.SCENE,
+        extra_metadata={"scene_ref_asset_id": payload.scene_ref_asset_id},
+    )
+

app/workers/activities/texture_activities.py

@@ -0,0 +1,15 @@
+"""Texture mock activity."""
+
+from temporalio import activity
+
+from app.domain.enums import AssetType
+from app.workers.activities.tryon_activities import execute_asset_step
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+@activity.defn
+async def run_texture_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock garment texture enhancement."""
+
+    return await execute_asset_step(payload, AssetType.TEXTURE)
+

app/workers/activities/tryon_activities.py

@@ -0,0 +1,170 @@
+"""Prepare-model and try-on mock activities plus shared helpers."""
+
+from __future__ import annotations
+
+from dataclasses import asdict, is_dataclass
+from datetime import datetime, timezone
+from enum import Enum
+from typing import Any
+from uuid import uuid4
+
+from temporalio import activity
+
+from app.domain.enums import AssetType, OrderStatus, StepStatus
+from app.infra.db.models.asset import AssetORM
+from app.infra.db.models.order import OrderORM
+from app.infra.db.models.workflow_run import WorkflowRunORM
+from app.infra.db.models.workflow_step import WorkflowStepORM
+from app.infra.db.session import get_session_factory
+from app.workers.workflows.types import MockActivityResult, StepActivityInput
+
+
+def utc_now() -> datetime:
+    """Return the current UTC timestamp."""
+
+    return datetime.now(timezone.utc)
+
+
+def jsonable(value: Any) -> Any:
+    """Convert enums, dataclasses, and nested values to JSON-safe structures."""
+
+    if value is None:
+        return None
+    if isinstance(value, Enum):
+        return value.value
+    if isinstance(value, datetime):
+        return value.isoformat()
+    if is_dataclass(value):
+        return jsonable(asdict(value))
+    if isinstance(value, dict):
+        return {key: jsonable(item) for key, item in value.items() if item is not None}
+    if isinstance(value, (list, tuple, set)):
+        return [jsonable(item) for item in value]
+    return value
+
+
+def mock_uri(order_id: int, step_name: str, filename: str = "result.png") -> str:
+    """Build a deterministic-looking mock URI for an order step."""
+
+    return f"mock://orders/{order_id}/{step_name}/{uuid4().hex[:8]}-{filename}"
+
+
+async def load_order_and_run(session, order_id: int, workflow_run_id: int) -> tuple[OrderORM, WorkflowRunORM]:
+    """Load the order and workflow run required by an activity."""
+
+    order = await session.get(OrderORM, order_id)
+    workflow_run = await session.get(WorkflowRunORM, workflow_run_id)
+    if order is None or workflow_run is None:
+        raise ValueError("Order or workflow run not found for activity execution")
+    return order, workflow_run
+
+
+def create_step_record(payload: StepActivityInput) -> WorkflowStepORM:
+    """Create a running workflow step row for an activity execution."""
+
+    return WorkflowStepORM(
+        workflow_run_id=payload.workflow_run_id,
+        step_name=payload.step_name,
+        step_status=StepStatus.RUNNING,
+        input_json=jsonable(payload),
+        started_at=utc_now(),
+    )
+
+
+async def execute_asset_step(
+    payload: StepActivityInput,
+    asset_type: AssetType,
+    *,
+    score: float = 0.95,
+    filename: str = "result.png",
+    message: str = "mock success",
+    extra_metadata: dict[str, Any] | None = None,
+    finalize: bool = False,
+) -> MockActivityResult:
+    """Persist a mock asset-producing step and return its result."""
+
+    async with get_session_factory()() as session:
+        order, workflow_run = await load_order_and_run(session, payload.order_id, payload.workflow_run_id)
+        step = create_step_record(payload)
+        session.add(step)
+
+        order.status = OrderStatus.RUNNING
+        workflow_run.status = OrderStatus.RUNNING
+        workflow_run.current_step = payload.step_name
+        await session.flush()
+
+        try:
+            metadata = {
+                **payload.metadata,
+                "source_asset_id": payload.source_asset_id,
+                "selected_asset_id": payload.selected_asset_id,
+                **(extra_metadata or {}),
+            }
+            metadata = {key: value for key, value in metadata.items() if value is not None}
+
+            asset = AssetORM(
+                order_id=payload.order_id,
+                asset_type=asset_type,
+                step_name=payload.step_name,
+                uri=mock_uri(payload.order_id, payload.step_name.value, filename),
+                metadata_json=jsonable(metadata),
+            )
+            session.add(asset)
+            await session.flush()
+
+            result = MockActivityResult(
+                step_name=payload.step_name,
+                success=True,
+                asset_id=asset.id,
+                uri=asset.uri,
+                score=score,
+                passed=True,
+                message=message,
+                metadata=jsonable(metadata) or {},
+            )
+
+            if finalize:
+                order.final_asset_id = asset.id
+                order.status = OrderStatus.SUCCEEDED
+                workflow_run.status = OrderStatus.SUCCEEDED
+
+            step.step_status = StepStatus.SUCCEEDED
+            step.output_json = jsonable(result)
+            step.ended_at = utc_now()
+            await session.commit()
+            return result
+        except Exception as exc:
+            step.step_status = StepStatus.FAILED
+            step.error_message = str(exc)
+            step.ended_at = utc_now()
+            order.status = OrderStatus.FAILED
+            workflow_run.status = OrderStatus.FAILED
+            await session.commit()
+            raise
+
+
+@activity.defn
+async def prepare_model_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock model preparation for the pipeline."""
+
+    return await execute_asset_step(
+        payload,
+        AssetType.PREPARED_MODEL,
+        extra_metadata={
+            "model_id": payload.model_id,
+            "pose_id": payload.pose_id,
+            "garment_asset_id": payload.garment_asset_id,
+            "scene_ref_asset_id": payload.scene_ref_asset_id,
+        },
+    )
+
+
+@activity.defn
+async def run_tryon_activity(payload: StepActivityInput) -> MockActivityResult:
+    """Mock try-on rendering."""
+
+    return await execute_asset_step(
+        payload,
+        AssetType.TRYON,
+        extra_metadata={"prepared_asset_id": payload.source_asset_id},
+    )