Fluxo: Sistema de Transparencia

O sistema de transparencia permite que administradores controlem quais dados os membros comuns podem visualizar. Existem 3 categorias de transparencia, cada uma com um toggle mestre e sub-toggles individuais.

Categorias de Transparencia

Regra geral: Coordenadores e Administradores sempre tem acesso completo, independente dos toggles. As restricoes se aplicam apenas a membros comuns.

1. Transparencia Financeira

Controla se membros podem ver dados financeiros do nucleo.

Toggles

• transparencia_financeira — Toggle mestre. Se desativado, nenhum dado financeiro e visivel para membros.
• transparencia_receitas — Exibir receitas
• transparencia_despesas — Exibir despesas
• transparencia_saldo — Exibir saldo geral
• transparencia_categorias — Exibir categorias de receita/despesa

GET /api/financeiro/transparencia

Retorna apenas os campos financeiros habilitados pelo administrador. Se o toggle mestre estiver desativado, retorna:

{ "habilitado": false }

Quando habilitado, retorna apenas os sub-campos ativos:

{
  "habilitado": true,
  "receitas": 45000,
  "despesas": 12000,
  "saldo": 33000
}

2. Transparencia de Ranking

Controla se membros podem ver o ranking de Capixacoins do nucleo.

Toggles

• transparencia_ranking — Toggle mestre. Se desativado, a pagina de ranking e ocultada do sidebar para membros.
• transparencia_ranking_pontos — Exibir pontuacao dos membros
• transparencia_ranking_posicao — Exibir posicao no ranking

Comportamento quando desativado

• O item "Ranking" e removido do sidebar para membros comuns
• A API retorna 403 Forbidden se um membro tentar acessar diretamente
• Coordenadores e Administradores continuam vendo o ranking normalmente

3. Transparencia de Relatorios

Controla se membros podem ver relatorios simplificados do nucleo.

Toggles

• transparencia_relatorios — Toggle mestre. Se desativado, nenhum relatorio e visivel para membros.
• transparencia_relatorios_membros — Exibir dados sobre membros
• transparencia_relatorios_eventos — Exibir dados sobre eventos
• transparencia_relatorios_loja — Exibir dados sobre a loja

GET /api/relatorios/transparencia

Retorna dados simplificados apenas das categorias habilitadas.

{
  "habilitado": true,
  "membros": { "total": 42, "novosUltimos30Dias": 5 },
  "eventos": { "realizados": 12, "participacaoMedia": 18 }
}

Restricoes

• O dashboard completo de relatorios com graficos detalhados permanece exclusivo para COORD/ADMIN
• Exportacao em CSV permanece exclusiva para COORD/ADMIN
• Membros veem apenas um resumo simplificado dos dados habilitados

Configuracao no Frontend

Os toggles sao gerenciados na pagina de Configuracoes, na secao "Transparencia para Membros".

Estrutura da UI

1. Cada categoria tem um toggle mestre (ex: "Transparencia Financeira")
2. Abaixo do toggle mestre, sub-toggles individuais aparecem quando o mestre esta ativado
3. Desativar o toggle mestre desativa automaticamente todos os sub-toggles

Sidebar Dinamico

Itens do sidebar que possuem a propriedade transparenciaKey sao ocultados automaticamente quando o toggle correspondente esta desativado para membros.

// Exemplo de item no sidebar
{
  "label": "Ranking",
  "href": "/ranking",
  "transparenciaKey": "transparencia_ranking"
}
// Se transparencia_ranking = false, este item nao aparece para membros

Migration 00012

Adiciona 11 novas colunas booleanas na tabela nucleos:

Nota: transparencia_relatorios_loja nao esta listada acima pois utiliza uma coluna ja existente. Total de novas colunas: 11.

Valores Padrao

• Ranking: ativado por padrao — membros veem o ranking ao entrar no nucleo
• Financeira: desativado por padrao — dados financeiros sao sensiveis
• Relatorios: desativado por padrao — admin decide o que compartilhar