Regras de Visibilidade e Permissões - API Arah

Parte de: API Arah - Lógica de Negócio e Usabilidade
Versão: 2.0
Data: 2025-01-20


🔒 Regras de Visibilidade e Permissões

Visibilidade de Conteúdo

PUBLIC (Público):

  • Visível para todos usuários autenticados
  • Visitantes (VISITOR) podem ver
  • Moradores (RESIDENT) podem ver

RESIDENTS_ONLY (Apenas Moradores):

  • Visível apenas para moradores verificados (RESIDENT + ResidencyVerification != NONE)
  • Visitantes não veem
  • Moradores não verificados (RESIDENT + ResidencyVerification = NONE) não veem

Permissões por Role

VISITOR (Visitante):

  • ✅ Ver posts públicos
  • ✅ Ver eventos públicos
  • ✅ Ver entidades públicas do mapa
  • ✅ Criar eventos
  • ✅ Reportar alertas
  • ✅ Sugerir entidades
  • ✅ Reportar posts/usuários
  • ✅ Bloquear usuários
  • ✅ Criar solicitações de entrada
  • ❌ Ver conteúdo RESIDENTS_ONLY
  • ❌ Comentar posts
  • ❌ Compartilhar posts
  • ❌ Criar stores/items
  • ❌ Criar assets
  • ❌ Relacionar-se com entidades

RESIDENT (não verificado):

  • ✅ Todas permissões de VISITOR
  • ❌ Ver conteúdo RESIDENTS_ONLY
  • ❌ Criar stores/items
  • ❌ Criar assets
  • ❌ Relacionar-se com entidades

RESIDENT (verificado):

  • ✅ Todas permissões de VISITOR
  • ✅ Ver conteúdo RESIDENTS_ONLY
  • ✅ Comentar posts
  • ✅ Compartilhar posts
  • ✅ Criar stores/items
  • ✅ Criar assets
  • ✅ Relacionar-se com entidades

CURATOR (Curador):

  • ✅ Todas permissões de RESIDENT (verificado)
  • ✅ Validar entidades
  • ✅ Validar alertas
  • ✅ Validar assets
  • ✅ Listar reports
  • ✅ Atualizar feature flags
  • ✅ Aprovar/rejeitar join requests

Sanções

PostingRestriction (Restrição de Postagem):

  • Usuário não pode criar posts no território
  • Usuário não pode criar eventos
  • Usuário não pode criar alertas

Scope (Escopo de Sanção):

  • TERRITORY: Sanção aplicada apenas ao território específico
  • GLOBAL: Sanção aplicada a todos os territórios

Duração:

  • Sanções podem ter data de início e fim
  • Sanções ativas são verificadas automaticamente

Acesso ao território e localização

Política atual (acesso independente da localização):

  • Conexão e visualização: Visitantes e moradores podem entrar e visualizar um território mesmo estando fora do perímetro (não é mais exigido que a geolocalização esteja dentro do território).
  • Status no perfil: Haverá informação de status (ex.: "no território" / "fora do território") no perfil do usuário; regras por ação (quais exigem estar no território) serão definidas depois.
  • Ações: Por ora todas as operações (ler feed, criar post, etc.) permitem acesso de qualquer local; no futuro algumas ações poderão voltar a exigir presença no território.

📚 Documentação Relacionada


Voltar para: Índice da Documentação da API