From 1f48247493578035072acb8a2fe3676669184bba Mon Sep 17 00:00:00 2001
From: deyvisonwanderley <deyvison.wanderley@gmail.com>
Date: Fri, 21 Nov 2025 17:11:40 -0300
Subject: [PATCH] feat: enhance ErrorModal and ChatWindow error handling

- Added HelpCircle icon to ErrorModal for improved visual feedback.
- Implemented logic to differentiate between instructions and technical details in ErrorModal.
- Updated ChatWindow to utilize traduzirErro for user-friendly error messages during call initiation.
- Enhanced error handling to provide clearer instructions and details based on error types.
---
 apps/web/src/lib/components/ErrorModal.svelte |  52 +++++--
 .../src/lib/components/chat/ChatWindow.svelte |  38 +++---
 apps/web/src/lib/utils/erroHelpers.ts         | 129 ++++++++++++++++++
 3 files changed, 191 insertions(+), 28 deletions(-)
 create mode 100644 apps/web/src/lib/utils/erroHelpers.ts

diff --git a/apps/web/src/lib/components/ErrorModal.svelte b/apps/web/src/lib/components/ErrorModal.svelte
index 5ccc653..c7de436 100644
--- a/apps/web/src/lib/components/ErrorModal.svelte
+++ b/apps/web/src/lib/components/ErrorModal.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { AlertCircle, X } from 'lucide-svelte';
+	import { AlertCircle, X, HelpCircle } from 'lucide-svelte';
 
 	interface Props {
 		open: boolean;
@@ -10,6 +10,18 @@
 	}
 
 	let { open = $bindable(false), title = 'Erro', message, details, onClose }: Props = $props();
+	
+	// Verificar se details contém instruções ou apenas detalhes técnicos
+	const temInstrucoes = $derived.by(() => {
+		if (!details) return false;
+		// Se contém palavras-chave de instruções, é uma instrução
+		return details.includes('Por favor') || 
+		       details.includes('aguarde') || 
+		       details.includes('recarregue') ||
+		       details.includes('Verifique') ||
+		       details.includes('tente novamente') ||
+		       details.match(/^\d+\./); // Começa com número (lista numerada)
+	});
 
 	let modalRef: HTMLDialogElement;
 
@@ -37,12 +49,12 @@
 			<!-- Header -->
 			<div class="border-base-300 flex items-center justify-between border-b px-6 py-4">
 				<h2 id="modal-title" class="text-error flex items-center gap-2 text-xl font-bold">
-					<AlertCircle class="h-5 w-5" strokeWidth={2} />
+					<AlertCircle class="h-6 w-6" strokeWidth={2.5} />
 					{title}
 				</h2>
 				<button
 					type="button"
-					class="btn btn-sm btn-circle"
+					class="btn btn-sm btn-circle btn-ghost"
 					onclick={handleClose}
 					aria-label="Fechar"
 				>
@@ -52,17 +64,41 @@
 
 			<!-- Content -->
 			<div class="px-6 py-6">
