> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/introducao/requisitos-e-estrutura.md).

# 📋 Requisitos e Estrutura

## 📋 Requisitos Técnicos e Estrutura Operacional

### 📌 Visão Geral

Este documento define os requisitos técnicos, responsabilidades operacionais e limitações de uso da plataforma DigitalSac.

O objetivo é garantir transparência sobre:

* funcionamento da plataforma
* capacidade operacional
* requisitos mínimos
* responsabilidades do cliente
* escopo de suporte
* limitações técnicas

***

## 🧱 Natureza da Plataforma

O DigitalSac é uma solução 100% self-hosted.

Isso significa que:

* o sistema é instalado em infraestrutura do cliente
* o ambiente operacional é controlado pelo contratante
* a DigitalSac não administra servidores de clientes
* a estabilidade depende diretamente da infraestrutura utilizada

O cliente possui total liberdade sobre:

* servidor
* provedor
* escalabilidade
* rede
* armazenamento
* segurança

***

## ⚙️ Estrutura de Planos

Os planos do DigitalSac são baseados na capacidade de processamento liberada para o sistema.

### Planos disponíveis

* Community Edition
* Cluster 4 Core
* Cluster 6 Core
* Cluster 8 Core

***

## 🧠 Regra de Processamento

### Community Edition

* utiliza até 2 núcleos de processamento

### Cluster Edition

* processamento multicore real
* utilização de:
  * 4 cores
  * 6 cores
  * 8 cores

***

## ⚠️ Importante

O plano contratado:

* não fornece servidor
* não inclui hospedagem da aplicação
* não limita hardware do cliente
* não controla recursos da VPS

O licenciamento define exclusivamente:

* capacidade operacional do software
* quantidade de processamento liberado
* recursos disponíveis da edição contratada

***

## 🖥️ Requisitos de Infraestrutura

### 📌 Recomendação Geral

Para garantir estabilidade operacional, recomenda-se utilizar sempre:

👉 no mínimo +2 cores acima da capacidade do plano contratado

Isso evita saturação do ambiente em situações de:

* pico de mensagens
* processamento de mídia
* IA
* filas
* campanhas
* múltiplos atendimentos simultâneos

***

## 🟢 Community Edition — 2 Cores

### Consumo do sistema

* até 2 cores

### Mínimo recomendado

* CPU: 4 cores
* RAM: 8 GB

### Recomendado para produção

* CPU: 6 cores
* RAM: 16 GB

***

## 🔹 Cluster 4 Core

### Consumo do sistema

* até 4 cores

### Mínimo recomendado

* CPU: 6 cores
* RAM: 8 GB

### Recomendado para produção

* CPU: 8 cores
* RAM: 16 GB

***

## 🔸 Cluster 6 Core

### Consumo do sistema

* até 6 cores

### Mínimo recomendado

* CPU: 8 cores
* RAM: 16 GB

### Recomendado para produção

* CPU: 10 cores
* RAM: 16 GB+

***

## 🔥 Cluster 8 Core

### Consumo do sistema

* até 8 cores

### Mínimo recomendado

* CPU: 10 cores
* RAM: 16 GB

### Recomendado para produção

* CPU: 12 cores
* RAM: 32 GB

***

## 🌐 Requisitos Adicionais

### Sistema Operacional

* Ubuntu 24.04 ou superior

### Infraestrutura

* Docker
* Docker Swarm
* acesso SSH root
* domínio configurado
* subdomínios configurados
* portas 80 e 443 liberadas

### Recomendado

* armazenamento NVMe
* baixa latência de rede
* monitoramento contínuo

***

## ⚠️ Responsabilidades do Cliente

O cliente é integralmente responsável por:

* manter o servidor ativo
* garantir recursos suficientes
* monitorar CPU e memória
* configurar firewall
* proteger acesso SSH
* realizar backups periódicos
* aplicar boas práticas de segurança
* monitorar estabilidade do ambiente

***

## 📌 Observação Importante

A performance do DigitalSac depende diretamente:

* da infraestrutura utilizada
* da qualidade do servidor
* da latência da rede
* da capacidade de processamento disponível

Infraestruturas abaixo do recomendado podem causar:

* lentidão
* instabilidade
* filas de processamento
* degradação operacional

***

## ⚙️ Responsabilidades da DigitalSac

A DigitalSac é responsável por:

* fornecer o software funcional
* disponibilizar atualizações
* corrigir bugs internos
* evoluir a plataforma
* manter compatibilidade dos recursos suportados

***

## 🚫 Limitação de Responsabilidade

A DigitalSac não se responsabiliza por:

* falhas de VPS
* indisponibilidade de servidor
* problemas de rede
* quedas de internet
* configurações incorretas
* falhas causadas por terceiros
* uso inadequado da plataforma
* APIs externas
* bloqueios ou limitações da Meta
* serviços externos como OpenAI, N8N, Typebot ou similares

***

## 🔧 Escopo de Suporte

### O suporte cobre

* erros do sistema
* bugs internos
* dúvidas sobre funcionalidades
* orientação de utilização da plataforma

***

## ❌ O suporte não cobre

* administração de VPS
* configuração de Linux
* infraestrutura
* otimização avançada
* problemas de Docker
* problemas externos
* serviços de terceiros
* redes internas
* firewall
* DNS

Isso segue o padrão de plataformas self-hosted.

***

## 📈 Escalabilidade

O DigitalSac não possui limitações internas de:

* usuários
* atendimentos
* conexões
* filas
* chatbots

A capacidade operacional depende exclusivamente:

* do plano contratado
* da infraestrutura disponível

***

## 💸 Custos Externos

### Obrigatórios

* servidor VPS ou dedicado
* domínio

### Variáveis

* API oficial da Meta
* APIs de IA
* SMS
* serviços externos
* automações
* ferramentas integradas

***

## 📌 Recomendações Operacionais

Para ambientes de produção recomenda-se:

* monitoramento contínuo
* backups automatizados
* uso de armazenamento NVMe
* servidores dedicados para grandes operações
* utilização das versões Cluster em ambientes de alto volume

***

## 📌 Resumo

* DigitalSac é uma plataforma self-hosted
* toda infraestrutura é controlada pelo cliente
* os planos definem capacidade operacional
* a estabilidade depende do servidor utilizado
* versões Cluster são recomendadas para operações de alto volume
* o cliente possui total liberdade sobre sua infraestrutura