Friends

Visão geral

Sistema social com duas relações:

• Friendship — simétrica em significado, com fluxo pedido/aceite (modelado em uma única tabela com requester_id/receiver_id)
• Block — assimétrica e direcional (A bloqueia B é diferente de B bloqueia A; podem coexistir)

Bloquear um amigo derruba a amizade automaticamente, desconecta chat 1-1 entre os dois, e esconde conteúdo de ambos os lados.

Entidades principais

Endpoints

11 endpoints divididos em duas seções:

Pedidos / amigos (montado em /friends):

Blocks (montado em /blocks):

Fluxos

Pedido + aceite

Bloquear (cascade)

Listar amigos (denormalização)

Eventos de socket

Edge cases e regras especiais

• Mutual interest: se A pede a B e já existe pending B→A, o backend aceita automaticamente (não cria duplicado)
• Block desfaz amizade silenciosamente — sem notificação ao bloqueado de que foi bloqueado
• Unblock NÃO restaura amizade — o user precisa refazer pedido. Block é "ruptura limpa".
• Tentar adicionar quem te bloqueou: backend retorna BLOCKED — frontend pode mostrar genérico "não foi possível enviar"
• Amizade não existe sem aceite — friend_accepted é o gatilho real (pending é "interesse expresso")
• Cancel ≠ Reject — cancel é o requester desfazendo, reject é o receiver recusando. Ambos viram DELETE; sem notificação em qualquer caso
• Privacy interage com amizade — perfil friends_only revela tudo só pra accepted friends

Dependências entre módulos

• Notifications — friend_request, friend_accepted
• Chat — linkFriendship/unlinkFriendship pra conectar/desconectar DM 1-1
• Users — privacy gating em getProfile depende de areFriends
• Posts/Feed — friends_only posts só aparecem pra friends accepted
• Collections / Items — friends_only collections seguem mesma regra