Documentação do Sistema de Cadastro de Eventos

Visão Geral

Este sistema permite que usuários criem automaticamente instâncias personalizadas do sistema de controle de presença. Cada evento cadastrado gera uma pasta única com todos os arquivos necessários para gerenciar convidados e confirmações de presença.

Estrutura de Arquivos

sistema_cadastro_eventos/
├── index.html              # Página principal do formulário
├── styles.css              # Estilos CSS responsivos
├── script.js               # JavaScript para validações e interações
├── criar_evento.php        # Backend para criar novos eventos
├── excluir_evento.php      # Backend para excluir eventos expirados
├── listar_eventos.php      # Backend para listar eventos
└── README.md               # Esta documentação

Funcionalidades

1. Cadastro de Eventos

• Formulário responsivo com validação em tempo real
• Campos obrigatórios: nome do evento, data, organizador, email, senha
• Validação de email e confirmação de senha
• Upload opcional de logo do evento

2. Criação Automática de Instâncias

• Geração de ID único para cada evento
• Criação de pasta dedicada para o evento
• Cópia de todos os arquivos do sistema de presença
• Configuração personalizada para o evento

3. Gestão de Dados

• Arquivo JSON centralizado (eventos_cadastrados.json) para controle
• Armazenamento de informações do evento e organizador
• Sistema de status (ativo/expirado)

4. Integração com n8n para Exclusão Automática

• Endpoint para listar eventos expirados
• Endpoint para excluir eventos após 30 dias
• Compatível com automação via n8n

Configuração do n8n

Para configurar a exclusão automática de eventos no n8n:

1. Criar Workflow com Timer

• Adicione um nó "Schedule Trigger" configurado para executar diariamente
• Configure para executar às 02:00 da manhã, por exemplo

2. Listar Eventos Expirados

• Adicione um nó "HTTP Request"
• Método: GET
• URL: https://seudominio.com/sistema_cadastro_eventos/listar_eventos.php

3. Processar Lista de Eventos

• Adicione um nó "Code" para processar a resposta
• Extrair eventos expirados da resposta JSON

4. Excluir Eventos Expirados

• Para cada evento expirado, fazer uma requisição POST
• URL: https://seudominio.com/sistema_cadastro_eventos/excluir_evento.php
• Body: {"evento_id": "ID_DO_EVENTO"}

Exemplo de Configuração n8n

// Nó Code para processar eventos expirados
const response = $input.first().json;

if (response.sucesso && response.eventos_expirados.length > 0) {
  return response.eventos_expirados.map(evento => ({
    json: {
      evento_id: evento.id,
      nome: evento.nome,
      data_evento: evento.data_evento
    }
  }));
}

return [];

Estrutura do JSON de Eventos

[
  {
    "id": "evento_12345",
    "nome": "Festa de 15 Anos",
    "data_evento": "2025-07-15",
    "organizador": "João Silva",
    "email": "joao@email.com",
    "diretorio": "../eventos/evento_12345/",
    "data_criacao": "2025-06-07 17:00:00",
    "status": "ativo"
  }
]

URLs Geradas

Para cada evento criado, são geradas duas URLs:

1. Página de Administração: /eventos/{evento_id}/admin.html

   • Acesso protegido por senha
   • Gerenciamento de convidados
   • Relatórios de presença

2. Página de Confirmação: /eventos/{evento_id}/index.html

   • Página pública para confirmação de presença
   • Interface amigável para convidados

Segurança

• Senhas são armazenadas com hash usando password_hash()
• Validação de dados no frontend e backend
• Proteção contra ataques de diretório
• Headers CORS configurados adequadamente

Instalação

1. Faça upload dos arquivos para seu servidor web
2. Certifique-se de que o PHP tenha permissões de escrita
3. Configure o diretório base para os eventos
4. Teste o formulário de cadastro
5. Configure o workflow no n8n para exclusão automática

Manutenção

• Monitore o arquivo eventos_cadastrados.json regularmente
• Faça backup dos dados importantes antes de exclusões
• Verifique logs de erro do servidor web
• Teste periodicamente o workflow do n8n