feat: add manual revision and dashboard list apis

app/api/routers/orders.py

@@ -1,10 +1,16 @@
 """Order routes."""
 
-from fastapi import APIRouter, Depends, status
+from fastapi import APIRouter, Depends, Query, status
 from sqlalchemy.ext.asyncio import AsyncSession
 
-from app.api.schemas.order import CreateOrderRequest, CreateOrderResponse, OrderDetailResponse
+from app.api.schemas.order import (
+    CreateOrderRequest,
+    CreateOrderResponse,
+    OrderDetailResponse,
+    OrderListResponse,
+)
 from app.application.services.order_service import OrderService
+from app.domain.enums import OrderStatus
 from app.infra.db.session import get_db_session
 
 router = APIRouter(prefix="/orders", tags=["orders"])
@@ -21,6 +27,27 @@ async def create_order(
     return await order_service.create_order(session, payload)
 
 
+@router.get("", response_model=OrderListResponse)
+async def list_orders(
+    page: int = Query(default=1, ge=1),
+    limit: int = Query(default=20, ge=1, le=100),
+    query: str | None = Query(default=None, min_length=1),
+    status_filter: OrderStatus | None = Query(default=None, alias="status"),
+    order_id: int | None = Query(default=None, ge=1),
+    session: AsyncSession = Depends(get_db_session),
+) -> OrderListResponse:
+    """Fetch recent orders for dashboard overview pages."""
+
+    return await order_service.list_orders(
+        session,
+        page=page,
+        limit=limit,
+        query=query,
+        status_filter=status_filter,
+        order_id=order_id,
+    )
+
+
 @router.get("/{order_id}", response_model=OrderDetailResponse)
 async def get_order(
     order_id: int,
@@ -29,4 +56,3 @@ async def get_order(
     """Fetch order details."""
 
     return await order_service.get_order(session, order_id)
-

app/api/routers/reviews.py

@@ -3,6 +3,7 @@
 from fastapi import APIRouter, Depends
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from app.api.schemas.revision import ConfirmRevisionRequest, ConfirmRevisionResponse
 from app.api.schemas.review import PendingReviewResponse, SubmitReviewRequest, SubmitReviewResponse
 from app.application.services.review_service import ReviewService
 from app.infra.db.session import get_db_session
@@ -30,3 +31,13 @@ async def submit_review(
 
     return await review_service.submit_review(session, order_id, payload)
 
+
+@router.post("/{order_id}/confirm-revision", response_model=ConfirmRevisionResponse)
+async def confirm_revision(
+    order_id: int,
+    payload: ConfirmRevisionRequest,
+    session: AsyncSession = Depends(get_db_session),
+) -> ConfirmRevisionResponse:
+    """Confirm a manual revision and resume the workflow."""
+
+    return await review_service.confirm_revision_continue(session, order_id, payload)

app/api/routers/revisions.py

@@ -0,0 +1,40 @@
+"""Manual revision routes."""
+
+from fastapi import APIRouter, Depends, status
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.schemas.revision import (
+    RegisterRevisionRequest,
+    RegisterRevisionResponse,
+    RevisionChainResponse,
+)
+from app.application.services.revision_service import RevisionService
+from app.infra.db.session import get_db_session
+
+router = APIRouter(prefix="/orders", tags=["revisions"])
+revision_service = RevisionService()
+
+
+@router.post(
+    "/{order_id}/revisions",
+    response_model=RegisterRevisionResponse,
+    status_code=status.HTTP_201_CREATED,
+)
+async def register_revision(
+    order_id: int,
+    payload: RegisterRevisionRequest,
+    session: AsyncSession = Depends(get_db_session),
+) -> RegisterRevisionResponse:
+    """Register an offline manual revision asset for an order."""
+
+    return await revision_service.register_revision(session, order_id, payload)
+
+
+@router.get("/{order_id}/revisions", response_model=RevisionChainResponse)
+async def list_revisions(
+    order_id: int,
+    session: AsyncSession = Depends(get_db_session),
+) -> RevisionChainResponse:
+    """List the single-line manual revision chain for an order."""
+
+    return await revision_service.list_revision_chain(session, order_id)

app/api/routers/workflows.py

@@ -1,16 +1,38 @@
 """Workflow routes."""
 
-from fastapi import APIRouter, Depends
+from fastapi import APIRouter, Depends, Query
 from sqlalchemy.ext.asyncio import AsyncSession
 
-from app.api.schemas.workflow import WorkflowStatusResponse
+from app.api.schemas.workflow import WorkflowListResponse, WorkflowStatusResponse
 from app.application.services.workflow_service import WorkflowService
+from app.domain.enums import OrderStatus
 from app.infra.db.session import get_db_session
 
 router = APIRouter(prefix="/workflows", tags=["workflows"])
 workflow_service = WorkflowService()
 
 
+@router.get("", response_model=WorkflowListResponse)
+async def list_workflows(
+    page: int = Query(default=1, ge=1),
+    limit: int = Query(default=20, ge=1, le=100),
+    query: str | None = Query(default=None, min_length=1),
+    status_filter: OrderStatus | None = Query(default=None, alias="status"),
+    order_id: int | None = Query(default=None, ge=1),
+    session: AsyncSession = Depends(get_db_session),
+) -> WorkflowListResponse:
+    """Fetch recent workflow runs for workflow lookup pages."""
+
+    return await workflow_service.list_workflows(
+        session,
+        page=page,
+        limit=limit,
+        query=query,
+        status_filter=status_filter,
+        order_id=order_id,
+    )
+
+
 @router.get("/{order_id}", response_model=WorkflowStatusResponse)
 async def get_workflow_status(
     order_id: int,
@@ -19,4 +41,3 @@ async def get_workflow_status(
     """Fetch persisted workflow status for an order."""
 
     return await workflow_service.get_workflow_status(session, order_id)
-