Afeta
Equipes que gerenciam fontes de dados do Reporter, paginam listas de relatórios ou renderizam previews de template.
O que mudou
O Reporter gerencia pela API um registro persistido de fontes de dados PostgreSQL e MongoDB. As senhas são apenas escrita e criptografadas em repouso com
DATASOURCE_CRED_ENC_KEY; templates ativos impedem que uma fonte de dados referenciada seja excluída. Deploys single-tenant podem popular entradas na inicialização, enquanto deploys multi-tenant as criam pela API.
As listas de relatórios usam paginação por keyset com nextCursor e prevCursor. Os previews de template têm um limite de concorrência síncrona controlado por PREVIEW_MAX_CONCURRENT (padrão 4); capacidade esgotada retorna HTTP 429 com RPT-0108, e uma recusa de renderização retorna RPT-0107.
Isto corrige a documentação de contratos implementados. Não anuncia um release de runtime.
Impacto
Classificação: Ação necessária. A automação de fontes de dados existente, o gerenciamento de segredos, a paginação de relatórios e o tratamento de nova tentativa de preview podem depender de suposições descontinuadas.
O que você precisa fazer
1
Defina uma
DATASOURCE_CRED_ENC_KEY válida e persistente para cada runtime do Reporter que lê o registro.2
Use o ciclo de vida da API de fontes de dados e considere a recusa de soft delete enquanto templates ativos referenciarem uma fonte.
3
Siga
nextCursor e prevCursor nas listas de relatórios em vez de usar números de página.4
Trate
RPT-0107 como uma recusa de renderização e tente RPT-0108 novamente depois que houver capacidade disponível.