feat: implement customizable point registration labels and GMT offset adjustment

- Added functionality to customize labels for point registration types (Entrada, Saída, etc.) in the configuration settings. - Introduced a GMT offset adjustment feature to account for time zone differences during point registration. - Updated the backend to ensure default values for custom labels and GMT offset are set correctly. - Enhanced the UI to allow users to input and save personalized names for each type of point registration. - Improved the point registration process to utilize the new configuration settings for displaying labels consistently across the application.
2025-11-19 06:22:07 -03:00
parent f465bd973e
commit 7cdc726781
10 changed files with 311 additions and 93 deletions
--- a/apps/web/src/lib/components/ponto/ComprovantePonto.svelte
+++ b/apps/web/src/lib/components/ponto/ComprovantePonto.svelte
@@ -1,6 +1,5 @@
 <script lang="ts">
-	import { onMount } from 'svelte';
-	import { useConvexClient, useQuery } from 'convex-svelte';
+	import { useQuery } from 'convex-svelte';
 	import { api } from '@sgse-app/backend/convex/_generated/api';
 	import jsPDF from 'jspdf';
 	import { Printer, X } from 'lucide-svelte';
@@ -15,8 +14,8 @@

 	let { registroId, onClose }: Props = $props();

-	const client = useConvexClient();
 	const registroQuery = useQuery(api.pontos.obterRegistro, { registroId });
+	const configQuery = useQuery(api.configuracaoPonto.obterConfiguracao, {});

 	let gerando = $state(false);

@@ -98,7 +97,16 @@
 			yPosition += 8;
 			doc.setFontSize(10);

-			doc.text(`Tipo: ${getTipoRegistroLabel(registro.tipo)}`, 15, yPosition);
+			const config = configQuery?.data;
+			const tipoLabel = config
+				? getTipoRegistroLabel(registro.tipo, {
+						nomeEntrada: config.nomeEntrada,
+						nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+						nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+						nomeSaida: config.nomeSaida,
+					})
+				: getTipoRegistroLabel(registro.tipo);
+			doc.text(`Tipo: ${tipoLabel}`, 15, yPosition);
 			yPosition += 6;

 			const dataHora = formatarDataHoraCompleta(registro.data, registro.hora, registro.minuto, registro.segundo);
@@ -118,30 +126,6 @@
 			);
 			yPosition += 10;

-			// Detalhes de localização removidos do comprovante (serão exibidos apenas no relatório detalhado)
-
-			// Informações do Dispositivo (resumido)
-			if (registro.browser || registro.sistemaOperacional) {
-				doc.setFont('helvetica', 'bold');
-				doc.text('DISPOSITIVO', 15, yPosition);
-				doc.setFont('helvetica', 'normal');
-				yPosition += 8;
-				doc.setFontSize(10);
-
-				if (registro.browser) {
-					doc.text(`Navegador: ${registro.browser}${registro.browserVersion ? ` ${registro.browserVersion}` : ''}`, 15, yPosition);
-					yPosition += 6;
-				}
-				if (registro.sistemaOperacional) {
-					doc.text(`Sistema: ${registro.sistemaOperacional}${registro.osVersion ? ` ${registro.osVersion}` : ''}`, 15, yPosition);
-					yPosition += 6;
-				}
-				if (registro.ipAddress) {
-					doc.text(`IP: ${registro.ipAddress}`, 15, yPosition);
-					yPosition += 6;
-				}
-			}
-
 			// Imagem capturada (se disponível)
 			if (registro.imagemUrl) {
 				yPosition += 10;
@@ -292,9 +276,19 @@

 					<!-- Informações do Registro -->
 					<div class="card bg-base-200">
-						<div class="card-body">
-							<h4 class="font-bold">Dados do Registro</h4>
-							<p><strong>Tipo:</strong> {getTipoRegistroLabel(registro.tipo)}</p>
+					<div class="card-body">
+						<h4 class="font-bold">Dados do Registro</h4>
+						<p>
+							<strong>Tipo:</strong>
+							{configQuery?.data
+								? getTipoRegistroLabel(registro.tipo, {
+										nomeEntrada: configQuery.data.nomeEntrada,
+										nomeSaidaAlmoco: configQuery.data.nomeSaidaAlmoco,
+										nomeRetornoAlmoco: configQuery.data.nomeRetornoAlmoco,
+										nomeSaida: configQuery.data.nomeSaida,
+									})
+								: getTipoRegistroLabel(registro.tipo)}
+						</p>
 							<p>
 								<strong>Data e Hora:</strong>
 								{formatarDataHoraCompleta(registro.data, registro.hora, registro.minuto, registro.segundo)}
--- a/apps/web/src/lib/components/ponto/RegistroPonto.svelte
+++ b/apps/web/src/lib/components/ponto/RegistroPonto.svelte
@@ -37,7 +37,6 @@
 	// Estados
 	let mostrandoWebcam = $state(false);
 	let registrando = $state(false);
-	let erro = $state<string | null>(null);
 	let sucesso = $state<string | null>(null);
 	let registroId = $state<Id<'registrosPonto'> | null>(null);
 	let mostrandoComprovante = $state(false);
@@ -63,6 +62,14 @@
 	});

 	const tipoLabel = $derived.by(() => {
+		if (config) {
+			return getTipoRegistroLabel(proximoTipo, {
+				nomeEntrada: config.nomeEntrada,
+				nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+				nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+				nomeSaida: config.nomeSaida,
+			});
+		}
 		return getTipoRegistroLabel(proximoTipo);
 	});

