From fc5ec1f50b1263918872b84c278a865c6f59d548 Mon Sep 17 00:00:00 2001
From: Rafael Lopes <rafael.lopes@sothis.com.br>
Date: Mon, 1 Jun 2026 14:27:30 -0300
Subject: [PATCH] DOCS: Adicionado RoadMAP

---
 Home.md    | 14 ++++++++------
 Roadmap.md | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+), 6 deletions(-)
 create mode 100644 Roadmap.md

diff --git a/Home.md b/Home.md
index 9482b57..e5af773 100644
--- a/Home.md
+++ b/Home.md
@@ -10,8 +10,9 @@ Esta pasta concentra a documentacao de operacao, arquitetura e decisao tecnica d
 - [Regras de negocio](./regras-negocio.md)
 - [ADRs - decisoes tecnicas](./adrs.md)
 - [Ambientes](./ambientes.md)
-- [Runbook](./runbook.md)
-- [Chat WhatsApp](./chat-whatsapp.md)
+- [Runbook](./runbook.md)
+- [Chat WhatsApp](./chat-whatsapp.md)
+- [Roadmap](./roadmap.md)
 
 ## Leitura por objetivo
 
@@ -28,7 +29,8 @@ Para code review:
 3. [Regras de negocio](./regras-negocio.md)
 4. [ADRs](./adrs.md)
 
-Para planejar producao:
-
-2. [Deploy e operacao](./deploy.md)
-3. [Runbook](./runbook.md)
+Para planejar producao:
+
+1. [Roadmap](./roadmap.md)
+2. [Deploy e operacao](./deploy.md)
+3. [Runbook](./runbook.md)
diff --git a/Roadmap.md b/Roadmap.md
new file mode 100644
index 0000000..682468d
--- /dev/null
+++ b/Roadmap.md
@@ -0,0 +1,41 @@
+# Roadmap
+
+Este documento consolida proximos passos tecnicos e de produto para evolucao do Omnichannel Sothis.
+
+## Chat omnichannel e auditoria
+
+- Persistir conversas e mensagens no PostgreSQL para auditoria.
+- Criar uma camada `chat` independente do canal, com conceitos como conversa, mensagem, remetente, direcao e historico.
+- Normalizar eventos de WhatsApp, Email, SMS e Instagram antes de salvar/exibir no frontend.
+- Manter o atendimento humano em `attendance`, separado do canal de origem.
+
+## Anexos e midias
+
+- Evitar armazenar arquivos e imagens em base64 direto no banco.
+- Guardar no PostgreSQL apenas metadados do anexo, como nome, mimetype, tamanho, provedor e chave de storage.
+- Avaliar storage em volume de VM Linux, AWS S3, Azure Blob ou SharePoint.
+- Desenhar a solucao com `storage_provider` e `storage_key` para permitir troca futura de storage.
+
+## WhatsApp
+
+- Reduzir o modulo `whatsapp` para atuar como adaptador tecnico do canal.
+- Substituir gradualmente `whatsapp-web.js` pela API oficial da Meta.
+- Manter compatibilidade temporaria com as rotas atuais enquanto o frontend migra para contratos mais genericos.
+
+## IA no primeiro atendimento
+
+- Adicionar IA no primeiro atendimento do chatbot.
+- Permitir que o admin configure no painel qual provedor/modelo de IA deseja usar.
+- Manter a base de conhecimento e regras de roteamento como contexto para a IA.
+- Registrar decisoes e respostas relevantes para auditoria.
+
+## Arquitetura alvo
+
+```text
+Canal especifico -> ChatModule -> AttendanceModule -> KnowledgeBase/IA
+```
+
+- Canal especifico: WhatsApp, Email, SMS, Instagram.
+- ChatModule: conversa, mensagens, historico e anexos.
+- AttendanceModule: fila, atribuicao, transferencia e encerramento.
+- KnowledgeBase/IA: regras do bot, contexto e primeira resposta automatica.