Portal MBL-ES — Documentacao

Bem-vindo a documentacao do Portal MBL-ES, uma plataforma multi-tenant de gestao de ativismo com 24 modulos, economia gamificada (Moeda virtual configuravel por nucleo) e inteligencia artificial. O sistema e composto por um frontend Next.js, backend NestJS e banco Supabase (PostgreSQL).

Fundacao

Infraestrutura base, convencoes e design system do projeto.

• Arquitetura — Visao geral do monorepo (Turborepo), stack e fluxo de dados
• Schema do Banco — Tabelas, relacionamentos, enums, triggers e RLS
• Setup Local — Como rodar o projeto do zero
• Variaveis de Ambiente — Lista completa de env vars para web, api e Supabase
• Design System — Tokens, cores (#5CBCAE, #EB894F), tipografia Afacad, componentes
• Convencoes e Git Flow — Conventional Commits, branches, nomenclatura

Usuarios e Autenticacao

Cadastro com aprovacao, login via Supabase Auth, RBAC por cargos e perfil do usuario.

• API: Autenticacao — Signup, login, aprovacao, refresh, recuperacao de senha
• API: Membros — Listar, buscar, alterar cargos e status
• API: Perfil — Edicao de dados pessoais, foto, endereco
• Fluxo de Cadastro — Signup, pendencia, aprovacao, ativacao
• Sistema RBAC — Cargos (Membro, Lider, Coordenador, Admin), permissoes e matriz de acesso

Organizacao

Multi-tenant, nucleos, super admin e configuracoes por nucleo.

• API: Nucleos/Super Admin — Gerenciar nucleos, painel super admin
• API: Configuracoes — Configuracoes do nucleo (cores, moeda, toggles, Asaas, WhatsApp)
• Multi-tenant — Isolamento por nucleo, RLS, troca de nucleo
• Integracao Asaas — Configuracao de subconta, webhooks, split de pagamento

Projetos e Eventos

Gestao de projetos com tarefas recompensadas e eventos com check-in e galeria.

• API: Projetos/Tarefas — CRUD de projetos, tarefas com recompensa em moeda do nucleo, validacao
• API: Eventos — Criar eventos, inscricao, check-in, galeria de fotos

Economia e Loja

Moeda virtual do nucleo (ledger de transacoes), loja interna, planos de assinatura, pagamentos e conquistas.

• API: Economia — Transacoes, saldo, extrato, multiplicador global
• API: Pagamentos — Integracao Asaas (PIX, cartao, boleto), webhooks
• API: Loja — Produtos, estoque, pedidos, checkout misto (moeda do nucleo + R$)
• API: Planos — Assinaturas mensais (Free, Apoiador, Militante, Onca)
• API: Conquistas — Badges automaticas por marcos de engajamento
• API: Financeiro — Lancamentos de receitas e despesas do nucleo

Comunicacao e Inteligencia

Notificacoes, feed, ranking, comunicados, enquetes, porta-vozes, relatorios e IA.

• API: Notificacoes — Notificacoes internas, polling, badge de nao lidas
• API: Feed — Timeline de atividades com curtidas
• API: Ranking — Ranking mensal e all-time de pontos
• API: Comunicados — Comunicados segmentados por cargo e plano
• API: Enquetes — Criar enquetes, votar, modal obrigatorio, resultados
• API: Porta-Vozes — Sync RSS de postagens de porta-vozes
• API: Relatorios — Dashboard consolidado, exportacao CSV, transparencia
• API: Dashboard — Dados consolidados por cargo
• API: IA (Gemini) — Resumo semanal, assistente de membros, chat com IA
• Transparencia — Configuracao granular de visibilidade
• Bug Reports — Widget de reporte de bugs com screenshot automatico e Kanban de gestao

Guias por Cargo

Passo a passo para cada perfil de usuario da plataforma:

• Guia do Super Admin — Criar nucleos, navegar entre nucleos, gerenciar super admins
• Guia do Administrador — Aprovacoes, cargos, configuracoes, transparencia, relatorios
• Guia do Coordenador — Projetos, eventos, enquetes, assistente IA, relatorios
• Guia do Porta-Voz — Comunicados, enquetes, emails, tarefas, assistente IA
• Guia do Membro — Loja, planos, conquistas, dashboard, enquetes, ranking