SuggestionAliasController

Kind: Controller

Source: atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts

Flat alias routes (/suggestions/...) for clients keyed by suggestionId alone — the web app's api-client adapter (apps/web/src/lib/api-client.ts) and the

SuggestionAliasController exposes flat /suggestions/... routes for clients that identify suggestions directly by suggestionId. It acts as a compatibility-oriented HTTP layer—used by the web API client adapter—and delegates suggestion operations to the existing suggestion domain/service logic rather than duplicating business rules.

Diagram

mermaid
graph LR
  Web[Web app API client adapter] -->|HTTP /suggestions/:suggestionId/...| Controller[SuggestionAliasController]
  Controller -->|delegates request| Service[Suggestion service / domain logic]
  Service --> Repository[Suggestion persistence]
  Repository --> DB[(Database)]

Usage

ts
// apps/web/src/lib/api-client.ts

export async function getSuggestion(suggestionId: string) {
  const response = await fetch(`/suggestions/${suggestionId}`, {
    method: 'GET',
    headers: {
      Accept: 'application/json',
    },
  });

  if (!response.ok) {
    throw new Error(`Unable to load suggestion ${suggestionId}`);
  }

  return response.json();
}

// Usage from the web application
const suggestion = await getSuggestion('suggestion_123');
console.log(suggestion);

AI Coding Instructions

• Keep alias routes flat and keyed by suggestionId, following the /suggestions/:suggestionId/... convention expected by the web API client adapter.
• Delegate request handling to the existing suggestion service or controller logic; do not duplicate validation, authorization, or business rules in alias endpoints.
• Preserve request and response DTO shapes used by the canonical suggestion API so clients can use alias routes without special-case parsing.
• Update apps/web/src/lib/api-client.ts whenever alias route paths, HTTP methods, or response contracts change.
• Validate and authorize access to the resolved suggestion before performing actions; a flat route must not bypass parent-resource access checks.

Relationships

• MODULE_DECLARES → list
• MODULE_DECLARES → create
• MODULE_DECLARES → accept
• MODULE_DECLARES → reject
• MODULE_DECLARES → delete
• MODULE_DECLARES → getById
• DEPENDS_ON → SuggestionService

Referenced By

• SuggestionModule (MODULE_DECLARES)