Go to file
João Pedro Toledo Goncalves 76665a21f8 UI Fix V10: Force Black Text on Active Search (Specificity Fix) 2026-02-02 22:07:33 -03:00
.gemini UI Fix V10: Force Black Text on Active Search (Specificity Fix) 2026-02-02 22:07:33 -03:00
assets Refactor: Flattened documentation structure and recovered files 2026-02-02 20:54:17 -03:00
documentacao backup Cleanup: Consolidate assets into Theme/assets folders 2026-02-02 21:08:34 -03:00
documentacao bancos de dados Refactor: Standardized filenames to [Level] Title format and cleaned duplicates 2026-02-02 21:04:34 -03:00
documentacao conteineres Cleanup: Removed residual *README.md files 2026-02-02 21:06:16 -03:00
documentacao exchange Cleanup: Consolidate assets into Theme/assets folders 2026-02-02 21:08:34 -03:00
documentacao linux Refactor: Standardized filenames to [Level] Title format and cleaned duplicates 2026-02-02 21:04:34 -03:00
documentacao rede e seguranca Cleanup: Consolidate assets into Theme/assets folders 2026-02-02 21:08:34 -03:00
documentacao storage Refactor: Standardized filenames to [Level] Title format and cleaned duplicates 2026-02-02 21:04:34 -03:00
documentacao virtualizacao Cleanup: Removed residual *README.md files 2026-02-02 21:06:16 -03:00
documentacao vmware Refactor: Standardized filenames to [Level] Title format and cleaned duplicates 2026-02-02 21:04:34 -03:00
documentacao windows Refactor: Standardized filenames to [Level] Title format and cleaned duplicates 2026-02-02 21:04:34 -03:00
documentacao zammad Refactor: Standardized filenames to [Level] Title format and cleaned duplicates 2026-02-02 21:04:34 -03:00
.dockerignore Refactor: Flattened documentation structure and recovered files 2026-02-02 20:54:17 -03:00
.gitignore Initial commit: Project structure and documentation assets 2026-01-22 23:20:15 -03:00
Dockerfile Refactor: Flattened documentation structure and recovered files 2026-02-02 20:54:17 -03:00
README.md feat(docs): add 9 Zammad manuals and update tracking 2026-01-27 09:06:18 -03:00
build_log_ui.txt UI/UX v2: Blue-Grey theme, Hidden Header Title, Centered Search 2026-02-02 21:20:04 -03:00
build_log_ui_v6.txt UI Fix V7: Restore Click-to-Dismiss Overlay + Unlock Body Scroll 2026-02-02 21:44:27 -03:00
build_log_ui_v7.txt UI Fix V8: Visible Dimming Overlay, Precision Dropdown Alignment 2026-02-02 22:00:43 -03:00
build_log_ui_v8.txt UI Fix V9: Revert Overlay Visibility + Fix Invisible Text Bug 2026-02-02 22:03:06 -03:00
build_log_ui_v9.txt UI Fix V10: Force Black Text on Active Search (Specificity Fix) 2026-02-02 22:07:33 -03:00
mkdocs.yml UI/UX v4: Brand Colors (Blue/Cyan), Compact Header (3rem) 2026-02-02 21:25:21 -03:00
requirements.txt Refactor: Flattened documentation structure and recovered files 2026-02-02 20:54:17 -03:00

README.md

Manuais Zammad - Repositório de Documentação

Este repositório contém a documentação técnica da iT Guys, organizada por sistemas e níveis de acesso.

📊 Quadro de Status dos Manuais

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░ 52% (93/177)

1. Rede e Segurança (pfSense / Suricata / OpenVPN)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░ 68% (15/22)

  • [Nível 3] Planejamento de Hardware e Virtualização
  • [Nível 2] Instalação Inicial e Setup Wizard
  • [Nível 2] Customização e Identidade Visual
  • [Nível 2] Gerenciamento de Usuários e Autenticação (LDAP)
  • [Nível 2] Configuração de Interfaces e Redes (VLAN/LAGG)
  • [Nível 3] Multi-WAN, Gateway Groups e Roteamento
  • [Nível 2] Firewall, NAT e Alias
  • [Nível 2] Serviço de DNS (Resolver e Forwarder)
  • [Nível 2] Serviço de DHCP e Reservas
  • [Nível 2] Serviço TFTP e Provisionamento
  • [Nível 3] Filtro de Conteúdo com pfBlockerNG
  • [Nível 3] IDS/IPS com Suricata
  • [Nível 2] VPN Road Warrior (OpenVPN + LDAP)
  • [Nível 3] VPN Site-to-Site (OpenVPN)
  • [Nível 3] Diagnóstico Avançado, Shell Recovery e Logs
  • [Nível 3] Tuning de Wi-Fi para Alta Densidade (Unifi/Omada)
  • [Nível 3] VPN Site-to-Site Avançada (Mesh / Hub-and-Spoke)
  • [Nível 3] Segregação de Redes Críticas (VLAN de Equipamentos Médicos/Industriais)
  • [Nível 3] Isolamento de Sistemas Legados (Windows XP/7 em Rede Segregada)
  • [Nível 2] Configuração de Captive Portal e Vouchers (Hotelaria/Eventos)
  • [Nível 3] QoS e Priorização de Tráfego VoIP/SIP (Call Centers)
  • [Nível 3] Redes Temporárias e Failover 4G/Starlink (Obras/Eventos)

