Sistema de Fórum

Sistema de fórum para comunicação interna entre usuários da plataforma, permitindo troca de experiências, dúvidas e discussões pedagógicas dentro dos municípios.

Índice:

• Visão Geral
• Como Funciona
• Componentes do Fórum
• Fluxo do Usuário
• Permissões e Acesso
• Interações Disponíveis
• Perguntas Frequentes

---

Visão Geral

Objetivo

Proporcionar um ambiente colaborativo onde usuários podem trocar experiências, tirar dúvidas e discutir temas pedagógicos, criando uma comunidade de prática dentro da plataforma.

Benefícios

• Compartilhamento: Professores trocam experiências e materiais
• Suporte: Dúvidas são respondidas pela comunidade
• Engajamento: Ranking reconhece usuários mais ativos
• Organização: Tópicos podem ser categorizados por município, escola e role
• Flexibilidade: Enquetes integradas para votação

Fluxo Resumido

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  Usuário         │───>│  Navega pelos   │───>│  Intera com     │
│  acessa fórum    │    │  tópicos         │    │  conteúdo        │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                              │                        │
                              v                        v
                       ┌─────────────────┐    ┌─────────────────┐
                       │  Cria novo      │    │  Comunidade     │
                       │  tópico         │    │  engajada       │
                       └─────────────────┘    └─────────────────┘

---

Como Funciona

Navegação e Descoberta

Tela Principal:

• Lista de tópicos com paginação (5 por página)
• Filtros por:
  • Tipo de usuário que criou
  • Tópicos fechados/abertos
  • Busca por texto no título
• Ordenação:
  • Fixados primeiro, depois mais recentes
  • Por data (crescente/decrescente)
• Ranking de usuários mais ativos

Ranking de Usuários:

• Top 5 usuários mais ativos
• Contagem de tópicos criados
• Contagem de mensagens postadas
• Ordenação por interações totais

Criação de Tópicos

Informações necessárias:

• Título do tópico
• Conteúdo detalhado
• Municípios com acesso (obrigatório pelo menos um)
• Escolas específicas (opcional)
• Roles permitidas (opcional)

Validações:

• Campos não podem conter apenas espaços em branco
• Ao menos um município deve ser selecionado
• Permissões verificadas automaticamente

Acesso e Visibilidade

Quem pode ver:

• Autores veem seus próprios tópicos
• Administradores veem qualquer tópico
• Demais usuários veem apenas tópicos de seus municípios

Controle de acesso:

• Por município (quem pode ver)
• Por escola (refinamento geográfico)
• Por role (tipo de usuário)

---

Componentes do Fórum

1. Tópicos (Discussions)

O que é: Discussões principais criadas por usuários.

Características:

• Título e conteúdo
• Autor do tópico
• Status (fixado no topo, fechado para interações)
• Controle de acesso (municípios, escolas, roles)

Validações:

• Título obrigatório (sem espaços em branco)
• Conteúdo obrigatório (sem espaços em branco)
• Vinculado a usuário ativo

2. Mensagens (Comments)

O que é: Respostas e comentários em tópicos.

Características:

• Conteúdo do comentário
• Autor do comentário
• Vinculada a um tópico

Funcionalidades:

• Respostas em thread
• Suporte a formatação de texto
• Edição pelos autores ou admins

3. Sistema de Curtidas

O que é: Indicador de popularidade e relevância.

Funcionalidades:

• Uma curtida por usuário por tópico
• Lista de usuários que curtiram
• Notificação para o autor
• Contagem total exibida

Por que existe: Permite identificar rapidamente quais tópicos são mais úteis ou populares na comunidade.

4. Sistema de Enquetes

O que é: Votação integrada aos tópicos.

Características:

• Alternativas definidas na criação
• Uma resposta por usuário por alternativa
• Resultados em tempo real
• Representação visual de distribuição

Quando usar:

• Decisões coletivas
• Pesquisas de opinião
• Preferências da comunidade

---

Fluxo do Usuário

Navegar pelo Fórum

O que o usuário faz:

1. Acessa o fórum
2. Vê lista de tópicos
3. Aplica filtros se desejar
4. Clica em tópico de interesse

O que vê:

• Tópicos ordenados (fixados primeiro)
• Preview do conteúdo
• Metadados (autor, data, contador)
• Status badges (fechado, fixado)
• Ranking lateral de top usuários

