docs: renomeia terminologia "staging" -> "dev" (ambiente nunca foi isolado)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-16 03:39:15 +02:00
parent 7d30c1aebe
commit 2064ff1ae7
8 changed files with 28 additions and 28 deletions
@@ -25,7 +25,7 @@ AllowedIPs = 10.99.0.10/32
 PublicKey = S40JqovA4F8oH8aieWsDvNEv1yw5Juwu1wb4zHjQ8Ww=
 AllowedIPs = 10.99.0.3/32
-# Peer 3: VPS 4 (Desenvolvimento / Staging)
+# Peer 3: VPS 4 (Desenvolvimento / Dev)
 [Peer]
 PublicKey = ln7phEfm4w//jZJqqlkGAjsXKWQnOw2kYc64ni5PXX0=
 AllowedIPs = 10.99.0.4/32
@@ -1,4 +1,4 @@
-# 🧪 Configuração de Rede Segura (VPN WireGuard) - VPS 4 (Desenvolvimento / Staging)
+# 🧪 Configuração de Rede Segura (VPN WireGuard) - VPS 4 (Desenvolvimento / Dev)
 Este diretório contém os arquivos de configuração necessários para que a **VPS 4** (`10.99.0.4`) entre na rede privada criptografada do **Clube67** de forma totalmente segura.
@@ -7,7 +7,7 @@ Este diretório contém os arquivos de configuração necessários para que a **
 ## 🗺️ Visão de Conexão da VPS 4
 ```mermaid
 graph LR
-    VPS4["🧪 VPS 4 (Staging) <br> IP: 10.99.0.4"]
+    VPS4["🧪 VPS 4 (Dev) <br> IP: 10.99.0.4"]
    VPS1["🖥️ VPS 1 (Hub Central) <br> IP: 10.99.0.1"]
    VPS3["🗄️ VPS 3 (Banco de Dados) <br> IP: 10.99.0.3"]
@@ -37,7 +37,7 @@ Antes de ativar a conexão na VPS 4, o servidor central (**VPS 1**) precisa auto
 3. Adicione o seguinte bloco de peer ao final do arquivo:
   ```ini
   [Peer]
-   # VPS 4 (Desenvolvimento / Staging)
+   # VPS 4 (Desenvolvimento / Dev)
   PublicKey = ln7phEfm4w//jZJqqlkGAjsXKWQnOw2kYc64ni5PXX0=
   AllowedIPs = 10.99.0.4/32
   PersistentKeepalive = 25
@@ -2,7 +2,7 @@
 # Adicione este bloco ao final do arquivo para autorizar a conexão da VPS 4
 [Peer]
-# VPS 4 (Desenvolvimento / Staging)
+# VPS 4 (Desenvolvimento / Dev)
 PublicKey = ln7phEfm4w//jZJqqlkGAjsXKWQnOw2kYc64ni5PXX0=
 AllowedIPs = 10.99.0.4/32
 PersistentKeepalive = 25
@@ -1,4 +1,4 @@
-# /etc/wireguard/wg0.conf - VPS 4 (Desenvolvimento / Staging)
+# /etc/wireguard/wg0.conf - VPS 4 (Desenvolvimento / Dev)
 # Configuração de Cliente VPN WireGuard
 # IP Atribuído: 10.99.0.4
@@ -18,7 +18,7 @@ graph TD
    subgraph "Rede Privada VPN (10.99.0.0/24)"
        VPS1["🖥️ VPS 1 (Produção) <br> IP: 10.99.0.1 <br> (Traefik / Apps)"]
        VPS3["🗄️ VPS 3 (Banco de Dados) <br> IP: 10.99.0.3 <br> (PostgreSQL Dedicado)"]
-        VPS4["🧪 VPS 4 (Desenvolvimento) <br> IP: 10.99.0.4 <br> (Staging / Builds)"]
+        VPS4["🧪 VPS 4 (Desenvolvimento) <br> IP: 10.99.0.4 <br> (Dev / Builds)"]
        VPS5["💬 VPS 5 (CRM WhatsApp) <br> IP: 10.99.0.5 <br> (Bots / APIs)"]
    end
@@ -77,15 +77,15 @@ graph TD
 ---
-### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Staging)
+### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Dev)
-* **Função Principal**: Testar novos recursos, hospedar containers de staging e realizar builds de desenvolvimento.
+* **Função Principal**: Testar novos recursos, hospedar containers de dev e realizar builds de desenvolvimento.
 * **IP Privado VPN**: `10.99.0.4`
 * **Políticas do Firewall (UFW)**:
  * **Porta 22 (SSH)**: **Bloqueada publicamente**. Apenas acessível via VPN.
  * **Portas de teste (ex: 3002, 8080)**: **Bloqueadas publicamente** ou atreladas apenas ao IP privado da VPN para acesso exclusivo dos desenvolvedores autorizados.
 * **Tecnologias**: Docker, Docker Compose, PostgreSQL 18 (Standby Replica em Container).
 * **Vantagens de Segurança & Performance**:
