Documento de Especificação Técnica

🔍 1. Glossário de Siglas

📋 2. Premissas e Restrições

2.1 Premissas

• A infraestrutura opera 24/7 com serviços reais em produção.
• Toda documentação deve seguir padrões de Data Center corporativo (Equinix, Ascenty, ODATA).
• Diagramas devem ser entregues no formato Draw.io (formato .drawio) para permitir edição posterior.
• Valores ainda não confirmados (capacidades de disco, endereços e VLANs) ficam marcados como a definir até serem validados — nunca estimados.
• Não documentar IDs de VMs — o que importa é o papel de cada serviço. VMs podem ser migradas, renomeadas ou recriadas sem invalidar a documentação.
• Separar documentação pública e interna — a versão publicada usa apenas valores ilustrativos; endereços, IDs de VLAN, hostnames, hardware e portas reais ficam somente na documentação interna.

2.2 Restrições

• Não inventar endereços IP, VLAN IDs, regras de firewall, senhas, ou qualquer dado técnico não fornecido.
• Onde o dado não existir, estruturar como tabela vazia ou template.
• Separar rigorosamente o que é produção do que é laboratório/desenvolvimento.

2.3 Classificação de Ambientes

🎯 3. Objetivos da Infraestrutura

3.1 Objetivo Geral

Documentar completamente um Data Center residencial ("Home Data Center") utilizado para desenvolvimento, validação e operação de serviços reais, projetado com conceitos corporativos de:

• Cluster de virtualização com HA e quorum
• Storage redundante com snapshots e replicação
• Backup dedicado (PBS)
• Segmentação de rede com VLANs e firewall corporativo
• Balanceamento de links e QoS
• Infraestrutura elétrica redundante com energia solar
• Monitoramento, SIEM e automação

3.2 Objetivos Específicos da Documentação

🏗️ 4. Arquitetura Geral

[Operadora A]               [Operadora B]
      │                           │
      └─────────────┬─────────────┘
                    ▼
[sw-core-01] ─── Switch de núcleo (Layer 2)
    │              links WAN isolados em VLANs próprias (WAN A / WAN B)
    │
    ├──► Troncos 802.1Q ──► [Cluster Proxmox VE — 3 nós] ─── HA, quorum, Live Migration, ZFS
    │                         ├── pve-node-01
    │                         ├── pve-node-02
    │                         ├── pve-node-03
    │                         └── fw-01 / fw-02 ─── Firewall em HA (ativo/standby)
    │                                              VMs em nós distintos · roteamento entre zonas,
    │                                              NAT, DHCP, VPN, balanceamento/failover de links
    │
    ├──► Troncos 802.1Q ──► [pbs-01] ─── Proxmox Backup Server dedicado
    │
    └──► Troncos 802.1Q ──► [Distribuição e acesso] ─── uplinks redundantes com STP
                              ├── rt-dist-01   (roteador de distribuição)
                              ├── sw-acc-01    (switch de acesso)
                              └── ap-01        (access points)

Valores ilustrativos — IDs de VLAN, endereços e nomes reais ficam na documentação interna.

4.1 Visão Geral de Capacidade

4.2 Servidores Físicos

Processador, memória e discos de cada servidor ficam registrados na documentação interna.

🌐 5. Topologia de Rede

5.1 Equipamentos de Rede

Valores ilustrativos — IDs de VLAN, endereços e nomes reais ficam na documentação interna.

5.2 Recursos de Rede Implementados

• VLANs e segmentação por zonas
• Links de operadora isolados em VLANs próprias no núcleo Layer 2
• Troncos 802.1Q entre núcleo, cluster e distribuição
• Uplinks redundantes com STP
• Firewall em HA (ativo/standby)
• VPN SSL e IPSec
• Load Balancing e failover (links múltiplos)
• QoS (Quality of Service)
• DNS próprio (Pi-hole + Unbound)
• Cache DNS
• DHCP interno

5.3 Tabela de VLANs (exemplo ilustrativo)

Valores ilustrativos — IDs de VLAN, endereços e nomes reais ficam na documentação interna.

5.4 DNS

🖥️ 6. Cluster de Virtualização (Proxmox VE)

6.1 Características do Cluster

6.2 Nós do Cluster

Valores ilustrativos — IDs de VLAN, endereços e nomes reais ficam na documentação interna. Especificações de hardware por nó: ver template da seção 4.2.

6.3 Proxmox Backup Server (PBS)

📦 7. Serviços por Categoria

🛡️ 8. Segurança

8.1 Stack de Segurança

8.2 Formato das Regras de Firewall (exemplos ilustrativos)

Exemplos ilustrativos do formato — as regras reais ficam na documentação interna.

📊 9. Monitoramento

🤖 10. Automação

⚡ 11. Infraestrutura Elétrica

11.1 Componentes

11.2 Documentação Elétrica Necessária

• Topologia elétrica (diagrama unifilar)
• Fluxo de alimentação (Rede → Inversor → Cargas)
• Autonomia estimada do banco de baterias
• Proteções (disjuntores, DPS, aterramento)
• Monitoramento de consumo e geração

🚀 12. Plano de Expansão (Roadmap)

📐 13. Diagramas (Especificação)

13.1 Lista de Diagramas Obrigatórios

13.2 Padrão de Nomenclatura

{SEQUENCIAL}_{TIPO}_{REVISÃO}.drawio

Exemplo: 01_Topologia_Fisica_v1.drawio, 02_Topologia_Logica_v1.drawio, 03_Fluxo_Rede_v1.drawio

📝 14. Template — Ficha Técnica por Serviço

Para cada serviço documentado individualmente, utilizar o template abaixo:

👥 15. Matriz de Responsabilidade (RACI)

💡 16. Observações Finais

Changelog