From b83ae5b28fe83f8d50f99415b5a845838e90f2d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Pedro=20Toledo?= <joao.goncalves@itguys.com.br>
Date: Thu, 22 Jan 2026 23:25:06 -0300
Subject: [PATCH] feat: expand documentation structure for new technologies

---
 .gemini/create_structure.py                   | 41 +++++++++++++++++++
 README.md                                     | 10 +++++
 documentacao aplicativos/README.md            |  3 ++
 documentacao aplicativos/asterisk/README.md   |  3 ++
 documentacao aplicativos/gitea/README.md      |  3 ++
 .../magnusbilling/README.md                   |  3 ++
 documentacao aplicativos/technium/README.md   |  3 ++
 documentacao aplicativos/zabbix/README.md     |  3 ++
 documentacao aplicativos/zammad/README.md     |  3 ++
 documentacao bancos de dados/README.md        |  3 ++
 documentacao bancos de dados/mysql/README.md  |  3 ++
 .../postgresql/README.md                      |  3 ++
 documentacao conteineres/README.md            |  3 ++
 .../docker-compose/README.md                  |  3 ++
 documentacao conteineres/docker/README.md     |  3 ++
 documentacao conteineres/portainer/README.md  |  3 ++
 documentacao ferramentas/README.md            |  3 ++
 documentacao ferramentas/putty/README.md      |  3 ++
 documentacao ferramentas/ssh/README.md        |  3 ++
 documentacao linux/README.md                  |  3 ++
 documentacao linux/alpine/README.md           |  3 ++
 documentacao linux/debian/README.md           |  3 ++
 documentacao linux/ubuntu/README.md           |  3 ++
 documentacao navegadores/README.md            |  3 ++
 documentacao navegadores/firefox/README.md    |  3 ++
 .../google_chrome/README.md                   |  3 ++
 documentacao rede e seguranca/README.md       |  3 ++
 .../pfsense/README.md                         |  3 ++
 documentacao storage/README.md                |  3 ++
 documentacao storage/iscsi/README.md          |  3 ++
 documentacao storage/nfs/README.md            |  3 ++
 documentacao storage/samba/README.md          |  3 ++
 documentacao storage/truenas/README.md        |  3 ++
 documentacao virtualizacao/README.md          |  3 ++
 documentacao virtualizacao/proxmox/README.md  |  3 ++
 documentacao windows/README.md                |  3 ++
 .../active_directory/README.md                |  3 ++
 documentacao windows/dns/README.md            |  3 ++
 documentacao windows/firewall/README.md       |  3 ++
 documentacao windows/gpo/README.md            |  3 ++
 40 files changed, 165 insertions(+)
 create mode 100644 .gemini/create_structure.py
 create mode 100644 documentacao aplicativos/README.md
 create mode 100644 documentacao aplicativos/asterisk/README.md
 create mode 100644 documentacao aplicativos/gitea/README.md
 create mode 100644 documentacao aplicativos/magnusbilling/README.md
 create mode 100644 documentacao aplicativos/technium/README.md
 create mode 100644 documentacao aplicativos/zabbix/README.md
 create mode 100644 documentacao aplicativos/zammad/README.md
 create mode 100644 documentacao bancos de dados/README.md
 create mode 100644 documentacao bancos de dados/mysql/README.md
 create mode 100644 documentacao bancos de dados/postgresql/README.md
 create mode 100644 documentacao conteineres/README.md
 create mode 100644 documentacao conteineres/docker-compose/README.md
 create mode 100644 documentacao conteineres/docker/README.md
 create mode 100644 documentacao conteineres/portainer/README.md
 create mode 100644 documentacao ferramentas/README.md
 create mode 100644 documentacao ferramentas/putty/README.md
 create mode 100644 documentacao ferramentas/ssh/README.md
 create mode 100644 documentacao linux/README.md
 create mode 100644 documentacao linux/alpine/README.md
 create mode 100644 documentacao linux/debian/README.md
 create mode 100644 documentacao linux/ubuntu/README.md
 create mode 100644 documentacao navegadores/README.md
 create mode 100644 documentacao navegadores/firefox/README.md
 create mode 100644 documentacao navegadores/google_chrome/README.md
 create mode 100644 documentacao rede e seguranca/README.md
 create mode 100644 documentacao rede e seguranca/pfsense/README.md
 create mode 100644 documentacao storage/README.md
 create mode 100644 documentacao storage/iscsi/README.md
 create mode 100644 documentacao storage/nfs/README.md
 create mode 100644 documentacao storage/samba/README.md
 create mode 100644 documentacao storage/truenas/README.md
 create mode 100644 documentacao virtualizacao/README.md
 create mode 100644 documentacao virtualizacao/proxmox/README.md
 create mode 100644 documentacao windows/README.md
 create mode 100644 documentacao windows/active_directory/README.md
 create mode 100644 documentacao windows/dns/README.md
 create mode 100644 documentacao windows/firewall/README.md
 create mode 100644 documentacao windows/gpo/README.md