-  * **Replicação Streaming Real-Time (Staging)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal.
+  * **Replicação Streaming Real-Time (Dev)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal.
  * **Isolamento de Riscos**: Compilações de código (`npm run build`, `docker build`) e testes pesados de carga rodam aqui e consomem CPU sem comprometer os servidores de produção e banco de dados.
  * **Ambiente Espelho**: Homologação idêntica à produção para validações precisas antes de aplicar modificações em produção.
@@ -205,15 +205,15 @@ graph TD
 A rede VPN WireGuard (`10.99.0.0/24`) deixa de ser tratada como uma zona de confiança irrestrita. Implementa-se uma política de privilégio mínimo na comunicação entre os servidores da VPN.
 * **O Problema de Movimentação Lateral**:
-  Se a máquina de desenvolvimento/staging (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados.
+  Se a máquina de desenvolvimento/dev (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados.
 * **Regras de Isolamento Lateral (Exemplo no Firewall da VPS 3)**:
  ```text
  # Bloquear por padrão toda conexão vinda da VPN exceto as estritamente autorizadas:
  - Permitir VPS 1 (Produção) -> Porta 5432 (PostgreSQL)                       [ACEITAR]
  - Permitir VPS 5 (CRM)       -> Porta 5432 (PostgreSQL)                       [ACEITAR]
-  - Permitir VPS 4 (Staging)   -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR]
+  - Permitir VPS 4 (Dev)   -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR]
-  - Permitir VPS 4 (Staging)   -> VPS 3 (Produção - Outras portas / serviços)   [BLOQUEAR]
+  - Permitir VPS 4 (Dev)   -> VPS 3 (Produção - Outras portas / serviços)   [BLOQUEAR]
  ```
 * **🌐 DNS e Acesso Seguro à Internet no WireGuard**:
@@ -18,7 +18,7 @@ graph TD
    subgraph "Rede Privada VPN (10.99.0.0/24)"
        VPS1["🖥️ VPS 1 (Produção) <br> IP: 10.99.0.1 <br> (Traefik / Apps)"]
        VPS3["🗄️ VPS 3 (Banco de Dados) <br> IP: 10.99.0.3 <br> (PostgreSQL Dedicado)"]
-        VPS4["🧪 VPS 4 (Desenvolvimento) <br> IP: 10.99.0.4 <br> (Staging / Builds)"]
+        VPS4["🧪 VPS 4 (Desenvolvimento) <br> IP: 10.99.0.4 <br> (Dev / Builds)"]
        VPS5["💬 VPS 5 (CRM WhatsApp) <br> IP: 10.99.0.5 <br> (Bots / APIs)"]
    end
@@ -77,15 +77,15 @@ graph TD
 ---
-### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Staging)
+### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Dev)
-* **Função Principal**: Testar novos recursos, hospedar containers de staging e realizar builds de desenvolvimento.
+* **Função Principal**: Testar novos recursos, hospedar containers de dev e realizar builds de desenvolvimento.
 * **IP Privado VPN**: `10.99.0.4`
 * **Políticas do Firewall (UFW)**:
  * **Porta 22 (SSH)**: **Bloqueada publicamente**. Apenas acessível via VPN.
  * **Portas de teste (ex: 3002, 8080)**: **Bloqueadas publicamente** ou atreladas apenas ao IP privado da VPN para acesso exclusivo dos desenvolvedores autorizados.
 * **Tecnologias**: Docker, Docker Compose, PostgreSQL 18 (Standby Replica em Container).
 * **Vantagens de Segurança & Performance**:
-  * **Replicação Streaming Real-Time (Staging)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal.
+  * **Replicação Streaming Real-Time (Dev)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal.
  * **Isolamento de Riscos**: Compilações de código (`npm run build`, `docker build`) e testes pesados de carga rodam aqui e consomem CPU sem comprometer os servidores de produção e banco de dados.
  * **Ambiente Espelho**: Homologação idêntica à produção para validações precisas antes de aplicar modificações em produção.
@@ -205,15 +205,15 @@ graph TD
 A rede VPN WireGuard (`10.99.0.0/24`) deixa de ser tratada como uma zona de confiança irrestrita. Implementa-se uma política de privilégio mínimo na comunicação entre os servidores da VPN.
 * **O Problema de Movimentação Lateral**:
-  Se a máquina de desenvolvimento/staging (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados.
+  Se a máquina de desenvolvimento/dev (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados.
 * **Regras de Isolamento Lateral (Exemplo no Firewall da VPS 3)**:
  ```text
  # Bloquear por padrão toda conexão vinda da VPN exceto as estritamente autorizadas:
  - Permitir VPS 1 (Produção) -> Porta 5432 (PostgreSQL)                       [ACEITAR]
  - Permitir VPS 5 (CRM)       -> Porta 5432 (PostgreSQL)                       [ACEITAR]
-  - Permitir VPS 4 (Staging)   -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR]
+  - Permitir VPS 4 (Dev)   -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR]
-  - Permitir VPS 4 (Staging)   -> VPS 3 (Produção - Outras portas / serviços)   [BLOQUEAR]
+  - Permitir VPS 4 (Dev)   -> VPS 3 (Produção - Outras portas / serviços)   [BLOQUEAR]
  ```
 ---
@@ -18,7 +18,7 @@ graph TD
    subgraph "Rede Privada VPN (10.99.0.0/24)"
        VPS1["🖥️ VPS 1 (Produção) <br> IP: 10.99.0.1 <br> (Traefik / Apps)"]
        VPS3["🗄️ VPS 3 (Banco de Dados) <br> IP: 10.99.0.3 <br> (PostgreSQL Dedicado)"]
-        VPS4["🧪 VPS 4 (Desenvolvimento) <br> IP: 10.99.0.4 <br> (Staging / Builds)"]
+        VPS4["🧪 VPS 4 (Desenvolvimento) <br> IP: 10.99.0.4 <br> (Dev / Builds)"]
        VPS5["💬 VPS 5 (CRM WhatsApp) <br> IP: 10.99.0.5 <br> (Bots / APIs)"]
    end
@@ -77,15 +77,15 @@ graph TD
 ---
-### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Staging)
+### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Dev)
-* **Função Principal**: Testar novos recursos, hospedar containers de staging e realizar builds de desenvolvimento.
+* **Função Principal**: Testar novos recursos, hospedar containers de dev e realizar builds de desenvolvimento.
 * **IP Privado VPN**: `10.99.0.4`
 * **Políticas do Firewall (UFW)**:
  * **Porta 22 (SSH)**: **Bloqueada publicamente**. Apenas acessível via VPN.
  * **Portas de teste (ex: 3002, 8080)**: **Bloqueadas publicamente** ou atreladas apenas ao IP privado da VPN para acesso exclusivo dos desenvolvedores autorizados.
 * **Tecnologias**: Docker, Docker Compose, PostgreSQL 18 (Standby Replica em Container).
 * **Vantagens de Segurança & Performance**:
-  * **Replicação Streaming Real-Time (Staging)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal.
+  * **Replicação Streaming Real-Time (Dev)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal.
  * **Isolamento de Riscos**: Compilações de código (`npm run build`, `docker build`) e testes pesados de carga rodam aqui e consomem CPU sem comprometer os servidores de produção e banco de dados.
  * **Ambiente Espelho**: Homologação idêntica à produção para validações precisas antes de aplicar modificações em produção.
@@ -205,15 +205,15 @@ graph TD
 A rede VPN WireGuard (`10.99.0.0/24`) deixa de ser tratada como uma zona de confiança irrestrita. Implementa-se uma política de privilégio mínimo na comunicação entre os servidores da VPN.
 * **O Problema de Movimentação Lateral**:
-  Se a máquina de desenvolvimento/staging (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados.
+  Se a máquina de desenvolvimento/dev (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados.
 * **Regras de Isolamento Lateral (Exemplo no Firewall da VPS 3)**:
  ```text
  # Bloquear por padrão toda conexão vinda da VPN exceto as estritamente autorizadas:
  - Permitir VPS 1 (Produção) -> Porta 5432 (PostgreSQL)                       [ACEITAR]
  - Permitir VPS 5 (CRM)       -> Porta 5432 (PostgreSQL)                       [ACEITAR]
-  - Permitir VPS 4 (Staging)   -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR]
+  - Permitir VPS 4 (Dev)   -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR]
-  - Permitir VPS 4 (Staging)   -> VPS 3 (Produção - Outras portas / serviços)   [BLOQUEAR]
+  - Permitir VPS 4 (Dev)   -> VPS 3 (Produção - Outras portas / serviços)   [BLOQUEAR]
  ```
 ---
@@ -145,7 +145,7 @@ Definimos o **`MTU = 1360`** (ou `1280` para máxima resiliência) em todos os a
   ```
   *Reinicie o serviço:* `sudo systemctl restart wg-quick@wg0`
-3. **Nas VPSs 4 e 5 (Staging e CRM - REQUER APLICAR):**
+3. **Nas VPSs 4 e 5 (Dev e CRM - REQUER APLICAR):**
   Repita o mesmo procedimento adicionando `MTU = 1360` sob `[Interface]` em seus respectivos `/etc/wireguard/wg0.conf` e reinicie a interface.
 > [!TIP]