Chat - Documentação Funcional
Versão: 1.0
Data: 2026-01-28
Status: Funcionalidade Implementada
Parte de: Documentação Funcional da Plataforma
🎯 Visão Geral
O Chat fornece comunicação em tempo real/assíncrona entre usuários com governança territorial. Suporta canais públicos, canais de moradores, grupos privados e mensagens diretas (DM).
Objetivo
Permitir que usuários:
- Comuniquem-se em canais territoriais
- Criem grupos privados
- Enviem mensagens diretas (se habilitado)
- Moderem conversas (curadores/moderadores)
💼 Função de Negócio
Para o Usuário
Canais Territoriais:
- Canal Público: Leitura para membros, escrita para moradores verificados
- Canal de Moradores: Apenas moradores verificados
Grupos:
- Criar grupos privados (apenas moradores verificados)
- Aprovação por curadoria
- Invite-only
DM:
- Mensagens diretas (se habilitado por território)
- Respeita bloqueios e preferências
🏗️ Elementos da Arquitetura
Entidades Principais
ChatConversation
- Tipos: TERRITORY_PUBLIC, TERRITORY_RESIDENTS, GROUP, DIRECT
- Status: PENDING_APPROVAL, ACTIVE, ARCHIVED
ChatMessage
- Propósito: Mensagem em conversa
- Tipos: Texto, Mídia (imagens, áudios curtos)
ConversationParticipant
- Propósito: Participante em conversa
- Roles: Owner, Member
⚙️ Regras de Negócio
- Feature Flags: CHATENABLED, CHATGROUPS, CHATDMENABLED controlam funcionalidades
- Permissões: Baseadas em Membership e verificação
- Grupos: Requerem aprovação de curadoria
- Privacidade: Respeita bloqueios e preferências
- Moderação: Moderadores podem trancar/desabilitar
📚 Documentação Relacionada
- Plataforma Arah - Visão geral
- Territórios e Memberships - Permissões baseadas em Membership
- API - Chat - Documentação técnica
Última Atualização: 2026-01-28
Versão: 1.0
Status: Funcionalidade Implementada