Technologies sort fix for the category overview + versions data

[max-ostapenko]

Filtering functionality improvements in /categories

• Implemented filtering by client ('mobile') in queries to allow retrieving categories data specific to the client type.

Dependent on adjusted report pre-aggregation: HTTPArchive/dataform#120

Example: https://reports-dev-2vzgiib6.uc.gateway.dev/v1/categories?category=CMS&client=desktop (sampled data in dev DB)

Resolves: HTTPArchive/httparchive.org#1081

Added versions data (currently available on dev endpoints only)

• /version endpoint, see readme

Example: https://reports-dev-2vzgiib6.uc.gateway.dev/v1/adoption?technology=WordPress&geo=ALL&rank=ALL&version=6.8

• All the reports can be filtered using version query parameter, example

version (optional): Filter by version name(s) - comma-separated list (only when single technology is specified)

[Copilot]

Pull request overview

This PR implements two major improvements to the Tech Report APIs: (1) adding client-based filtering to the categories endpoint and (2) introducing version filtering capabilities across all report endpoints. The changes also include a significant infrastructure migration from Google Cloud Functions to Cloud Run with containerization.

Key changes:

• Adds client parameter filtering (mobile/desktop) to /v1/categories endpoint
• Implements /v1/versions endpoint and adds version filtering to all report endpoints (adoption, CWV, lighthouse, page-weight, audits)
• Migrates infrastructure from Cloud Functions to Cloud Run using Docker containers

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
terraform/prod/main.tf	Refactors infrastructure to use modularized API Gateway and Cloud Run service, adds Docker provider configuration
terraform/prod/local.auto.tfvars.template	Removes template file (configuration moved elsewhere)
terraform/modules/run-service/variables.tf	Updates variables for Cloud Run migration, renames function_name to service_name, changes memory/timeout types
terraform/modules/run-service/outputs.tf	Updates output to reference Cloud Run service instead of Cloud Function
terraform/modules/run-service/main.tf	Replaces Cloud Functions deployment with Docker-based Cloud Run service deployment
terraform/modules/api-gateway/variables.tf	Adds spec_yaml variable and default values for better module reusability
terraform/modules/api-gateway/main.tf	Modularizes API Gateway configuration to accept spec_yaml as parameter
terraform/dev/variables.tf	Updates default database from prod to dev environment
terraform/dev/main.tf	Refactors infrastructure similar to prod, adds /v1/versions endpoint to OpenAPI spec
terraform/dev/local.auto.tfvars.template	Removes template file (configuration moved elsewhere)
src/package.json	Adds Docker build and run scripts for local development
src/controllers/technologiesController.js	Updates cache key to include technology and category filters for proper cache invalidation
src/controllers/reportController.js	Implements version filtering for all report types with single-technology constraint
src/controllers/categoriesController.js	Adds client parameter filtering and updates cache key data
src/tests/routes.test.js	Adds test for version parameter on adoption endpoint
src/Dockerfile	Creates containerized deployment configuration for Cloud Run
src/.dockerignore	Defines files to exclude from Docker build context
README.md	Documents new client and version parameters across multiple endpoints

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The provider name is incorrect. The docker provider is being configured but the source points to hashicorp/google-beta which is the Google Beta provider. This should be source = "kreuzwerker/docker" to match the provider configuration used in the prod and dev main.tf files.

Suggested change

	source = "hashicorp/google-beta"
	source = "kreuzwerker/docker"

[Copilot]

The fallback value || ['category', 'description', 'technologies', 'origins'] after params.fields.split(',').map(f => f.trim()) will never be used. The split() method always returns an array, even if the string is empty. If the intention is to provide default fields, the check should happen before the split operation: params.fields ? params.fields.split(',').map(f => f.trim()) : ['category', 'description', 'technologies', 'origins']

Suggested change

	const requestedFields = params.fields.split(',').map(f => f.trim()) || ['category', 'description', 'technologies', 'origins'];
	const requestedFields = params.fields ? params.fields.split(',').map(f => f.trim()) : ['category', 'description', 'technologies', 'origins'];

[Copilot]

The hardcoded ENV DATABASE=tech-report-api-prod in the Dockerfile means the dev environment will incorrectly use the production database. This should be parameterized or passed at runtime via the Cloud Run service configuration. The dev environment should use tech-report-api-dev as specified in terraform/dev/variables.tf.

Suggested change

ENV DATABASE=tech-report-api-prod

[Copilot]

The production OpenAPI specification is missing the /v1/versions endpoint that was added to the dev environment. This endpoint should be added to ensure consistency between dev and prod environments.

Suggested change

	description: String
	description: String
	/v1/versions:
	get:
	summary: versions
	operationId: getVersions
	responses:
	200:
	description: String