Substituir Alerta Customizado (Froala.js) pelo Componente Padrão (Quill.js) #52
Description
Contexto
Dentro do plugin [Mencionar o nome do plugin, se souber, senão deixar como "o plugin X do Mapa Cultural"], utilizamos um alerta customizado para exibir e/ou editar conteúdo que atualmente depende da biblioteca Froala.js para renderização e edição do texto. A equipe desenvolveu um novo componente de alerta padrão que utiliza o editor de texto Quill.js em conjunto com o SweetAlert2 para padronizar a experiência e reduzir a dependência de licenças/bibliotecas legadas.
Objetivo
Como um Programador (Dev)
Quero substituir o uso atual do Froala.js pelo novo componente de alerta baseado em Quill.js
Para padronizar a experiência do usuário, garantir a manutenção do código e consolidar o uso do Quill.js como editor de texto padrão da plataforma.
Escopo
- Identificar e refatorar o código onde o alerta customizado que usa o Froala.js está sendo inicializado.
- Substituir a inicialização do alerta Froala.js pela chamada ao novo componente de alerta da equipe (baseado em Quill.js e SweetAlert2).
- Adaptar as funções de callback e de manipulação de dados para garantir que o texto inserido/editado pelo Quill.js seja capturado e processado corretamente.
- Garantir que o styling e a funcionalidade básica do alerta (abrir, fechar, salvar/cancelar) permaneçam consistentes com o comportamento original.
Fora de Escopo
- Atualização ou manutenção em outras áreas do plugin que não utilizem o alerta em questão.
- Alterações no código do novo componente de alerta baseado em Quill.js (assumimos que o componente já está funcional e pronto para uso).
- Migração de qualquer outra funcionalidade do Froala.js que não esteja ligada diretamente a esse alerta.
Critérios de Aceitação (Gherkin/Cucumber)
1. Inicialização do Novo Componente
Dado que o usuário aciona a funcionalidade que exibe o alerta (ex: clicar no botão "Editar Observação")
Quando o alerta é chamado no código
Então o novo componente de alerta da equipe, que utiliza o Quill.js, deve ser exibido
E o editor de texto dentro do alerta deve ser renderizado pelo Quill.js e não mais pelo Froala.js.
2. Edição de Conteúdo (Persistência)
Dado que o novo alerta com Quill.js está aberto
E o usuário insere ou edita um texto
Quando o usuário clica em "Salvar" (ou equivalente)
Então a string de texto editada deve ser capturada corretamente pelo callback
E o conteúdo deve ser persistido no sistema como era antes da mudança.
3. Remoção de Dependência Legada
Dado que a implementação da issue foi finalizada
Quando o código do plugin é analisado
Então não deve haver nenhuma referência ou inicialização do Froala.js no contexto do alerta refatorado.
Observações
- Verificar se há alguma diferença de formatação (markup) entre o conteúdo gerado pelo Froala.js e pelo Quill.js que possa afetar a exibição em outras partes do sistema. Se houver, documentar ou criar uma issue separada.
- O componente SweetAlert2 deve continuar sendo o gerenciador do modal/alerta em si.