Refactoring de código spaghetti

Toma este método largo y aplica refactoring: extrae métodos pequeños, renombra variables confusas, elimina código duplicado, aplica DRY, reduce complejidad ciclomática y mejora nombres de funciones.