# Estrutura de Tabelas

## Visão Geral

Este tópico apresenta a estrutura de banco de dados utilizada pelo serviço `suricato_Placa` para o armazenamento, controle e processamento de informações de placas, veículos e crachás. 

A arquitetura é composta por uma view de consulta e tabelas específicas que gerenciam a fila e o histórico de operações.

## Regras de Negócio

Antes de utilizar ou manipular a estrutura de dados, observe as seguintes diretrizes:

* **Consulta de Cadastros:** A view `VHISTORICOCRACHAPLACA` deve ser utilizada exclusivamente para a consulta de dados válidos de colaboradores e visitantes.
* **Registros Processados:** A tabela `TBPLACACONTROLE` armazena apenas os registros que já concluíram o fluxo de processamento.
* **Fila de Trabalho:** A tabela `TBPLACAFILA` representa a fila ativa de processamento consumida pelo `Suricato-Player`.
* **Auditoria e Histórico:** A tabela `TBPLACAHISTORICO` armazena o histórico completo de todas as operações executadas pelo sistema.
* **Integridade Referencial:** Os dados inseridos ou validados devem manter consistência estrita entre o vínculo de veículo, placa e crachá.
* **Manipulação Direta:** Alterações manuais (via scripts externos) diretamente nas tabelas devem ser evitadas ou realizadas com critério técnico, sob o risco de corromper o fluxo de processamento do serviço.

## Passo a Passo - Estrutura de Tabelas

{% stepper %}
{% step %}

#### Consultar dados de placas e crachás

Para consultar os dados válidos e vigentes no sistema, utilize a estrutura abaixo:

* **Objeto:** `VHISTORICOCRACHAPLACA` (View)
* **Campos de Consulta:** `IDVEIC`, `PLACVEIC`, `CRACHA`, `PLANTA`, `CODIN`.
  {% endstep %}

{% step %}

#### Verificar registros já processados

Para auditar os registros que já foram processados pelo serviço:

* Objeto: `TBPLACACONTROLE` (Tabela)
* Campos de Consulta: `IDVEIC`, `PLACVEIC`, `CRACHA`, `CODIPLAN`, `CODICOLE`.
  {% endstep %}

{% step %}

#### Consultar fila de processamento

Para monitorar os comandos e registros que aguardam execução pelo `Suricato-Player`:

* Objeto: `TBPLACAFILA` (Tabela)
* Campos de Consulta: `CODIGO`, `IDVEIC`, `PLACAVEIC`, `CRACHA`, `CODIPLAN`, `CODICOLE`, `EQUIPAMENTO`, `OPERACAO`.
  {% endstep %}

{% step %}

#### Consultar histórico de processamento

Para rastrear o ciclo de vida e o resultado das operações realizadas:

* Objeto: `TBPLACAHISTORICO` (Tabela)
* Campos de Consulta: `INCLUSÃO`, `CODIGO`, `IDVEIC`, `PLACVEIC`, `CRACHA`, `CODIPLAN`, `CODICOLE`, `EQUIPAMENTO`, `OPERACAO`, `STATUS`.
  {% endstep %}
  {% endstepper %}

## FAQ – Perguntas Frequentes

<details>

<summary>Qual tabela devo usar para consultar placas válidas?</summary>

Utilize a view **VHISTORICOCRACHAPLACA**.

</details>

<details>

<summary>Onde verifico se um registro já foi processado?</summary>

Na tabela **TBPLACACONTROLE**.

</details>

<details>

<summary>Onde acompanho o que ainda será processado?</summary>

Na tabela **TBPLACAFILA**.

</details>

<details>

<summary>Onde posso consultar o histórico completo das operações?</summary>

Na tabela **TBPLACAHISTORICO**.

</details>

<details>

<summary>Posso alterar diretamente os dados das tabelas?</summary>

Não é recomendado. Alterações indevidas podem comprometer o funcionamento do sistema.

</details>


---

# 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://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-suricato-placa/parametrizacao-do-suricato-placa/estrutura-de-tabelas.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.