================================================================================
🎯 GUIA VISUAL COMPLETO - WILDCARD DNS (PASSO A PASSO COM PRINTS)
================================================================================

⚠️ IMPORTANTE: WHM e cPanel são PAINÉIS DIFERENTES!
   • WHM = Painel do SERVIDOR (root/administrador)
   • cPanel = Painel da CONTA (usuário)

================================================================================
📍 PARTE 1: CONFIGURAR DNS NO WHM (Painel Administrativo)
================================================================================

🔐 ACESSO AO WHM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

URL: https://seu-servidor.com:2087
     ou
     https://IP-DO-SERVIDOR:2087

Exemplo: https://192.168.1.100:2087

Login: root (ou seu usuário administrativo)
Senha: [sua senha de root do WHM]

┌────────────────────────────────────────────────────────────┐
│                    WHM - Web Host Manager                  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  Username: root                                      │  │
│  │  Password: ••••••••                                  │  │
│  │  [Login]                                             │  │
│  └──────────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────────┘

💡 DICA: Se não consegue acessar WHM:2087, você pode não ter acesso root.
   Neste caso, peça ao seu provedor de hospedagem para fazer isso.


🔍 PASSO 1: ENCONTRAR A OPÇÃO DE DNS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Após fazer login no WHM, você verá o menu lateral esquerdo.

PROCURE POR:
   "DNS Functions" (Funções DNS)

Pode estar em uma dessas seções:
   • DNS Functions
   • DNS Zone Manager
   • Zone Editor

CLIQUE EM:
   "Edit DNS Zone" (Editar Zona DNS)
   ou
   "Edit a DNS Zone" (Editar uma Zona DNS)

┌────────────────────────────────────────────────────────────┐
│  WHM - Menu Lateral                                        │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  📁 Home                                                   │
│  📁 Account Functions                                      │
│  📁 DNS Functions                      ← AQUI!            │
│      ├─ Add a DNS Zone                                    │
│      ├─ Edit DNS Zone                  ← CLIQUE AQUI!     │
│      ├─ Delete a DNS Zone                                 │
│      └─ ...                                               │
│  📁 Email                                                  │
│  📁 Server Configuration                                   │
└────────────────────────────────────────────────────────────┘


🔍 PASSO 2: SELECIONAR O DOMÍNIO
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Você verá uma lista de DOMÍNIOS (não subdomínios).

PROCURE E SELECIONE:
   soumulheragenda.com.br

┌────────────────────────────────────────────────────────────┐
│  Edit DNS Zone - Select a Domain                          │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Select a domain to edit:                                 │
│                                                            │
│  ( ) example.com                                          │
│  ( ) outrodominio.com.br                                  │
│  (●) soumulheragenda.com.br         ← SELECIONE ESTE!    │
│  ( ) maisumdominio.net                                    │
│                                                            │
│  [Edit] [Cancel]                                          │
└────────────────────────────────────────────────────────────┘

CLIQUE EM: [Edit]


🔍 PASSO 3: ADICIONAR REGISTRO WILDCARD
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Você verá a zona DNS com MUITOS registros existentes.

ROLE ATÉ O FINAL DA PÁGINA!

Você verá: "Add New Entries Below this Line"
          (Adicionar Novos Registros Abaixo desta Linha)

PREENCHA OS CAMPOS:

┌────────────────────────────────────────────────────────────┐
│  Add New Entries Below this Line                          │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                            │
│  Name:     *.soumulheragenda.com.br.                      │
│            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^                   │
│            (ATENÇÃO: ponto no final!)                     │
│                                                            │
│  TTL:      14400                                          │
│            (deixe padrão)                                 │
│                                                            │
│  Class:    IN                                             │
│            (deixe padrão)                                 │
│                                                            │
│  Type:     A                                              │
│            (dropdown - selecione "A")                     │
│                                                            │
│  Address:  [SEU_IP_AQUI]                                  │
│            Exemplo: 192.168.1.100                         │
│            (IP do seu servidor)                           │
│                                                            │
│  [Add Record] [Save Zone]                                 │
└────────────────────────────────────────────────────────────┘

🔍 COMO DESCOBRIR O IP DO SERVIDOR?

OPÇÃO A: No próprio WHM
   WHM → Server Information → "Shared IP Address"

OPÇÃO B: Via terminal
   ping soumulheragenda.com.br

OPÇÃO C: Via nslookup
   nslookup soumulheragenda.com.br


🔍 PASSO 4: SALVAR
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Após preencher, CLIQUE EM:
   [Add Record]  (Adicionar Registro)

Depois CLIQUE EM:
   [Save Zone]   (Salvar Zona)

Você verá mensagem:
   ✅ "Zone saved successfully"
   ou
   ✅ "Zona salva com sucesso"

🎉 PRONTO! Parte 1 concluída!


