Ir para o conteúdo

Nível de serviço

Esta é uma declaração breve e honesta do que o IRIS pretende entregar. Ela é intencionalmente modesta: o IRIS é um serviço de máquina única com onboarding manual do operador, não uma plataforma gerenciada redundante. Preferimos prometer menos e cumprir do que publicar um compromisso que o deployment não consegue honrar.

Disponibilidade — máquina única, melhor esforço

O IRIS roda em uma única máquina. Não há alta disponibilidade ou redundância, e o setup de máquina única é um ponto único de falha (SPOF) que é explicitamente aceito neste estágio. Consequentemente:

  • A disponibilidade é de melhor esforço. Não publicamos uma porcentagem numérica de disponibilidade nem uma garantia de disponibilidade.
  • Manutenção planejada, uma falha da máquina ou uma indisponibilidade upstream do INAPI podem tornar o serviço indisponível. A recuperação é conduzida pelo operador e não é limitada por um compromisso publicado de tempo de recuperação.
  • A durabilidade dos dados é coberta por backups criptografados fora da máquina; esta é uma medida de durabilidade, não uma garantia de disponibilidade.

Se sua integração exige disponibilidade garantida ou failover, trate o IRIS como uma fonte de melhor esforço e projete seu próprio retry/cache de acordo.

Cadência de atualidade

O IRIS mantém seu corpus neutro atualizado executando seus pipelines de ingestão do INAPI em um cron gerenciado. A cadência segue como o próprio INAPI publica:

Fonte Cadência de publicação do INAPI Sync do IRIS
Sheets Diária Cron gerenciado, diário
Estado-Diario Segunda–Sexta (Santiago) Cron gerenciado, nos dias de publicação
Buscador Contínua Cron gerenciado

Todas as cadências são declaradas no horário de America/Santiago. Como o sync é de melhor esforço em uma única máquina, uma dada execução pode atrasar ou ser pulada (por exemplo, durante uma indisponibilidade da máquina); a atualidade por fonte a qualquer momento é reportada por GET /v1/freshness (escopo insights:read) — veja a página de status. Trate GET /v1/freshness, não este documento, como a verdade ao vivo sobre o quão fresco o corpus está neste momento.

Resposta de suporte

O suporte é de melhor esforço, atendido pelo operador durante o horário comercial normal (America/Santiago):

  • Não há suporte 24/7 e nenhum tempo de resposta contratualmente garantido.
  • Para problemas, contate seu operador com o requestId do envelope de erro (ele correlaciona seu relato com o log do servidor).
  • Avisos de mudanças incompatíveis e de descontinuação são publicados no changelog com a janela de migração declarada na política de versionamento.

Resumo

Aspecto Compromisso
Disponibilidade Melhor esforço, máquina única (SPOF aceito). Sem garantia numérica.
Recuperação Conduzida pelo operador, melhor esforço. Sem objetivo de tempo de recuperação publicado.
Atualidade Sheets diário; Estado-Diario Seg–Sex (Santiago); via cron gerenciado.
Atualidade ao vivo GET /v1/freshness é autoritativo para o atraso atual.
Suporte Melhor esforço, operador, horário comercial. Sem tempo de resposta garantido.