​

AI (Anthropic)

​

Configuracion

​

Servicio

generateText(options: {
  systemPrompt: string
  userPrompt: string
  model?: string        // default: claude-sonnet-4-20250514
  maxTokens?: number    // default: 1024
  temperature?: number  // default: 0.3
}): Promise<{
  text: string
  model: string
  inputTokens: number
  outputTokens: number
} | null>

​

Survey Insights

​

Tabla survey_insights

​

Cache e invalidacion

• Los insights se cachean en la tabla survey_insights
• Se invalidan automaticamente cuando total_responses actual difiere del cacheado (nuevas respuestas)
• La regeneracion es fire-and-forget (no bloquea el request del usuario)
• Deduplicacion de requests en vuelo (prevencion de thundering herd)

​

Rate limiting

• Maximo 3 generaciones por dia por combinacion survey_id + scope_type + scope_id + section
• Cuando se alcanza el limite, se sirve el cache existente (aunque sea stale)
• El contador se resetea diariamente

​

Prompts

• Distribucion de respuestas por pregunta
• Tendencias y patrones
• Recomendaciones accionables

​

Estructura de modulo

apps/backend/src/shared/ai/
  ai.module.ts          # Global module
  ai.service.ts         # Anthropic SDK wrapper
  ai.types.ts           # TypeScript interfaces

apps/backend/src/surveys/insights/
  survey-insights.service.ts   # Cache, rate limiting, insight generation