Documento interno
Arquitetura Tecnica

RBAC & Permissoes

Perfis, papeis e controle de acesso por persona no sistema Romeo.

Versao
1.0
Atualizado
junho/2026
Status
pronto
1

Visao geral

O Romeo implementa RBAC (Role-Based Access Control) com duas camadas:

  • Personas — tipos de usuario do sistema (corretor, inquilino, etc.)
  • Papeis — funcoes dentro de uma organizacao (dono, gestor, etc.)
Principio
Cada usuario tem uma persona e, se vinculado a uma organizacao, um papel. A combinacao define o que ele pode fazer.
2

Personas do sistema

PersonaTipoDescricaoAcesso
Admin PlataformaInternoEquipe RomeoTudo
Dono/AdminB2BDono da imobiliariaOrganizacao
CorretorB2BProfissional com CRECICarteira propria
ProprietarioB2B2CDono de imovelSeus imoveis
InquilinoB2B2CLocatarioSeu contrato
HospedeB2B2CTemporadaSua reserva
PublicoAnonimoVisitanteMarketplace
3

Papeis internos

Dentro de uma organizacao (imobiliaria), usuarios podem ter diferentes papeis:

PapelDescricaoPode gerenciar equipe?
DonoProprietario da contaSim
GestorGerente com acesso amploSim
SecretariaAtendimento e agendaNao
CorretorProfissional de vendasNao
FinanceiroGestao financeiraNao
AdvogadoJuridico (externo)Nao
SindicoGestao de condominioNao

Papeis sao hierarquicos. Dono herda tudo de Gestor, que herda de Corretor.

4

Permissoes por modulo

Cada papel tem nivel de acesso por modulo: Nenhum, Ver ou Gerenciar.

ModuloDonoGestorCorretorSecretaria
ImoveisGerenciarGerenciarGerenciar*Ver
CarteiraGerenciarGerenciarGerenciar*Gerenciar
FinanceiroGerenciarGerenciarVerNenhum
EquipeGerenciarGerenciarNenhumNenhum
ConfigGerenciarVerNenhumNenhum

* Corretor: apenas recursos da sua carteira

5

Regras de isolamento

Por organizacao

Todo dado pertence a uma organizacao_id. RLS no Postgres garante que usuarios so vejam dados da organizacao onde estao vinculados.

Por corretor

Corretores so veem imoveis onde sao responsaveis ou tem parceria ativa. Gestores e Secretarias veem todos da organizacao.

Por contrato (portais)

Inquilinos so veem seu contrato. Proprietarios so veem seus imoveis. Hospedes so veem sua reserva.

Seguranca
Isolamento e aplicado no banco de dados (RLS), nao apenas na UI. Mesmo via API direta, usuarios nao conseguem acessar dados de outros.
6

Casos especiais

Primeiro usuario

Quem cria a organizacao recebe papel "Dono" automaticamente. Esse papel nao pode ser removido, apenas transferido (via suporte).

CRECI pendente

Corretor com CRECI em validacao pode usar o sistema normalmente. Se rejeitado, conta e suspensa apos 30 dias para regularizacao.

MFA obrigatorio

Admin da plataforma: MFA obrigatorio. Dono/Gestor: recomendado. Outros: opcional.

Dados sensiveis

DadoQuem pode ver
Palavra-chave do proprietarioCorretor do imovel, Dono, Gestor
CPF completoDono, Gestor, Financeiro
Dados bancariosDono, Financeiro (nunca completo)
Comissoes de outrosDono, Gestor, Financeiro