> ## 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.

# Overview

> Visão geral da modelagem de dados do DEVMOB

## Introdução

A modelagem de dados do DEVMOB segue uma arquitetura baseada em **Domains** do Domain-Driven Design. Cada domain agrupa entidades relacionadas a um domínio específico do negócio de transporte rodoviário de passageiros.

## Convenções

| Convenção              | Descrição                                                                 |
| ---------------------- | ------------------------------------------------------------------------- |
| **Identificadores**    | IDs são opacos e ordenáveis, adequados para paginação por cursor          |
| **Valores monetários** | Armazenados em **centavos** (`Int`) — ex.: R\$ 15,50 = `1550`             |
| **Rates derivados**    | Quando documentados, usam **basis points** (`Int`) — ex.: 10.00% = `1000` |
| **Timestamps**         | Formato ISO 8601 (`DateTime`)                                             |
| **Remoção lógica**     | Campo `deletedAt` indica quando um recurso foi removido logicamente       |
| **Audit trail**        | Registra mutações relevantes para rastreabilidade                         |

## Domains

O sistema está organizado em **14 grupos de modelagem** e uma seção transversal de webhooks:

<CardGroup cols={2}>
  <Card title="Identity" icon="user" href="/data-modelling/identity/user">
    Usuários, sessões, passageiros (Customer), endereços, OTP e Profile. **6 entidades.**
  </Card>

  <Card title="Tenant" icon="building" href="/data-modelling/tenant/organization">
    Organizações, cooperativas, empresas, funcionários, memberships e convites. **7 entidades.**
  </Card>

  <Card title="Authorization" icon="shield-halved" href="/data-modelling/authorization/role">
    Roles e atribuição de permissions do catálogo estático exposto via API. **2 entidades.**
  </Card>

  <Card title="Fleet" icon="truck" href="/data-modelling/fleet/driver">
    Motoristas, veículos, tipos de assento e mapa de assentos. **4 entidades.**
  </Card>

  <Card title="Operations" icon="route" href="/data-modelling/operations/route">
    Pontos, rotas, aprovações, viagens, avaliações, tracking, paradas, itinerários, eventos, ocupação de assentos e programações recorrentes. **13 entidades.**
  </Card>

  <Card title="Sales" icon="cart-shopping" href="/data-modelling/sales/order">
    Checkouts, pedidos, bilhetes, atividades de bilhete e passageiros. **5 entidades.**
  </Card>

  <Card title="Benefits" icon="tag" href="/data-modelling/benefits/fare-benefit-category">
    Gratuidades, descontos, solicitações, validação documental e histórico de uso.
  </Card>

  <Card title="Credit Grant" icon="wallet" href="/data-modelling/credit-grant/credit-grant">
    Créditos concedidos por Company e movimentos de uso. **2 entidades.**
  </Card>

  <Card title="Promotion" icon="tags" href="/data-modelling/promotion/promotional">
    Catálogo, regras fixas de validação e histórico de aplicação de promoções. **6 entidades.**
  </Card>

  <Card title="Support" icon="headset" href="/data-modelling/support/support-case">
    Chamados, mensagens, anexos, atribuições, categorias e avaliação do atendimento.
  </Card>

  <Card title="Communication" icon="bell" href="/data-modelling/communication/notification">
    Notificações persistidas, inbox e estado por destinatário. **2 entidades.**
  </Card>

  <Card title="Export" icon="file-arrow-up" href="/data-modelling/data-transfer/export-resource">
    Catálogo, agendamentos e jobs para exportação assíncrona de dados.
  </Card>

  <Card title="Billing" icon="money-bill-transfer" href="/data-modelling/billing/payment">
    Configuração de billing da empresa, pagamentos, métodos de pagamento, recebíveis, contas bancárias e transferências.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/data-modelling/webhooks/webhook">
    Registro de eventos externos recebidos com idempotência e status de processamento.
  </Card>

  <Card title="Observability" icon="eye" href="/data-modelling/observability/audit-log">
    Log de auditoria para rastreabilidade. **1 entidade.**
  </Card>
</CardGroup>