Ir para o conteúdo

Nível de serviço

Esta página é o acordo de nível de serviço (SLA) da API REST (https://api.tarno.cl) e do servidor MCP (https://mcp.tarno.cl) do Tarno: o que nos comprometemos a cumprir, como cada número é medido e o que fica de fora. Os números são conservadores de propósito: cada um está abaixo do que o serviço mediu na prática (indicado ao lado), para que o compromisso possa ser cumprido também num mês ruim.

As consequências de um descumprimento (créditos ou outras) são fixadas pelo contrato da sua organização; esta página fixa os objetivos e como são medidos.

Arquitetura: uma máquina, cópias fora e recuperação ensaiada

O Tarno roda em uma única máquina. Não há uma segunda máquina a quente nem failover automático: uma falha da máquina é coberta recuperando o serviço a partir de cópia, não passando o tráfego para outra. Por isso os compromissos desta página são de disponibilidade mensal e de tempo de recuperação, não de redundância.

  • Cópias criptografadas fora da máquina, num armazenamento externo independente: o corpus e a vigilância, uma vez por dia; as chaves de API e as organizações dos clientes, a cada hora. São guardadas por 14 dias.
  • Arquivo dos PDF do Estado Diario: os boletins tal como o INAPI os publicou são copiados todos os dias para o mesmo armazenamento externo, a integridade da cópia completa é verificada (cada arquivo, por tamanho e hash) e são conservados sem expiração. Não são criptografados: são documentos públicos.
  • Recuperação ensaiada: a restauração completa do serviço numa máquina nova, a partir das cópias reais, está escrita passo a passo e cronometrada (último ensaio: 2026-10-04).

Compromissos

Compromisso Valor comprometido Medido (referência)
Disponibilidade mensal da API REST e do MCP 99,5 % 99,93 % em 30 dias (em 2026-09-30)
Respostas de erro do servidor (5xx) < 0,5 % das requisições do mês 0,034 % em 30 dias
Perda máxima de dados (RPO) 24 h (chaves e organizações: 1 h) cópia diária do corpus e da vigilância; a cada hora, chaves e organizações
Tempo de recuperação (RTO) 4 h restauração completa ensaiada: 11 min de trabalho técnico até servir com as chaves dos clientes, ≈ 28 min até o serviço completo
Manutenção dentro da janela declarada, avisada com 48 h —

Disponibilidade

Porcentagem dos minutos do mês civil (UTC) em que a API REST e o MCP respondem às requisições. Um minuto conta como indisponível quando o serviço não responde ou responde 503 a todas as requisições. Não contam como indisponíveis os minutos das exclusões, incluída a manutenção avisada. 99,5 % equivale a no máximo cerca de 3 h 40 min de indisponibilidade num mês de 31 dias.

Erros do servidor

Proporção das requisições do mês que terminam num código 5xx. Não contam os 4xx (requisição inválida, chave sem permissão, 429 por exceder a cota ou o limite de rajada): são respostas corretas a uma requisição que não pode ser atendida.

Perda máxima de dados (RPO)

Se fosse preciso recuperar o serviço a partir de cópia, o máximo que se pode perder é o que foi escrito desde a última cópia:

dados RPO
Corpus (marcas, anotações, partes, catálogos) 24 h; além disso, a sincronização seguinte com o INAPI volta a trazer o que foi publicado
Vigilância de semelhantes (listas, itens e semelhantes detectadas) 24 h
Chaves de API e organizações dos clientes 1 h

Depois de uma recuperação, GET /system/freshness diz de que data é o corpus servido.

Tempo de recuperação (RTO)

Tempo desde a confirmação de uma falha da máquina até que a API REST e o MCP voltem a responder com as chaves dos clientes e a busca completa (incluída a busca por similaridade). O prazo corre dentro do horário de suporte; uma falha fora dele começa a contar no início do período seguinte. A parte técnica da restauração está medida (cerca de 28 min até o serviço completo); o resto do prazo é margem para preparar a máquina nova, seus nomes e certificados.

Manutenção

  • Janela declarada: domingos das 02:00 às 06:00 (America/Santiago), no máximo 4 h por mês.
  • Aviso prévio: pelo menos 48 h antes, ao contato técnico da sua organização.
  • Uma manutenção fora da janela ou sem aviso conta como indisponibilidade.
  • A sincronização diária não é manutenção: a carga dos dados do INAPI é feita com o serviço em funcionamento, sem interrupção. Durante a cadeia diária a API e o MCP continuam respondendo.

Exclusões

Não contam contra os compromissos:

  • a manutenção avisada dentro da janela declarada;
  • força maior e indisponibilidades de provedores de rede ou de nomes alheios ao Tarno;
  • a indisponibilidade do INAPI ou das suas fontes: afeta a atualidade do corpus, não a disponibilidade da API, que continua servindo os dados já carregados;
  • o uso acima da cota ou do limite de rajada (429), e as requisições inválidas ou sem permissão (4xx);
  • ataques ou abuso que obriguem a limitar o acesso para proteger o serviço.

Objetivos de desempenho

Objetivos de latência (p95, medidos sobre o mês) sob os quais operamos o serviço. Ao contrário dos compromissos acima, são objetivos: se forem excedidos, investiga-se e corrige-se.

Operação Objetivo p95 Medido (teste de carga, 6 clientes simultâneos)
Ficha, anotações e catálogos < 1,5 s ficha 1,2 s · anotações 0,4 s
Busca < 3 s 1,1 s
Busca por similaridade (similarTo) < 5 s 1,4 s com cache quente; 4,5–4,7 s a frio para consultas curtas
Relatórios < 6 s relatório de disponibilidade 3,2 s

Cadência de atualidade

O Tarno 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 Tarno
Dados abertos do INAPI Diária Cron gerenciado, de segunda a sábado (sem sync aos domingos)
Estado-Diario Segunda–Sexta (Santiago) Cron gerenciado, nos dias de publicação
Fichas de processo do INAPI Contínua Cron gerenciado, uma vez por dia dentro da cadeia diária (12:00 Chile)

Não há sincronização aos domingos (decisão de 2026-10-10): a cadeia roda de segunda a sábado às 12:00 do Chile, então no domingo dataAsOf fica no sábado. stale em GET /system/freshness não conta os domingos (com o limite padrão; com thresholdHours explícito, exato). Na segunda a cadeia recolhe tudo o que se acumulou. O INAPI não publica o Estado Diário aos domingos.

Objetivo de atualidade: o que o INAPI publica num dia útil, disponível antes das 15:00 (America/Santiago) desse dia, salvo se o INAPI não o tiver publicado a tempo. Todas as cadências são declaradas no horário de America/Santiago. A atualidade por fonte a qualquer momento é reportada por GET /system/freshness (escopo insights:read) — veja a página de status. Trate GET /system/freshness, não este documento, como a verdade ao vivo sobre o quão fresco o corpus está neste momento.

Suporte

O suporte é atendido pelo operador em horário comercial (segunda a sexta, America/Santiago, exceto feriados do Chile):

  • Não há suporte 24/7. Uma falha fora do horário é atendida no início do horário comercial seguinte, e o RTO conta a partir daí.
  • 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 99,5 % mensal; erros 5xx < 0,5 % das requisições.
Dados RPO 24 h (chaves e organizações 1 h); cópias criptografadas fora da máquina, 14 dias.
Recuperação RTO 4 h dentro do horário de suporte; restauração ensaiada.
Manutenção Domingos 02:00–06:00 (Santiago), máx. 4 h/mês, aviso de 48 h. A sincronização diária não interrompe o serviço.
Arquitetura Uma máquina, sem redundância a quente; recupera-se a partir de cópia.
Atualidade Dados abertos de segunda a sábado (sem sync aos domingos); Estado-Diario Seg–Sex (Santiago); ao vivo em GET /system/freshness.
Suporte Operador, horário comercial do Chile. Sem suporte 24/7.