modules/studentact/current_situation_interface.py

# modules/studentact/current_situation_interface.py

import streamlit as st
import logging
from ..utils.widget_utils import generate_unique_key
from .current_situation_analysis import (
    analyze_text_dimensions, 
    analyze_clarity,
    analyze_reference_clarity,
    analyze_vocabulary_diversity, 
    analyze_cohesion,
    analyze_structure,
    get_dependency_depths, 
    normalize_score, 
    generate_sentence_graphs, 
    generate_word_connections, 
    generate_connection_paths,
    create_vocabulary_network, 
    create_syntax_complexity_graph, 
    create_cohesion_heatmap,     
)

logger = logging.getLogger(__name__)
####################################
def display_current_situation_visual(doc, metrics):
    """
    Muestra visualizaciones detalladas del análisis.
    """
    try:
        st.markdown("### 📊 Visualizaciones Detalladas")
        
        # 1. Visualización de vocabulario
        with st.expander("Análisis de Vocabulario", expanded=True):
            vocab_graph = create_vocabulary_network(doc)
            if vocab_graph:
                st.pyplot(vocab_graph)
                plt.close(vocab_graph)
        
        # 2. Visualización de estructura
        with st.expander("Análisis de Estructura", expanded=True):
            syntax_graph = create_syntax_complexity_graph(doc)
            if syntax_graph:
                st.pyplot(syntax_graph)
                plt.close(syntax_graph)
        
        # 3. Visualización de cohesión
        with st.expander("Análisis de Cohesión", expanded=True):
            cohesion_graph = create_cohesion_heatmap(doc)
            if cohesion_graph:
                st.pyplot(cohesion_graph)
                plt.close(cohesion_graph)

    except Exception as e:
        logger.error(f"Error en visualización: {str(e)}")
        st.error("Error al generar las visualizaciones")


####################################
def display_recommendations(metrics, t):
    """
    Muestra recomendaciones basadas en las métricas del texto.
    """
    # 1. Resumen Visual con Explicación
    st.markdown("### 📊 Resumen de tu Análisis")
    
    # Explicación del sistema de medición
    st.markdown("""
        **¿Cómo interpretar los resultados?**
        
        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
    """)

    # 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 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 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 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="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 de acción
    st.markdown("---")
    col1, col2, col3 = st.columns([1,2,1])
    with col2:
        st.button(
            "🎯 Comenzar ejercicios recomendados",
            type="primary",
            use_container_width=True,
            key="start_exercises"
        )