Docs: Update README with manual status board

This commit is contained in:
João Pedro Toledo Goncalves 2026-01-23 07:37:29 -03:00
parent 9e3dbc1097
commit c4d3f8609b
1 changed files with 114 additions and 23 deletions

137
README.md
View File

@ -2,32 +2,123 @@
Este repositório contém a documentação técnica da iT Guys, organizada por sistemas e níveis de acesso. Este repositório contém a documentação técnica da iT Guys, organizada por sistemas e níveis de acesso.
## Estrutura de Pastas ## 📊 Quadro de Status dos Manuais
* **documentacao exchange/**: Manuais relacionados ao Microsoft Exchange. ### 1. Rede e Segurança (pfSense / Suricata / OpenVPN)
* **documentacao vmware/**: Manuais relacionados ao ambiente VMWare. - [ ] [Nível 1] Diagnóstico de Conectividade e Logs
* **documentacao rede e seguranca/**: Pfsense. - [ ] [Nível 2] Gestão de Regras de Firewall e Aliases
* **documentacao storage/**: TrueNAS, Samba, NFS, iSCSI. - [ ] [Nível 2] Configuração e Troubleshooting de VPN
* **documentacao bancos de dados/**: PostgreSQL, MySQL. - [ ] [Nível 3] Backup e Restauração de Configurações
* **documentacao windows/**: Active Directory, DNS, Firewall, GPO. - [ ] [Nível 3] Atualização e Hardening
* **documentacao linux/**: Ubuntu, Debian, Alpine. - [ ] [Nível 2] Suricata: Instalação e Integração
* **documentacao virtualizacao/**: Proxmox. - [ ] [Nível 2] Suricata: Gestão de Regras
* **documentacao conteineres/**: Docker, Docker-compose, Portainer. - [ ] [Nível 3] Suricata: Análise de Alertas
* **documentacao aplicativos/**: Zammad, Zabbix, Gitea, VoIP. - [ ] [Nível 1] OpenVPN: Instalação do Servidor
* **documentacao navegadores/**: Chrome, Firefox. - [ ] [Nível 2] OpenVPN: Configuração de Clientes
* **documentacao ferramentas/**: Putty, SSH. - [ ] [Nível 3] OpenVPN: Troubleshooting de Conexão
* **.gemini/**: Scripts e assets utilitários para padronização e geração de PDFs. - [ ] [Nível 2] VLANs: Conceitos e Configuração
- [ ] [Nível 2] VLANs: Configuração em pfSense/Linux
- [ ] [Nível 3] VLANs: Troubleshooting
## Como Gerar PDFs ### 2. Storage (TrueNAS / ZFS)
- [ ] [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] Manutenção de ZFS (Scrub/Resilver)
- [ ] [Nível 3] Configuração de iSCSI Target
Utilize o script localizado em `.gemini/convert_to_pdf.py` para converter os arquivos Markdown em PDF seguindo o padrão visual da iT Guys. ### 3. Bancos de Dados (PostgreSQL / MySQL / Redis)
- [ ] [Nível 1] Backup e Restore Básico
- [ ] [Nível 2] Manutenção Preventiva (Vacuum/Optimize)
- [ ] [Nível 2] Gestão de Usuários e Permissões
- [ ] [Nível 3] Troubleshooting de Performance
- [ ] [Nível 1] Redis: Instalação e Comandos
- [ ] [Nível 2] Redis: Persistência e Segurança
- [ ] [Nível 3] Redis: Troubleshooting de Memória
### 4. Windows Server (AD / DNS / GPO)
- [ ] [Nível 1] Criação e Bloqueio de Usuários (Padrão)
- [ ] [Nível 2] Manutenção de DNS e DHCP
- [ ] [Nível 3] Diagnóstico de Replicação (DCDIAG)
- [ ] [Nível 3] Gestão Centralizada via GPO
- [ ] [Nível 3] Disaster Recovery do Active Directory
### 5. Microsoft Exchange (Exchange 2019)
- [x] [Nível 0] Como Acessar e Configurar Webmail e Celular
- [x] [Nível 0] Como Configurar Resposta Automatica de Ferias
- [x] [Nível 1] Diagnostico Basico - Usuario nao recebe e-mail
- [x] [Nível 1] Procedimento de Criacao e Bloqueio de Usuarios
- [x] [Nível 2] Gerenciamento de Cotas e Arquivamento
- [x] [Nível 2] Gerenciamento de Quarentena Movel
- [x] [Nível 2] Gestao de Permissoes (Full Access/Send As)
- [x] [Nível 2] Solucao de Problemas de Lista de Enderecos
- [x] [Nível 3] Acesso ao Servidor Windows Core e PowerShell
- [x] [Nível 3] Arquitetura Tecnica e Mapeamento
- [x] [Nível 3] Auditoria Administrativa e Logs
- [x] [Nível 3] Checklist de Manutencao Diaria/Semanal
- [x] [Nível 3] Disaster Recovery e Soft Restore
- [x] [Nível 3] Gestao de Conectores e Roteamento
- [x] [Nível 3] Referencia de Operacoes via PowerShell
- [x] [Nível 3] Relatorios Avancados
- [x] [Nível 3] Renovacao de Certificado SSL
### 6. Virtualização (VMware / Proxmox)
**VMware:**
- [x] [Nível 1] Visão Geral e Escopo
- [x] [Nível 1] Verificação Básica de VM
- [x] [Nível 1] Operações de Energia
- [x] [Nível 1] Monitoramento Básico
- [x] [Nível 2] Gestão de Recursos
- [x] [Nível 2] Networking e Storage
- [x] [Nível 2] Manutenção e Lifecycle
- [x] [Nível 2] Troubleshooting
- [x] [Nível 3] CLI Troubleshooting
- [x] [Nível 3] Networking Avançado
- [x] [Nível 3] Storage Deep Dive
- [x] [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)
- [ ] [Nível 1] Deploy e Update de Stacks
- [ ] [Nível 2] Diagnóstico de Containers
- [ ] [Nível 2] Manutenção de Disco (Prune)
- [ ] [Nível 3] Backup de Volumes
### 8. Linux Server
- [ ] [Nível 1] Comandos Essenciais de Diagnóstico
- [ ] [Nível 2] Gerenciamento de Pacotes e Updates
- [ ] [Nível 2] Configuração de Firewall
- [ ] [Nível 3] Hardening de Servidor
- [ ] [Nível 3] Análise de Logs (Journalctl)
**Novas Seções (Fase 2 & 3):**
- [ ] [Nível 1-3] Service Desk (Zammad)
- [ ] [Nível 1-3] Hardware e Infraestrutura (iDRAC/UPS)
- [ ] [Nível 2-3] Scripting e Automação (PowerShell/Bash)
- [ ] [Nível 1-3] Processos e SOPs (NOC/Incidentes)
- [ ] [Nível 1-3] Ferramentas e Web Servers (Nginx/Apache/FTP/Certbot)
- [ ] [Nível 1-3] Cloud e Colaboração (Nextcloud/Office)
---
## 📂 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:
**Comando:**
```powershell ```powershell
python .gemini/convert_to_pdf.py "Caminho/Para/Arquivo.md" 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.*
## Padrões
Toda a documentação deve seguir o padrão definido no **MTITG 002-23**.
Consulte os templates existentes e as regras de formatação antes de criar novos documentos.