Update modules/studentact/current_situation_interface.py

modules/studentact/current_situation_interface.py

@@ -69,89 +69,132 @@ def display_recommendations(metrics, t):
     """
     Muestra recomendaciones basadas en las métricas del texto.
     """
-    st.markdown("### Recomendaciones Personalizadas")
+    # 1. Resumen Visual con Explicación
+    st.markdown("### 📊 Resumen de tu Análisis")
     
-    # Definir umbrales para cada dimensión
-    THRESHOLDS = {
-        'vocabulary': 0.7,
-        'structure': 0.6,
-        'cohesion': 0.65,
-        'clarity': 0.7
-    }
-    
-    # 1. Recomendaciones morfosintácticas
-    st.markdown("#### Análisis de Estructura")
-    if metrics['structure']['normalized_score'] < THRESHOLDS['structure']:
-        st.warning("""
-        📝 **Para mejorar la estructura de tus textos, te recomendamos:**
-        1. Realiza el análisis morfosintáctico de 3 párrafos diferentes
-        2. Practica la combinación de oraciones simples en compuestas
-        3. Identifica y clasifica los tipos de oraciones en textos académicos
-        4. Ejercita la variación sintáctica
-        """)
-    else:
-        st.success("✨ ¡Buen manejo de estructuras! Mantén el nivel con práctica regular.")
-        
-    # 2. Recomendaciones semánticas
-    st.markdown("#### Análisis de Vocabulario")
-    if metrics['vocabulary']['normalized_score'] < THRESHOLDS['vocabulary']:
-        st.warning("""
-        📚 **Para enriquecer tu vocabulario, te sugerimos:**
-        A. Realiza el análisis semántico de un texto académico
-        B. Identifica y agrupa campos semánticos
-        C. Practica la sustitución léxica en tus párrafos
-        D. Construye redes de conceptos
-        E. Analiza las relaciones entre ideas principales
-        """)
-    else:
-        st.success("📖 ¡Excelente vocabulario! Continúa expandiéndolo con lecturas variadas.")
+    # Explicación del sistema de medición
+    st.markdown("""
+        **¿Cómo interpretar los resultados?**
         
-    # 3. Recomendaciones de cohesión
-    st.markdown("#### Análisis de Cohesión")
-    if metrics['cohesion']['normalized_score'] < THRESHOLDS['cohesion']:
-        st.warning("""
-        🔄 **Para mejorar la cohesión de tus textos:**
-        1. Realiza el análisis del discurso de un texto modelo
-        2. Practica el uso de diferentes conectores textuales
-        3. Identifica las cadenas de referencia en textos académicos
-        4. Ejercita la progresión temática en tus escritos
-        """)
-    else:
-        st.success("🔗 ¡Buena cohesión textual! Sigue practicando para mantener la calidad.")
+        Cada métrica se mide en una escala de 0.0 a 1.0, donde:
+        - 0.0 - 0.4: Necesita atención prioritaria
+        - 0.4 - 0.6: En desarrollo
+        - 0.6 - 0.8: Buen nivel
+        - 0.8 - 1.0: Nivel avanzado
+    """)
 
-    # Agregar resumen visual de las métricas
-    st.markdown("### 📊 Resumen de tu análisis")
+    # Métricas con explicaciones detalladas
     col1, col2, col3, col4 = st.columns(4)
     
     with col1:
         st.metric(
             "Vocabulario",
             f"{metrics['vocabulary']['normalized_score']:.2f}",
-            help="Mide la riqueza y variedad de tu vocabulario"
+            help="Mide la variedad y riqueza de tu vocabulario. Un valor alto indica un uso diverso de palabras sin repeticiones excesivas."
         )
