Comunidades

Visão geral

Comunidades são espaços persistentes que reúnem pessoas ao redor de um interesse (gênero de jogo, jogo específico, hobby de colecionador etc.). Qualquer usuário autenticado pode criar, participar ou moderar comunidades.

Dois modelos de entrada:

• public — qualquer membro pode entrar diretamente
• restricted — entrada requer aprovação de owner ou moderador

Entidades principais

Schema resumido

communities
├── id, slug (auto-suffix em colisão), name, description
├── ownerId (nullable — owner pode deletar conta sem destruir comunidade)
├── category (boardgames | tcg | rpg-mesa | rpg-digital | mmo | souls | fps |
│             survival | indie | retro | mobile | simulation | strategy |
│             mods | community-events)
├── iconUrl, coverUrl   ← multipart no create/update
├── visibility: public | restricted
├── rules (5000 chars), welcomeMessage (1000 chars)
├── memberCount, topicCount  ← counters denormalizados
└── deletedAt (soft delete — só owner)

community_members
├── communityId, userId
├── role: owner | moderator | member
├── status: pending | active | banned
├── banReason, joinedAt, approvedAt
└── unique(communityId, userId)

community_join_requests
├── communityId, userId
├── status: pending | approved | rejected
├── decidedBy, decidedAt
└── partial unique(communityId, userId) WHERE status='pending'

community_topic_meta        ← estende posts (PK = postId)
├── communityId
├── pinned, locked, pinnedAt, lockedAt
└── movedFromCommunityId

Endpoints

28 rotas sob /comunidades:

Comunidades (CRUD)

Membros

Pedidos de entrada (Join Requests)

Tópicos

Tópicos reutilizam o sistema de posts: reactions (power_up, epic, critical, loot, gg) e comentários planos funcionam nos tópicos sem endpoints extras.

Fluxos

Criar comunidade

Entrar em comunidade restrita

Aprovar pedido de entrada

Moderação de membro

ban     → status = 'banned', banReason gravado, audit log
unban   → status = 'active', banReason limpo, audit log
kick    → row deletada de community_members, audit log
promote → role = 'moderator' (owner only), audit log
demote  → role = 'member'    (owner only), audit log

Todas as ações de moderação são registradas em community_audit_log com actorId, targetUserId, action e metadata.

Regras de acesso

Visibilidade e feeds

• Posts criados como tópico de comunidade não aparecem no feed global — ficam restritos ao feed da comunidade.
• Reactions e comentários em tópicos funcionam via endpoints existentes (/posts/:id/reactions, /posts/:id/comments), sem rotas extras.

Slug

O slug é derivado do nome (slugify) na criação. Em caso de colisão, um sufixo numérico atômico é adicionado dentro de uma transação (my-community → my-community-2 → my-community-3…). O endpoint de detalhes aceita tanto UUID quanto slug como :id.

Códigos de erro

CommunitiesError.code:

Limitações conhecidas (alpha)

• Sem chat próprio por comunidade — usuários se comunicam via DM ou tópicos
• Posts cruzados (cross-post de tópico no feed pessoal) não implementados
• Transferência de ownership (community_transfers) criada no schema mas endpoints ainda não expostos
• Convites diretos (community_invites) no schema mas endpoints não expostos
• Sem notificações de eventos da comunidade (novo tópico, pedido aprovado etc.)
• Sem limite de comunidades por usuário
• Sem busca full-text em tópicos