# Relacionamento de Views

Esta página ajuda a entender como as views de BI se conectam entre si.

O diagrama abaixo segue a convenção atual da documentação. Campos iniciados por `Id` representam chaves primárias, estrangeiras ou chaves operacionais recorrentes entre as views;

## Como ler este diagrama

Use a seta e o rótulo para localizar o campo que faz a ligação entre as views.

Exemplos:

* `Clientes.IdCliente -> ContratosComerciais.IdCliente`
* `Propostas.IdProposta -> ContratosComerciais.IdProposta`
* `ContratosLocacao.IdContratoLocacao -> ContratosLocacaoPrecos.IdContratoLocacao`

## Legenda visual

* nós em verde: views centrais da jornada de negócio;
* nós em azul claro: views satélite, itens e históricos ligados às centrais;
* nós com borda tracejada: cadastros de apoio, situações, tipos ou views analíticas complementares;
* setas contínuas: relação mostrada diretamente pelos campos públicos da documentação;
* setas pontilhadas: relacionamento operacional, alias ou chave textual usada para facilitar a leitura.

## Visão geral

```mermaid
flowchart LR
    subgraph comercial_e_cliente["Comercial e cliente"]
        direction TB
        cli["Clientes"]
        ctc["ContatosClientes"]
        ctn["ContatosClientesNotificacoes"]
        pro["Propostas"]
        itp["ItensProposta"]
        cco["ContratosComerciais"]
        itc["ItensContratos"]
    end

    subgraph locacao_e_faturamento["Locacao e faturamento"]
        direction TB
        clo["ContratosLocacao"]
        clp["ContratosLocacaoPrecos"]
        rac["ContratosLocacaoRac"]
        fat["Faturamentos"]
        fti["FaturamentoItems"]
        hpc["HistoricoPrecosContratos"]
    end

    subgraph frota["Frota"]
        direction TB
        vei["Veiculos"]
        vac["VeiculosAcessorios"]
        vcp["VeiculosComprados"]
        vvd["VeiculosVendidos"]
        ali["Alienacoes"]
    end

    subgraph operacao_e_manutencao["Operacao e manutencao"]
        direction TB
        ods["OrdensServico"]
        ios["ItensOrdemServico"]
        ocd["OcorrenciasDevolucao"]
        oci["OcorrenciasInfracoes"]
        ocm["OcorrenciasManutencao"]
        ocs["OcorrenciasSinistro"]
        ocv["OcorrenciasVeiculoTemporario"]
        pcs["PecasServicos"]
    end

    subgraph cadastros_de_apoio["Cadastros de apoio"]
        direction TB
        forn["Fornecedores"]
        caf["CategoriasFornecedores"]
        qaf["QualificacoesFornecedores"]
        con["Condutores"]
        cmp["Compradores"]
        fil["Filiais"]
        pat["Patios"]
        mon["Montadoras"]
    end

    cli -->|IdCliente| ctc
    ctc -->|IdContatoCliente| ctn
    cli -->|IdCliente| pro
    pro -->|IdProposta| itp
    pro -->|IdProposta| cco
    cco -.->|IdContrato| itc
    itc -->|IdItemContrato| clo
    clo -->|IdContratoLocacao| clp
    cli -->|IdCliente| rac
    vei -->|IdVeiculo| rac
    vei -->|IdVeiculoPrincipal| clo
    con -->|IdCondutor| clo
    fat -->|IdNota| fti
    cli -->|IdCliente| fat
    cmp -->|IdComprador| fat
    clo -->|IdContratoLocacao| fti
    cco -->|IdContratoComercial| fti
    vei -->|IdVeiculo| fti
    vei -->|IdVeiculo| vac
    vei -->|IdVeiculo| vcp
    vei -->|IdVeiculo| vvd
    vei -->|IdVeiculo| ali
    vei -->|IdVeiculo| ods
    ods -->|IdOrdemServico| ios
    ocd -->|IdOcorrencia| ods
    oci -->|IdOcorrencia| ods
    ocm -->|IdOcorrencia| ods
    ocs -->|IdOcorrencia| ods
    ocv -->|IdOcorrencia| ods
    ios -->|IdPecaServico| pcs
    forn -->|IdFornecedor| ods
    forn -->|IdFornecedor| caf
    forn -->|IdFornecedor| qaf
    mon -->|IdMontadora| vei
    fil -->|IdFilial| vei
    pat -->|IdPatio| vei

    classDef hub fill:#0f766e,stroke:#115e59,color:#ffffff,stroke-width:2px;
    classDef sat fill:#ecfeff,stroke:#0ea5e9,color:#0f172a;
    classDef ref fill:#f8fafc,stroke:#94a3b8,color:#334155,stroke-dasharray: 4 4;
    class cli hub
    class ctc sat
    class ctn sat
    class pro hub
    class itp sat
    class cco hub
    class itc sat
    class clo hub
    class clp sat
    class rac sat
    class fat hub
    class fti sat
    class hpc ref
    class vei hub
    class vac sat
    class vcp sat
    class vvd sat
    class ali sat
    class ods hub
    class ios sat
    class ocd sat
    class oci sat
    class ocm sat
    class ocs sat
    class ocv sat
    class pcs sat
    class forn hub
    class caf sat
    class qaf sat
    class con sat
    class cmp sat
    class fil sat
    class pat sat
    class mon sat
```

> Observação: nesta visão resumida, o fluxo `ContratosComerciais -> ItensContratos -> ContratosLocacao` usa a chave operacional `IdContrato` para manter a jornada comercial visível do início ao fim.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.bluefleet.com.br/home/views-de-bi/relacionamento-de-views.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
