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