2. Storage (TrueNAS / ZFS)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░ 75% (6/8)

  • [Nível 1] Monitoramento de Saúde de Discos
  • [Nível 2] Gestão de Users, Groups e ACLs
  • [Nível 2] Configuração de Snapshots e Replicação
  • [Nível 3] Arquitetura ZFS e Planejamento
  • [Nível 3] Manutenção de ZFS (Scrub/Resilver)
  • [Nível 3] Configuração de iSCSI Target
  • [Nível 3] Otimização de Storage para Edição de Vídeo (10GbE/Jumbo Frames)
  • [Nível 3] Otimização de Protocolo SMB para Arquivos Grandes (AutoCAD/Revit)

3. Bancos de Dados (PostgreSQL / MySQL / Redis)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100% (7/7)

  • [Nível 1] Diagnóstico de Conectividade e Status
  • [Nível 1] Procedimento de Backup e Restore Manual
  • [Nível 2] Instalação e Configuração Base
  • [Nível 2] Gestão de Usuários e Permissões
  • [Nível 2] Manutenção Preventiva e Logs
  • [Nível 3] Tuning de Performance e Otimização
  • [Nível 3] Arquitetura de Persistência e Troubleshooting Avançado

4. Windows Server (AD / DNS / GPO)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░ 77% (7/9)

  • [Nível 1] Criação e Gestão do Ciclo de Vida de Usuários (AD)
  • [Nível 2] Padrões de Senha e Configuração Inicial (Post-Install)
  • [Nível 2] Gestão Avançada de DNS e DHCP
  • [Nível 3] Automação e Relatórios com PowerShell
  • [Nível 3] Diagnóstico de Replicação (DCDIAG)
  • [Nível 3] Gestão Centralizada via GPO
  • [Nível 3] Disaster Recovery e Continuidade de Negócios (AD)
  • [Nível 3] RDS/Terminal Services: Otimização para Alta Latência
  • [Nível 3] Gestão de Impressão Centralizada e Cotas (PaperCut)

5. Microsoft Exchange (Exchange 2019)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100% (17/17)

  • [Nível 0] Como Acessar e Configurar Webmail e Celular
  • [Nível 0] Como Configurar Resposta Automatica de Ferias
  • [Nível 1] Diagnostico Basico - Usuario nao recebe e-mail
  • [Nível 1] Procedimento de Criacao e Bloqueio de Usuarios
  • [Nível 2] Gerenciamento de Cotas e Arquivamento
  • [Nível 2] Gerenciamento de Quarentena Movel
  • [Nível 2] Gestao de Permissoes (Full Access/Send As)
  • [Nível 2] Solucao de Problemas de Lista de Enderecos
  • [Nível 3] Acesso ao Servidor Windows Core e PowerShell
  • [Nível 3] Arquitetura Tecnica e Mapeamento
  • [Nível 3] Auditoria Administrativa e Logs
  • [Nível 3] Checklist de Manutencao Diaria/Semanal
  • [Nível 3] Disaster Recovery e Soft Restore
  • [Nível 3] Gestao de Conectores e Roteamento
  • [Nível 3] Referencia de Operacoes via PowerShell
  • [Nível 3] Relatorios Avancados
  • [Nível 3] Renovacao de Certificado SSL

6. Virtualização (VMware / Proxmox)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░ 75% (12/16) VMware:

  • [Nível 1] Visão Geral e Escopo
  • [Nível 1] Verificação Básica de VM
  • [Nível 1] Operações de Energia
  • [Nível 1] Monitoramento Básico
  • [Nível 2] Gestão de Recursos
  • [Nível 2] Networking e Storage
  • [Nível 2] Manutenção e Lifecycle
  • [Nível 2] Troubleshooting
  • [Nível 3] CLI Troubleshooting
  • [Nível 3] Networking Avançado
  • [Nível 3] Storage Deep Dive
  • [Nível 3] DR Arquitetura

Proxmox VE:

  • [Nível 1] Gestão Básica de VMs/LXC
  • [Nível 2] Gestão de Backups e Snapshots
  • [Nível 3] Gestão de Cluster e HA
  • [Nível 3] Troubleshooting de Rede