================================================================================
📍 PARTE 2: CONFIGURAR SUBDOMÍNIO NO CPANEL (Painel da Conta)
================================================================================

🔐 ACESSO AO CPANEL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ ATENÇÃO: Agora é CPANEL (não WHM!)

URL: https://seu-servidor.com:2083
     ou
     https://soumulheragenda.com.br/cpanel
     ou
     https://soumulheragenda.com.br:2083

Login: usuário do cPanel (não é root!)
Senha: [senha do cPanel]

┌────────────────────────────────────────────────────────────┐
│                        cPanel                              │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  Username: usuario_cpanel                            │  │
│  │  Password: ••••••••                                  │  │
│  │  [Log in]                                            │  │
│  └──────────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────────┘


🔍 PASSO 1: ENCONTRAR "SUBDOMÍNIOS"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

No cPanel, procure por:
   "Subdomínios" ou "Subdomains"

Está na seção:
   "Domains" (Domínios)

┌────────────────────────────────────────────────────────────┐
│  cPanel - Home                                            │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                            │
│  [Files]  [Databases]  [Email]  [Domains]  [Metrics]     │
│                                    ↑                      │
│                              CLIQUE AQUI                  │
│                                                            │
│  Domains (Domínios)                                       │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                            │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐            │
│  │ Domains   │  │Subdomains │  │ Aliases   │            │
│  │           │  │           │  │           │            │
│  └───────────┘  └───────────┘  └───────────┘            │
│                      ↑                                    │
│                 CLIQUE AQUI!                              │
└────────────────────────────────────────────────────────────┘


🔍 PASSO 2: CRIAR SUBDOMÍNIO WILDCARD
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Você verá o formulário de criar subdomínio.

PREENCHA:

┌────────────────────────────────────────────────────────────┐
│  Create a Subdomain                                        │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                            │
│  Subdomain:  *                                            │
│              ↑                                            │
│        (APENAS O ASTERISCO, NADA MAIS!)                   │
│                                                            │
│  Domain:     soumulheragenda.com.br                       │
│              (selecione no dropdown)                      │
│                                                            │
│  Document Root:  /home/usuario/public_html                │
│                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^            │
│              (Caminho onde está o CodeIgniter)            │
│              (NÃO mexa nisso se não souber!)              │
│                                                            │
│  [Create]                                                 │
└────────────────────────────────────────────────────────────┘

CLIQUE EM: [Create]

Você verá mensagem:
   ✅ "Success! The subdomain * has been created."


🎉 PRONTO! Parte 2 concluída!


================================================================================
📍 PARTE 3: AGUARDAR PROPAGAÇÃO DNS
================================================================================

⏱️ TEMPO DE ESPERA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Após as configurações, o DNS precisa PROPAGAR:

MÍNIMO:  1 hora
MÉDIO:   2-4 horas
MÁXIMO:  24-48 horas (raro)

💡 DICA: Na maioria dos casos funciona em 1-2 horas!


🔍 COMO TESTAR SE JÁ PROPAGOU?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TESTE 1: Via Terminal (Windows)
   cmd → nslookup teste123.soumulheragenda.com.br

RESULTADO ESPERADO:
   Name:    teste123.soumulheragenda.com.br
   Address: 192.168.1.100  ← Seu IP do servidor

TESTE 2: Via Navegador
   http://teste123.soumulheragenda.com.br
   http://qualquercoisa.soumulheragenda.com.br

RESULTADO ESPERADO:
   ✅ Carrega uma página (mesmo que vazia ou 404)
   ❌ NÃO deve dar "Servidor não encontrado"


================================================================================
📍 PARTE 4: VERIFICAR SE ESTÁ FUNCIONANDO
================================================================================

🔍 TESTE COMPLETO
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. CADASTRE UMA EMPRESA DE TESTE

   Via banco de dados:
   ```sql
   INSERT INTO usuarios (nome, email, pagina, password, level)
   VALUES ('Empresa Teste', 'teste@teste.com', 'teste', 'senha123', 1);
   ```

2. ACESSE NO NAVEGADOR

   http://teste.soumulheragenda.com.br

3. RESULTADO ESPERADO

   ✅ Landing page carrega
   ✅ Nome da empresa aparece
   ✅ Seções visíveis (Hero, Sobre, etc)


================================================================================
❓ FAQ - PERGUNTAS FREQUENTES
================================================================================

Q: Não encontro "DNS Functions" no WHM
A: Procure por "Zone Editor" ou "Edit DNS Zone"
   Se não encontrar, pode não ter acesso root ao WHM.
   Peça ao provedor de hospedagem para configurar.

Q: Aparece erro ao salvar DNS
A: Verifique se colocou o PONTO no final:
   *.soumulheragenda.com.br.  ← CORRETO (com ponto)
   *.soumulheragenda.com.br   ← ERRADO (sem ponto)

