refactor(BA-5979): split deployment search into admin and scoped layers

Restructures the deployment search/projection stack so every layer
(db_source → repository → service → processor → adapter → REST/GQL/SDK/CLI)
makes the search scope explicit:

- Admin-only search: ``DeploymentAdminRepository``/``DeploymentAdminService``
  with ``admin_search_deployments`` at every level. The DBSource side
  carries the prefix too so the unscoped intent is visible alongside
  the scoped ``search_user_deployments`` / ``search_project_deployments``
  variants in the same namespace.
- User/project search: dedicated actions (``SearchUserDeploymentsAction``,
  ``SearchProjectDeploymentsAction``) with their own RBAC scope. The v2
  adapter's ``my_search`` / ``project_search`` now route through these.
- Project summary: ``SearchProjectDeploymentSummaryAction`` for the
  lightweight project-admin list view (renamed from
  ``SearchDeploymentsInProject``).

EndpointRow → ModelDeploymentData projection moves onto the row as
``EndpointRow.to_model_deployment_data()``, following the existing
``to_deployment_info`` shape and the BA-6056 relationship split: the
projection reads ``current_revision_row`` / ``deploying_revision_row``
directly instead of scanning a ``revisions`` list. The fragile
``DeploymentInfo``-via-helper path (``_convert_deployment_info_to_data``)
disappears together with its placeholder defaults; service callers now
fetch ``ModelDeploymentData`` straight from the repository.

API surface:

- v1 REST: ``POST /deployments/search`` contract preserved; a new
  ``SearchLegacyDeploymentsRequest`` (standalone, not a subclass) carries
  the ``project_id`` inline on the body, and the handler routes through
  ``SearchProjectDeploymentsAction``. v1 SDK, ``./bai`` CLI, and
  ``client/func`` migrate to the new request type.
- v2 REST/GQL: ``SearchDeploymentsInput`` / ``SearchDeploymentsPayload``
  (neutral names, no admin prefix) are shared by admin / project / my
  variants — mirrors the vfolder / model_card / user / session v2
  convention. Admin and scope variants only differ in URL + middleware.
- GraphQL ``deployment_loader`` keeps the unscoped batch lookup it was
  born with, now routed through ``admin_search_deployments`` rather
  than the legacy slot — parent resolvers stay responsible for RBAC.

Tests:

- ``tests/unit/manager/repositories/deployment/test_endpoint_projection.py``
  pins the new ``EndpointRow.to_model_deployment_data`` against the
  ``current_revision_row`` relationship (replaces the BA-5963 list-order
  regression test, which is structurally impossible under the new lookup).
- v1 component / unit / SDK tests migrate to ``SearchLegacyDeploymentsRequest``.
- Existing ``SearchProjectDeploymentSummary`` action becomes
  ``@dataclass(frozen=True)`` to match the rest of the search-action set.

Co-Authored-By: Gyubong <gbl@lablup.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jopemachine

changes/11522.enhance.md

@@ -0,0 +1 @@
+Project ``EndpointRow`` directly to ``ModelDeploymentData`` for the API path so deployment responses no longer pass through a fragile ``DeploymentInfo`` conversion, and split no-scope deployment reads into a dedicated admin repository/service/processor.

src/ai/backend/client/cli/deployment.py