Criar um Tópico

O que o usuário faz:

1. Clica em "Novo Tópico"
2. Preenche título e conteúdo
3. Seleciona municípios com acesso
4. Opcionalmente seleciona escolas/roles
5. Opcionalmente adiciona enquete
6. Submete

O que acontece:

• Sistema valida campos
• Tópico criado
• Notificação enviada (se configurado)
• Tópico aparece na lista

Interagir com Tópicos

Curtir:

• Clica em ícone de curtir
• Contagem incrementada
• Autor notificado

Comentar:

• Clica em "Responder"
• Escreve mensagem
• Submete
• Comentário aparece thread abaixo
• Autor notificado

Votar em enquete:

• Vê alternativas
• Seleciona uma
• Voto registrado
• Resultados atualizados em tempo real

Editar e Gerenciar

Editar próprio tópico:

• Autor pode editar
• Admins podem editar qualquer tópico
• Histórico preservado

Fechar tópico:

• Autor ou admin pode fechar
• Novas interações bloqueadas
• Visualização permanece

Fixar tópico:

• Admin pode fixar
• Aparece no topo da lista
• Útil para avisos importantes

---

Permissões e Acesso

Roles com Acesso

Acesso Total:

• admin: Acesso completo, pode editar/deletar qualquer coisa

Visualização e Criação:

• school_manager: Pode criar e ver tópicos
• teacher: Pode criar e ver tópicos

Visualização Limitada:

• company_manager: Pode ver tópicos
• company_assistant: Pode ver tópicos
• county_supervisor: Pode ver tópicos

Sem Acesso:

• student: Não acessa fórum
• parent: Não acessa fórum

Regras de Visibilidade

Autores:

• Sempre veem seus próprios tópicos
• Podem editar/deletar seus tópicos

Administradores:

• Veem qualquer tópico
• Podem editar/deletar qualquer tópico

Demais Usuários:

• Veem apenas tópicos de seus municípios
• Não veem tópicos de outros municípios
• Podem interagir se tiverem permissão

---

Interações Disponíveis

Tipos de Interação

Curtir:

• Indica relevância ou concordância
• Uma curtida por usuário por tópico
• Autor é notificado

Comentar:

• Adiciona ao tópico
• Thread de discussão
• Autor do tópico é notificado
• Outros participantes podem responder

Votar (Enquetes):

• Uma resposta por usuário
• Resultados em tempo real
• Distribuição visual

Notificações

Quando são enviadas:

• Novo comentário em tópico
• Alguém curtiu seu tópico
• Menções a outros usuários (planejado)

Propósito: Manter engajamento e informar usuários sobre atividade relevante.

---

Perguntas Frequentes

Uso Geral

Quem pode acessar o fórum? Professores, gestores e admins. Estudantes e responsáveis não têm acesso.

Posso ver tópicos de outros municípios? Não, apenas tópicos do seu próprio município (a menos que você seja admin).

Posso editar meu tópico depois de criar? Sim, autores podem editar tópicos próprios. Admins podem editar qualquer tópico.

Criação e Gerenciamento

O que torna um tópico "fixado"? Admins podem fixar tópicos importantes no topo da lista. Útil para avisos, regras ou tópicos muito relevantes.

Posso criar uma enquete? Sim, ao criar um tópico você pode adicionar enquete com múltiplas alternativas.

O que acontece se eu fechar um tópico? Novas interações (comentários, curtidas) são bloqueadas, mas o tópico continua visível para consulta.

Ranking e Engajamento

Como funciona o ranking? O ranking conta tópicos criados e mensagens postadas por usuário. Top 5 é exibido na lateral.

Por que há ranking? Para reconhecer usuários mais ativos e incentivar participação na comunidade.

Posio desativar o ranking? O ranking é automático e baseado em atividade real. Não há como desativar, mas você pode não aparecer nele se não interagir.

Privacidade e Acesso

Meus tópicos são privados? Tópicos são visíveis para usuários do(s) município(s) que você selecionou ao criar. Não são globalmente públicos.

Posso restringir por role? Sim, você pode limitar quais tipos de usuários (professores, gestores, etc.) podem ver seu tópico.

---

Última atualização: 2026-08-03