Q: No cPanel não aparece opção "Subdomínios"
A: Procure por "Subdomains" em inglês
   Ou vá em: Domains → Subdomains

Q: Deu erro ao criar subdomínio "*"
A: Tente criar: *.soumulheragenda.com.br (com domínio junto)
   Ou entre em contato com suporte da hospedagem

Q: DNS não propaga após 24h
A: Limpe cache DNS:
   Windows: ipconfig /flushdns
   Linux: sudo systemd-resolve --flush-caches
   Mac: sudo dscacheutil -flushcache

Q: Subdomínio carrega página errada
A: Verifique Document Root no cPanel
   Deve apontar para: public_html (onde está o CodeIgniter)

Q: Aparece erro 404
A: Verifique .htaccess na raiz do projeto
   Deve ter mod_rewrite ativo


================================================================================
🆘 NÃO TENHO ACESSO AO WHM - E AGORA?
================================================================================

Se você NÃO tem acesso ao WHM (painel administrativo), você tem 3 opções:

OPÇÃO 1: PEÇA AO PROVEDOR
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Entre em contato com seu provedor de hospedagem e envie:

╔═══════════════════════════════════════════════════════════╗
║  Assunto: Configurar Wildcard DNS                        ║
║                                                           ║
║  Olá,                                                     ║
║                                                           ║
║  Preciso configurar um registro DNS wildcard para:       ║
║                                                           ║
║  Domínio: soumulheragenda.com.br                         ║
║  Registro: *.soumulheragenda.com.br                      ║
║  Tipo: A                                                 ║
║  Apontar para: IP do servidor                           ║
║                                                           ║
║  Também preciso criar um subdomínio "*" no cPanel        ║
║  apontando para /public_html                             ║
║                                                           ║
║  Obrigado!                                               ║
╚═══════════════════════════════════════════════════════════╝


OPÇÃO 2: USAR CLOUDFLARE (GRATUITO)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Cadastre-se em: cloudflare.com
2. Adicione o domínio: soumulheragenda.com.br
3. Altere nameservers do domínio para Cloudflare
4. No painel Cloudflare: DNS → Add Record
   Type: A
   Name: *
   Content: IP_DO_SERVIDOR
5. Salvar

💡 Vantagem: Você tem controle total + CDN grátis!


OPÇÃO 3: USAR PATH (SEM SUBDOMÍNIO)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Se não conseguir configurar wildcard, use path:

   soumulheragenda.com.br/lojadamaria
   soumulheragenda.com.br/salao
   soumulheragenda.com.br/petshop

JÁ FUNCIONA! Não precisa configurar nada!

O sistema detecta automaticamente:
   - Subdomínio: empresa.soumulheragenda.com.br
   - Path: soumulheragenda.com.br/empresa


================================================================================
✅ CHECKLIST FINAL
================================================================================

PARTE 1 - WHM:
   [  ] Acessei WHM (porta 2087)
   [  ] Encontrei "DNS Functions" → "Edit DNS Zone"
   [  ] Selecionei domínio: soumulheragenda.com.br
   [  ] Adicionei registro: *.soumulheragenda.com.br. (com ponto!)
   [  ] Tipo: A
   [  ] IP: [coloquei IP do servidor]
   [  ] Salvei zona DNS

PARTE 2 - cPanel:
   [  ] Acessei cPanel (porta 2083)
   [  ] Encontrei "Domains" → "Subdomains"
   [  ] Criei subdomínio: *
   [  ] Domínio: soumulheragenda.com.br
   [  ] Document Root: public_html
   [  ] Criei com sucesso

PARTE 3 - Teste:
   [  ] Aguardei 1-2 horas
   [  ] Testei com nslookup: OK
   [  ] Testei no navegador: OK
   [  ] Cadastrei empresa teste
   [  ] Acessei landing page: OK

🎉 SE TODOS MARCADOS: ESTÁ FUNCIONANDO!


================================================================================
📞 PRECISA DE AJUDA?
================================================================================

Se mesmo seguindo este guia você não conseguiu:

1. Verifique se tem acesso root ao WHM
2. Entre em contato com seu provedor de hospedagem
3. Considere usar Cloudflare (opção gratuita e fácil)
4. Ou use o sistema em modo Path (já funciona sem configurar!)


================================================================================
🎉 PRONTO!
================================================================================

Após seguir TODOS os passos:

✅ Wildcard DNS configurado
✅ Subdomínio wildcard criado
✅ Sistema detecta automaticamente
✅ Landing pages funcionando!

Cada empresa cadastrada terá seu subdomínio AUTOMÁTICO:

   empresa1.soumulheragenda.com.br  ← FUNCIONA!
   empresa2.soumulheragenda.com.br  ← FUNCIONA!
   empresa3.soumulheragenda.com.br  ← FUNCIONA!
   ...

SEM PRECISAR CONFIGURAR NADA MANUALMENTE!

================================================================================
