Overview

O domínio de Tenant define a estrutura organizacional do sistema. Ele separa operação de transporte, permissionários e empresas corporativas compradoras de crédito. O isolamento multi-tenant do DEVMOB é baseado em Organization. O contexto ativo vem do Profile autenticado e das Memberships do usuário.

BKO é a superfície administrativa da MOB/plataforma. MOB/Admin não é uma Organization; usuários internos de BKO usam roles INTERNAL sem organizationId.

Conceitos

Organization Onboarding

Fluxo de criação de organizações, role admin e Invite do owner.

Operational Model

Relação entre cooperativa, permissionário e empresa corporativa.

Invitation Flow

Ciclo de vida do Invite: membro, motorista, ativação de conta e revogação.

Entidades

Entidade	Descrição
Organization	Tenant base com dados cadastrais comuns a cooperativas e empresas.
OrganizationAddress	Endereço da organização (relação 1:1).
Cooperative	Organização operacional que coordena rotas, permissionários, frota, trips, tickets e repasses.
TransportOperator	Permissionário autorizado a operar transporte dentro de uma cooperativa.
Company	Empresa corporativa que compra créditos da master/MOB/BKO e distribui para funcionários.
Employee	Funcionário vinculado a uma Company a partir de uma Membership na Organization da empresa.
Membership	Vínculo entre usuário, organização e role. Roles `ENVIRONMENT` e `ORGANIZATION` usam escopo de organização; roles `INTERNAL` não.
Invite	Token polimórfico para membro (`MEMBER`) ou motorista (`DRIVER`).

OrganizationType

Tipo	Descrição
`COOPERATIVE`	Cooperativa que opera transporte e concentra rotas, trips, tickets e financeiro operacional.
`COMPANY`	Empresa corporativa que compra créditos e gerencia funcionários.

Separação de responsabilidades

Cooperative = coordena a operação.
TransportOperator = permissionário autorizado a operar.
Driver = dirige a Trip.
Company = compra e distribui créditos para funcionários.
BKO = superfície administrativa da MOB/plataforma.
BKO/MOB = aprova, fiscaliza e bloqueia quando necessário.

Extensions

Tipo	Cooperative Extension	Company Extension
`COOPERATIVE`	Sim	—
`COMPANY`	—	Sim

TransportOperator não é Organization. Ele vive dentro de uma cooperativa e representa o permissionário autorizado a operar.

Employee

Employee nasce de uma Membership na Organization de uma Company. Ele representa o vínculo do usuário com a empresa corporativa e pode apontar para o Customer do mesmo usuário quando esse funcionário também usa fluxos de passageiro. Créditos concedidos por regra de funcionário validam esse vínculo, mas continuam pertencendo ao Customer no domínio de Credit Grant. Veja Operational Model para a documentação completa do relacionamento entre Cooperative, TransportOperator e Company.

Visão geral

Authorization

Benefits

Billing

Communication

Credit Grant

Export

Fleet

Identity

Observability

Operations

Platform

Sales

Support

Tenant

Overview

Overview

Conceitos

Organization Onboarding

Operational Model

Invitation Flow

Entidades

OrganizationType

Separação de responsabilidades

Extensions

Employee

​Overview

​Conceitos

Organization Onboarding

Operational Model

Invitation Flow

​Entidades

​OrganizationType

​Separação de responsabilidades

​Extensions

​Employee

Overview

Conceitos

Entidades

OrganizationType

Separação de responsabilidades

Extensions

Employee