Employee

​

Campos

​

Relacionamentos

• Relaciona-se com Company por companyId.
• Relaciona-se com Organization por organizationId.
• Relaciona-se com User por userId, quando a identidade é resolvida diretamente ou o convite é aceito.
• Relaciona-se com Invite pelos convites emitidos para o cadastro.

​

Regras de negócio

• Employee só pode ser criado com organizationId preenchido e pertencente a uma Company.
• A criação exige name, email e telefone para resolver a identidade do funcionário e, quando necessário, gerar o convite.
• organizationId deve ser igual ao organizationId da Company informada em companyId.
• Se email ou telefone resolverem o mesmo User existente, o Employee nasce ACTIVE, com userId e activatedAt, sem Invite.
• Se não houver User existente, o Employee nasce PENDING, sem userId, e recebe um Invite EMPLOYEE.
• Se email e telefone resolverem Users diferentes, a criação deve ser rejeitada.
• O Invite EMPLOYEE não possui roleId e não cria Membership.
• Ao aceitar o convite, o sistema cria ou resolve o User, grava userId e muda o Employee para ACTIVE.
• O par companyId + userId deve ser único quando o usuário já estiver vinculado.
• O vínculo pertence à Company. O mesmo usuário pode ser funcionário de múltiplas Companies, cada uma com seu próprio Employee.
• Employee não deve referenciar Passenger, porque Passenger é snapshot de uma passagem.
• Elegibilidade, saldo e uso de subsídio ou crédito corporativo devem ser derivados de CreditGrant e CreditLedgerEntry, não persistidos em Employee.
• Quando o vínculo deixa de valer, o registro deve mudar para SUSPENDED ou REVOKED; o histórico não deve ser apagado.
• Créditos concedidos por regra de funcionário devem validar a mesma companyId do Employee e resolver o Customer separadamente pelo User.

​

Enums

​

EmployeeStatus

​

Example

{
  "employeeId": "0197f760-8a12-7356-92c6-a7444de02d4a",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
  "userId": null,
  "name": "Maria Silva",
  "employeeCode": "EMP-1024",
  "jobTitle": "Atendente",
  "department": "Operação",
  "status": "PENDING",
  "activatedAt": null,
  "suspendedAt": null,
  "revokedAt": null,
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T14:00:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T14:00:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}