diff --git a/.gemini/create_structure.py b/.gemini/create_structure.py
new file mode 100644
index 0000000..3544c75
--- /dev/null
+++ b/.gemini/create_structure.py
@@ -0,0 +1,41 @@
+import os
+
+root_dir = r"c:\Users\joao.goncalves\Desktop\manuais zammad"
+
+structure = {
+    "documentacao rede e seguranca": ["pfsense"],
+    "documentacao storage": ["truenas", "samba", "nfs", "iscsi"],
+    "documentacao bancos de dados": ["postgresql", "mysql"],
+    "documentacao windows": ["active directory", "dns", "firewall", "gpo"],
+    "documentacao linux": ["ubuntu", "debian", "alpine"],
+    "documentacao virtualizacao": ["proxmox"],
+    "documentacao conteineres": ["docker", "docker-compose", "portainer"],
+    "documentacao aplicativos": ["gitea", "zammad", "zabbix", "technium", "magnusbilling", "asterisk"],
+    "documentacao navegadores": ["google chrome", "firefox"],
+    "documentacao ferramentas": ["putty", "ssh"]
+}
+
+for category, subitems in structure.items():
+    cat_path = os.path.join(root_dir, category)
+    if not os.path.exists(cat_path):
+        os.makedirs(cat_path)
+        print(f"Created category: {category}")
+    
+    # Create category README
+    with open(os.path.join(cat_path, "README.md"), "w", encoding="utf-8") as f:
+        f.write(f"# {category.replace('documentacao ', '').title()}\n\nManuais relacionados a {category.replace('documentacao ', '')}.\n")
+
+    for item in subitems:
+        # Create subdirectories for each item to keep it clean, or just keep them in the category? 
+        # The user's list is long. Specific folders for each item is better for organization.
+        item_slug = item.replace(" ", "_")
+        item_path = os.path.join(cat_path, item_slug)
+        
+        if not os.path.exists(item_path):
+            os.makedirs(item_path)
+            print(f"  Created item: {item}")
+            
+        with open(os.path.join(item_path, "README.md"), "w", encoding="utf-8") as f:
+            f.write(f"# Documentação {item.title()}\n\nLocal para manuais e procedimentos referentes ao **{item.title()}**.\n")
+
+print("Directory structure created successfully.")
diff --git a/README.md b/README.md
index d17a411..0fa0291 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,16 @@ Este repositório contém a documentação técnica da iT Guys, organizada por s
 
 *   **documentacao exchange/**: Manuais relacionados ao Microsoft Exchange.
 *   **documentacao vmware/**: Manuais relacionados ao ambiente VMWare.
+*   **documentacao rede e seguranca/**: Pfsense.
+*   **documentacao storage/**: TrueNAS, Samba, NFS, iSCSI.
+*   **documentacao bancos de dados/**: PostgreSQL, MySQL.
+*   **documentacao windows/**: Active Directory, DNS, Firewall, GPO.
+*   **documentacao linux/**: Ubuntu, Debian, Alpine.
+*   **documentacao virtualizacao/**: Proxmox.
+*   **documentacao conteineres/**: Docker, Docker-compose, Portainer.
+*   **documentacao aplicativos/**: Zammad, Zabbix, Gitea, VoIP.
+*   **documentacao navegadores/**: Chrome, Firefox.
+*   **documentacao ferramentas/**: Putty, SSH.
 *   **.gemini/**: Scripts e assets utilitários para padronização e geração de PDFs.
 
 ## Como Gerar PDFs
diff --git a/documentacao aplicativos/README.md b/documentacao aplicativos/README.md
new file mode 100644
index 0000000..99ade3d
--- /dev/null
+++ b/documentacao aplicativos/README.md	
@@ -0,0 +1,3 @@
+# Aplicativos
+
+Manuais relacionados a aplicativos.
diff --git a/documentacao aplicativos/asterisk/README.md b/documentacao aplicativos/asterisk/README.md
new file mode 100644
index 0000000..e69c231
--- /dev/null
+++ b/documentacao aplicativos/asterisk/README.md	
@@ -0,0 +1,3 @@
+# Documentação Asterisk
+
+Local para manuais e procedimentos referentes ao **Asterisk**.
diff --git a/documentacao aplicativos/gitea/README.md b/documentacao aplicativos/gitea/README.md
new file mode 100644
index 0000000..091fb3b
--- /dev/null
+++ b/documentacao aplicativos/gitea/README.md	
@@ -0,0 +1,3 @@
+# Documentação Gitea
+
+Local para manuais e procedimentos referentes ao **Gitea**.
diff --git a/documentacao aplicativos/magnusbilling/README.md b/documentacao aplicativos/magnusbilling/README.md
new file mode 100644
index 0000000..a30ef66
--- /dev/null
+++ b/documentacao aplicativos/magnusbilling/README.md	
@@ -0,0 +1,3 @@
+# Documentação Magnusbilling
+
+Local para manuais e procedimentos referentes ao **Magnusbilling**.
diff --git a/documentacao aplicativos/technium/README.md b/documentacao aplicativos/technium/README.md
new file mode 100644
index 0000000..347b2b6
--- /dev/null
+++ b/documentacao aplicativos/technium/README.md	
@@ -0,0 +1,3 @@
+# Documentação Technium
+
+Local para manuais e procedimentos referentes ao **Technium**.
diff --git a/documentacao aplicativos/zabbix/README.md b/documentacao aplicativos/zabbix/README.md
new file mode 100644
index 0000000..4ad9cce
--- /dev/null
+++ b/documentacao aplicativos/zabbix/README.md	
@@ -0,0 +1,3 @@
+# Documentação Zabbix
+
+Local para manuais e procedimentos referentes ao **Zabbix**.
diff --git a/documentacao aplicativos/zammad/README.md b/documentacao aplicativos/zammad/README.md
new file mode 100644
index 0000000..0e1e539
--- /dev/null
+++ b/documentacao aplicativos/zammad/README.md	
@@ -0,0 +1,3 @@
+# Documentação Zammad
+
+Local para manuais e procedimentos referentes ao **Zammad**.
diff --git a/documentacao bancos de dados/README.md b/documentacao bancos de dados/README.md
new file mode 100644
index 0000000..cce6ca9
--- /dev/null
+++ b/documentacao bancos de dados/README.md	
@@ -0,0 +1,3 @@
+# Bancos De Dados
+
+Manuais relacionados a bancos de dados.
diff --git a/documentacao bancos de dados/mysql/README.md b/documentacao bancos de dados/mysql/README.md
new file mode 100644
index 0000000..3acff90
--- /dev/null
+++ b/documentacao bancos de dados/mysql/README.md	
@@ -0,0 +1,3 @@
+# Documentação Mysql
+
+Local para manuais e procedimentos referentes ao **Mysql**.
diff --git a/documentacao bancos de dados/postgresql/README.md b/documentacao bancos de dados/postgresql/README.md
new file mode 100644
index 0000000..37fb8ec
--- /dev/null
+++ b/documentacao bancos de dados/postgresql/README.md	
@@ -0,0 +1,3 @@
+# Documentação Postgresql
+
+Local para manuais e procedimentos referentes ao **Postgresql**.
diff --git a/documentacao conteineres/README.md b/documentacao conteineres/README.md
new file mode 100644
index 0000000..303f59a
--- /dev/null
+++ b/documentacao conteineres/README.md	
@@ -0,0 +1,3 @@
+# Conteineres
+
+Manuais relacionados a conteineres.
diff --git a/documentacao conteineres/docker-compose/README.md b/documentacao conteineres/docker-compose/README.md
new file mode 100644
index 0000000..db08192
--- /dev/null
+++ b/documentacao conteineres/docker-compose/README.md	
@@ -0,0 +1,3 @@
+# Documentação Docker-Compose
+
+Local para manuais e procedimentos referentes ao **Docker-Compose**.
diff --git a/documentacao conteineres/docker/README.md b/documentacao conteineres/docker/README.md
new file mode 100644
index 0000000..01c0b3e
--- /dev/null
+++ b/documentacao conteineres/docker/README.md	
@@ -0,0 +1,3 @@
+# Documentação Docker
+
+Local para manuais e procedimentos referentes ao **Docker**.
diff --git a/documentacao conteineres/portainer/README.md b/documentacao conteineres/portainer/README.md
new file mode 100644
index 0000000..7a5574f
--- /dev/null
+++ b/documentacao conteineres/portainer/README.md	
@@ -0,0 +1,3 @@
+# Documentação Portainer
+
+Local para manuais e procedimentos referentes ao **Portainer**.
diff --git a/documentacao ferramentas/README.md b/documentacao ferramentas/README.md
new file mode 100644
index 0000000..759f852
--- /dev/null
+++ b/documentacao ferramentas/README.md	
@@ -0,0 +1,3 @@
+# Ferramentas
+
+Manuais relacionados a ferramentas.
diff --git a/documentacao ferramentas/putty/README.md b/documentacao ferramentas/putty/README.md
new file mode 100644
index 0000000..ef7d845
--- /dev/null
+++ b/documentacao ferramentas/putty/README.md	
@@ -0,0 +1,3 @@
+# Documentação Putty
+
+Local para manuais e procedimentos referentes ao **Putty**.
diff --git a/documentacao ferramentas/ssh/README.md b/documentacao ferramentas/ssh/README.md
new file mode 100644
index 0000000..86734e2
--- /dev/null
+++ b/documentacao ferramentas/ssh/README.md	
@@ -0,0 +1,3 @@
+# Documentação Ssh
+
+Local para manuais e procedimentos referentes ao **Ssh**.
diff --git a/documentacao linux/README.md b/documentacao linux/README.md
new file mode 100644
index 0000000..bd2826e
--- /dev/null
+++ b/documentacao linux/README.md	
@@ -0,0 +1,3 @@
+# Linux
+
+Manuais relacionados a linux.
diff --git a/documentacao linux/alpine/README.md b/documentacao linux/alpine/README.md
new file mode 100644
index 0000000..a117518
--- /dev/null
+++ b/documentacao linux/alpine/README.md	
@@ -0,0 +1,3 @@
+# Documentação Alpine
+
+Local para manuais e procedimentos referentes ao **Alpine**.
diff --git a/documentacao linux/debian/README.md b/documentacao linux/debian/README.md
new file mode 100644
index 0000000..12194a0
--- /dev/null
+++ b/documentacao linux/debian/README.md	
@@ -0,0 +1,3 @@
+# Documentação Debian
+
+Local para manuais e procedimentos referentes ao **Debian**.
diff --git a/documentacao linux/ubuntu/README.md b/documentacao linux/ubuntu/README.md
new file mode 100644
index 0000000..e5cf7fd
--- /dev/null
+++ b/documentacao linux/ubuntu/README.md	
@@ -0,0 +1,3 @@
+# Documentação Ubuntu
+
+Local para manuais e procedimentos referentes ao **Ubuntu**.
diff --git a/documentacao navegadores/README.md b/documentacao navegadores/README.md
new file mode 100644
index 0000000..eefc284
--- /dev/null
+++ b/documentacao navegadores/README.md	
@@ -0,0 +1,3 @@
+# Navegadores
+
+Manuais relacionados a navegadores.
diff --git a/documentacao navegadores/firefox/README.md b/documentacao navegadores/firefox/README.md
new file mode 100644
index 0000000..7944e94
--- /dev/null
+++ b/documentacao navegadores/firefox/README.md	
@@ -0,0 +1,3 @@
+# Documentação Firefox
+
+Local para manuais e procedimentos referentes ao **Firefox**.
diff --git a/documentacao navegadores/google_chrome/README.md b/documentacao navegadores/google_chrome/README.md
new file mode 100644
index 0000000..0814672
--- /dev/null
+++ b/documentacao navegadores/google_chrome/README.md	
@@ -0,0 +1,3 @@
+# Documentação Google Chrome
+
+Local para manuais e procedimentos referentes ao **Google Chrome**.
diff --git a/documentacao rede e seguranca/README.md b/documentacao rede e seguranca/README.md
new file mode 100644
index 0000000..0fe2855
--- /dev/null
+++ b/documentacao rede e seguranca/README.md	
@@ -0,0 +1,3 @@
+# Rede E Seguranca
+
+Manuais relacionados a rede e seguranca.
diff --git a/documentacao rede e seguranca/pfsense/README.md b/documentacao rede e seguranca/pfsense/README.md
new file mode 100644
index 0000000..021d012
--- /dev/null
+++ b/documentacao rede e seguranca/pfsense/README.md	
@@ -0,0 +1,3 @@
+# Documentação Pfsense
+
+Local para manuais e procedimentos referentes ao **Pfsense**.
diff --git a/documentacao storage/README.md b/documentacao storage/README.md
new file mode 100644
index 0000000..9ccd866
--- /dev/null
+++ b/documentacao storage/README.md	
@@ -0,0 +1,3 @@
+# Storage
+
+Manuais relacionados a storage.
diff --git a/documentacao storage/iscsi/README.md b/documentacao storage/iscsi/README.md
new file mode 100644
index 0000000..67a6b9a
--- /dev/null
+++ b/documentacao storage/iscsi/README.md	
@@ -0,0 +1,3 @@
+# Documentação Iscsi
+
+Local para manuais e procedimentos referentes ao **Iscsi**.
diff --git a/documentacao storage/nfs/README.md b/documentacao storage/nfs/README.md
new file mode 100644
index 0000000..156357b
--- /dev/null
+++ b/documentacao storage/nfs/README.md	
@@ -0,0 +1,3 @@
+# Documentação Nfs
+
+Local para manuais e procedimentos referentes ao **Nfs**.
diff --git a/documentacao storage/samba/README.md b/documentacao storage/samba/README.md
new file mode 100644
index 0000000..0c39214
--- /dev/null
+++ b/documentacao storage/samba/README.md	
@@ -0,0 +1,3 @@
+# Documentação Samba
+
+Local para manuais e procedimentos referentes ao **Samba**.
diff --git a/documentacao storage/truenas/README.md b/documentacao storage/truenas/README.md
new file mode 100644
index 0000000..824e8db
--- /dev/null
+++ b/documentacao storage/truenas/README.md	
@@ -0,0 +1,3 @@
+# Documentação Truenas
+
+Local para manuais e procedimentos referentes ao **Truenas**.
diff --git a/documentacao virtualizacao/README.md b/documentacao virtualizacao/README.md
new file mode 100644
index 0000000..418f3fd
--- /dev/null
+++ b/documentacao virtualizacao/README.md	
@@ -0,0 +1,3 @@
+# Virtualizacao
+
+Manuais relacionados a virtualizacao.
diff --git a/documentacao virtualizacao/proxmox/README.md b/documentacao virtualizacao/proxmox/README.md
new file mode 100644
index 0000000..c2851d8
--- /dev/null
+++ b/documentacao virtualizacao/proxmox/README.md	
@@ -0,0 +1,3 @@
+# Documentação Proxmox
+
+Local para manuais e procedimentos referentes ao **Proxmox**.
diff --git a/documentacao windows/README.md b/documentacao windows/README.md
new file mode 100644
index 0000000..7d39b6a
--- /dev/null
+++ b/documentacao windows/README.md	
@@ -0,0 +1,3 @@
+# Windows
+
+Manuais relacionados a windows.
diff --git a/documentacao windows/active_directory/README.md b/documentacao windows/active_directory/README.md
new file mode 100644
index 0000000..42958c4
--- /dev/null
+++ b/documentacao windows/active_directory/README.md	
@@ -0,0 +1,3 @@
+# Documentação Active Directory
+
+Local para manuais e procedimentos referentes ao **Active Directory**.
diff --git a/documentacao windows/dns/README.md b/documentacao windows/dns/README.md
new file mode 100644
index 0000000..ae7006c
--- /dev/null
+++ b/documentacao windows/dns/README.md	
@@ -0,0 +1,3 @@
+# Documentação Dns
+
+Local para manuais e procedimentos referentes ao **Dns**.
diff --git a/documentacao windows/firewall/README.md b/documentacao windows/firewall/README.md
new file mode 100644
index 0000000..698a4fb
--- /dev/null
+++ b/documentacao windows/firewall/README.md	
@@ -0,0 +1,3 @@
+# Documentação Firewall
+
+Local para manuais e procedimentos referentes ao **Firewall**.
diff --git a/documentacao windows/gpo/README.md b/documentacao windows/gpo/README.md
new file mode 100644
index 0000000..322eb51
--- /dev/null
+++ b/documentacao windows/gpo/README.md	
@@ -0,0 +1,3 @@
+# Documentação Gpo
+
+Local para manuais e procedimentos referentes ao **Gpo**.