⚠️ Versão Beta - Este plugin está em fase de testes. Recomenda-se cautela em ambientes de produção.

O Gestão Coletiva é um plugin WordPress para gestão transparente e coletiva de recursos de projetos. Permite arrecadação, gestão e prestação de contas em tempo real, com livro-caixa público e sistema completo de contestações.

Autor: Quilombo Ciência (https://github.com/quilombociencia)
Repositório: https://github.com/quilombociencia/gestao-coletiva
Licença: GPL/GNU 3.0
Versão: 1.2.0-beta

Este projeto é desenvolvido como uma trilha de criação da Escola de Projetos do Quilombo Ciência. A trilha completa está disponível na escola de projetos:

📚 Trilha Gestão Coletiva: https://quilombociencia.org/escola/course/view.php?id=18

A trilha de criação ensina desde conceitos básicos de desenvolvimento WordPress até implementação de sistemas complexos de gestão financeira transparente.

• Lançamentos: Registro de receitas (doações) and despesas
• Estados automáticos: Previsto → Efetivado → Contestado/Aceito
• Prazos automatizados: Para efetivação, contestação e resolução
• Recorrência: Doações únicas, mensais, trimestrais ou anuais
• 🆕 PIX Integrado: Configuração e exibição automática de chave PIX para doações

• Livro-caixa público: Visualização em tempo real de todas movimentações
• Relatórios periódicos: Mensais, trimestrais e anuais
• Certificados de doação: Comprovantes automáticos com verificação de autenticidade
• Sistema de contestação: Qualquer pessoa pode questionar lançamentos

• Tipos de contestação:
  • Doação não contabilizada (enviar comprovante)
  • Despesa não verificada (solicitar comprovante)
• Fluxo completo: Contestação → Resposta → Análise → Resolução
• Escalação comunitária: Disputas não resolvidas vão para votação

• Interface simplificada para registro de doações
• Instruções automáticas de PIX após registro
• Verificação manual pela administração
• Certificados digitais para doações efetivadas

• Configuração de limites: Valor máximo para doações anônimas
• Controle automático: Verificação de limites por valor e mensal
• Interface inteligente: Avisos automáticos sobre anonimato
• Transparência seletiva: Despesas sempre identificadas, doações configuráveis

• Filtros por lançamento: Visualizar contestações específicas
• Limite de contestações: Configurar máximo por lançamento
• Sistema de correções: Permitir correções nas respostas
• Contadores visuais: Indicação de contestações pendentes

• Estados mais claros: Textos amigáveis para todos os estados
• Navegação melhorada: Links contextuais entre seções
• Controles refinados: Permissões mais precisas para ações
• Experiência otimizada: Feedback visual aprimorado

• Informações de recorrência: Certificados agora incluem detalhes sobre doações recorrentes
• Verificação de autenticidade: Sistema completo para validar certificados via QR Code
• Novo shortcode: [gc_verificar_certificado] para páginas de verificação
• Restrições de segurança: Apenas autor da doação ou administradores podem gerar certificados
• Impressão corrigida: Funcionalidade de imprimir certificados totalmente funcional

• RESOLVIDO: Erro 404 ao consultar lançamentos nas views públicas
• Modais AJAX: Substituídos redirecionamentos problemáticos por modais fluidos
• Experiência melhorada: Consultas e visualizações sem mudança de página
• Compatibilidade: Funções JavaScript organizadas para melhor integração

• Autenticidade garantida: Verificação via número do certificado
• QR Code funcional: Links diretos para verificação
• Interface dedicada: Página específica para verificações públicas
• Verificação automática: Suporte a URLs com parâmetros de verificação

• Configuração no admin: Configure sua chave PIX e nome do beneficiário nas configurações
• Exibição automática: Informações PIX aparecem automaticamente nos formulários de doação
• Cópia com um clique: Clique na chave PIX para copiar automaticamente
• Visual destacado: Seção PIX com design atrativo e informativo

• "Dashboard" → "Painel": Terminologia em português para melhor usabilidade
• Limpeza técnica: Removidos botões de correção manual desnecessários
• Instalação simplificada: Estrutura do banco atualizada automaticamente

• Contabilização correta: Estados 'confirmado', 'aceito' e 'retificado_comunidade' agora contam nos saldos
• Certificados expandidos: Disponíveis para todas as doações efetivamente confirmadas
• Contestações ajustadas: Possível contestar qualquer valor já confirmado

1. Faça upload dos arquivos para /wp-content/plugins/gestao-coletiva/
2. Ative o plugin no painel administrativo do WordPress
3. Configure os prazos em Gestão Coletiva → Configurações
4. 🆕 Configure o PIX: Na seção "Configurações PIX", informe:
   • Chave PIX: Email, CPF, celular ou chave aleatória
   • Nome do Beneficiário: Nome completo do titular da conta

gestao-coletiva/
├── gestao-coletiva.php          # Arquivo principal com classe GestaoColetiva
├── includes/                    # Classes principais
│   ├── class-gc-database.php    # Gerenciamento do banco e configurações
│   ├── class-gc-lancamento.php  # Lógica de lançamentos financeiros
│   ├── class-gc-contestacao.php # Sistema completo de contestações
│   ├── class-gc-relatorio.php   # Relatórios e livro-caixa público
│   └── class-gc-admin.php       # Interface administrativa e AJAX
├── admin/views/                 # Telas administrativas
│   ├── dashboard.php            # Dashboard principal com resumos
│   ├── lancamentos.php          # Gerenciamento de lançamentos
│   │   ├── buscar.php          # Busca de lançamentos
│   │   ├── criar.php           # Criação de lançamentos
│   │   ├── listar.php          # Listagem completa
│   │   └── ver.php             # Visualização detalhada
│   ├── contestacoes.php         # Gerenciamento de contestações
│   ├── relatorios.php           # Relatórios e extratos
│   └── configuracoes.php        # Configurações do sistema
├── public/views/                # Interface pública (shortcodes)
│   ├── painel.php              # Painel principal público
│   ├── lancamentos.php         # Interface de lançamentos públicos
│   ├── livro-caixa.php         # Livro-caixa público
│   └── verificar-certificado.php # Verificação de autenticidade
├── assets/                      # CSS e JavaScript
│   ├── css/                    # Estilos para admin e público
│   │   ├── admin.css
│   │   └── public.css
│   └── js/                     # Scripts para admin e público
│       ├── admin.js
│       └── public.js
└── languages/                   # Traduções i18n
    └── gestao-coletiva.pot

Exibe o painel principal com:

• Banner para contribuição
• Balanço financeiro atual
• Ações rápidas (doar, registrar despesa, consultar)
• Estatísticas de transparência

Interface para:

• Criar novos lançamentos
• Consultar lançamentos por número
• Visualizar detalhes completos
• Gerar certificados

Livro-caixa público com:

• Seletor de período
• Gráfico de evolução do saldo
• Lista detalhada de movimentações
• Resumo financeiro do período

Sistema de verificação de autenticidade:

• Formulário para inserir número do certificado
• Verificação automática via URL
• Validação de autenticidade em tempo real
• Exibição completa dos dados do certificado

1. Previsto: Criado, aguardando verificação
2. Efetivado: Verificado e confirmado
3. Cancelado: Cancelado pelo autor
4. Expirado: Não verificado no prazo
5. Em Contestação: Questionado por usuário
6. Contestado: Contestação procedente
7. Confirmado: Contestação improcedente, aguardando análise
8. Aceito: Análise aceita pelo contestante
9. Em Disputa: Análise rejeitada, vai para comunidade
10. Retificado/Contestado pela Comunidade: Decisão final

1. Usuário abre contestação → Estado: "Em Contestação"
2. Administrador/Autor responde → Estado: "Confirmado" ou "Contestado"
3. Contestante analisa resposta → Estado: "Aceito" ou "Em Disputa"
4. Se disputa: Publicação no blog + Enquete da comunidade
5. Decisão final: "Retificado" ou "Contestado pela Comunidade"

• Efetivação: Tempo para verificar lançamentos (padrão: 72h)
• Resposta a contestações: Tempo para responder (padrão: 48h)
• Análise de resposta: Tempo para analisar resposta (padrão: 24h)
• Publicação de disputa: Tempo para publicar disputa (padrão: 24h)
• Resolução: Tempo para votação comunitária (padrão: 7 dias)

• Agradecimento nos certificados
• Informações de PIX (através de hooks)

// Após criação de lançamento
do_action('gc_lancamento_criado', $lancamento_id, $dados);

// Após mudança de estado
do_action('gc_lancamento_estado_alterado', $lancamento_id, $estado_anterior, $novo_estado);

// Processamento automático de vencimentos
do_action('gc_processar_vencimentos');

// Customizar informações de PIX
add_filter('gc_informacoes_pix', function($info) {
    $info['chave'] = 'sua-chave@pix.com';
    $info['beneficiario'] = 'Seu Projeto';
    return $info;
});

// Customizar permissões para receitas (despesas são sempre restritas a admins)
add_filter('gc_pode_criar_lancamento', function($pode, $user_id, $tipo) {
    // Exemplo: permitir que editores criem doações
    if ($tipo === 'receita') {
        $user = get_user_by('id', $user_id);
        return $user && in_array('editor', $user->roles);
    }
    return $pode; // Despesas sempre controladas internamente
}, 10, 3);

• wp_gc_lancamentos: Todos os lançamentos financeiros
• wp_gc_contestacoes: Sistema de contestações
• wp_gc_relatorios: Relatórios enviados manualmente
• wp_gc_configuracoes: Configurações do plugin

• Inicialização automática: Plugin verifica e cria tabelas automaticamente
• Sistema robusto: Tratamento de erros e recuperação de falhas
• Cron job: Executa periodicamente para processar vencimentos
• Estados automáticos: Transições de estado baseadas em prazos
• Log detalhado: Registro de atividades no error_log do WordPress

• Receitas/Doações: Usuários logados (authors+ ou filtro personalizado)
• Despesas: Apenas administradores (manage_options)
• Certificados: Apenas autor da doação ou administradores
• Contestações: Usuários logados
• Administração: Apenas administrators
• Verificação: Nonces em todas ações AJAX

• Sanitização de todos inputs
• Verificação de capacidades do usuário
• Escape de outputs para prevenir XSS
• Prepared statements em todas consultas

• WordPress 5.0+
• PHP 7.4+
• MySQL 5.6+

• GestaoColetiva: Classe principal do plugin, gerencia inicialização e hooks
• GC_Database: Gerenciamento de tabelas, configurações e operações de banco
• GC_Lancamento: Lógica principal dos lançamentos financeiros
• GC_Contestacao: Sistema completo de contestações
• GC_Relatorio: Geração de relatórios e livro-caixa público
• GC_Admin: Interface administrativa e handlers AJAX

O plugin foi desenvolvido para ser facilmente customizável:

• CSS classes bem definidas
• Hooks em pontos estratégicos
• Estrutura modular
• Código documentado

Para questões, bugs ou sugestões:

• Abra uma issue no repositório
• Contribuições via pull request são bem-vindas
• Documentação adicional no wiki

GPL/GNU 3.0 - Licença Pública Geral GNU versão 3.0.

Veja o arquivo CHANGELOG.md para histórico completo de todas as versões.