> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Contratos de fuentes de datos y de vistas previas en Reporter

> Ahora están documentados el ciclo de vida de las fuentes de datos de Reporter, la paginación de informes, el cifrado de credenciales y la capacidad de vista previa de plantillas.

<Badge stroke icon="calendar-days" iconType="regular">25 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Corrección de documentación</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Acción requerida</Badge>

## Afecta a

***

Equipos que gestionan fuentes de datos de Reporter, paginan listas de informes o renderizan vistas previas de plantillas.

## Qué cambió

***

Reporter gestiona a través de la API un registro persistente de fuentes de datos de PostgreSQL y MongoDB. Las contraseñas son de solo escritura y se cifran en reposo con `DATASOURCE_CRED_ENC_KEY`; las plantillas activas impiden que se elimine una fuente de datos referenciada. Los despliegues single-tenant pueden precargar entradas en el arranque, mientras que los despliegues multi-tenant las crean a través de la API.

Las listas de informes usan paginación por keyset con `nextCursor` y `prevCursor`. Las vistas previas de plantillas tienen un límite de concurrencia síncrona controlado por `PREVIEW_MAX_CONCURRENT` (predeterminado `4`); la capacidad agotada devuelve HTTP `429` con `RPT-0108`, y un rechazo de renderizado devuelve `RPT-0107`.

Esto corrige la documentación de contratos ya implementados. No anuncia un lanzamiento del runtime.

## Impacto

***

**Clasificación: Acción requerida.** La automatización de fuentes de datos, la gestión de secretos, la paginación de informes y el manejo de reintentos de vista previa existentes pueden depender de suposiciones retiradas.

## Qué debes hacer

***

<Steps>
  <Step>Define una única clave `DATASOURCE_CRED_ENC_KEY` válida y persistente para cada runtime de Reporter que lea el registro.</Step>
  <Step>Usa el ciclo de vida de la API de fuentes de datos y prevé el rechazo del borrado lógico mientras plantillas activas referencien una fuente.</Step>
  <Step>Sigue `nextCursor` y `prevCursor` para las listas de informes en lugar de usar números de página.</Step>
  <Step>Trata `RPT-0107` como un rechazo de renderizado y reintenta `RPT-0108` después de que haya capacidad disponible.</Step>
</Steps>

### Plazo

Revisa antes de desplegar clientes de Reporter o de cambiar la configuración de fuentes de datos.