# modules/studentact/current_situation_interface.py
import streamlit as st
import logging
from ..utils.widget_utils import generate_unique_key
import matplotlib.pyplot as plt
import numpy as np
from ..database.current_situation_mongo_db import store_current_situation_result
from ..database.writing_progress_mongo_db import (
store_writing_baseline,
store_writing_progress,
get_writing_baseline,
get_writing_progress,
get_latest_writing_metrics
)
from .current_situation_analysis import (
analyze_text_dimensions,
analyze_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
)
# Configuración del estilo de matplotlib para el gráfico de radar
plt.rcParams['font.family'] = 'sans-serif'
plt.rcParams['axes.grid'] = True
plt.rcParams['axes.spines.top'] = False
plt.rcParams['axes.spines.right'] = False
logger = logging.getLogger(__name__)
####################################
TEXT_TYPES = {
'academic_article': {
'name': 'Artículo Académico',
'thresholds': {
'vocabulary': {'min': 0.70, 'target': 0.85},
'structure': {'min': 0.75, 'target': 0.90},
'cohesion': {'min': 0.65, 'target': 0.80},
'clarity': {'min': 0.70, 'target': 0.85}
}
},
'student_essay': {
'name': 'Trabajo Universitario',
'thresholds': {
'vocabulary': {'min': 0.60, 'target': 0.75},
'structure': {'min': 0.65, 'target': 0.80},
'cohesion': {'min': 0.55, 'target': 0.70},
'clarity': {'min': 0.60, 'target': 0.75}
}
},
'general_communication': {
'name': 'Comunicación General',
'thresholds': {
'vocabulary': {'min': 0.50, 'target': 0.65},
'structure': {'min': 0.55, 'target': 0.70},
'cohesion': {'min': 0.45, 'target': 0.60},
'clarity': {'min': 0.50, 'target': 0.65}
}
}
}
####################################
ANALYSIS_DIMENSION_MAPPING = {
'morphosyntactic': {
'primary': ['vocabulary', 'clarity'],
'secondary': ['structure'],
'tools': ['arc_diagrams', 'word_repetition']
},
'semantic': {
'primary': ['cohesion', 'structure'],
'secondary': ['vocabulary'],
'tools': ['concept_graphs', 'semantic_networks']
},
'discourse': {
'primary': ['cohesion', 'structure'],
'secondary': ['clarity'],
'tools': ['comparative_analysis']
}
}
##############################################################################
# FUNCIÓN PRINCIPAL
##############################################################################
def display_current_situation_interface(lang_code, nlp_models, t):
"""
TAB:
- Expander con radio para tipo de texto
Contenedor-1 con expanders:
- Expander "Métricas de la línea base"
- Expander "Métricas de la iteración"
Contenedor-2 (2 columnas):
- Col1: Texto base
- Col2: Texto iteración
Al final, Recomendaciones en un expander (una sola “fila”).
"""
# --- Inicializar session_state ---
if 'base_text' not in st.session_state:
st.session_state.base_text = ""
if 'iter_text' not in st.session_state:
st.session_state.iter_text = ""
if 'base_metrics' not in st.session_state:
st.session_state.base_metrics = {}
if 'iter_metrics' not in st.session_state:
st.session_state.iter_metrics = {}
if 'show_base' not in st.session_state:
st.session_state.show_base = False
if 'show_iter' not in st.session_state:
st.session_state.show_iter = False
# Creamos un tab
tabs = st.tabs(["Análisis de Texto"])
with tabs[0]:
# [1] Expander con radio para seleccionar tipo de texto
with st.expander("Selecciona el tipo de texto", expanded=True):
text_type = st.radio(
"¿Qué tipo de texto quieres analizar?",
options=list(TEXT_TYPES.keys()),
format_func=lambda x: TEXT_TYPES[x]['name'],
index=0
)
st.session_state.current_text_type = text_type
st.markdown("---")
# ---------------------------------------------------------------------
# CONTENEDOR-1: Expanders para métricas base e iteración
# ---------------------------------------------------------------------
with st.container():
# --- Expander para la línea base ---
with st.expander("Métricas de la línea base", expanded=False):
if st.session_state.show_base and st.session_state.base_metrics:
# Mostramos los valores reales
display_metrics_in_one_row(st.session_state.base_metrics, text_type)
else:
# Mostramos la maqueta vacía
display_empty_metrics_row()
# --- Expander para la iteración ---
with st.expander("Métricas de la iteración", expanded=False):
if st.session_state.show_iter and st.session_state.iter_metrics:
display_metrics_in_one_row(st.session_state.iter_metrics, text_type)
else:
display_empty_metrics_row()
st.markdown("---")
# ---------------------------------------------------------------------
# CONTENEDOR-2: 2 columnas (texto base | texto iteración)
# ---------------------------------------------------------------------
with st.container():
col_left, col_right = st.columns(2)
# Columna izquierda: Texto base
with col_left:
st.markdown("**Texto base**")
text_base = st.text_area(
label="",
value=st.session_state.base_text,
key="text_base_area",
placeholder="Pega aquí tu texto base",
)
if st.button("Analizar Base"):
with st.spinner("Analizando texto base..."):
doc = nlp_models[lang_code](text_base)
metrics = analyze_text_dimensions(doc)
st.session_state.base_text = text_base
st.session_state.base_metrics = metrics
st.session_state.show_base = True
# Al analizar base, reiniciamos la iteración
st.session_state.show_iter = False
# Columna derecha: Texto iteración
with col_right:
st.markdown("**Texto de iteración**")
text_iter = st.text_area(
label="",
value=st.session_state.iter_text,
key="text_iter_area",
placeholder="Edita y mejora tu texto...",
disabled=not st.session_state.show_base
)
if st.button("Analizar Iteración", disabled=not st.session_state.show_base):
with st.spinner("Analizando iteración..."):
doc = nlp_models[lang_code](text_iter)
metrics = analyze_text_dimensions(doc)
st.session_state.iter_text = text_iter
st.session_state.iter_metrics = metrics
st.session_state.show_iter = True
# ---------------------------------------------------------------------
# Recomendaciones al final en un expander (una sola “fila”)
# ---------------------------------------------------------------------
if st.session_state.show_iter:
with st.expander("Recomendaciones", expanded=False):
reco_list = []
for dimension, values in st.session_state.iter_metrics.items():
score = values['normalized_score']
target = TEXT_TYPES[text_type]['thresholds'][dimension]['target']
if score < target:
# Aquí, en lugar de get_dimension_suggestions, unificamos con:
suggestions = suggest_improvement_tools_list(dimension)
reco_list.extend(suggestions)
if reco_list:
# Todas en una sola línea
st.write(" | ".join(reco_list))
else:
st.info("¡No hay recomendaciones! Todas las métricas superan la meta.")
#Funciones de visualización ##################################
############################################################
# Funciones de visualización para las métricas
############################################################
def display_metrics_in_one_row(metrics, text_type):
"""
Muestra las cuatro dimensiones (Vocabulario, Estructura, Cohesión, Claridad)
en una sola línea, usando 4 columnas con ancho uniforme.
"""
thresholds = TEXT_TYPES[text_type]['thresholds']
dimensions = ["vocabulary", "structure", "cohesion", "clarity"]
col1, col2, col3, col4 = st.columns([1,1,1,1])
cols = [col1, col2, col3, col4]
for dim, col in zip(dimensions, cols):
score = metrics[dim]['normalized_score']
target = thresholds[dim]['target']
min_val = thresholds[dim]['min']
if score < min_val:
status = "⚠️ Por mejorar"
color = "inverse"
elif score < target:
status = "📈 Aceptable"
color = "off"
else:
status = "✅ Óptimo"
color = "normal"
with col:
col.metric(
label=dim.capitalize(),
value=f"{score:.2f}",
delta=f"{status} (Meta: {target:.2f})",
delta_color=color,
border=True
)
# -------------------------------------------------------------------------
# Función que muestra una fila de 4 columnas “vacías”
# -------------------------------------------------------------------------
def display_empty_metrics_row():
"""
Muestra una fila de 4 columnas vacías (Vocabulario, Estructura, Cohesión, Claridad).
Cada columna se dibuja con st.metric en blanco (“-”).
"""
empty_cols = st.columns([1,1,1,1])
labels = ["Vocabulario", "Estructura", "Cohesión", "Claridad"]
for col, lbl in zip(empty_cols, labels):
with col:
col.metric(
label=lbl,
value="-",
delta="",
border=True
)
####################################################################
def display_metrics_analysis(metrics, text_type=None):
"""
Muestra los resultados del análisis: métricas verticalmente y gráfico radar.
"""
try:
# Usar valor por defecto si no se especifica tipo
text_type = text_type or 'student_essay'
# Obtener umbrales según el tipo de texto
thresholds = TEXT_TYPES[text_type]['thresholds']
# Crear dos columnas para las métricas y el gráfico
metrics_col, graph_col = st.columns([1, 1.5])
# Columna de métricas
with metrics_col:
metrics_config = [
{
'label': "Vocabulario",
'key': 'vocabulary',
'value': metrics['vocabulary']['normalized_score'],
'help': "Riqueza y variedad del vocabulario",
'thresholds': thresholds['vocabulary']
},
{
'label': "Estructura",
'key': 'structure',
'value': metrics['structure']['normalized_score'],
'help': "Organización y complejidad de oraciones",
'thresholds': thresholds['structure']
},
{
'label': "Cohesión",
'key': 'cohesion',
'value': metrics['cohesion']['normalized_score'],
'help': "Conexión y fluidez entre ideas",
'thresholds': thresholds['cohesion']
},
{
'label': "Claridad",
'key': 'clarity',
'value': metrics['clarity']['normalized_score'],
'help': "Facilidad de comprensión del texto",
'thresholds': thresholds['clarity']
}
]
# Mostrar métricas
for metric in metrics_config:
value = metric['value']
if value < metric['thresholds']['min']:
status = "⚠️ Por mejorar"
color = "inverse"
elif value < metric['thresholds']['target']:
status = "📈 Aceptable"
color = "off"
else:
status = "✅ Óptimo"
color = "normal"
st.metric(
metric['label'],
f"{value:.2f}",
f"{status} (Meta: {metric['thresholds']['target']:.2f})",
delta_color=color,
help=metric['help']
)
st.markdown("<div style='margin-bottom: 0.5rem;'></div>", unsafe_allow_html=True)
except Exception as e:
logger.error(f"Error mostrando resultados: {str(e)}")
st.error("Error al mostrar los resultados")
def display_comparison_results(baseline_metrics, current_metrics):
"""Muestra comparación entre línea base y métricas actuales"""
# Crear columnas para métricas y gráfico
metrics_col, graph_col = st.columns([1, 1.5])
with metrics_col:
for dimension in ['vocabulary', 'structure', 'cohesion', 'clarity']:
baseline = baseline_metrics[dimension]['normalized_score']
current = current_metrics[dimension]['normalized_score']
delta = current - baseline
st.metric(
dimension.title(),
f"{current:.2f}",
f"{delta:+.2f}",
delta_color="normal" if delta >= 0 else "inverse"
)
# Sugerir herramientas de mejora
if delta < 0:
suggest_improvement_tools(dimension)
with graph_col:
display_radar_chart_comparison(
baseline_metrics,
current_metrics
)
def display_metrics_and_suggestions(metrics, text_type, title, show_suggestions=False):
"""
Muestra métricas y opcionalmente sugerencias de mejora.
Args:
metrics: Diccionario con las métricas analizadas
text_type: Tipo de texto seleccionado
title: Título para las métricas ("Base" o "Iteración")
show_suggestions: Booleano para mostrar sugerencias
"""
try:
thresholds = TEXT_TYPES[text_type]['thresholds']
st.markdown(f"### Métricas {title}")
for dimension, values in metrics.items():
score = values['normalized_score']
target = thresholds[dimension]['target']
min_val = thresholds[dimension]['min']
# Determinar estado y color
if score < min_val:
status = "⚠️ Por mejorar"
color = "inverse"
elif score < target:
status = "📈 Aceptable"
color = "off"
else:
status = "✅ Óptimo"
color = "normal"
# Mostrar métrica
st.metric(
dimension.title(),
f"{score:.2f}",
f"{status} (Meta: {target:.2f})",
delta_color=color,
help=f"Meta: {target:.2f}, Mínimo: {min_val:.2f}"
)
# Mostrar sugerencias si es necesario
if show_suggestions and score < target:
suggest_improvement_tools(dimension)
# Agregar espacio entre métricas
st.markdown("<div style='margin-bottom: 0.5rem;'></div>", unsafe_allow_html=True)
except Exception as e:
logger.error(f"Error mostrando métricas: {str(e)}")
st.error("Error al mostrar métricas")
def display_radar_chart(metrics_config, thresholds, baseline_metrics=None):
"""
Muestra el gráfico radar con los resultados.
Args:
metrics_config: Configuración actual de métricas
thresholds: Umbrales para las métricas
baseline_metrics: Métricas de línea base (opcional)
"""
try:
# Preparar datos para el gráfico
categories = [m['label'] for m in metrics_config]
values_current = [m['value'] for m in metrics_config]
min_values = [m['thresholds']['min'] for m in metrics_config]
target_values = [m['thresholds']['target'] for m in metrics_config]
# Crear y configurar gráfico
fig = plt.figure(figsize=(8, 8))
ax = fig.add_subplot(111, projection='polar')
# Configurar radar
angles = [n / float(len(categories)) * 2 * np.pi for n in range(len(categories))]
angles += angles[:1]
values_current += values_current[:1]
min_values += min_values[:1]
target_values += target_values[:1]
# Configurar ejes
ax.set_xticks(angles[:-1])
ax.set_xticklabels(categories, fontsize=10)
circle_ticks = np.arange(0, 1.1, 0.2)
ax.set_yticks(circle_ticks)
ax.set_yticklabels([f'{tick:.1f}' for tick in circle_ticks], fontsize=8)
ax.set_ylim(0, 1)
# Dibujar áreas de umbrales
ax.plot(angles, min_values, '#e74c3c', linestyle='--', linewidth=1,
label='Mínimo', alpha=0.5)
ax.plot(angles, target_values, '#2ecc71', linestyle='--', linewidth=1,
label='Meta', alpha=0.5)
ax.fill_between(angles, target_values, [1]*len(angles),
color='#2ecc71', alpha=0.1)
ax.fill_between(angles, [0]*len(angles), min_values,
color='#e74c3c', alpha=0.1)
# Si hay línea base, dibujarla primero
if baseline_metrics is not None:
values_baseline = [baseline_metrics[m['key']]['normalized_score']
for m in metrics_config]
values_baseline += values_baseline[:1]
ax.plot(angles, values_baseline, '#888888', linewidth=2,
label='Línea base', linestyle='--')
ax.fill(angles, values_baseline, '#888888', alpha=0.1)
# Dibujar valores actuales
label = 'Actual' if baseline_metrics else 'Tu escritura'
color = '#3498db' if baseline_metrics else '#3498db'
ax.plot(angles, values_current, color, linewidth=2, label=label)
ax.fill(angles, values_current, color, alpha=0.2)
# Ajustar leyenda
legend_handles = []
if baseline_metrics:
legend_handles.extend([
plt.Line2D([], [], color='#888888', linestyle='--',
label='Línea base'),
plt.Line2D([], [], color='#3498db', label='Actual')
])
else:
legend_handles.extend([
plt.Line2D([], [], color='#3498db', label='Tu escritura')
])
legend_handles.extend([
plt.Line2D([], [], color='#e74c3c', linestyle='--', label='Mínimo'),
plt.Line2D([], [], color='#2ecc71', linestyle='--', label='Meta')
])
ax.legend(
handles=legend_handles,
loc='upper right',
bbox_to_anchor=(1.3, 1.1),
fontsize=10,
frameon=True,
facecolor='white',
edgecolor='none',
shadow=True
)
plt.tight_layout()
st.pyplot(fig)
plt.close()
except Exception as e:
logger.error(f"Error mostrando gráfico radar: {str(e)}")
st.error("Error al mostrar el gráfico")
#Funciones auxiliares ##################################
############################################################
# Unificamos la lógica de sugerencias en una función
############################################################
def suggest_improvement_tools_list(dimension):
"""
Retorna en forma de lista las herramientas sugeridas
basadas en 'ANALYSIS_DIMENSION_MAPPING'.
"""
suggestions = []
for analysis, mapping in ANALYSIS_DIMENSION_MAPPING.items():
# Verificamos si la dimensión está en primary o secondary
if dimension in mapping['primary'] or dimension in mapping['secondary']:
suggestions.extend(mapping['tools'])
# Si no hay nada, al menos retornamos un placeholder
return suggestions if suggestions else ["Sin sugerencias específicas."]
def prepare_metrics_config(metrics, text_type='student_essay'):
"""
Prepara la configuración de métricas en el mismo formato que display_results.
Args:
metrics: Diccionario con las métricas analizadas
text_type: Tipo de texto para los umbrales
Returns:
list: Lista de configuraciones de métricas
"""
# Obtener umbrales según el tipo de texto
thresholds = TEXT_TYPES[text_type]['thresholds']
# Usar la misma estructura que en display_results
return [
{
'label': "Vocabulario",
'key': 'vocabulary',
'value': metrics['vocabulary']['normalized_score'],
'help': "Riqueza y variedad del vocabulario",
'thresholds': thresholds['vocabulary']
},
{
'label': "Estructura",
'key': 'structure',
'value': metrics['structure']['normalized_score'],
'help': "Organización y complejidad de oraciones",
'thresholds': thresholds['structure']
},
{
'label': "Cohesión",
'key': 'cohesion',
'value': metrics['cohesion']['normalized_score'],
'help': "Conexión y fluidez entre ideas",
'thresholds': thresholds['cohesion']
},
{
'label': "Claridad",
'key': 'clarity',
'value': metrics['clarity']['normalized_score'],
'help': "Facilidad de comprensión del texto",
'thresholds': thresholds['clarity']
}
]