feat: add manual revision and dashboard list apis

app/api/schemas/asset.py

@@ -17,7 +17,10 @@ class AssetRead(BaseModel):
     order_id: int
     asset_type: AssetType
     step_name: WorkflowStepName | None
+    parent_asset_id: int | None = None
+    root_asset_id: int | None = None
+    version_no: int = 0
+    is_current_version: bool = False
     uri: str
     metadata_json: dict[str, Any] | None
     created_at: datetime
-

app/api/schemas/order.py

@@ -5,7 +5,7 @@ from datetime import datetime
 from pydantic import BaseModel
 
 from app.api.schemas.asset import AssetRead
-from app.domain.enums import CustomerLevel, OrderStatus, ServiceMode, WorkflowStepName
+from app.domain.enums import CustomerLevel, OrderStatus, ReviewTaskStatus, ServiceMode, WorkflowStepName
 
 
 class CreateOrderRequest(BaseModel):
@@ -41,7 +41,41 @@ class OrderDetailResponse(BaseModel):
     final_asset_id: int | None
     workflow_id: str | None
     current_step: WorkflowStepName | None
+    current_revision_asset_id: int | None = None
+    current_revision_version: int | None = None
+    latest_revision_asset_id: int | None = None
+    latest_revision_version: int | None = None
+    revision_count: int = 0
+    review_task_status: ReviewTaskStatus | None = None
+    pending_manual_confirm: bool = False
     final_asset: AssetRead | None
     created_at: datetime
     updated_at: datetime
 
+
+class OrderListItemResponse(BaseModel):
+    """Order list item response for overview screens."""
+
+    order_id: int
+    workflow_id: str | None
+    customer_level: CustomerLevel
+    service_mode: ServiceMode
+    status: OrderStatus
+    current_step: WorkflowStepName | None
+    updated_at: datetime
+    final_asset_id: int | None
+    review_task_status: ReviewTaskStatus | None = None
+    latest_revision_asset_id: int | None = None
+    latest_revision_version: int | None = None
+    revision_count: int = 0
+    pending_manual_confirm: bool = False
+
+
+class OrderListResponse(BaseModel):
+    """Order list response."""
+
+    page: int
+    limit: int
+    total: int
+    total_pages: int
+    items: list[OrderListItemResponse]

app/api/schemas/review.py

@@ -4,7 +4,7 @@ from datetime import datetime
 
 from pydantic import BaseModel
 
-from app.domain.enums import ReviewDecision, WorkflowStepName
+from app.domain.enums import ReviewDecision, ReviewTaskStatus, WorkflowStepName
 
 
 class SubmitReviewRequest(BaseModel):
@@ -32,5 +32,10 @@ class PendingReviewResponse(BaseModel):
     order_id: int
     workflow_id: str
     current_step: WorkflowStepName | None
+    review_task_status: ReviewTaskStatus = ReviewTaskStatus.PENDING
+    latest_revision_asset_id: int | None = None
+    current_revision_asset_id: int | None = None
+    latest_revision_version: int | None = None
+    revision_count: int = 0
+    pending_manual_confirm: bool = False
     created_at: datetime
-

app/api/schemas/revision.py

@@ -0,0 +1,69 @@
+"""Revision API schemas."""
+
+from datetime import datetime
+
+from pydantic import BaseModel
+
+from app.domain.enums import ReviewDecision, ReviewTaskStatus
+
+
+class RegisterRevisionRequest(BaseModel):
+    """Request payload for registering a manual revision asset."""
+
+    parent_asset_id: int
+    uploaded_uri: str
+    reviewer_id: int
+    comment: str | None = None
+
+
+class RegisterRevisionResponse(BaseModel):
+    """Response returned after a manual revision has been registered."""
+
+    order_id: int
+    workflow_id: str
+    asset_id: int
+    parent_asset_id: int
+    root_asset_id: int
+    version_no: int
+    review_task_status: ReviewTaskStatus
+    latest_revision_asset_id: int
+    revision_count: int
+
+
+class RevisionChainItem(BaseModel):
+    """One item in the manual revision chain."""
+
+    asset_id: int
+    order_id: int
+    parent_asset_id: int | None
+    root_asset_id: int | None
+    version_no: int
+    is_current_version: bool
+    uri: str
+    created_at: datetime
+
+
+class RevisionChainResponse(BaseModel):
+    """Response returned when listing a revision chain."""
+
+    order_id: int
+    latest_revision_asset_id: int | None = None
+    revision_count: int = 0
+    items: list[RevisionChainItem]
+
+
+class ConfirmRevisionRequest(BaseModel):
+    """Request payload for confirming a manual revision."""
+
+    reviewer_id: int
+    comment: str | None = None
+
+
+class ConfirmRevisionResponse(BaseModel):
+    """Response returned after confirming a manual revision."""
+
+    order_id: int
+    workflow_id: str
+    revision_asset_id: int
+    decision: ReviewDecision
+    status: str

app/api/schemas/workflow.py

@@ -5,7 +5,7 @@ from typing import Any
 
 from pydantic import BaseModel, ConfigDict
 
-from app.domain.enums import OrderStatus, StepStatus, WorkflowStepName
+from app.domain.enums import OrderStatus, ReviewTaskStatus, StepStatus, WorkflowStepName
 
 
 class WorkflowStepRead(BaseModel):
@@ -32,7 +32,40 @@ class WorkflowStatusResponse(BaseModel):
     workflow_type: str
     workflow_status: OrderStatus
     current_step: WorkflowStepName | None
+    current_revision_asset_id: int | None = None
+    current_revision_version: int | None = None
+    latest_revision_asset_id: int | None = None
+    latest_revision_version: int | None = None
+    revision_count: int = 0
+    review_task_status: ReviewTaskStatus | None = None
+    pending_manual_confirm: bool = False
     steps: list[WorkflowStepRead]
     created_at: datetime
     updated_at: datetime
 
+
+class WorkflowListItemResponse(BaseModel):
+    """Workflow list item response for workflow home screens."""
+
+    order_id: int
+    workflow_id: str
+    workflow_type: str
+    workflow_status: OrderStatus
+    current_step: WorkflowStepName | None
+    updated_at: datetime
+    failure_count: int
+    review_task_status: ReviewTaskStatus | None = None
+    latest_revision_asset_id: int | None = None
+    latest_revision_version: int | None = None
+    revision_count: int = 0
+    pending_manual_confirm: bool = False
+
+
+class WorkflowListResponse(BaseModel):
+    """Workflow list response."""
+
+    page: int
+    limit: int
+    total: int
+    total_pages: int
+    items: list[WorkflowListItemResponse]