[CSM Portal] Add deployments search; fix product versions route; remove unused endpoint

[Rashmika998]

Summary

• Adds POST /deployments/search endpoint proxying to the entity service, with DeploymentHandler, entity client method, route registration, OpenAPI schema, and full test coverage
• Renames /product/{id}/versions/search to /products/{id}/versions/search for consistency with other resource routes
• Removes unused GET /updates/recommended-update-levels endpoint and all related types, mapper, client method, tests, and OpenAPI path

Test plan

• go test ./... passes locally
• Pre-push hook ran all backend tests — all green
• Verify POST /deployments/search proxies to entity service and returns deployment list
• Verify filtering by projectIds and deploymentTypeKeys works end-to-end
• Verify POST /products/{id}/versions/search still resolves correctly with the renamed route
• Verify unauthenticated requests return 401
• Verify oversized / invalid JSON bodies return 413 / 400

🤖 Generated with Claude Code

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR adds a new POST /deployments/search endpoint to the CSM Portal backend. The change includes OpenAPI schemas defining request/response structures, an entity client method forwarding search payloads to a downstream service, an HTTP handler enforcing authentication and validation, comprehensive test coverage, and server wiring to register the route.

Changes

Deployment Search Endpoint

Layer / File(s)	Summary
API Contract and Schemas apps/csm-portal/backend/openapi.yaml	OpenAPI definitions for POST /deployments/search endpoint with DeploymentSearchPayload, DeploymentSearchResponse, and Deployment schemas supporting pagination, search queries, and optional filters.
Entity Client Search Method apps/csm-portal/backend/internal/entity/entity.go	New SearchDeployments method on entity client that issues POST request to /deployments/search and returns raw JSON response bytes.
Handler Implementation and Tests apps/csm-portal/backend/internal/handler/deployments.go, apps/csm-portal/backend/internal/handler/deployments_test.go, apps/csm-portal/backend/internal/handler/helpers_test.go	DeploymentHandler with SearchDeployments method enforces authentication via context, applies max request body size limit, validates JSON payload, forwards to entity client, maps upstream errors to HTTP responses, and returns 200 OK. Comprehensive tests cover unauthenticated access, oversized requests, invalid JSON, successful forwarding, and error mapping; mock test helper supports the test suite.
Server Wiring apps/csm-portal/backend/cmd/server/main.go	Initializes DeploymentHandler with entity client and registers POST /deployments/search route on HTTP mux.

Sequence Diagram

sequenceDiagram
  participant Client
  participant SearchDeployments
  participant EntityClient
  Client->>SearchDeployments: POST /deployments/search
  SearchDeployments->>SearchDeployments: Extract user from context
  alt No authenticated user
    SearchDeployments-->>Client: 401 Unauthorized
  end
  SearchDeployments->>SearchDeployments: Read and validate body size
  alt Body too large
    SearchDeployments-->>Client: 413 Request Entity Too Large
  end
  SearchDeployments->>SearchDeployments: Validate JSON format
  alt Invalid JSON
    SearchDeployments-->>Client: 400 Bad Request
  end
  SearchDeployments->>EntityClient: SearchDeployments(body)
  EntityClient-->>SearchDeployments: Response bytes or error
  alt Upstream error
    SearchDeployments-->>Client: Mapped HTTP error status
  else Success
    SearchDeployments-->>Client: 200 OK with JSON response
  end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• wso2-open-operations/cs-tools#445: Adds frontend implementation consuming the POST /deployments/search endpoint and DeploymentSearchPayload structure added in this PR.
• wso2-open-operations/cs-tools#751: Implements the downstream deployment search service and repository that the entity client method in this PR delegates to.

Suggested labels

Type/Improvement, Area/Backend, App/CSM Portal

Suggested reviewers

• cloby99
• kasunsiyambalapitiya

Poem

🐰 A search endpoint hops to life,
Schemas dance, no deployment strife,
Auth guards the gate with careful cheer,
Validations test what we hold dear,
One POST to find them all so clear! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 3

❌ Failed checks (3 warnings)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 33.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check	⚠️ Warning	The title mentions 'Add deployments search' which aligns with the main change, but also references two other unrelated changes ('fix product versions route; remove unused endpoint'), making it overly broad and not focused on the primary objective.	Revise the title to focus on the primary change: 'Add POST /deployments/search endpoint' or similar, and consider addressing the other changes in separate PRs for clarity.
Description check	⚠️ Warning	The PR description is minimal and uses a non-standard format. It provides a summary of changes and test plan but lacks most required template sections including Purpose, Goals, Approach, User stories, Release notes, Documentation, Training, Certification, Marketing, Security checks, Samples, Related PRs, and Migrations.	Use the provided description template to include all required sections: Purpose (with issue links), Goals, Approach, User stories, Release notes, Documentation impact assessment, Training links, Certification status, Marketing content, Automation test details, Security checks, Samples, Related PRs, and any applicable Migrations. At minimum, address Purpose, Goals, Release notes, Documentation, and Security checks.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0