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
1
Define una única clave
DATASOURCE_CRED_ENC_KEY válida y persistente para cada runtime de Reporter que lea el registro.2
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.
3
Sigue
nextCursor y prevCursor para las listas de informes en lugar de usar números de página.4
Trata
RPT-0107 como un rechazo de renderizado y reintenta RPT-0108 después de que haya capacidad disponible.
