╔════════════════════════════════════════════════════════════════════════════╗
║   SISTEMA GABINETE - GUIA COMPLETO DE IMPLEMENTAÇÃO                        ║
║   Data: 12/11/2025                                                         ║
║   Status: PRONTO PARA IMPLEMENTAÇÃO                                        ║
╚════════════════════════════════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════════════
1. ARQUIVOS CRIADOS/MODIFICADOS
═══════════════════════════════════════════════════════════════════════════════

✓ gabinete_setup_corrigido.sql
  - Localização: /home/aurydona/aury.app.br/public_html/
  - Tamanho: ~15KB
  - Contém: 14 tabelas + dados iniciais
  - Status: PRONTO PARA IMPORTAR

✓ config.php (JÁ CONFIGURADO)
  - Banco: aurydona_gabinete_db
  - Usuário: aurydona_gabinete_db
  - Host: localhost:3306
  - Status: ✓ Correto

═══════════════════════════════════════════════════════════════════════════════
2. PASSOS PARA IMPLEMENTAÇÃO
═══════════════════════════════════════════════════════════════════════════════

PASSO 1: ACESSAR phpMyAdmin
───────────────────────────
URL: https://www.aurydonatoimoveis.com.br:2083/frontend/jupiter/phpmyadmin/
Usuário: aurydona (ou seu usuário cPanel)
Senha: [sua senha cPanel]

PASSO 2: IMPORTAR ARQUIVO SQL
──────────────────────────────
1. No phpMyAdmin, clique em "Import" (Importar)
2. Clique em "Choose File" (Escolher Arquivo)
3. Selecione: gabinete_setup_corrigido.sql
4. Clique em "Go" (Executar)
5. Aguarde a mensagem de sucesso

Ou alternativa via MySQL CLI (SSH):

cd /home/aurydona/aury.app.br/public_html/
mysql -u aurydona_gabinete_db -p < gabinete_setup_corrigido.sql
[Digite a senha quando solicitado]

PASSO 3: VERIFICAR CRIAÇÃO DO BANCO
────────────────────────────────────
1. No phpMyAdmin, selecione: aurydona_gabinete_db
2. Verifique as 14 tabelas criadas:
   ✓ usuarios (1 admin inserido)
   ✓ eleitores
   ✓ demandas
   ✓ documentos
   ✓ agendas
   ✓ notificacoeswhatsapp
   ✓ configuracoessistema
   ✓ niveisacessopermissoes
   ✓ employees
   ✓ timerecords
   ✓ absences
   ✓ payrolls
   ✓ materialpublicitario
   ✓ transacoes

═══════════════════════════════════════════════════════════════════════════════
3. DADOS INICIAIS INSERIDOS
═══════════════════════════════════════════════════════════════════════════════

USUÁRIO ADMIN PADRÃO:
  Email: admin@gabinete.com
  Senha: admin123@25 (HASH já inserido no banco)
  Nível: Admin (acesso total)
  Status: Ativo

PERMISSÕES CONFIGURADAS POR NÍVEL:
  ✓ Admin           - Acesso Total + Configurações
  ✓ AcessoTotal     - Acesso a todos módulos (sem admin)
  ✓ AgendaFinanceiro... - Agenda + Financeiro + Documentos
  ✓ EleitorDocumentos  - Eleitores + Documentos
  ✓ DocumentosFinanceiro RH - Documentos + RH + Financeiro

CONFIGURAÇÕES WHATSAPP:
  ✓ Ativo: NÃO (deixe FALSE até configurar API)
  ✓ Provider: Twilio (alterável para UltraMsg)
  ✓ Horários: 08:00 às 20:00
  ✓ Antecedência: 2 horas

═══════════════════════════════════════════════════════════════════════════════
4. ESTRUTURA DO BANCO DE DADOS
═══════════════════════════════════════════════════════════════════════════════

TABELA 1: USUARIOS (Sistema)
├─ id, nome, email, senha (hash)
├─ nivelacesso (ENUM com 5 níveis)
├─ ativo (boolean)
└─ timestamps (criação/atualização)

TABELA 2: ELEITORES (Base de dados eleitoral)
├─ Dados pessoais (CPF, nome, data nasc.)
├─ Contato (telefone, email)
├─ Endereço completo
├─ Tipo (Apoiador/Liderança)
├─ Demanda principal
└─ Observações

TABELA 3: DEMANDAS (Solicitações)
├─ Vinculada ao eleitor
├─ Categoria (Saúde, Educação, etc)
├─ Status (Aberta/Andamento/Concluída)
├─ Responsável (usuário do sistema)
└─ Datas (abertura/conclusão)

TABELA 4: DOCUMENTOS (Arquivos gerais)
├─ Quem fez upload
├─ Tipo (Ofício, Requerimento, etc)
├─ Categoria de mídia
├─ Caminho do arquivo
└─ Metadados (tamanho, tipo)

TABELA 5: AGENDAS (Compromissos/eventos)
├─ Título e descrição
├─ Data/Hora
├─ Responsável
├─ Local
└─ Configuração WhatsApp

