Documentação PrecisaX Neural Guard

Instalação

Você recebe por email — ou WhatsApp/Telegram, se preferir — um link único do instalador. Dois caminhos, escolha o que se encaixa:

Caminho A — Quick install (você já tem Debian/Ubuntu)

Cola no terminal do servidor onde quer instalar:

curl -fsSL https://precisax.com.br/install/inst_XXXXXXXXXXXXX | sudo bash

Suporta: Debian 12 (bookworm), Ubuntu 22.04, Ubuntu 24.04. Arquitetura x86_64 + RAM ≥ 4 GB + disco ≥ 50 GB.

Caminho B — ISO bootable (hardware sem SO)

Baixa, verifica, grava em pendrive:

Boot do USB → instalação 100% automatizada (sem clicks).

Primeiro boot

1. LUKS wizard — o sistema pede pra você definir a senha do disco. Mínimo 12 caracteres.
   Guarde em local seguro — sem ela, ninguém decifra o disco, nem a PrecisaX.
2. Burn-in rápido — validador de hardware (CPU, RAM, disco, rede). ~5 minutos.
3. Installer — Docker, banco, AI engines, tudo sobe automaticamente.
4. Acesso — https://precisax.com.br/t/seuisp/

Operação diária

Tudo via UI web. CLI no host só pra manutenção:

# SSH no appliance
ssh precisaxops@<ip-local>

# Logs da stack
sudo docker logs -f precisax-edge-ui

# Reiniciar componentes
sudo systemctl restart precisax-stack

Backup & restore

Botão Backup na UI gera arquivo .enc criptografado com AES-256-GCM (Scrypt N=2¹⁷). Senha gerada client-side. Restore via:

sudo curl -fsSL https://precisax.com.br/install/inst_NEWTOKEN | \
  sudo bash -s -- --restore-from=<backup>.enc

Licença

Vault local cifrado com hardware fingerprint (machine-id + MAC + CPU). Visualize em /admin/license.

• Ativa — tudo funcionando.
• Grace — licença venceu há <40 dias. Banner amarelo, sem bloqueios.
• Degradado — venceu há >40 dias. AI e SSH externo bloqueiam. NMS e backup mantidos.

Polling DDM Configurável

Cada enlace de fibra do seu PrecisaX tem seu próprio intervalo de coleta DDM, configurável em 4 tiers de criticidade.

Tiers

• Backbone — enlaces P2P principais entre POPs/cidades. Polling rápido (30-60s) pra detectar variações sutis e cortes súbitos.
• Distribuição — enlaces inter-bairros, anéis metropolitanos. Polling intermediário (60-180s).
• Acesso — última milha, cliente único. Polling espaçado (5-10 min) — coleta suficiente pra alerta sem sobrecarregar.
• Lab/Teste — enlaces experimentais ou em homologação. Polling mínimo (15-60 min).

Defaults por plano

Como configurar

Pelo app cliente em https://precisax.com.br/t/<seu-slug>/admin/links:

1. Lista de enlaces mostra tier atual + intervalo + freshness em tempo real
2. Clique no nome do enlace pra abrir /admin/links/<id>/config
3. Escolha o tier (Backbone / Distribuição / Acesso / Lab)
4. Slider permite ajustar intervalo customizado, respeitando o mínimo do plano
5. Botão Salvar → próxima coleta usa o novo intervalo (não precisa restart)

Backoff automático em falha

Se um enlace falhar 3× consecutivas (SNMP timeout, sem resposta), o sistema entra em backoff exponencial:

3 falhas → próxima tentativa em 60s
4 falhas → 120s
5 falhas → 240s
6 falhas → 480s
máx → 1800s (30 min)

Quando o enlace volta, contador zera e intervalo normal retoma.

Freshness status

• fresh — última coleta dentro de 1.5× o intervalo configurado
• stale — entre 1.5× e 3× — alerta
• missing — mais de 3× — investigar
• never_polled — enlace nunca coletado (recém-cadastrado)

Endpoint API

# Health de um enlace específico
GET /api/qfi/links/<id>/health
→ {
    "link_id": 14,
    "name": "Sidrolandia a Capao Bonito 2",
    "tier": "distribuicao",
    "poll_interval_sec": 60,
    "last_poll_at": "2026-05-17T17:08:16Z",
    "seconds_since_last_poll": 12,
    "seconds_to_next_poll": 48,
    "consecutive_failures": 0,
    "freshness_status": "fresh"
  }

# Health de todos
GET /api/qfi/links/health/all
→ {"links": [...], "total": 13}

Retention

Histórico em link_poll_history retentido por retention_days (default 30-90 dias por plano). Limpeza automática a cada 15 min.

Suporte

Termos de Uso

Versão 1.0 · vigor a partir de 16/05/2026

1. Objeto. PrecisaX Neural Guard é uma plataforma de monitoramento e operação para ISPs, composta de software (licença anual renovável) + hardware (appliance, propriedade do cliente após compra).
2. Pagamento. Mensalidade cobrada via boleto/PIX no 5º dia útil de cada mês. Inadimplência >40 dias → modo degradado (AI off, SSH externo off, backup mantido).
3. Cancelamento. A qualquer momento, sem multa. Última mensalidade proporcional ao mês corrente.
4. Garantia hardware. 12 meses on-site. Falhas de software cobertas enquanto licença ativa.
5. Limites de responsabilidade. PrecisaX não responde por perda de dados em caso de força maior, ataque ou má operação. Backup é responsabilidade compartilhada.
6. Propriedade intelectual. Código PrecisaX é fechado. Engenharia reversa proibida.
7. Foro. Comarca de Campo Grande, MS.

Política de Privacidade (LGPD)

Conformidade Lei 13.709/2018 · DPO: dpo@precisax.com.br

1. Dados coletados. Razão social, CNPJ, contato (nome, email, telefone), dados técnicos do appliance (serial, fingerprint, uptime).
2. Não coletamos. Dados dos seus assinantes finais. Toda telemetria de rede fica na sua infraestrutura. O cloud só vê: licença, AI requests (texto/imagem que você envia), e logs operacionais agregados.
3. Compartilhamento. Nunca repassamos dados a terceiros, exceto provedores cloud que assinam DPA (OpenAI/Anthropic pra AI assistente — só quando você usa).
4. Direitos. Você pode solicitar acesso, retificação, exclusão de qualquer dado a qualquer momento via dpo@precisax.com.br (resposta em até 15 dias).
5. Retenção. Dados de licença mantidos enquanto contrato ativo + 5 anos (obrigação fiscal). Dados pessoais excluídos em até 30 dias após cancelamento.
6. Segurança. TLS 1.3 em trânsito. AES-256 em repouso (LUKS no appliance, AES-GCM em backups). RLS Postgres + Flask hook + Sentinela isolando tenants no cloud.