# painelconsultas/painel-consultas architecture

> Architecture diagram of the GitHub repository painelconsultas/painel-consultas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/painelconsultas/painel-consultas
- Repository: https://github.com/painelconsultas/painel-consultas

## Overview

Vortex Buscas is a vehicle and personal-record lookup service offered through a web panel, Telegram bot, and REST API. Users create an account, add credits, submit a lookup, and can later review history or export a PDF. The README describes vehicle, person, driver’s-license, fleet, and ownership-history lookups, with prioritized provider fallback and normalized results. No source files were provided, so implementation paths and undocumented internal calls cannot be established; edges below reflect only relationships explicitly described in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_channels["Access channels"]
  node_web["Web panel"]
  node_telegram["Telegram bot"]
  node_api["REST API"]
end

subgraph group_lookup["Lookup capabilities"]
  node_vehicle["Vehicle lookup"]
  node_person["Person lookup"]
  node_cnh["CNH lookup"]
  node_fleet["Fleet lookup"]
  node_owners["Owner history"]
end

subgraph group_runtime["Lookup runtime"]
  node_lookup_engine["Lookup service"]
  node_providers["Data providers"]
  node_normalization["Result normalization"]
end

subgraph group_account["Account and usage"]
  node_account["User account"]
  node_credits["Credits and quotas"]
  node_history[("Lookup history")]
  node_pdf["PDF export"]
end

node_user(("Customer"))
node_pix["Pix payment"]

node_user -->|"uses"| node_web
node_user -->|"uses"| node_telegram
node_user -->|"integrates"| node_api
node_web -->|"submits lookups"| node_lookup_engine
node_telegram -->|"submits lookups"| node_lookup_engine
node_api -->|"uses shared base"| node_lookup_engine
node_lookup_engine -->|"tries by priority"| node_providers
node_lookup_engine -->|"normalizes results"| node_normalization
node_user -->|"requests"| node_vehicle
node_user -->|"requests"| node_person
node_user -->|"requests"| node_cnh
node_user -->|"requests"| node_fleet
node_user -->|"requests"| node_owners
node_user -->|"creates account"| node_account
node_user -->|"pays via"| node_pix
node_pix -->|"releases automatically"| node_credits
node_user -->|"reopens lookups"| node_history
node_user -->|"exports reports"| node_pdf

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_telegram,node_api toneBlue
class node_vehicle,node_person,node_cnh,node_fleet,node_owners toneAmber
class node_lookup_engine,node_providers,node_normalization toneMint
class node_account,node_credits,node_history,node_pdf toneRose
class node_user,node_pix toneIndigo
```

## Components

### Access channels

- **Web panel**
- **Telegram bot**
- **REST API**

### Lookup capabilities

- **Vehicle lookup**
- **Person lookup**
- **CNH lookup**
- **Fleet lookup**
- **Owner history**

### Lookup runtime

- **Lookup service**
- **Data providers**
- **Result normalization**

### Account and usage

- **User account**
- **Credits and quotas**
- **Lookup history**
- **PDF export**

### Other components

- **Customer**
- **Pix payment**

## Connections

- Customer → Web panel: uses (evidence: `README.md`)
- Customer → Telegram bot: uses (evidence: `README.md`)
- Customer → REST API: integrates (evidence: `README.md`)
- Web panel → Lookup service: submits lookups (evidence: `README.md`)
- Telegram bot → Lookup service: submits lookups (evidence: `README.md`)
- REST API → Lookup service: uses shared base (evidence: `README.md`)
- Lookup service → Data providers: tries by priority (evidence: `README.md`)
- Lookup service → Result normalization: normalizes results (evidence: `README.md`)
- Customer → Vehicle lookup: requests (evidence: `README.md`)
- Customer → Person lookup: requests (evidence: `README.md`)
- Customer → CNH lookup: requests (evidence: `README.md`)
- Customer → Fleet lookup: requests (evidence: `README.md`)
- Customer → Owner history: requests (evidence: `README.md`)
- Customer → User account: creates account (evidence: `README.md`)
- Customer → Pix payment: pays via (evidence: `README.md`)
- Pix payment → Credits and quotas: releases automatically (evidence: `README.md`)
- Customer → Lookup history: reopens lookups (evidence: `README.md`)
- Customer → PDF export: exports reports (evidence: `README.md`)
