WebSVN – LeadersLinked - Backend – Diff – /module/LeadersLinked/src/Controller/MicrolearningReportsController.php

             ]);
+        }
+    }
+    /**
+     * Acción para mostrar el progreso de microlearning de un estudiante específico por tópicos
+     *
+     * Este método muestra el progreso del estudiante agrupado por tópicos, donde cada tópico
+     * contiene múltiples cápsulas. Se calcula el progreso agregado por tópico basado en
+     * las cápsulas completadas vs. el total de cápsulas asignadas.
+     *
+     * Este método maneja dos tipos de respuesta:
+     * - Respuesta JSON: Retorna datos del progreso por tópico en formato JSON para AJAX
+     * - Respuesta HTML: Retorna la vista del formulario de reporte de estudiante
+     *
      * @return JsonModel|ViewModel Respuesta en formato JSON o vista HTML
      */
+    public function progressForStudentAction()
     public function progressForStudentAction()
         // Obtener información del usuario actual y su empresa
         $currentUserPlugin = $this->plugin('currentUserPlugin');
         $currentUser = $currentUserPlugin->getUser();
+        $currentCompany = $currentUserPlugin->getCompany();
         $currentCompany = $currentUserPlugin->getCompany();
         $request = $this->getRequest();
-        $request = $this->getRequest();
         // Solo procesar peticiones GET
+        if($request->isGet())
         if($request->isGet())
             // Obtener headers de la petición para determinar el tipo de respuesta
             $headers  = $request->getHeaders();
-            $headers  = $request->getHeaders();
+            // Verificar si la petición espera una respuesta JSON
             $isJson = false;
             if($headers->has('Accept')) {
+                $accept = $headers->get('Accept');
-                $accept = $headers->get('Accept');
+                $prioritized = $accept->getPrioritized();
-                $prioritized = $accept->getPrioritized();
+                // Iterar sobre los tipos de contenido aceptados
                 foreach($prioritized as $key => $value) {
                     $raw = trim($value->getRaw());
-                    if(!$isJson) {
+                    // Verificar si se solicita JSON
-                        $isJson = strpos($raw, 'json');
+                    if(!$isJson) {
                         $isJson = strpos($raw, 'json');
+                    }
+                }
-                }
+            }
             // Procesamiento para respuesta JSON (peticiones AJAX)
             if($isJson) {
+                // Verificar permisos ACL para descarga de Excel
-            if($isJson) {
+                $acl = $this->getEvent()->getViewModel()->getVariable('acl');
                 $allowDownload = $acl->isAllowed($currentUser->usertype_id, 'microlearning/reports/progress-for-student/excel');
                 $acl = $this->getEvent()->getViewModel()->getVariable('acl');
-                $allowDownload = $acl->isAllowed($currentUser->usertype_id, 'microlearning/reports/progress-for-student/excel');
+                // Obtener y sanitizar el UUID del estudiante desde query parameters
                 $student_uuid = Functions::sanitizeFilterString($this->params()->fromQuery('student_uuid'));
                 $student_uuid     = Functions::sanitizeFilterString($this->params()->fromQuery('student_uuid'));
+                // Buscar el usuario por UUID y red
                 $userMapper = UserMapper::getInstance($this->adapter);
                 $user = $userMapper->fetchOneByUuidAndNetworkId($student_uuid, $currentUser->network_id);
                 // Validar que el usuario existe
                 if(!$user) {
                     return new JsonModel([
                         'success' => false,
                         'data' => 'ERROR_USER_NOT_FOUND'
                     ]);
-                }
+                }
                 // Verificar que el usuario tiene acceso a cápsulas de microlearning de la empresa
                 $microlearningCapsuleUserMapper = MicrolearningCapsuleUserMapper::getInstance($this->adapter);
-                $count = $microlearningCapsuleUserMapper->fetchCountByCompanyIdAndUserId($currentCompany->id, $user->id);
+                $count = $microlearningCapsuleUserMapper->fetchCountByCompanyIdAndUserId($currentCompany->id, $user->id);
                 // Si no tiene acceso, retornar error de autorización
                 if(!$count) {
                     return new JsonModel([
                         'success' => false,
+                        'data' => 'ERROR_UNAUTHORIZED'
-                        'data' => 'ERROR_UNAUTHORIZED'
+                    ]);
-                    ]);
+                }
+                // Inicializar estructura de datos de respuesta
+                $data = [
+                    'items' => [],
-                $data = [
+                ];
                     'items' => [],
-                ];
+                // Primera consulta: Obtener todos los tópicos asignados al usuario
                 $queryMapper = QueryMapper::getInstance($this->adapter);