@@ -153,7 +160,6 @@
 		}

 		registrando = true;
-		erro = null;
 		sucesso = null;
 		coletandoInfo = true;

@@ -189,7 +195,15 @@
 			});

 			registroId = resultado.registroId;
-			sucesso = `Ponto registrado com sucesso! Tipo: ${getTipoRegistroLabel(resultado.tipo)}`;
+			const tipoLabelSucesso = config
+				? getTipoRegistroLabel(resultado.tipo, {
+						nomeEntrada: config.nomeEntrada,
+						nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+						nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+						nomeSaida: config.nomeSaida,
+					})
+				: getTipoRegistroLabel(resultado.tipo);
+			sucesso = `Ponto registrado com sucesso! Tipo: ${tipoLabelSucesso}`;
 			imagemCapturada = null;
 			justificativa = ''; // Limpar justificativa após registro
 			mostrandoModalConfirmacao = false;
@@ -208,7 +222,15 @@
 				mensagemErro.includes('já existe um registro')
 			) {
 				mensagemErroModal = 'Registro de ponto duplicado';
-				detalhesErroModal = `Não é possível registrar o ponto no mesmo minuto.\n\nVocê já possui um registro de ${getTipoRegistroLabel(proximoTipo)} para este minuto.\n\nPor favor, aguarde pelo menos 1 minuto antes de tentar registrar novamente.`;
+				const tipoLabelErro = config
+					? getTipoRegistroLabel(proximoTipo, {
+							nomeEntrada: config.nomeEntrada,
+							nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+							nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+							nomeSaida: config.nomeSaida,
+						})
+					: getTipoRegistroLabel(proximoTipo);
+				detalhesErroModal = `Não é possível registrar o ponto no mesmo minuto.\n\nVocê já possui um registro de ${tipoLabelErro} para este minuto.\n\nPor favor, aguarde pelo menos 1 minuto antes de tentar registrar novamente.`;
 				mostrarModalErro = true;
 			} else {
 				// Outros erros também mostram no modal
@@ -216,8 +238,6 @@
 				detalhesErroModal = mensagemErro;
 				mostrarModalErro = true;
 			}
-			
-			erro = mensagemErro;
 		} finally {
 			registrando = false;
 			coletandoInfo = false;
@@ -309,7 +329,6 @@
 		mostrarModalErro = false;
 		mensagemErroModal = '';
 		detalhesErroModal = '';
-		erro = null;
 	}

 	async function imprimirComprovante(registroId: Id<'registrosPonto'>) {
@@ -322,6 +341,9 @@
 				return;
 			}

