Gestão Coletiva
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. O plugin foi criado pelo Quilombo Ciência (quilombociencia.org) com o auxílio do modelo de linguagem Claude (claude.ai).
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/quilombociencia/gestao-coletiva/archive/refs/heads/main.zipGestão Coletiva - Plugin WordPress
⚠️ Versão Beta - Este plugin está em fase de testes. Recomenda-se cautela em ambientes de produção.
Sobre o Plugin
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
Desenvolvimento e Trilha de Criação
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.
Funcionalidades Principais
🏦 Gestão Financeira
- 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
🔍 Transparência Total
- 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
🛡️ Sistema de Contestações
- 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
💰 Doações via PIX
- 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
🎉 Novidades da v1.2.0-beta
🎭 Sistema de Doações Anônimas
- 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
🔧 Melhorias no Sistema de Contestações
- 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
🎨 Interface Aprimorada
- 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
🎉 Novidades da v1.1.1
🏆 Certificados Aprimorados
- 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
🔧 Correções Críticas de Interface
- 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
🔐 Sistema de Verificaçã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
📋 Novidades da v1.1.0
🏦 PIX Totalmente Integrado
- 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
🎨 Interface Aprimorada
- "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
🐛 Correções Importantes
- 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
Instalação
- Faça upload dos arquivos para
/wp-content/plugins/gestao-coletiva/ - Ative o plugin no painel administrativo do WordPress
- Configure os prazos em Gestão Coletiva → Configurações
- 🆕 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
Estrutura do Projeto
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
Shortcodes Disponíveis
[gc_painel]
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
[gc_lancamentos]
Interface para:
- Criar novos lançamentos
- Consultar lançamentos por número
- Visualizar detalhes completos
- Gerar certificados
[gc_livro_caixa]
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
[gc_verificar_certificado] 🆕
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
Estados dos Lançamentos
- Previsto: Criado, aguardando verificação
- Efetivado: Verificado e confirmado
- Cancelado: Cancelado pelo autor
- Expirado: Não verificado no prazo
- Em Contestação: Questionado por usuário
- Contestado: Contestação procedente
- Confirmado: Contestação improcedente, aguardando análise
- Aceito: Análise aceita pelo contestante
- Em Disputa: Análise rejeitada, vai para comunidade
- Retificado/Contestado pela Comunidade: Decisão final
Fluxo de Contestações
- Usuário abre contestação → Estado: "Em Contestação"
- Administrador/Autor responde → Estado: "Confirmado" ou "Contestado"
- Contestante analisa resposta → Estado: "Aceito" ou "Em Disputa"
- Se disputa: Publicação no blog + Enquete da comunidade
- Decisão final: "Retificado" ou "Contestado pela Comunidade"
Configurações
Prazos (em horas/dias)
- 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)
Textos Customizáveis
- Agradecimento nos certificados
- Informações de PIX (através de hooks)
Hooks e Filtros
Actions
// 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');
Filters
// 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);
Banco de Dados
Tabelas Criadas
wp_gc_lancamentos: Todos os lançamentos financeiroswp_gc_contestacoes: Sistema de contestaçõeswp_gc_relatorios: Relatórios enviados manualmentewp_gc_configuracoes: Configurações do plugin
Processamento Automático
- 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
Segurança
Permissões
- 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
Validação
- Sanitização de todos inputs
- Verificação de capacidades do usuário
- Escape de outputs para prevenir XSS
- Prepared statements em todas consultas
Desenvolvimento
Requisitos
- WordPress 5.0+
- PHP 7.4+
- MySQL 5.6+
Estrutura de Classes
- 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
Customização
O plugin foi desenvolvido para ser facilmente customizável:
- CSS classes bem definidas
- Hooks em pontos estratégicos
- Estrutura modular
- Código documentado
Suporte
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
Licença
GPL/GNU 3.0 - Licença Pública Geral GNU versão 3.0.
Changelog
Veja o arquivo CHANGELOG.md para histórico completo de todas as versões.
Desenvolvido para promover transparência e gestão coletiva responsável de recursos.