Menthor DB: Banco de Dados Estruturados
=======================================

O processamento de contextos no Menthor DB é **assíncrono**. A API responde imediatamente enquanto o trabalho pesado ocorre em segundo plano.

Fluxo de Processamento
----------------------

1. **Início**: O cliente chama ``/receive_documents_db`` ou ``/create_description_db``.
2. **Resposta Imediata**: Confirmação de entrada na fila.
3. **Processamento**: Validação e análise via LLM.
4. **Notificação (Webhook)**: Envio de POST para a plataforma externa:
   
   .. code-block:: none

      /company-contexts/partners/context/{id_context}/processed

.. important::
   O campo ``status`` na notificação pode ser ``SUCCESS`` ou ``ERROR``. Em caso de erro, o processo deve ser reiniciado manualmente.

Modelos de Ingestão: Criação vs. Recebimento
--------------------------------------------

* **Geração por IA (create_description_db)**: 
  Para tabelas sem documentação. A IA gera as descrições. Maior latência e consumo de recursos.
* **Sincronização Direta (receive_documents_db)**: 
  Para metadados já prontos. Apenas recebe e persiste metadados.