+			// Buscar configuração para usar nomes personalizados
+			const configComprovante = await client.query(api.configuracaoPonto.obterConfiguracao, {});
+
 			const doc = new jsPDF();

 			// Logo
@@ -385,7 +407,15 @@
 			yPosition += 8;
 			doc.setFontSize(10);

-			doc.text(`Tipo: ${getTipoRegistroLabel(registro.tipo)}`, 15, yPosition);
+			const tipoLabelComprovante = configComprovante
+				? getTipoRegistroLabel(registro.tipo, {
+						nomeEntrada: configComprovante.nomeEntrada,
+						nomeSaidaAlmoco: configComprovante.nomeSaidaAlmoco,
+						nomeRetornoAlmoco: configComprovante.nomeRetornoAlmoco,
+						nomeSaida: configComprovante.nomeSaida,
+					})
+				: getTipoRegistroLabel(registro.tipo);
+			doc.text(`Tipo: ${tipoLabelComprovante}`, 15, yPosition);
 			yPosition += 6;

 			const dataHora = formatarDataHoraCompleta(registro.data, registro.hora, registro.minuto, registro.segundo);
@@ -578,10 +608,10 @@
 		if (!config) return [];

 		const horarios = [
-			{ tipo: 'entrada', horario: config.horarioEntrada, label: 'Entrada' },
-			{ tipo: 'saida_almoco', horario: config.horarioSaidaAlmoco, label: 'Saída para Almoço' },
-			{ tipo: 'retorno_almoco', horario: config.horarioRetornoAlmoco, label: 'Retorno do Almoço' },
-			{ tipo: 'saida', horario: config.horarioSaida, label: 'Saída' }
+			{ tipo: 'entrada', horario: config.horarioEntrada, label: config.nomeEntrada || 'Entrada 1' },
+			{ tipo: 'saida_almoco', horario: config.horarioSaidaAlmoco, label: config.nomeSaidaAlmoco || 'Saída 1' },
+			{ tipo: 'retorno_almoco', horario: config.horarioRetornoAlmoco, label: config.nomeRetornoAlmoco || 'Entrada 2' },
+			{ tipo: 'saida', horario: config.horarioSaida, label: config.nomeSaida || 'Saída 2' }
 		];

 		return horarios.map((h) => {
@@ -761,7 +791,16 @@
 									<div class="flex items-start justify-between gap-4">
 										<div class="flex-1">
 											<div class="mb-1 flex items-center gap-2">
-												<span class="font-semibold">{getTipoRegistroLabel(registro.tipo)}</span>
+												<span class="font-semibold">
+													{config
+														? getTipoRegistroLabel(registro.tipo, {
+																nomeEntrada: config.nomeEntrada,
+																nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+																nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+																nomeSaida: config.nomeSaida,
+															})
+														: getTipoRegistroLabel(registro.tipo)}
+												</span>
 												{#if registro.dentroDoPrazo}
 													<CheckCircle2 class="h-4 w-4 text-success" />
 												{:else}
--- a/apps/web/src/lib/utils/ponto.ts
+++ b/apps/web/src/lib/utils/ponto.ts
@@ -66,13 +66,34 @@ export function verificarDentroDoPrazo(

 /**
 * Obtém label do tipo de registro
+ * Se config fornecida, usa os nomes personalizados, senão usa os padrões
 */
-export function getTipoRegistroLabel(tipo: 'entrada' | 'saida_almoco' | 'retorno_almoco' | 'saida'): string {
+export function getTipoRegistroLabel(
+	tipo: 'entrada' | 'saida_almoco' | 'retorno_almoco' | 'saida',
+	config?: {
+		nomeEntrada?: string;
+		nomeSaidaAlmoco?: string;
+		nomeRetornoAlmoco?: string;
+		nomeSaida?: string;
+	}
+): string {
+	// Se config fornecida, usar nomes personalizados
+	if (config) {
+		const labels: Record<string, string> = {
+			entrada: config.nomeEntrada || 'Entrada 1',
+			saida_almoco: config.nomeSaidaAlmoco || 'Saída 1',
+			retorno_almoco: config.nomeRetornoAlmoco || 'Entrada 2',
+			saida: config.nomeSaida || 'Saída 2',
+		};
+		return labels[tipo] || tipo;
+	}
+
+	// Valores padrão
 	const labels: Record<string, string> = {
-		entrada: 'Entrada',
-		saida_almoco: 'Saída para Almoço',
-		retorno_almoco: 'Retorno do Almoço',
-		saida: 'Saída',
+		entrada: 'Entrada 1',
+		saida_almoco: 'Saída 1',
+		retorno_almoco: 'Entrada 2',
+		saida: 'Saída 2',
 	};
 	return labels[tipo] || tipo;
 }
--- a/apps/web/src/routes/(dashboard)/recursos-humanos/registro-pontos/+page.svelte
+++ b/apps/web/src/routes/(dashboard)/recursos-humanos/registro-pontos/+page.svelte
@@ -32,10 +32,12 @@
 	const funcionariosQuery = useQuery(api.funcionarios.getAll, {});
 	const registrosQuery = useQuery(api.pontos.listarRegistrosPeriodo, registrosParams);
 	const estatisticasQuery = useQuery(api.pontos.obterEstatisticas, estatisticasParams);
+	const configQuery = useQuery(api.configuracaoPonto.obterConfiguracao, {});

 	const funcionarios = $derived(funcionariosQuery?.data || []);
 	const registros = $derived(registrosQuery?.data || []);
 	const estatisticas = $derived(estatisticasQuery?.data);
+	const config = $derived(configQuery?.data);

 	// Agrupar registros por funcionário e data
 	const registrosAgrupados = $derived.by(() => {
@@ -146,9 +148,17 @@
 			yPosition += 10;

 			// Tabela de registros
+			const config = await client.query(api.configuracaoPonto.obterConfiguracao, {});
 			const tableData = registrosFuncionario.map((r) => [
 				r.data,
-				getTipoRegistroLabel(r.tipo),
+				config
+					? getTipoRegistroLabel(r.tipo, {
+							nomeEntrada: config.nomeEntrada,
+							nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+							nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+							nomeSaida: config.nomeSaida,
+						})
+					: getTipoRegistroLabel(r.tipo),
 				formatarHoraPonto(r.hora, r.minuto),
 				r.dentroDoPrazo ? 'Sim' : 'Não',
 			]);
@@ -258,7 +268,16 @@
 			yPosition += 8;
 			doc.setFontSize(10);

-			doc.text(`Tipo: ${getTipoRegistroLabel(registro.tipo)}`, 15, yPosition);
+			const config = await client.query(api.configuracaoPonto.obterConfiguracao, {});
+			const tipoLabel = config
+				? getTipoRegistroLabel(registro.tipo, {
+						nomeEntrada: config.nomeEntrada,
+						nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+						nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+						nomeSaida: config.nomeSaida,
+					})
+				: getTipoRegistroLabel(registro.tipo);
+			doc.text(`Tipo: ${tipoLabel}`, 15, yPosition);
 			yPosition += 6;

 			const dataHora = `${registro.data} ${registro.hora.toString().padStart(2, '0')}:${registro.minuto.toString().padStart(2, '0')}:${registro.segundo.toString().padStart(2, '0')}`;
@@ -784,7 +803,16 @@
 											{#each grupo.registros as registro}
 												<tr>
 													<td>{registro.data}</td>
-													<td>{getTipoRegistroLabel(registro.tipo)}</td>
+													<td>
+														{config
+															? getTipoRegistroLabel(registro.tipo, {
+																	nomeEntrada: config.nomeEntrada,
+																	nomeSaidaAlmoco: config.nomeSaidaAlmoco,
+																	nomeRetornoAlmoco: config.nomeRetornoAlmoco,
+																	nomeSaida: config.nomeSaida,
+																})
+															: getTipoRegistroLabel(registro.tipo)}
+													</td>
 													<td>{formatarHoraPonto(registro.hora, registro.minuto)}</td>
 													<td>
 														<span
--- a/apps/web/src/routes/(dashboard)/ti/configuracoes-ponto/+page.svelte
+++ b/apps/web/src/routes/(dashboard)/ti/configuracoes-ponto/+page.svelte
@@ -11,6 +11,10 @@
 	let horarioRetornoAlmoco = $state('13:00');
 	let horarioSaida = $state('17:00');
 	let toleranciaMinutos = $state(15);
+	let nomeEntrada = $state('Entrada 1');
+	let nomeSaidaAlmoco = $state('Saída 1');
+	let nomeRetornoAlmoco = $state('Entrada 2');
+	let nomeSaida = $state('Saída 2');
 	let processando = $state(false);
 	let mensagem = $state<{ tipo: 'success' | 'error'; texto: string } | null>(null);

@@ -21,6 +25,10 @@
 			horarioRetornoAlmoco = configQuery.data.horarioRetornoAlmoco;
 			horarioSaida = configQuery.data.horarioSaida;
 			toleranciaMinutos = configQuery.data.toleranciaMinutos;
+			nomeEntrada = configQuery.data.nomeEntrada || 'Entrada 1';
+			nomeSaidaAlmoco = configQuery.data.nomeSaidaAlmoco || 'Saída 1';
+			nomeRetornoAlmoco = configQuery.data.nomeRetornoAlmoco || 'Entrada 2';
+			nomeSaida = configQuery.data.nomeSaida || 'Saída 2';
 		}
 	});

@@ -43,6 +51,12 @@
 			return;
 		}

+		// Validação dos nomes
+		if (!nomeEntrada.trim() || !nomeSaidaAlmoco.trim() || !nomeRetornoAlmoco.trim() || !nomeSaida.trim()) {
+			mostrarMensagem('error', 'Preencha todos os nomes dos registros');
+			return;
+		}
+
 		processando = true;
 		try {
 			await client.mutation(api.configuracaoPonto.salvarConfiguracao, {
@@ -51,6 +65,10 @@
 				horarioRetornoAlmoco,
 				horarioSaida,
 				toleranciaMinutos,
+				nomeEntrada: nomeEntrada.trim(),
+				nomeSaidaAlmoco: nomeSaidaAlmoco.trim(),
+				nomeRetornoAlmoco: nomeRetornoAlmoco.trim(),
+				nomeSaida: nomeSaida.trim(),
 			});

 			mostrarMensagem('success', 'Configuração salva com sucesso!');
@@ -170,6 +188,84 @@
 				</div>
 			</div>

+			<div class="divider"></div>
+
+			<!-- Nomes Personalizados dos Registros -->
+			<h2 class="card-title mb-4">Nomes dos Registros</h2>
+			<p class="text-sm text-base-content/70 mb-4">
+				Personalize os nomes exibidos para cada tipo de registro de ponto
+			</p>
+
+			<div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+				<!-- Nome Entrada -->
+				<div class="form-control">
+					<label class="label" for="nome-entrada">
+						<span class="label-text font-medium">Nome do Registro de Entrada *</span>
+					</label>
+					<input
+						id="nome-entrada"
+						type="text"
+						bind:value={nomeEntrada}
+						placeholder="Ex: Entrada 1"
+						class="input input-bordered"
+					/>
+					<div class="label">
+						<span class="label-text-alt">Nome exibido para o primeiro registro do dia</span>
+					</div>
+				</div>
+
+				<!-- Nome Saída Almoço -->
+				<div class="form-control">
+					<label class="label" for="nome-saida-almoco">
+						<span class="label-text font-medium">Nome do Registro de Saída para Almoço *</span>
+					</label>
+					<input
+						id="nome-saida-almoco"
+						type="text"
+						bind:value={nomeSaidaAlmoco}
+						placeholder="Ex: Saída 1"
+						class="input input-bordered"
+					/>
+					<div class="label">
+						<span class="label-text-alt">Nome exibido para a saída para almoço</span>
+					</div>
+				</div>
+
+				<!-- Nome Retorno Almoço -->
+				<div class="form-control">
+					<label class="label" for="nome-retorno-almoco">
+						<span class="label-text font-medium">Nome do Registro de Retorno do Almoço *</span>
+					</label>
+					<input
+						id="nome-retorno-almoco"
+						type="text"
+						bind:value={nomeRetornoAlmoco}
+						placeholder="Ex: Entrada 2"
+						class="input input-bordered"
+					/>
+					<div class="label">
+						<span class="label-text-alt">Nome exibido para o retorno do almoço</span>
+					</div>
+				</div>
+
+				<!-- Nome Saída -->
+				<div class="form-control">
+					<label class="label" for="nome-saida">
+						<span class="label-text font-medium">Nome do Registro de Saída *</span>
+					</label>
+					<input
+						id="nome-saida"
+						type="text"
+						bind:value={nomeSaida}
+						placeholder="Ex: Saída 2"
+						class="input input-bordered"
+					/>
+					<div class="label">
+						<span class="label-text-alt">Nome exibido para a saída final do dia</span>
+					</div>
+				</div>
+			</div>
+
 			<!-- Ações -->
 			<div class="card-actions justify-end mt-6">
 				<button
--- a/apps/web/src/routes/(dashboard)/ti/configuracoes-relogio/+page.svelte
+++ b/apps/web/src/routes/(dashboard)/ti/configuracoes-relogio/+page.svelte
@@ -10,6 +10,7 @@
 	let portaNTP = $state(123);
 	let usarServidorExterno = $state(false);
 	let fallbackParaPC = $state(true);
+	let gmtOffset = $state(0);
 	let processando = $state(false);
 	let testando = $state(false);
 	let mensagem = $state<{ tipo: 'success' | 'error'; texto: string } | null>(null);
@@ -20,6 +21,7 @@
 			portaNTP = configQuery.data.portaNTP || 123;
 			usarServidorExterno = configQuery.data.usarServidorExterno || false;
 			fallbackParaPC = configQuery.data.fallbackParaPC !== undefined ? configQuery.data.fallbackParaPC : true;
+			gmtOffset = configQuery.data.gmtOffset ?? 0;
 		}
 	});

@@ -49,6 +51,7 @@
 				portaNTP: usarServidorExterno ? portaNTP : undefined,
 				usarServidorExterno,
 				fallbackParaPC,
+				gmtOffset,
 			});

 			mostrarMensagem('success', 'Configuração salva com sucesso!');
