DOCS: Adicionado RoadMAP

Rafael Alves Lopes 2026-06-01 14:27:30 -03:00
parent a560f19486
commit fc5ec1f50b
2 changed files with 49 additions and 6 deletions

14
Home.md

@ -10,8 +10,9 @@ Esta pasta concentra a documentacao de operacao, arquitetura e decisao tecnica d
- [Regras de negocio](./regras-negocio.md) - [Regras de negocio](./regras-negocio.md)
- [ADRs - decisoes tecnicas](./adrs.md) - [ADRs - decisoes tecnicas](./adrs.md)
- [Ambientes](./ambientes.md) - [Ambientes](./ambientes.md)
- [Runbook](./runbook.md) - [Runbook](./runbook.md)
- [Chat WhatsApp](./chat-whatsapp.md) - [Chat WhatsApp](./chat-whatsapp.md)
- [Roadmap](./roadmap.md)
## Leitura por objetivo ## Leitura por objetivo
@ -28,7 +29,8 @@ Para code review:
3. [Regras de negocio](./regras-negocio.md) 3. [Regras de negocio](./regras-negocio.md)
4. [ADRs](./adrs.md) 4. [ADRs](./adrs.md)
Para planejar producao: Para planejar producao:
2. [Deploy e operacao](./deploy.md) 1. [Roadmap](./roadmap.md)
3. [Runbook](./runbook.md) 2. [Deploy e operacao](./deploy.md)
3. [Runbook](./runbook.md)

41
Roadmap.md Normal file

@ -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.