Ambiente Orquestrado com IA

Dois servidores prontos para produção e homologação, deploy direto do GitHub, agentes de IA trabalhando com regras claras e backups que saem do servidor todos os dias.

Uma estrutura que a TUXTEC Soluções implanta em qualquer empresa com equipe de desenvolvimento. Os nomes de domínio desta página são exemplos. Voltar para a apresentação principal.

2ambientes isolados: produção e homologação

3cópias de cada backup, uma fora dos servidores

6camadas de segurança, do firewall aos dados

4ferramentas de IA prontas para usar

código e deploy acesso da IA via MCP backup Recomendadoindicado por nós, opcional Inclusoparte da implantação

Dois ambientes, uma só estrutura docs/01-arquitetura.md

Produção e homologação ficam em servidores fisicamente separados, com os mesmos projetos e os mesmos nomes. O que funciona em homologação funciona igual em produção, e um teste pesado, um erro ou um agente de IA mal instruído nunca alcança os dados reais.

VPS 1 · Produção

Papel: Sistemas em uso pelos clientes e pela empresa
Deploy: Branch main, com aprovação
Painel: producao.suaempresa.com.br
Dados: Reais
IA: Sem acesso operacional
Recursos: 6 vCPU, 8 GB de RAM, 150 GB, Debian 13 Incluso

VPS 2 · Homologação

Papel: Testes, validação e trabalho dos agentes de IA
Deploy: Branch develop, automático
Painel: homologacao.suaempresa.com.br
Dados: Fictícios ou anonimizados
IA: Consulta e opera via MCP, com token pessoal
Recursos: 6 vCPU, 8 GB de RAM, 150 GB, Debian 13 Incluso

O que roda em cada servidor

Componente	Para que serve
Dokploy	Painel que publica as aplicações, cuida dos domínios, certificados, variáveis e backups
Sistema de gestão	Estrutura pronta para frontend, backend, PostgreSQL e uma API para conexões externas
Sistemas satélites	Aplicações menores que conversam com a gestão pela API, cada uma com sua própria chave
n8n	Automações repetitivas, em `flow.suaempresa.com.br`
Utilitários	rclone, filebrowser e monitoramento de disponibilidade, nunca expostos sem senha

Segurança em camadas docs/08-seguranca-e-boas-praticas.md

Nenhuma proteção sozinha é suficiente. Cada camada cobre a falha da anterior, de fora para dentro, até chegar ao que mais importa.

O Docker passa por cima do firewall. Uma porta publicada por um container fica aberta para a internet mesmo com o UFW bloqueando. Por isso as aplicações são expostas só pelo domínio, os bancos nunca recebem porta externa e o firewall é aplicado também à rede dos containers.

Desenvolvimento com IA, com controle docs/04-desenvolvimento-com-ia.md

Os agentes de IA se conectam ao ambiente pelo protocolo MCP. Cada desenvolvedor usa o próprio token, com prazo de validade, e o agente nunca tem mais permissão do que a pessoa que o usa.

O caminho de um pedido

Você pedeDescreve a tarefa ao agente

O agente lê as regrasAGENTS.md define o que pode e o que não pode

Plano e aprovaçãoVocê revisa antes de qualquer mudança

MCP com seu tokenConsulta status e logs da homologação

Pull RequestO código passa pela revisão de um colega

Ferramentas prontas para usar

Claude CodeRegras em CLAUDE.md, permissões que bloqueiam a leitura de segredos

Codex CLILê o AGENTS.md nativamente, sandbox restrito ao projeto

Qwen CodeRegras em QWEN.md, mesmo servidor MCP

Modelos GLMUsados por dentro do Claude Code, com os mesmos arquivos

Em homologação o agente pode	Em nenhum ambiente o agente pode
Listar projetos e serviços	Operar a produção
Consultar status, deploys e logs	Ler ou alterar senhas e variáveis
Publicar quando o desenvolvedor pedir	Excluir bancos, volumes ou serviços
Reiniciar um serviço travado, avisando antes	Mexer em domínios e certificados

O agente propõe, você aprova. Token, senha ou dado de cliente nunca vai para a conversa com a IA. Se acontecer, o token é revogado na hora, sem afetar os dos colegas.

Cada um na sua branch docs/03-fluxo-git-e-branches.md

Os desenvolvedores trabalham em paralelo sem interferir um no outro. Nada entra em homologação sem revisão, e nada chega à produção sem passar pela homologação.

Comece da develop atualizadaCada tarefa nasce de uma base comum e recente.
Crie a sua branchfeature/seu-nome-assunto, só sua.
Faça commits pequenosAntes de cada commit, uma verificação automática procura senhas e tokens.
Abra o Pull RequestO colega revisa; ao aprovar, a mudança vai sozinha para a homologação.
Leve para a produçãoDepois de validada, a develop vira uma versão na main, marcada para permitir voltar atrás.

API com limites, sistemas conectados docs/07-integracoes-api-e-n8n.md

O sistema de gestão é o centro. Satélites, automações e parceiros externos falam com ele por uma API que identifica quem chama e impede que alguém sobrecarregue o sistema.