@@ -194,6 +197,35 @@
 				</div>
 			</div>

+			<div class="divider"></div>
+
+			<!-- Ajuste de Fuso Horário (GMT) -->
+			<h2 class="card-title mb-4">Ajuste de Fuso Horário (GMT)</h2>
+			<p class="text-sm text-base-content/70 mb-4">
+				Configure o fuso horário para ajustar o horário de registro. Use valores negativos para fusos a oeste de UTC e positivos para fusos a leste.
+			</p>
+			<div class="form-control">
+				<label class="label" for="gmt-offset">
+					<span class="label-text font-medium">GMT Offset (horas) *</span>
+				</label>
+				<select
+					id="gmt-offset"
+					bind:value={gmtOffset}
+					class="select select-bordered"
+				>
+					{#each Array.from({ length: 49 }, (_, i) => i - 12) as offset}
+						<option value={offset} selected={gmtOffset === offset}>
+							GMT{offset >= 0 ? '+' : ''}{offset}{offset === -3 ? ' (Brasil - Brasília)' : offset === 0 ? ' (UTC)' : ''}
+						</option>
+					{/each}
+				</select>
+				<div class="label">
+					<span class="label-text-alt"
+						>Ajuste em horas em relação ao UTC. Exemplo: -3 para horário de Brasília (GMT-3)</span
+					>
+				</div>
+			</div>
+
 			<!-- Ações -->
 			<div class="card-actions justify-end mt-6 gap-3">
 				{#if usarServidorExterno}