+                $sql = $queryMapper->getSql();
-                $queryMapper = QueryMapper::getInstance($this->adapter);
+                $select = $sql->select();
-                $sql = $queryMapper->getSql();
+                $select->columns(['topic_id', 'access', 'paid_from', 'paid_to' ]);
-                $select = $sql->select();
+                $select->from(['tb1' => MicrolearningTopicUserMapper::_TABLE] );
-                $select->columns(['capsule_id', 'access', 'paid_from', 'paid_to' ]);
+                // Join con tabla de tópicos para obtener el nombre del tópico
-                $select->from(['tb1' => MicrolearningCapsuleUserMapper::_TABLE] );
+                $select->join(['tb2' => MicrolearningTopicMapper::_TABLE], 'tb1.company_id = tb2.company_id AND tb1.topic_id = tb2.id', ['topic' => 'name']);
-                $select->join(['tb2' => MicrolearningTopicMapper::_TABLE], 'tb1.company_id = tb2.company_id AND tb1.topic_id = tb2.id', ['topic' => 'name']);
+                $select->where->equalTo('tb1.company_id', $currentCompany->id);
-                $select->join(['tb3' => MicrolearningCapsuleMapper::_TABLE], 'tb1.company_id = tb3.company_id AND tb1.topic_id = tb3.topic_id AND tb1.capsule_id = tb3.id', ['capsule' => 'name']);
+                $select->where->equalTo('tb1.user_id', $user->id);
-                $select->where->equalTo('tb1.company_id', $currentCompany->id);
+                $select->group('tb1.topic_id'); // Agrupar por tópico para evitar duplicados
-                $select->where->equalTo('tb1.user_id', $user->id);
+                $select->order('tb2.name ASC');
-                $select->order('tb2.name ASC, tb3.name ASC');
+                // Construir array inicial de items con valores por defecto (agrupado por tópico)
                 $items = [];
                 $records = $queryMapper->fetchAll($select);
-                foreach($records as $record)
-                {
-                    $capsule_id = $record['capsule_id'];
+                foreach($records as $record)
+                {
+                    $topic_id = $record['topic_id'];
+                    // Estructura base de cada tópico con estadísticas de cápsulas
                     $item = [
+                        'topic' => ucwords(strtolower($record['topic'])),
+                        'progress' => 0, // Porcentaje de progreso del tópico
-                        'topic' => ucwords(strtolower($record['topic'])),
+                        'total_capsules' => 0, // Total de cápsulas asignadas en el tópico
-                        'capsule' => ucwords(strtolower($record['capsule'])),
+                        'completed_capsules' => 0, // Cápsulas completadas
-                        'progress' => 0,
+                        'started_capsules' => 0, // Cápsulas iniciadas pero no completadas
+                        'pending_capsules' => 0, // Cápsulas sin iniciar
+                        'added_on' => '', // Fecha de inicio del primer progreso
-                        'total_slides' => 0,
-                        'view_slides' => 0,
-                        'completed' => 'No',
-                        'added_on' => '',
+                        'updated_on' => '', // Fecha de última actualización
-                        'updated_on' => '',
-                    ];
+                    ];
-                    $items[ $record['capsule_id'] ] =  $item;
+                    // Indexar por ID de tópico para facilitar actualización posterior
-                }
+                    $items[ $topic_id ] = $item;
+                }
                 // Segunda consulta: Obtener fechas de progreso y finalizar cálculos por tópico
