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
requestIddo 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. |