-				<p class="text-base-content mb-4">{message}</p>
+				<!-- Mensagem principal -->
+				<div class="mb-6">
+					<p class="text-base-content text-base leading-relaxed font-medium">{message}</p>
+				</div>
+
+				<!-- Instruções ou detalhes (se houver) -->
 				{#if details}
-					<div class="bg-base-200 mb-4 rounded-lg p-4">
-						<p class="text-base-content/70 text-sm whitespace-pre-line">{details}</p>
+					<div class="bg-info/10 border-info/30 mb-4 rounded-lg border-l-4 p-4">
+						<div class="flex items-start gap-3">
+							<HelpCircle class="text-info h-5 w-5 shrink-0 mt-0.5" strokeWidth={2} />
+							<div class="flex-1">
+								<p class="text-base-content/90 text-sm font-semibold mb-2">
+									{temInstrucoes ? 'Como resolver:' : 'Informação adicional:'}
+								</p>
+								<div class="text-base-content/80 text-sm space-y-2">
+									{#each details.split('\n').filter(line => line.trim().length > 0) as linha (linha)}
+										{#if linha.trim().match(/^\d+\./)}
+											<div class="flex items-start gap-2">
+												<span class="text-info font-semibold shrink-0">{linha.trim().split('.')[0]}.</span>
+												<span class="flex-1 leading-relaxed">{linha.trim().substring(linha.trim().indexOf('.') + 1).trim()}</span>
+											</div>
+										{:else}
+											<p class="leading-relaxed">{linha.trim()}</p>
+										{/if}
+									{/each}
+								</div>
+							</div>
+						</div>
 					</div>
 				{/if}
 			</div>
 
 			<!-- Footer -->
-			<div class="modal-action px-6 pb-6">
-				<button class="btn btn-primary" onclick={handleClose}> Fechar </button>
+			<div class="modal-action border-base-300 border-t px-6 pb-6 pt-4">
+				<button class="btn btn-primary btn-md" onclick={handleClose}> Entendi, obrigado </button>
 			</div>
 		</div>
 
diff --git a/apps/web/src/lib/components/chat/ChatWindow.svelte b/apps/web/src/lib/components/chat/ChatWindow.svelte
index 0308121..304e8b5 100644
--- a/apps/web/src/lib/components/chat/ChatWindow.svelte
+++ b/apps/web/src/lib/components/chat/ChatWindow.svelte
@@ -13,6 +13,7 @@
 	import ErrorModal from '../ErrorModal.svelte';
 	import { getAvatarUrl } from '$lib/utils/avatarGenerator';
 	import { browser } from '$app/environment';
+	import { traduzirErro } from '$lib/utils/erroHelpers';
 	import {
 		Bell,
 		X,
@@ -47,6 +48,7 @@
 	let showErrorModal = $state(false);
 	let errorTitle = $state('Erro');
 	let errorMessage = $state('');
+	let errorInstructions = $state<string | undefined>(undefined);
 	let errorDetails = $state<string | undefined>(undefined);
 
 	const chamadaAtivaQuery = useQuery(api.chamadas.obterChamadaAtiva, {
@@ -146,8 +148,9 @@
 	// Funções para chamadas
 	async function iniciarChamada(tipo: 'audio' | 'video'): Promise<void> {
 		if (chamadaAtual) {
-			errorTitle = 'Chamada Ativa';
-			errorMessage = 'Já existe uma chamada ativa nesta conversa';
+			errorTitle = 'Chamada já em andamento';
+			errorMessage = 'Já existe uma chamada ativa nesta conversa. Você precisa finalizar a chamada atual antes de iniciar uma nova.';
+			errorInstructions = 'Finalize a chamada atual e tente novamente.';
 			errorDetails = undefined;
 			showErrorModal = true;
 			return;
@@ -166,23 +169,17 @@
 		} catch (error) {
 			console.error('Erro ao iniciar chamada:', error);
 			
-			// Tratar diferentes tipos de erro
-			if (error instanceof Error) {
-				errorTitle = 'Erro ao Iniciar Chamada';
-				
-				// Verificar se é erro do Convex sobre função não encontrada
-				if (error.message.includes('Could not find public function')) {
-					errorMessage = 'O servidor de chamadas não está sincronizado. Por favor, aguarde alguns segundos e tente novamente.';
-					errorDetails = `Erro técnico: ${error.message}\n\nSugestão: Verifique se o backend Convex está rodando corretamente.`;
-				} else {
-					errorMessage = error.message || 'Erro ao iniciar chamada';
-					errorDetails = error.stack;
-				}
-			} else {
-				errorTitle = 'Erro ao Iniciar Chamada';
-				errorMessage = 'Ocorreu um erro desconhecido ao iniciar a chamada. Por favor, tente novamente.';
-				errorDetails = String(error);
-			}
+			// Traduzir erro técnico para mensagem amigável
+			const erroTraduzido = traduzirErro(error);
+			
+			errorTitle = erroTraduzido.titulo;
+			errorMessage = erroTraduzido.mensagem;
+			errorInstructions = erroTraduzido.instrucoes;
+			
+			// Apenas mostrar detalhes técnicos se solicitado e disponível
+			errorDetails = erroTraduzido.mostrarDetalhesTecnicos && erroTraduzido.detalhesTecnicos
+				? erroTraduzido.detalhesTecnicos
+				: undefined;
 			
 			showErrorModal = true;
 		} finally {
@@ -193,6 +190,7 @@
 	function fecharErrorModal(): void {
 		showErrorModal = false;
 		errorMessage = '';
+		errorInstructions = undefined;
 		errorDetails = undefined;
 	}
 
@@ -632,6 +630,6 @@
 	open={showErrorModal}
 	title={errorTitle}
 	message={errorMessage}
-	details={errorDetails}
+	details={errorInstructions || errorDetails}
 	onClose={fecharErrorModal}
 />
diff --git a/apps/web/src/lib/utils/erroHelpers.ts b/apps/web/src/lib/utils/erroHelpers.ts
new file mode 100644
index 0000000..c954be1
--- /dev/null
+++ b/apps/web/src/lib/utils/erroHelpers.ts
@@ -0,0 +1,129 @@
+/**
+ * Utilitários para tratar e traduzir erros técnicos em mensagens amigáveis ao usuário
+ */
+
+export interface MensagemErro {
+	titulo: string;
+	mensagem: string;
+	instrucoes?: string;
+	mostrarDetalhesTecnicos?: boolean;
+	detalhesTecnicos?: string;
+}
+
+/**
+ * Traduzir erros técnicos para mensagens amigáveis ao usuário
+ */
+export function traduzirErro(error: unknown): MensagemErro {
+	if (!(error instanceof Error)) {
+		return {
+			titulo: 'Erro inesperado',
+			mensagem: 'Ocorreu um erro inesperado. Por favor, tente novamente em alguns instantes.',
+			instrucoes: 'Se o problema persistir, entre em contato com o suporte técnico.',
+			detalhesTecnicos: String(error)
+		};
+	}
+
+	const mensagemErro = error.message.toLowerCase();
+	const erroCompleto = error.message;
+
+	// Erro: Função do Convex não encontrada (servidor não sincronizado)
+	if (mensagemErro.includes('could not find public function')) {
+		return {
+			titulo: 'Servidor em atualização',
+			mensagem: 'O sistema está sendo atualizado no momento. Isso geralmente leva apenas alguns segundos.',
+			instrucoes: 'Por favor, aguarde de 10 a 30 segundos e tente iniciar a chamada novamente. Se o problema persistir, recarregue a página (F5).',
+			mostrarDetalhesTecnicos: false
+		};
+	}
+
+	// Erro: Não autenticado
+	if (mensagemErro.includes('não autenticado') || mensagemErro.includes('não autenticado')) {
+		return {
+			titulo: 'Sessão expirada',
+			mensagem: 'Sua sessão expirou. É necessário fazer login novamente para continuar.',
+			instrucoes: 'Você será redirecionado para a tela de login em alguns instantes.',
+			mostrarDetalhesTecnicos: false
+		};
+	}
+
+	// Erro: Permissão negada
+	if (
+		mensagemErro.includes('permissão') ||
+		mensagemErro.includes('não tem permissão') ||
+		mensagemErro.includes('não participa')
+	) {
+		return {
+			titulo: 'Acesso negado',
+			mensagem: 'Você não tem permissão para realizar esta ação.',
+			instrucoes: 'Verifique se você faz parte desta conversa ou se possui as permissões necessárias.',
+			mostrarDetalhesTecnicos: false
+		};
+	}
+
+	// Erro: Recurso já existe
+	if (
+		mensagemErro.includes('já existe') ||
+		mensagemErro.includes('já está') ||
+		mensagemErro.includes('ativo')
+	) {
+		return {
+			titulo: 'Ação não disponível',
+			mensagem: erroCompleto,
+			instrucoes: 'Verifique o status atual e tente novamente.',
+			mostrarDetalhesTecnicos: false
+		};
+	}
+
+	// Erro: Conexão
+	if (
+		mensagemErro.includes('connection') ||
+		mensagemErro.includes('network') ||
+		mensagemErro.includes('conexão') ||
+		mensagemErro.includes('timeout')
+	) {
+		return {
+			titulo: 'Problema de conexão',
+			mensagem: 'Não foi possível conectar com o servidor. Verifique sua conexão com a internet.',
+			instrucoes: 'Verifique se você está conectado à internet e tente novamente. Se o problema persistir, recarregue a página (F5).',
+			mostrarDetalhesTecnicos: false
+		};
+	}
+
+	// Erro: Não encontrado
+	if (mensagemErro.includes('não encontrado') || mensagemErro.includes('not found')) {
+		return {
+			titulo: 'Recurso não encontrado',
+			mensagem: 'O item que você está tentando acessar não foi encontrado.',
+			instrucoes: 'Verifique se o item ainda existe ou se foi removido. Recarregue a página (F5) para atualizar a lista.',
+			mostrarDetalhesTecnicos: false
+		};
+	}
+
+	// Erro genérico com mensagem do sistema
+	if (erroCompleto && erroCompleto.length < 200) {
+		// Se a mensagem for curta e compreensível, usá-la diretamente
+		const mensagemLimpa = erroCompleto
+			.replace(/\[.*?\]/g, '') // Remove tags como [CONVEX M(...)]
+			.replace(/Request ID:.*/i, '') // Remove Request IDs
+			.trim();
+
+		if (mensagemLimpa.length > 0) {
+			return {
+				titulo: 'Erro ao processar ação',
+				mensagem: mensagemLimpa,
+				instrucoes: 'Por favor, tente novamente. Se o problema persistir, recarregue a página (F5) ou entre em contato com o suporte.',
+				mostrarDetalhesTecnicos: false
+			};
+		}
+	}
+
+	// Erro genérico desconhecido
+	return {
+		titulo: 'Erro ao processar ação',
+		mensagem: 'Ocorreu um erro ao processar sua solicitação. Por favor, tente novamente.',
+		instrucoes: 'Se o problema persistir:\n1. Recarregue a página (pressione F5)\n2. Aguarde alguns instantes e tente novamente\n3. Entre em contato com o suporte técnico se o erro continuar',
+		mostrarDetalhesTecnicos: true,
+		detalhesTecnicos: erroCompleto
+	};
+}
+