> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/infraestrutura-instalacao-e-requisitos/visao-geral-and-descritivo-tecnico-da-ferramenta.md).

# Visão geral & descritivo técnico da ferramenta

Este documento apresenta a arquitetura estrutural e os principais componentes que compõem o ecossistema do Weknow, fornecendo uma visão geral da comunicação entre seus serviços e do fluxo de dados na plataforma.

Antes de iniciar a instalação do ambiente, é importante compreender como esses componentes se integram, quais são suas responsabilidades e como ocorre a comunicação entre os servidores e as interfaces utilizadas pelos usuários.

O Weknow foi desenvolvido com uma arquitetura distribuída, que promove o isolamento dos serviços, maior segurança no acesso às informações e alto desempenho no processamento de consultas analíticas.

### 🧩 A Topologia do ecossistema Weknow

A arquitetura do Weknow é composta por três camadas independentes e integradas. Cada uma delas possui uma função específica e deve ser considerada durante o planejamento da infraestrutura.

#### Camada de dados

Responsável pelo armazenamento das informações utilizadas pelo sistema.

Durante a implantação do ambiente, o Weknow utiliza diferentes tecnologias de armazenamento, cada uma destinada a uma finalidade específica:

* **PostgreSQL:** armazena as informações de configuração, parametrização, licenciamento e demais dados administrativos da plataforma.

  **DuckDB:** banco de dados analítico embarcado utilizado como padrão para o armazenamento offline dos metadados. Sua arquitetura leve proporciona alto desempenho em consultas locais, reduz a complexidade de administração do ambiente e melhora o processamento analítico.

  **MonetDB:** permanece disponível como alternativa ao DuckDB, principalmente para ambientes já existentes ou cenários específicos que utilizem essa tecnologia para armazenamento offline dos metadados.

#### Camada de processamento

Representada pelo **Weknow Server**, responsável por centralizar toda a lógica de funcionamento da plataforma.

Entre suas responsabilidades estão:

* validação das licenças;
* gerenciamento das credenciais;
* execução das regras de negócio;
* processamento das consultas;
* execução do **Weknow Task Manager**, responsável pelos agendamentos, cargas de dados (ETL) e disparo de alertas.

#### Camada de aplicação

Corresponde às interfaces utilizadas pelos administradores e usuários finais.

Essa camada é composta por:

* **Weknow Client:** utilizado para criação, edição e manutenção dos dashboards.
* **Weknow Web:** ambiente de acesso aos dashboards por meio do navegador, publicado através do servidor Apache.

### 🔄 Fluxo de comunicação

O fluxo abaixo representa, de forma simplificada, como ocorre a comunicação entre os componentes do ecossistema Weknow.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2F7x7KVIDO7YWTVvnBwAgn%2Fimage.png?alt=media&amp;token=88a853ff-8941-4492-9394-d2706a93696e" alt=""><figcaption></figcaption></figure>

{% hint style="warning" icon="lock-keyhole" %}
As estações de trabalho e o portal Web **não estabelecem conexão direta** com o banco de dados de produção da instituição (MV, Tasy ou outros sistemas). Toda comunicação é autenticada e processada exclusivamente pelo **Weknow Server**, garantindo maior segurança e preservando a integridade dos sistemas de origem.
{% endhint %}

### 🗺️ Próximos Passos

Compreendida a arquitetura geral da plataforma, prossiga para os artigos que detalham os requisitos necessários para implantação do ambiente:

* [Broken mention](broken://pages/r56ju6mYvGad4ezdprep)
* [Broken mention](broken://pages/eIiEx102KY1N3UxRGGBf)&#x20;
* [Broken mention](broken://pages/G57aFYMaNMtYRi58Gh5b)