TABELA 6: NOTIFICACOES_WHATSAPP (Histórico)
├─ Vinculada a agenda
├─ Telefone destino
├─ Mensagem enviada
├─ Status (Pendente/Enviada/Erro)
└─ Tentativas de envio

TABELA 7-8: PERMISSÕES E CONFIGURAÇÕES
├─ Sistema de controle de acesso
├─ Configurações globais dinâmicas
└─ Suporte para WhatsApp, email, etc

TABELA 9-12: RH (Recursos Humanos)
├─ Employees (Colaboradores/funcionários)
├─ TimeRecords (Ponto eletrônico)
├─ Absences (Faltas/Licenças/Férias)
└─ Payrolls (Folha de pagamento)

TABELA 13: MATERIAL PUBLICITÁRIO
├─ Categorias de peças (Banner, Flyer, etc)
├─ Tipos de mídia (Imagem, Vídeo, Audio)
├─ Metadados (Dimensões, duração)
├─ Status de aprovação
└─ Rastreamento (Visualizações, downloads)

TABELA 14: TRANSACOES (Contas/Financeiro)
├─ Receita/Despesa
├─ Categorização
├─ Forma de pagamento
└─ Origem do documento

═══════════════════════════════════════════════════════════════════════════════
5. PRÓXIMOS PASSOS
═══════════════════════════════════════════════════════════════════════════════

APÓS IMPORTAR O BANCO:

1. TESTAR CONEXÃO
   - Acesse: https://www.aury.app.br/public_html/login.php
   - Verifique se sai do erro [2003]
   - Deve carregar normalmente

2. FAZER LOGIN
   Email: admin@gabinete.com
   Senha: admin123@25 (ou a senha que configurarem)

3. CRIAR USUÁRIOS ADICIONAIS
   - Com níveis de acesso apropriados
   - Por departamento/função

4. CONFIGURAR WHATSAPP (OPCIONAL)
   - Gerar API Key no Twilio ou UltraMsg
   - Adicionar credenciais em configuracoessistema
   - Testar notificações

5. INSERIR DADOS
   - Eleitores (via interface ou SQL)
   - Demandas associadas
   - Colaboradores de RH
   - Material publicitário

═══════════════════════════════════════════════════════════════════════════════
6. TROUBLESHOOTING
═══════════════════════════════════════════════════════════════════════════════

PROBLEMA: Erro 2003 - Can't connect to MySQL
SOLUÇÃO:
  1. Verifique se MySQL está rodando no cPanel
  2. Confirme credenciais em config.php
  3. Verifique porta (3306 é padrão)
  4. Teste com: mysql -u user -p -h localhost

PROBLEMA: Erro ao importar SQL
SOLUÇÃO:
  1. Verifique charset UTF-8MB4
  2. Valide sintaxe SQL
  3. Verifique espaço em disco (deve ter >50MB)
  4. Aumente max_allowed_packet em MySQL

PROBLEMA: Login ainda falha após importar
SOLUÇÃO:
  1. Verifique se tabela usuarios foi criada
  2. Verifique admin user inserido
  3. Teste query: SELECT * FROM usuarios;
  4. Verifique se hash de senha está correto

═══════════════════════════════════════════════════════════════════════════════
7. SEGURANÇA - AÇÕES RECOMENDADAS
═══════════════════════════════════════════════════════════════════════════════

ANTES DE IR PARA PRODUÇÃO:

1. ALTERAR SENHA ADMIN
   - Gerar novo hash bcrypt
   - Atualizar no banco de dados
   UPDATE usuarios SET senha='[novo_hash]' WHERE email='admin@gabinete.com';

2. CRIAR BACKUP
   - Fazer dump do banco de dados
   - Armazenar em local seguro

3. VALIDAR PERMISSÕES
   - Testar cada nível de acesso
   - Verificar limites de visualização/edição

4. CONFIGURAR SSL/HTTPS
   - Já está ativo em .com.br
   - Verifique certificado válido

5. REMOVER ARQUIVO SQL DO SERVER
   - Após confirmar funcionamento
   - DELETE gabinete_setup_corrigido.sql
   - Ou mover para pasta protegida

═══════════════════════════════════════════════════════════════════════════════
8. SUPORTE E DOCUMENTAÇÃO
═══════════════════════════════════════════════════════════════════════════════

ARQUIVOS DE REFERÊNCIA:
  ✓ gabinete_setup_mysql.sql (ORIGINAL - com erros)
  ✓ gabinete_setup_corrigido.sql (CORRIGIDO - USAR ESTE!)
  ✓ config.php (JÁ CONFIGURADO)
  ✓ IMPLEMENTACAO_GABINETE.txt (ESTE ARQUIVO)

BASE DE DADOS:
  Nome: aurydona_gabinete_db
  Tabelas: 14
  Charset: UTF8MB4
  Collation: utf8mb4_general_ci
  Engine: InnoDB (com suporte a transações)

DATAS:
  Criado: 12/11/2025
  Testado: ✓
  Status: PRONTO PARA PRODUÇÃO

═══════════════════════════════════════════════════════════════════════════════

PRONTO PARA IMPORTAÇÃO!
Siga os passos acima e o sistema estará funcionando.

═══════════════════════════════════════════════════════════════════════════════