> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# DriverCompany

> Vínculo N:N entre motorista e empresa, com status operacional por empresa

## Campos

| Campo             | Tipo                  | Descrição                                              |
| ----------------- | --------------------- | ------------------------------------------------------ |
| `driverCompanyId` | `UUID`                | Identificador único                                    |
| `driverId`        | `UUID`                | Referência ao motorista                                |
| `companyId`       | `UUID`                | Referência à empresa                                   |
| `status`          | `DriverCompanyStatus` | Status operacional do motorista nesta empresa          |
| `createdBy`       | `UUID?`               | Usuário que criou o registro, quando aplicável         |
| `createdAt`       | `DateTime`            | Data de criação                                        |
| `updatedBy`       | `UUID?`               | Usuário que fez a última atualização, quando aplicável |
| `updatedAt`       | `DateTime`            | Data da última atualização                             |
| `deletedBy`       | `UUID?`               | Usuário que removeu o registro, quando aplicável       |
| `deletedAt`       | `DateTime?`           | Data de remoção                                        |

## Relacionamentos

* Relaciona-se com [Driver](/data-modelling/fleet/driver)
* Relaciona-se com [Company](/data-modelling/tenant/company)

## Regras de Negócio

* Um `Driver` pode estar vinculado a múltiplas `Company` — cada vínculo é uma linha em `DriverCompany` com seu próprio `status`.
* O par `driverId` + `companyId` é único — não pode haver mais de um vínculo do mesmo motorista na mesma empresa.
* A desativação é **por empresa**: desativar o motorista numa empresa não afeta o vínculo dele com outras.
* `ACTIVE`/`INACTIVE` expressam o status operacional do vínculo.
* O vínculo surge no aceite do [convite de motorista](/domain/tenant/invitation-flow#flow--driver-invite).

## Enums

### DriverCompanyStatus

| Valor      | Descrição                                                           |
| ---------- | ------------------------------------------------------------------- |
| `ACTIVE`   | Motorista ativo nesta empresa                                       |
| `INACTIVE` | Motorista inativo nesta empresa (férias, afastamento, desligamento) |

## Example

```json theme={null}
{
  "driverCompanyId": "0197a807-b333-7923-9cde-b1e0e3122c22",
  "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "status": "ACTIVE",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T14:05:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T14:05:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}
```