7. Conteineres (Docker / Portainer)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100% (9/9)

  • [Nível 0] Docker para Devs e Ferramentas
  • [Nível 1] Instalação e Configuração (Docker + Compose)
  • [Nível 1] Deploy Portainer CE
  • [Nível 1] Gestão de Stacks (Manual/GitOps)
  • [Nível 2] Redes e Firewall
  • [Nível 2] Volumes e Persistência de Dados
  • [Nível 2] Healthchecks e Cron
  • [Nível 3] Docker Swarm: Inicialização e Gerenciamento
  • [Nível 3] Kubernetes: Visão Geral e Ferramentas Básicas

8. Linux Server

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100% (7/7)

  • [Nível 1] Comandos Essenciais de Diagnóstico
  • [Nível 2] Gerenciamento de Pacotes e Updates
  • [Nível 2] Configuração de Rede e Firewall
  • [Nível 2] Gestão de Usuários e Permissões
  • [Nível 3] Hardening de Servidor
  • [Nível 3] Análise de Logs (Journalctl)
  • [Nível 3] Scripting e Automação Avançada

9. Service Desk (Zammad)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100% (8/8)

  • [Nível 1] Criação, Classificação e Fusão de Tickets
  • [Nível 2] Instalação e Deploy (Docker, LXC, Source)
  • [Nível 2] Configuração de Triggers e Automações
  • [Nível 2] Gerenciamento de SLAs, Grupos e Roles
  • [Nível 2] Configuração de Canais de Entrada (Email / Chat / Telegram)
  • [Nível 3] Planejamento de Infraestrutura e Sizing
  • [Nível 3] Integrações via API e Webhooks
  • [Nível 3] Backup, Restore e Manutenção do Zammad

10. Hardware - Gerenciamento Out-of-Band (OOB)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/3)

  • [Nível 2] Acesso e Gerenciamento via iDRAC (Dell PowerEdge)
  • [Nível 2] Acesso e Gerenciamento via IMM (Lenovo System x)
  • [Nível 3] Atualização de Firmware, BIOS e Lifecycle Controller

11. Hardware - Energia e Monitoramento

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/4)

  • [Nível 2] Monitoramento de UPS/Nobreaks (APC PowerChute)
  • [Nível 2] Gerenciamento de Réguas PDU Metrificadas (Voltagem/Consumo)
  • [Nível 2] Monitoramento Ambiental (Sensores de Temperatura/Umidade)
  • [Nível 3] Configuração de Shutdown Automático em Falha de Energia

12. Web Servers - Nginx

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/4)

  • [Nível 1] Comandos Básicos (Start/Stop/Reload/Logs)
  • [Nível 2] Configuração de Virtual Hosts (Server Blocks)
  • [Nível 3] Reverse Proxy e Load Balancing
  • [Nível 3] Tuning de Performance e Caching

13. Web Servers - Apache

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/3)

  • [Nível 1] Comandos Básicos (Start/Stop/Reload/Logs)
  • [Nível 2] Configuração de Virtual Hosts (Sites-Available)
  • [Nível 3] Gerenciamento de Módulos e Security Hardening

14. Segurança Web - Certificados (Certbot/SSL)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/3)

  • [Nível 2] Emissão Padrão (Webroot Nginx/Apache)
  • [Nível 2] Emissão Standalone (Sem Web Server Ativo)
  • [Nível 2] Configuração de Renovação Automática e Hooks

15. Cloud - Nextcloud Hub

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/7)

  • [Nível 0] Guia de Uso Básico (Interface Web e App Mobile)
  • [Nível 1] Diagnóstico de Logs e Erros Comuns do PHP/System
  • [Nível 2] Administração de Usuários, Grupos e Cotas
  • [Nível 2] Migração e Transferência de Dados entre Usuários
  • [Nível 3] Integração com Office Online Server (OOS/Collabora)
  • [Nível 3] Troubleshooting de WebDAV, Disco e Permissões
  • [Nível 3] Tuning de PHP-FPM e Caching (Redis/APCu)

16. Cloud - Microsoft 365

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/5)

  • [Nível 2] Gestão de Licenças e Usuários (Admin Center)
  • [Nível 2] Configuração de Grupos e Equipes (Teams)
  • [Nível 3] Configuração de Sincronização de Diretório (Entra ID Connect)
  • [Nível 3] Políticas de Segurança e Acesso Condicional
  • [Nível 2] Configuração de Criptografia de Email (S/MIME e OME) para Jurídico

17. Cloud - Google Workspace (Edu/Corp)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/3)

  • [Nível 1] Gestão de Usuários e Rollover de Alunos (Edu)
  • [Nível 2] Filtro de Conteúdo e SafeSearch (Chrome Policies)
  • [Nível 2] Gestão de Chromebooks (Google Admin Console)