@@ -93,31 +93,28 @@ def create_deployment_cmd(
 
 @deployment.command("list")
 @pass_ctx_obj
-@click.option("--project-id", type=str, default=None, help="Filter by project ID")
+@click.option("--project-id", type=str, required=True, help="Project ID to search within")
 @click.option("--limit", type=int, default=50, help="Maximum items to return")
 @click.option("--offset", type=int, default=0, help="Number of items to skip")
 def list_deployments_cmd(
     ctx: CLIContext,
-    project_id: str | None,
+    project_id: str,
     limit: int,
     offset: int,
 ) -> None:
-    """List all deployments."""
+    """List deployments within a project."""
     from uuid import UUID
 
     from ai.backend.client.session import Session
-    from ai.backend.common.dto.manager.deployment import (
-        DeploymentFilter,
-        SearchDeploymentsRequest,
-    )
+    from ai.backend.common.dto.manager.deployment import SearchLegacyDeploymentsRequest
 
     with Session() as session:
         try:
-            filter_cond = None
-            if project_id:
-                filter_cond = DeploymentFilter(project_id=UUID(project_id))
-
-            request = SearchDeploymentsRequest(filter=filter_cond, limit=limit, offset=offset)
+            request = SearchLegacyDeploymentsRequest(
+                project_id=UUID(project_id),
+                limit=limit,
+                offset=offset,
+            )
             result = session.Deployment.search(request)
 
             deployments = result.deployments

src/ai/backend/client/cli/v2/admin/deployment.py

@@ -62,10 +62,10 @@ def search(
     """Search all deployments (admin)."""
     from ai.backend.common.dto.manager.query import StringFilter
     from ai.backend.common.dto.manager.v2.deployment.request import (
-        AdminSearchDeploymentsInput,
         DeploymentFilter,
         DeploymentOrder,
         DeploymentStatusFilter,
+        SearchDeploymentsInput,
     )
     from ai.backend.common.dto.manager.v2.deployment.types import DeploymentOrderField
 
@@ -99,7 +99,7 @@ async def _run() -> None:
         registry = await create_v2_registry(load_v2_config())
         try:
             result = await registry.deployment.admin_search(
-                AdminSearchDeploymentsInput(
+                SearchDeploymentsInput(
                     filter=filter_dto,
                     order=orders,
                     limit=limit,

src/ai/backend/client/cli/v2/deployment/commands.py

@@ -50,10 +50,10 @@ def project_search(
 
     from ai.backend.common.dto.manager.query import StringFilter
     from ai.backend.common.dto.manager.v2.deployment.request import (
-        AdminSearchDeploymentsInput,
         DeploymentFilter,
         DeploymentOrder,
         DeploymentStatusFilter,
+        SearchDeploymentsInput,
     )
     from ai.backend.common.dto.manager.v2.deployment.types import DeploymentOrderField
 
@@ -79,7 +79,7 @@ def project_search(
             )
         orders = parsed
 
-    body = AdminSearchDeploymentsInput(
+    body = SearchDeploymentsInput(
         filter=filter_dto,
         order=orders,
         limit=limit,

src/ai/backend/client/cli/v2/my/deployment.py

@@ -41,9 +41,9 @@ def search(
 
     from ai.backend.common.dto.manager.query import StringFilter
     from ai.backend.common.dto.manager.v2.deployment.request import (
-        AdminSearchDeploymentsInput,
         DeploymentFilter,
         DeploymentStatusFilter,
+        SearchDeploymentsInput,
     )
 
     filter_dto: DeploymentFilter | None = None
@@ -56,7 +56,7 @@ def search(
     async def _run() -> None:
         registry = await create_v2_registry(load_v2_config())
         try:
-            request = AdminSearchDeploymentsInput(
+            request = SearchDeploymentsInput(
                 filter=filter_dto,
                 first=first,
                 after=after,

src/ai/backend/client/func/deployment.py

@@ -17,7 +17,7 @@
     ListDeploymentsResponse,
     ListRevisionsResponse,
     ListRoutesResponse,
-    SearchDeploymentsRequest,
+    SearchLegacyDeploymentsRequest,
     SearchRevisionsRequest,
     SearchRoutesRequest,
     UpdateDeploymentRequest,
@@ -58,9 +58,9 @@ async def create(
     @classmethod
     async def search(
         cls,
-        request: SearchDeploymentsRequest,
+        request: SearchLegacyDeploymentsRequest,
     ) -> ListDeploymentsResponse:
-        """Search deployments with filters."""
+        """Search deployments within a project."""
         rqst = Request("POST", "/deployments/search")
         rqst.set_json(request.model_dump(mode="json"))
         async with rqst.fetch() as resp:

src/ai/backend/client/v2/domains/deployment.py

@@ -19,7 +19,7 @@
     ListRevisionsResponse,
     ListRoutesResponse,
     SearchDeploymentPoliciesRequest,
-    SearchDeploymentsRequest,
+    SearchLegacyDeploymentsRequest,
     SearchRevisionsRequest,
     SearchRoutesRequest,
     UpdateDeploymentRequest,
@@ -51,7 +51,7 @@ async def create_deployment(
 
     async def search_deployments(
         self,
-        request: SearchDeploymentsRequest,
+        request: SearchLegacyDeploymentsRequest,
     ) -> ListDeploymentsResponse:
         return await self._client.typed_request(
             "POST",

src/ai/backend/client/v2/domains_v2/deployment.py

@@ -14,7 +14,6 @@
 from ai.backend.common.dto.manager.v2.deployment.request import (
     ActivateRevisionInput,
     AddRevisionInput,
-    AdminSearchDeploymentsInput,
     AdminSearchRevisionsInput,
     BulkDeleteAccessTokensInput,
     CreateAccessTokenInput,
@@ -25,6 +24,7 @@
     SearchAccessTokensInput,
     SearchAutoScalingRulesInput,
     SearchDeploymentPoliciesInput,
+    SearchDeploymentsInput,
     SearchReplicasInput,
     SearchRoutesInput,
     SyncReplicaInput,
@@ -36,7 +36,6 @@
     ActivateRevisionPayload,
     AddRevisionPayload,
     AdminRefreshDeploymentRevisionsPayload,
-    AdminSearchDeploymentsPayload,
     AdminSearchRevisionsPayload,
     BulkDeleteAccessTokensPayload,
     BulkDeleteAutoScalingRulesPayload,
@@ -56,6 +55,7 @@
     SearchAccessTokensPayload,
     SearchAutoScalingRulesPayload,
     SearchDeploymentPoliciesPayload,
+    SearchDeploymentsPayload,
     SearchReplicasPayload,
     SearchRoutesPayload,
     SyncReplicaPayload,
@@ -91,39 +91,39 @@ async def create(
 
     async def admin_search(
         self,
-        body: AdminSearchDeploymentsInput,
-    ) -> AdminSearchDeploymentsPayload:
+        body: SearchDeploymentsInput,
+    ) -> SearchDeploymentsPayload:
         """Search deployments with admin scope (superadmin only)."""
         return await self._client.typed_request(
             "POST",
             _PATH + "/search",
             request=body,
-            response_model=AdminSearchDeploymentsPayload,
+            response_model=SearchDeploymentsPayload,
         )
 
     async def my_search(
         self,
-        body: AdminSearchDeploymentsInput,
-    ) -> AdminSearchDeploymentsPayload:
+        body: SearchDeploymentsInput,
+    ) -> SearchDeploymentsPayload:
         """Search deployments owned by the current user."""
         return await self._client.typed_request(
             "POST",
             f"{_PATH}/my/search",
             request=body,
-            response_model=AdminSearchDeploymentsPayload,
+            response_model=SearchDeploymentsPayload,
         )
 
     async def project_search(
         self,
         project_id: UUID,
-        body: AdminSearchDeploymentsInput,
-    ) -> AdminSearchDeploymentsPayload:
+        body: SearchDeploymentsInput,
+    ) -> SearchDeploymentsPayload:
         """Search deployments within a specific project."""
         return await self._client.typed_request(
             "POST",
             f"{_PATH}/projects/{project_id}/search",
             request=body,
-            response_model=AdminSearchDeploymentsPayload,
+            response_model=SearchDeploymentsPayload,
         )
 
     async def get(

src/ai/backend/common/data/model_deployment/types.py

@@ -1,5 +1,6 @@
 from typing import Any, Self
 
+from ai.backend.common.data.endpoint.types import EndpointLifecycle
 from ai.backend.common.types import CIStrEnum
 
 
@@ -48,6 +49,20 @@ def _missing_(cls, value: Any) -> Self | None:
                 return cls(alias)
         return super()._missing_(value)
 
+    @classmethod
+    def from_lifecycle(cls, lifecycle: EndpointLifecycle) -> "ModelDeploymentStatus":
+        match lifecycle:
+            case EndpointLifecycle.PENDING | EndpointLifecycle.CREATED:
+                return cls.PENDING
+            case EndpointLifecycle.READY | EndpointLifecycle.SCALING:
+                return cls.READY
+            case EndpointLifecycle.DEPLOYING:
+                return cls.DEPLOYING
+            case EndpointLifecycle.DESTROYING:
+                return cls.STOPPING
+            case EndpointLifecycle.DESTROYED:
+                return cls.STOPPED
+
 
 class DeploymentStrategy(CIStrEnum):
     ROLLING = "ROLLING"

src/ai/backend/common/dto/manager/deployment/__init__.py

@@ -28,7 +28,7 @@
     RouteFilter,
     RoutePathParam,
     SearchDeploymentPoliciesRequest,
-    SearchDeploymentsRequest,
+    SearchLegacyDeploymentsRequest,
     SearchRevisionsRequest,
     SearchRoutesRequest,
     UpdateDeploymentRequest,
@@ -90,11 +90,12 @@
     # Request DTOs - Path params
     "DeploymentPathParam",
     "DeploymentPolicyPathParam",
+    "DeploymentProjectSearchPathParam",
     "RevisionPathParam",
     "RoutePathParam",
     # Request DTOs - Search/List
     "SearchDeploymentPoliciesRequest",
-    "SearchDeploymentsRequest",
+    "SearchLegacyDeploymentsRequest",
     "SearchRevisionsRequest",
     "SearchRoutesRequest",
     # Request DTOs - Create inputs