Migrate locale endpoints from platform to nexus service

[Copilot]

Migrates the four project locale CRUD endpoints from the legacy platform service (TypeScript) to the nexus service (Go).

Implementation

OpenAPI Specification (oapi/resources.yml)

• Added locale endpoints under /api/admin/projects/{projectID}/locales
• Locale schema with id, project_id, key, label, timestamps
• CreateLocale schema with key and label fields

Store Layer (internal/store/locales.go)

• CRUD operations with multi-tenant isolation via project_id
• List with pagination using COUNT(*) OVER ()
• Get supports dual-lookup (UUID or key) with optimized query path selection
• Hard delete on removal (no deleted_at column in schema)

Controller Layer (internal/http/controllers/v1/locales.go)

• Project existence validation before all operations
• HTTP 201 for create, 204 for delete, 404 for not found
• Dual-lookup GET: accepts both UUID (/locales/{uuid}) and key (/locales/en)
• DELETE accepts UUID only for safety

Tests (internal/http/controllers/v1/locales_test.go)

• Full CRUD coverage with testcontainers
• Pagination edge cases
• Error scenarios (project not found, locale not found)
• Dual-lookup validation

Query Optimization

// Avoids type conversion overhead by branching on UUID parse
id, err := uuid.Parse(localeID)
if err == nil {
    query = "WHERE project_id = $1 AND id = $2"  // Direct UUID comparison
} else {
    query = "WHERE project_id = $1 AND key = $2"  // String key lookup
}

This prevents id::text conversion on every row during key-based lookups.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Migrate locale endpoints to nexus service</issue_title>
<issue_description>The project locale endpoints in /services/platform/src/projects/ProjectLocaleController.ts have to be migrated to the nexus service. Please follow the style and architecture of the nexus project and include unit tests using test containers for the newly created controller and store if needed.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Migrate locale endpoints to nexus service #77

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

Pull request overview

This PR migrates four locale CRUD endpoints from the legacy TypeScript platform service to the Go-based nexus service. The migration follows nexus project conventions with OpenAPI-first design, separated store/controller layers, hard delete behavior, and comprehensive test coverage including testcontainers.

Key changes:

• OpenAPI schema definitions for Locale and CreateLocale with four endpoints (GET list, POST create, GET by ID, DELETE)
• Store layer with dual-lookup support (UUID or key) and query optimization
• Controller layer with project existence validation and proper HTTP status codes

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
services/nexus/oapi/resources.yml	Added locale endpoints and schemas to OpenAPI specification
services/nexus/oapi/resources_gen.go	Generated Go types and client code from OpenAPI spec
services/nexus/internal/store/locales.go	Implemented locale CRUD operations with dual-lookup GetLocale
services/nexus/internal/store/store.go	Registered LocalesStore in store aggregator
services/nexus/internal/http/controllers/v1/locales.go	Created locale controller with project validation and error handling
services/nexus/internal/http/controllers/v1/locales_test.go	Added comprehensive tests for all locale operations
services/nexus/internal/http/controllers/v1/controller.go	Registered LocalesController in main controller