O caminho de uma chamada à API

RequisiçãoParceiro, satélite ou n8n

Limite na entradaTraefik barra excesso por endereço

Chave de APIUma por sistema, revogável

Escopos e cotasSó o que aquela chave pode fazer

Sistema de gestãoResponde com paginação e tempo limite

Quem	Como conversa	Proteção
Sistemas satélites	Pela rede interna do servidor	Chave própria com escopos mínimos
n8n	Pela rede interna, nos dois sentidos	Chave exclusiva e webhooks autenticados
Parceiros externos	Por HTTPS, no domínio da API	Limite por endereço, cota diária e auditoria
Homologação e produção	Nunca entre si	Redes e servidores separados

Três cópias, sempre docs/06-backup-e-recuperacao.md

Cada servidor guarda os backups do outro, e uma terceira cópia criptografada sai para o Cloudflare R2. Se um servidor falhar, a recuperação é rápida. Se os dois falharem ao mesmo tempo, os dados continuam seguros fora deles.

Cópia	Onde fica	Protege contra
Original	No próprio servidor	Nada: são os dados em uso
Cruzada	No S3 da outra VPS, criptografada	Falha de um servidor, com recuperação rápida
Externa Recomendado	Cloudflare R2, com bloqueio de exclusão	Falha do provedor, erro humano e ransomware

Todo projeto novo com banco de dados ou volume nasce com uma rotina de backup agendada. Os 10 GB gratuitos do R2 comportam, por exemplo, duas semanas de backups diários de até 600 MB.

Backup que nunca foi restaurado é só uma esperança. A implantação termina com uma restauração de teste, e o procedimento fica documentado para ser repetido todo mês.

Kit para a equipe README.md

Junto com o ambiente, a equipe recebe documentação, diagramas e arquivos-modelo para copiar em cada projeto. As regras ficam escritas uma vez e valem para pessoas e agentes de IA.

meu-projeto/ ├── AGENTS.md no Git regras do projeto para qualquer agente ├── CLAUDE.md, QWEN.md no Git apontam para o AGENTS.md ├── .gitignore, .dockerignore no Git impedem que segredos saiam da máquina ├── .env.example no Git nomes das variáveis, sem valores ├── .github/ no Git modelo de PR e verificação de segredos ├── scripts/setup-dev.sh no Git prepara a máquina em um comando │ ├── .env só local token pessoal e valores reais ├── .mcp.json só local conexão do agente com o Dokploy └── .claude/, .qwen/ só local permissões e preferências de cada um

Documento	Assunto
Arquitetura	Servidores, componentes, domínios e organização dos projetos
Acessos e identidade	Usuários, 2FA, perfis e tokens com validade
Fluxo Git	Branches, Pull Requests, versões e volta atrás
Desenvolvimento com IA	Configuração de cada ferramenta e cuidados de segurança
Gestão de segredos	Onde cada credencial vive e o que fazer em caso de vazamento
Backup e recuperação	Rotinas, Cloudflare R2 e restauração passo a passo
Onboarding e operação	Primeiro dia de um desenvolvedor, deploy, logs e incidentes

Como contratar

A implantação é a mesma nas três modalidades. O que muda é quanto conhecimento a sua equipe recebe e por quanto tempo contamos com acompanhamento.

	Implantação + passagem de bastão	Implantação + transferência de conhecimento	Implantação + acompanhamento continuado
Ambiente completo e kit para a equipe	✓	✓	✓
Sessão prática de entrega	✓	✓	✓
Capacitação em Linux, redes, Docker, Dokploy, GitHub e IA	–	Completa	Gradual
Suporte depois da entrega	–	Chamados avulsos	Durante o contrato
Atualizações, revisão de acessos e teste de restauração mensais	–	–	✓
Indicado para	Equipes experientes	Equipes que querem autonomia	Quem quer segurança na adoção

Etapas da implantação

Diagnóstico e planejamentoEntendemos a equipe, o que já existe e dimensionamos os servidores.
Servidores protegidosSistema operacional, acesso por chave, firewall e atualizações automáticas.
Orquestração e integraçõesDokploy, domínios com HTTPS, GitHub, n8n e utilitários.
Segurança e continuidadeUsuários com 2FA, tokens, segredos, backup cruzado e Cloudflare R2.
Kit e validaçãoAgentes de IA configurados e um deploy de teste nos dois ambientes.
Entrega e aceiteCapacitação conforme a modalidade e restauração de teste comprovada.

Para ir além

Serviço	O que resolve
Cofre de segredos Recomendado	Nenhuma senha visível em texto no painel
Painéis atrás de VPN	Painel de administração invisível para a internet
Build no GitHub Actions	Deploys sem pesar nos servidores
Horas adicionais	Suporte ou capacitação além do contratado

Vamos conversar

Cada proposta é montada a partir de um diagnóstico do seu cenário: equipe, sistemas existentes e quanto tempo o negócio pode ficar parado.

TUXTEC Soluções

Projetos personalizados de infraestrutura e desenvolvimento.

WhatsApp
(31) 98331-2416

Telefone
(31) 98331-2416

E-mail
denio@tuxtec.com.br