-                $queryMapper = QueryMapper::getInstance($this->adapter);
+                $select = $sql->select();
+                $select->columns([
+                    'topic_id',
-                $sql = $queryMapper->getSql();
+                    'added_on' => new \Laminas\Db\Sql\Expression('MIN(added_on)'), // Fecha de primer acceso
-                $select = $sql->select(MicrolearningUserProgressMapper::_TABLE);
+                    'updated_on' => new \Laminas\Db\Sql\Expression('MAX(updated_on)') // Fecha de última actividad
-                $select->columns(['capsule_id', 'progress', 'total_slides' , 'view_slides', 'completed', 'added_on','updated_on']);
+                ]);
+                $select->from(MicrolearningUserProgressMapper::_TABLE);
                 $select->where->equalTo('company_id', $currentCompany->id);
                 $select->where->equalTo('user_id', $user->id);
+                $select->where->equalTo('type', MicrolearningUserProgress::TYPE_CAPSULE);
-                $select->where->equalTo('type', MicrolearningUserProgress::TYPE_CAPSULE);
+                $select->where->in('topic_id', $topic_ids);
+                $select->group('topic_id');
+                $records = $queryMapper->fetchAll($select);
                 foreach($records as $record) {
+                    $topic_id = $record['topic_id'];
-                $records = $queryMapper->fetchAll($select);
+                    // Formatear fechas de inicio y actualización del tópico
                     $dt_added_on = \DateTime::createFromFormat('Y-m-d H:i:s', $record['added_on']);
+                    $added_on = $dt_added_on->format('d/m/Y h:i a');
                 foreach($records as $record)
                     $dt_updated_on = \DateTime::createFromFormat('Y-m-d H:i:s', $record['updated_on']);
-                    $capsule_id = $record['capsule_id'];
+                    $updated_on = $dt_updated_on->format('d/m/Y h:i a');
                     $dt_added_on = \DateTime::createFromFormat('Y-m-d H:i:s', $record['added_on']);
-                    $added_on = $dt_added_on->format('d/m/Y h:i a');
+                    $items[$topic_id]['added_on'] = $added_on;
+                    $items[$topic_id]['updated_on'] = $updated_on;
-                    $dt_updated_on = \DateTime::createFromFormat('Y-m-d H:i:s', $record['updated_on']);
+                    // Calcular cápsulas pendientes (no iniciadas)
-                    $updated_on = $dt_updated_on->format('d/m/Y h:i a');
+                    $items[$topic_id]['pending_capsules'] = $items[$topic_id]['total_capsules'] -
                         ($items[$topic_id]['completed_capsules'] + $items[$topic_id]['started_capsules']);
                     $items[ $capsule_id ]['progress'] = $record['progress'];
-                    $items[ $capsule_id ]['total_slides'] = $record['total_slides'];
+                    // Calcular progreso total del tópico como porcentaje de cápsulas completadas
-                    $items[ $capsule_id ]['view_slides'] = $record['view_slides'];
+                    if($items[$topic_id]['total_capsules'] > 0) {
-                    $items[ $capsule_id ]['completed'] = $record['completed'] == 1 ? 'Si' : 'No';
+                        $progress = ($items[$topic_id]['completed_capsules'] * 100) / $items[$topic_id]['total_capsules'];
                 return $viewModel ;
+            }
         } else {
-        } else {
+            // Método HTTP no permitido (solo se acepta GET)
             return new JsonModel([
                 'success' => false,
                 'data' => 'ERROR_METHOD_NOT_ALLOWED'

Proyectos de Subversion LeadersLinked - Backend

(root)/module/LeadersLinked/src/Controller/MicrolearningReportsController.php – Rev 17347 → 17350