18. Processos e SOPs (NOC / Incidentes)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/4)

  • [Nível 1] Fluxo de Atendimento e Triagem Nível 1
  • [Nível 2] Procedimento de Escalonamento de Incidentes
  • [Nível 3] Gestão de Crise (War Room) e Comunicação
  • [Nível 3] Relatórios de Post-Mortem (RCA)

19. Backup & DR - Infraestrutura Virtual (Veeam)

Status: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100% (5/5)

  • [Nível 1] Verificação Diária de Jobs de VM (Success/Failure)
  • [Nível 2] Restauração de Arquivos Guest (Windows/Linux)
  • [Nível 2] Instant VM Recovery (Restauração Rápida)
  • [Nível 3] Configuração de Repositórios Imutáveis (Hardened Linux)
  • [Nível 3] Criação de Rotinas de Teste de Restore (SureBackup)

20. Gestão de Endpoints e Periféricos (ManageEngine)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/12)

  • [Nível 1] Inventário de Ativos (Hardware/Software)
  • [Nível 1] Ferramentas de Acesso Remoto e Chat
  • [Nível 2] Gestão de Patches e Atualizações Críticas
  • [Nível 2] Distribuição de Software (Pacotes .msi/.exe)
  • [Nível 2] MDM para Coletores Android (Kiosk Mode)
  • [Nível 2] Configuração de Impressoras Térmicas (Zebra) em Massa
  • [Nível 2] Instalação e Troubleshooting de Tokens/Smartcards (A3)
  • [Nível 3] Configuração de Políticas de Bloqueio USB/DLP
  • [Nível 3] Configuração de Assinadores Digitais e Banking
  • [Nível 2] Integração Básica de macOS em Redes Windows (SMB/Printers)
  • [Nível 2] Configuração de Scanners de Alta Produção e Fluxo GED (Jurídico)
  • [Nível 2] Gestão de Fontes e Assets Criativos (Agências)

21. Padronização de Workstations (Setup Base)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/4)

  • [Nível 1] Checklist de Configuração Inicial (OOBE)
  • [Nível 1] Instalação do Agente de Gestão e Antivírus
  • [Nível 2] Script de Debloat e Otimização do Windows
  • [Nível 2] Configuração de Criptografia de Disco (Bitlocker)

22. Ferramentas e Utilitários (SSH / Editores / Transferência)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/4)

  • [Nível 0] Acesso Remoto Seguro (SSH Keys/Putty)
  • [Nível 1] Transferência de Arquivos via SCP/WinSCP
  • [Nível 1] Editores de Texto em Terminal (Nano/Vim Básico)
  • [Nível 2] Tunelamento SSH (Port Forwarding) para Acesso Seguro

23. Monitoramento e VoIP (Zabbix / Asterisk)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/5)

  • [Nível 1] Zabbix: Adição de Hosts e Templates
  • [Nível 2] Zabbix: Criação de Triggers e Alertas
  • [Nível 1] VoIP: Diagnóstico de Ramais e Softphones
  • [Nível 2] VoIP: Troubleshooting de Áudio (RTP/NAT) e Logs
  • [Nível 2] MagnusBilling: Gestão de Tarifas e Troncos SIP

24. Desenvolvimento e BI (VSCode / PowerBI)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/3)

  • [Nível 1] VSCode Server: Ambiente de Desenvolvimento Remoto
  • [Nível 2] PowerBI Report Server: Deploy e Atualização de Relatórios (.pbix)
  • [Nível 1] Gitea: Gestão Básica de Repositórios Git Self-Hosted

25. Segurança de E-mail (Proxmox Mail Gateway)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/3)

  • [Nível 1] Rastreamento de Logs (Tracking Center)
  • [Nível 2] Gestão de Whitelist/Blacklist e Regras de Spam
  • [Nível 3] Cluster PMG e Alta Disponibilidade

26. Administração Web (Webmin)

Status: ░░░░░░░░░░░░░░░░░░░░ 0% (0/2)

  • [Nível 1] Instalação e Acesso Seguro ao Webmin
  • [Nível 2] Gestão de Serviços (Apache/Postfix) via Interface Web

📂 Estrutura de Pastas e Níveis

A documentação segue estritamente a estrutura: documentacao [tema] / Nivel_[X].

  • Nivel_0 (Cliente): Tutoriais visuais passo-a-passo.
  • Nivel_1 (Service Desk): Procedimentos operacionais padrão (SOP).
  • Nivel_2 (NOC/Infra): Configuração, manutenção e análise técnica.
  • Nivel_3 (Engenharia): Arquitetura, Disaster Recovery e scripts avançados.

🛠 Como Gerar Novos PDFs

Utilize o comando abaixo na raiz do projeto:

python .gemini/convert_to_pdf.py "Caminho/Para/SeuManual.md"

O script detecta imagens, formata tabelas e aplica o padrão visual iT Guys automaticamente.