+        with st.expander("ℹ️ Detalles"):
+            st.write("""
+                **Vocabulario**
+                - Evalúa la diversidad léxica
+                - Considera palabras únicas vs. totales
+                - Detecta repeticiones innecesarias
+                - Valor óptimo: > 0.7
+            """)
     
     with col2:
         st.metric(
             "Estructura",
             f"{metrics['structure']['normalized_score']:.2f}",
-            help="Evalúa la complejidad de tus oraciones"
+            help="Evalúa la complejidad y variedad de las estructuras sintácticas en tus oraciones."
         )
+        with st.expander("ℹ️ Detalles"):
+            st.write("""
+                **Estructura**
+                - Analiza la complejidad sintáctica
+                - Mide variación en construcciones
+                - Evalúa longitud de oraciones
+                - Valor óptimo: > 0.6
+            """)
     
     with col3:
         st.metric(
             "Cohesión",
             f"{metrics['cohesion']['normalized_score']:.2f}",
-            help="Indica qué tan bien conectadas están tus ideas"
+            help="Indica qué tan bien conectadas están tus ideas y párrafos entre sí."
         )
+        with st.expander("ℹ️ Detalles"):
+            st.write("""
+                **Cohesión**
+                - Mide conexiones entre ideas
+                - Evalúa uso de conectores
+                - Analiza progresión temática
+                - Valor óptimo: > 0.65
+            """)
     
     with col4:
         st.metric(
             "Claridad",
             f"{metrics['clarity']['normalized_score']:.2f}",
-            help="Mide la facilidad de comprensión de tu texto"
+            help="Evalúa la facilidad de comprensión general de tu texto."
         )
+        with st.expander("ℹ️ Detalles"):
+            st.write("""
+                **Claridad**
+                - Evalúa comprensibilidad
+                - Considera estructura lógica
+                - Mide precisión expresiva
+                - Valor óptimo: > 0.7
+            """)
+
+    st.markdown("---")
+
+    # 2. Recomendaciones basadas en puntuaciones
+    st.markdown("### 💡 Recomendaciones Personalizadas")
+    
+    # Recomendaciones morfosintácticas
+    if metrics['structure']['normalized_score'] < 0.6:
+        st.warning("""
+        #### 📝 Análisis Morfosintáctico Recomendado
+        
+        **Tu nivel actual sugiere que sería beneficioso:**
+        1. Realizar el análisis morfosintáctico de 3 párrafos diferentes
+        2. Practicar la combinación de oraciones simples en compuestas
+        3. Identificar y clasificar tipos de oraciones en textos académicos
+        4. Ejercitar la variación sintáctica
+        
+        *Hacer clic en "Comenzar ejercicios" para acceder al módulo morfosintáctico*
+        """)
+        
+    # Recomendaciones semánticas
+    if metrics['vocabulary']['normalized_score'] < 0.7:
+        st.warning("""
+        #### 📚 Análisis Semántico Recomendado
+        
+        **Para mejorar tu vocabulario y expresión:**
+        A. Realiza el análisis semántico de un texto académico
+        B. Identifica y agrupa campos semánticos relacionados
+        C. Practica la sustitución léxica en tus párrafos
+        D. Construye redes de conceptos sobre tu tema
+        E. Analiza las relaciones entre ideas principales
+        
+        *Hacer clic en "Comenzar ejercicios" para acceder al módulo semántico*
+        """)
+    
+    # Recomendaciones de cohesión
+    if metrics['cohesion']['normalized_score'] < 0.65:
+        st.warning("""
+        #### 🔄 Análisis del Discurso Recomendado
+        
+        **Para mejorar la conexión entre ideas:**
+        1. Realizar el análisis del discurso de un texto modelo
+        2. Practicar el uso de diferentes conectores textuales
+        3. Identificar cadenas de referencia en textos académicos
+        4. Ejercitar la progresión temática en tus escritos
+        
+        *Hacer clic en "Comenzar ejercicios" para acceder al módulo de análisis del discurso*
+        """)
     
-    # Botón para comenzar ejercicios
+    # Botón de acción
     st.markdown("---")
     col1, col2, col3 = st.columns([1,2,1])
     with col2: