[robertofabiot]

Resumen de Cambios

Este PR introduce la implementación completa del Sprint 10, correspondiente al cierre exhaustivo de todas las brechas heurísticas, casos límite y restricciones ergonómicas documentadas en la auditoría maestra de UI/UX (Módulos 1 al 7), garantizando un estándar de calidad 10/10 en cada flujo y logrando una apariencia idéntica y predecible en Windows y Linux. Los cambios abarcan ampliaciones aditivas en el motor (prettycalc.core), componentes transversales y refinamiento integral de los seis módulos interactivos en la interfaz de escritorio (prettycalc.ui).

Objetivos Cumplidos

• Paridad Multiplataforma Windows/Linux: Fuentes empaquetadas (Inter, Fira Code, DejaVu Sans) registradas al arranque, forzado de estilo Fusion, tamaños exclusivamente en píxeles (no puntos ni dependencia de DPI lógico), iconos vectoriales dibujados por la app y eliminación total de dependencias de fuentes y emojis del sistema.
• Tokens de Accesibilidad WCAG AA y Sistema de Temas: Paletas con contraste garantizado ≥ 4.5:1 (text_muted #C9C3D6, surface_elevated #4A4257), tres temas completos (oscuro, alto contraste y claro) seleccionables en Apariencia (Ctrl+,) y cálculo dinámico de texto legible en badges.
• Interacción Preventiva, No Modal y Deshacible: Eliminación de diálogos modales para validación de entrada en favor de feedback en línea contextual; soporte integral de Deshacer/Rehacer (Ctrl+Z, Ctrl+Y) para cambios masivos (pegar, reiniciar, cargar ejemplos, intercambiar operandos); auto-completado de celda vacía a 0 al desenfocar; y ejecución universal con Ctrl+Intro.
• Excelencia Pedagógica en los 6 Módulos: Atajos inteligentes y guía contextual en Cramer/Gauss-Jordan, desglose de contradicción 0 = c con salto al paso, inspección interactiva celda a celda en productos matriciales, traza componente a componente en vectores u ± v y k·v, solución particular destacada en SCI, sincronización gráfica de diagonales de Sarrus, sugerencia de línea óptima en Laplace y clasificación completa con filas permutadas en PLU.
• Suite de Pruebas Automatizadas: 448 pruebas pasando en verde (113 nuevas pruebas en Sprint 10 cubriendo paridad de layout con 96/144 ppp, aislamiento sin fuentes del sistema, diagnóstico de entradas y flujos completos de los 6 módulos), preservando el 100% de la suite previa sin regresiones.

Detalles de Implementación por Módulo

1. Motor Matemático (prettycalc/core/)

• Diagnóstico de Entradas (input_diagnostics.py): diagnose_scalar_text() para explicar en lenguaje natural errores comunes de digitación (coma decimal, letra 'O'/'o' por cero, división entre cero a/0, signos duplicados o caracteres inválidos) y decimal_hint() para ofrecer aproximaciones decimales útiles de fracciones.
• Trazador de Pasos (tracer.py): CalculationStep ampliado con soporte de alert_rows (resaltado de contradicción/filas críticas) y highlight_cells (coordenadas de celdas involucradas).
• Determinantes (determinants.py): Cierre explícito de triangulación con producto de la diagonal principal \det(A) = (-1)^k \prod u_{ii}, diagonales individuales en Sarrus, marcado de fila/columna en Laplace, función best_expansion_line() para sugerir la línea con más ceros y scaling_breakdown() para la ley k^n \det(A).
• Clasificador de Sistemas (classifier.py): Incorporación de inconsistent_value en SystemAnalysis para identificar el valor de la fila 0 = c.
• Operaciones Vectoriales (vector_ops.py): Trazadores pedagógicos trace_vector_sum() y trace_vector_scale() con explicación aritmética elemento por elemento.
• Exposición pública (__init__.py): Contratos del núcleo matemáticamente exactos con fractions.Fraction intactos; los nuevos diagnósticos y trazadores se consumen limpiamente por sus módulos.

2. Capa de Presentación (prettycalc/ui/)

• Alineación y Plataforma (platform_setup.py, assets/fonts/): Carga y registro de familias Inter, Fira Code y DejaVu Sans; configuración de escalado PassThrough; renderizado consistente sin depender de tipografías del SO.
• Sistema de Diseño y Temas (theme.py, preferences_dialog.py): Soporte de temas (oscuro, alto contraste, claro) y selector de escala de interfaz accesible mediante Ctrl+,.
• Cuadrícula Interactiva (matrix_grid.py, book_matrix.py): Historial de deshacer/rehacer por matriz, explicación en línea de celda errónea en badge inferior, relleno automático de vacíos con 0, atajos Ctrl+Supr y Ctrl+Mayús+Supr, pegado no modal con confirmación y restauración del fondo de celdas destacadas.
• Controles Comunes y Responsive (feedback.py, scalar_field.py, size_control.py, responsive.py, export.py): Sistema de Toasts no modales con acción, estado «Calculando...», selector directo MatrixSizeControl m × n, ScalarField con chips y pistas decimales, ResponsiveRow y CurrentPageStack que eliminan barras de scroll horizontales a 1366×768, y exportación a PDF, HTML, LaTeX y texto desde el carrusel (stepper_carousel.py).
• Módulos 1 y 2 (linear_systems_view.py, applied_models_panel.py, matrix_operations_view.py): Spinboxes directos, desactivación instructiva de Cramer con botón para igualar o resolver vía Gauss-Jordan, sumas en vivo en Leontief, botón único de cálculo con Ctrl+Intro, inspector interactivo de entradas $C_{ij}$ y atajos de adaptación de dimensiones.
• Módulos 3 y 4 (vectors_view.py, vector_set_editor.py, matrix_equations_view.py): Editor de conjuntos vectoriales en FlowLayout, botón deshacible u ↔ v, advertencia previa si $k > n$, inspector de producto exterior $uv^T$, insignia de solución particular en SCI y vínculo de dimensiones de $u$ y $v$ a las columnas de $A$.
• Módulos 5 y 6 (determinants_view.py, sarrus_diagram.py, lu_factorization_view.py): Sarrus con botón deshacible «Ajustar a 3×3» y diagrama dinámico de diagonales; Laplace con sugerencia visual de ceros; pestañas para adjunta e inversa con opción «Enviar $A^{-1}$ a Matrices»; y visualización LU con filas permutadas en ocre y clasificación completa de $Ax = b$ ante pivote nulo.

3. Pruebas Automatizadas (tests/)

• tests/core/test_input_diagnostics.py: Pruebas unitarias de detección de coma decimal, 'O' por cero, divisiones entre cero y notación científica.
• tests/ui/test_cross_platform.py: Cobertura de glifos en fuentes empaquetadas, ausencia total de fuentes del SO y emojis, y paridad geométrica estricta de 113 widgets a 96 y 144 ppp.
• tests/ui/test_sprint10_ui.py: Pruebas de integración de componentes UI, atajos, desbordamiento, tokens de contraste WCAG AA, y flujos de Módulos 1 y 2.
• tests/ui/test_sprint10_vectors.py: Flujos del Módulo 3 (desglose de componentes, intercambio de vectores, advertencia $k > n$, pegado de columnas).
• tests/ui/test_sprint10_equations.py: Flujos del Módulo 4 (solución particular, reporte de fila en SI, propiedades de transformación lineal).
• tests/ui/test_sprint10_det_lu.py: Flujos de Módulos 5 y 6 (ajuste de orden en Sarrus, sugerencia en Laplace, filas permutadas por $P$ y resolución en LU).

4. Documentación

• Docs/Sprints/Sprint10/README.md: Memoria técnica completa del Sprint 10 con detalle de requerimientos, decisiones de arquitectura y registro de commits.
• Docs/design-rules.md: Actualización de tokens cromáticos, especificación de tipografías empaquetadas y reglas de interacción no modal.
• README.md: Inclusión de la tabla de atajos de teclado globales y soporte de visualización.
• .github/workflows/tests.yml: Matriz de integración continua en Ubuntu y Windows con Python 3.10 y 3.13.

Casos de Prueba Verificados

Caso	Tema	Comportamiento esperado	Estado
Paridad DPI y fuentes	Multiplataforma	Geometría idéntica de widgets entre 96 y 144 ppp y sin fuentes del SO	Aprobado
Tokens de diseño	Accesibilidad	Ratio de contraste ≥ 4.5:1 (WCAG AA) en temas oscuro, alto contraste y claro	Aprobado
Diagnóstico escalar	Validación	Explicación en línea para 3,5, 1O, 5/0 y aceptación de 1e5	Aprobado
Contradicción SI	Sistemas lineales	Salto automático a la fila crítica y reporte exacto de $0 = c$ en dashboard	Aprobado
Cramer rectangular	Sistemas lineales	Deshabilitación instructiva con acciones «Igualar a n×n» y «Usar Gauss-Jordan»	Aprobado
Inversa singular	Matrices	Salto al paso crítico en reducción y bloqueo de acciones de reinversión	Aprobado
Desglose vectorial	Vectores	Pasos elemento por elemento para $u \pm v$ y $k \cdot v$ con trazador exacto	Aprobado
Sarrus fuera de 3×3	Determinantes	Bloqueo no modal con acción deshacible «Ajustar a 3×3» y diagrama dinámico	Aprobado
Laplace óptimo	Determinantes	Resaltado visual en cuadrícula y recomendación de línea con más ceros	Aprobado
Desglose de escala	Determinantes	Explicación detallada de $k^n \det(A)$ (ej. $2^2 = 4 \Rightarrow 4 \cdot 9 = 36$)	Aprobado
Factorización PLU	LU	Filas permutadas marcadas en ocre sobre $A$ y clasificación en caso singular	Aprobado
Resolución 1366×768	Responsive	Cero barras de desplazamiento horizontal con ejemplos cargados	Aprobado

Instrucciones de Ejecución

Ejecutar la aplicación gráfica

pip install -r requirements.txt
python run.py

• En cualquier módulo, presione F1 para abrir la hoja completa de atajos de teclado o Ctrl+, para ajustar el tema y escala.
• En la cuadrícula matricial, edite celdas y use Ctrl+Z / Ctrl+Y para verificar deshacer/rehacer, o Ctrl+Intro para calcular directamente.
• En Determinantes, ingrese un orden $4 \times 4$ y seleccione Sarrus para comprobar la sugerencia interactiva «Ajustar a 3×3».

Ejecutar la suite de pruebas

pytest

En un entorno sin pantalla:

QT_QPA_PLATFORM=offscreen pytest

Checklist de Revisión

• El motor nuevo usa solo Python estándar y fractions.Fraction.
• Cada algoritmo pedagógico deja pasos en StepTracer cuando el sprint lo exige.
• La interfaz cubre el caso correcto y los errores de dominio sin cerrar la aplicación.
• Los casos numéricos de clase coinciden componente a componente.
• pytest pasa, incluida la suite que ya existía antes del sprint.