🚀 Release v2.0.0 - Interfaz Gráfica + Testing + CI/CD

[Jandres25]

📋 Descripción

Este Pull Request contiene el Release v2.0.0 oficial del proyecto, un major release que introduce cambios significativos y marca la evolución de una calculadora CLI simple a una aplicación completa con interfaz gráfica, testing automatizado y CI/CD.

🎉 Major Release - Interfaz Gráfica + Testing Automatizado

Este release incluye:

• 🖥️ Interfaz Gráfica Completa (GUI) con tkinter

  • Calculadora visual con diseño moderno y tema oscuro
  • Display de alta resolución
  • Grid de botones organizados por función
  • Diseño responsive

• ⌨️ Soporte Completo de Teclado

  • Atajos para todos los números (0-9)
  • Operadores (+, -, *, /, ^)
  • Enter/= para calcular
  • Escape para limpiar
  • Backspace para borrar

• 🧪 Testing Automatizado de GUI

  • test_gui_calculator.py con suite completa de tests
  • conftest.py con mocks de Tkinter (DummyRoot, DummyEntry, DummyButton, DummyLabel)
  • Tests ejecutables sin display gráfico (headless)
  • Compatible con CI/CD

• 🤖 CI/CD con GitHub Actions

  • Pipeline automático en cada PR
  • Tests en ambiente headless
  • Validación continua de calidad

• 🔧 Funcionalidades de GUI

  • Entrada numérica por clicks
  • Botón decimal con validación
  • Botones Clear (C) y Backspace (⌫)
  • Funciones científicas: abs, max, min
  • Soporte para números negativos
  • Manejo visual de errores

• 📝 Documentación Completa

  • README. md profesional con badges
  • CHANGELOG.md detallado
  • Guía de usuario para GUI
  • Créditos a todos los contribuidores

---

🔗 Issues Relacionadas

Issues que se cerrarán automáticamente:

Closes #15, Closes #18, Closes #20, Closes #22, Closes #23, Closes #24, Closes #25, Closes #26, Closes #28, Closes #29, Closes #30, Closes #36, Closes #37, Closes #38, Closes #41, Closes #43

📋 Ver lista detallada de issues (16 issues)

• Implementar: Prototipo inicial de GUI #15 - Implementar: Prototipo inicial de GUI
• Mejorar diseño: Ajustes y refinamientos de la GUI #18 - Mejorar diseño: Ajustes y refinamientos de la GUI
• Mejora: Estilos visuales de la GUI #20 - Mejora: Estilos visuales de la GUI
• Agregar función: Clicks de botones numéricos en GUI #22 - Agregar función: Clicks de botones numéricos en GUI
• Pruebas: Testing manual completo de GUI #23 - Pruebas: Testing manual completo de GUI
• Documentación: Guía de usuario para GUI #24 - Documentación: Guía de usuario para GUI
• Agregar función: Botón punto decimal en GUI #25 - Agregar función: Botón punto decimal en GUI
• Agregar función: Lógica de operadores en GUI #26 - Agregar función: Lógica de operadores en GUI
• Agregar funcionalidad: Botones Clear y Backspace #28 - Agregar funcionalidad: Botones Clear y Backspace
• Mejora: Manejo de errores y validaciones en GUI #29 - Mejora: Manejo de errores y validaciones en GUI
• Agregar función: Funciones científicas en GUI #30 - Agregar función: Funciones científicas en GUI
• Configurar CI/CD con GitHub Actions #36 - Configurar CI/CD con GitHub Actions
• Agregar soporte de teclado para calculadora GUI #37 - Agregar soporte de teclado para calculadora GUI
• Integración final y preparación de release v2.0.0 #38 - Integración final y preparación de release v2.0.0
• Mejora: Agregar característica: Números negativos sin operación de resta #41 - Mejora: Números negativos sin operación de resta
• Error: Difícil ingresar múltiples números negativos en operaciones #43 - Error: Difícil ingresar múltiples números negativos

---

🎯 Tipo de Cambio

• 🐛 Bug fix (corrección de error)
• ✨ Nueva funcionalidad
• 📝 Mejora de documentación
• ♻️ Refactoring (sin cambios de funcionalidad)
• 🧪 Tests (agregar o mejorar tests)
• 🎨 Estilo (formateo, nombres de variables)
• 🚀 Release (preparación para release)

---

🧪 ¿Cómo se ha probado?

• Tests unitarios
• Prueba manual
• Probado en diferentes sistemas operativos

Comandos ejecutados:

# Tests de calculadora básica
pytest test_calculator.py -v

# Tests de GUI con mocks
pytest test_gui_calculator.py -v

# Todos los tests
pytest -v

# Verificar CLI
python main.py

# Verificar GUI
python gui.py

# CI/CD
# ✅ GitHub Actions: Todos los tests pasando en cada PR

Resultados:

• ✅ Todos los tests unitarios pasando (CLI)
• ✅ Todos los tests de GUI pasando (con mocks)
• ✅ CI/CD verificado en 24+ PRs
• ✅ Probado manualmente en Windows/Linux/Mac
• ✅ No hay conflictos entre dev y main

---

✅ Checklist

• Mi código sigue las convenciones del proyecto
• He realizado self-review de mi código
• He comentado mi código en áreas complejas
• He actualizado la documentación correspondiente
• Mis cambios no generan nuevas advertencias
• He agregado tests que prueban mis cambios
• Los tests nuevos y existentes pasan localmente
• Los commits siguen Conventional Commits
• CI/CD pasa exitosamente

---

📊 Estadísticas del Release v2.0.0

Números:

• 📦 Commits totales: 60+
• 🔀 Pull Requests mergeados: 24+
• ✅ Issues completadas: 16
• 👥 Contribuidores: 3
• 📅 Duración del desarrollo: ~3 semanas (Nov 6 - Nov 28)

Archivos:

• ➕ Archivos nuevos (4):

  • gui.py - Interfaz gráfica con tkinter
  • test_gui_calculator.py - Tests de GUI
  • conftest.py - Fixtures y mocks de Tkinter
  • . github/workflows/ci.yml - Pipeline CI/CD

• 📝 Archivos modificados:

  • README.md - Documentación completa actualizada
  • CHANGELOG. md - Historial de v2.0.0
  • calculator.py - Mejoras y refactoring

Pull Requests Incluidos:

🔀 Ver todos los PRs mergeados (24+)

• test: agregar tests de GUI con mocks de tkinter #48 - test: agregar tests de GUI con mocks de tkinter
• feat: agregar soporte de teclado para calculadora GUI #47 - feat: agregar soporte de teclado para calculadora GUI
• refactor(gui): eliminar lógica redundante en el manejo de operadores #46 - refactor(gui): eliminar lógica redundante en el manejo de operadores
• feat(gui): soporte para números negativos y actualización de documentación #45 - feat(gui): soporte para números negativos y actualización de documentación
• feat: Configurar CI/CD con GitHub Actions #42 - feat: Configurar CI/CD con GitHub Actions
• docs — Añadir guía de usuario para la GUI #40 - docs: Añadir guía de usuario para la GUI
• refactor(gui): mejorar funciones unarias y manejo de errores #39 - refactor(gui): mejorar funciones unarias y manejo de errores
• feat: Agregar funciones científicas (abs, max, min) con integración en GUI #35 - feat: Agregar funciones científicas (abs, max, min) con integración en GUI
• feat: implementar botones C y ⌫ con su funcionalidad correspondiente #34 - feat: implementar botones C y ⌫ con su funcionalidad correspondiente
• feat(core): añadir lógica de operaciones (+, -, *, /, ^) y soporte para botón "=" #33 - feat(core): añadir lógica de operaciones (+, -, *, /, ^) y soporte para botón "="
• feat: implementar botón decimal con validación en la calculadora Tkinter #32 - feat: implementar botón decimal con validación en la calculadora Tkinter
• feat: Implementar lógica de clic para entrada numérica #31 - feat: Implementar lógica de clic para entrada numérica
• feat: actualizar colores en gui.py #21 - feat: actualizar colores en gui.py
• feat: ajustar diseño segun selección del equipo #19 - feat: ajustar diseño según selección del equipo
• feat: Merge prototype calculator design from dev to main (#15) #17 - feat: Merge prototype calculator design from dev to main
• feat: agregar prototipo de GUI con diseño base #16 - feat: agregar prototipo de GUI con diseño base
• Eiminar código duplicado por pegado accidental #14 - hotfix: eliminar código duplicado
• Merge dev into main — Sync features, tests and fixes #12 - Merge dev into main — Sync features, tests and fixes
• feat: añadir valor_minimo y soportarlo en main.py y tests #11 - feat: añadir valor_minimo
• Corregir indentación y pruebas unitarias #10 - fix: corregir indentación
• Revert "Corregir problemas de indentación en main.py" rama incorrecta #9 - Revert: rama incorrecta
• Corregir problemas de indentación en main.py #8 - fix: problemas de indentación
• Implementar función de valor maximo, pruebas unitarias y soporte en main.py #6 - feat: función valor_maximo
• Implementar función de valor absoluto, pruebas unitarias y soporte en main.py #5 - feat: función valor_absoluto

---

📝 Notas Adicionales

Lo que incluye este Release:

Interfaz Gráfica:

• Ventana principal 320x400px
• Tema oscuro profesional
• Botones numéricos (0-9)
• Operadores (+, -, *, /, ^)
• Funciones científicas (abs, max, min)
• Botón decimal con validación
• Clear (C) y Backspace (⌫)
• Display de alta resolución

Testing:

• Tests unitarios para lógica matemática
• Tests de GUI con mocks (sin dependencia de Tcl/Tk)
• Fixtures de pytest con autouse=True
• Ejecutable en entornos headless

CI/CD:

• Workflow para main y dev
• Ejecución automática en cada PR
• Tests en ambiente sin display

Documentación:

• README profesional con badges
• Tabla de atajos de teclado
• Instrucciones de instalación
• Guía de contribución
• CHANGELOG completo

Issues Pendientes para v2.1.0:

• Soporte de operaciones con paréntesis en la calculadora GUI #44 - Soporte de operaciones con paréntesis
• Error: Manejo confuso de números decimales negativos (secuencia "- . 3") #49 - Fix: Manejo de decimales negativos
• Error: Raíces pares de números negativos generan resultados complejos #50 - Fix: Raíces pares de números negativos

🙏 Agradecimientos

Este release fue posible gracias al trabajo colaborativo de todo el equipo:

Contribuidores:

@Jandres25 - Jose Andres Meneces Lopez

• Coordinador del release
• Prototipo de GUI (Implementar: Prototipo inicial de GUI #15, feat: agregar prototipo de GUI con diseño base #16)
• CI/CD con GitHub Actions (Configurar CI/CD con GitHub Actions #36, feat: Configurar CI/CD con GitHub Actions #42)
• Testing automatizado de GUI (Pruebas: Testing manual completo de GUI #23, test: agregar tests de GUI con mocks de tkinter #48)
• Soporte de teclado (Agregar soporte de teclado para calculadora GUI #37, feat: agregar soporte de teclado para calculadora GUI #47)
• Documentación del release (Integración final y preparación de release v2.0.0 #38)

[@Jhos3ph](https://github. com/Jhos3ph) - Jose Orozco

• Funciones científicas en GUI (Agregar función: Funciones científicas en GUI #30, feat: Agregar funciones científicas (abs, max, min) con integración en GUI #35)
• Lógica de operaciones matemáticas (Agregar función: Lógica de operadores en GUI #26, feat(core): añadir lógica de operaciones (+, -, *, /, ^) y soporte para botón "=" #33)
• Entrada numérica (Agregar función: Clicks de botones numéricos en GUI #22, feat: Implementar lógica de clic para entrada numérica #31)
• Refactoring y optimizaciones (refactor(gui): mejorar funciones unarias y manejo de errores #39, refactor(gui): eliminar lógica redundante en el manejo de operadores #46)
• Soporte de números negativos (Mejora: Agregar característica: Números negativos sin operación de resta #41, feat(gui): soporte para números negativos y actualización de documentación #45)

@alexricardotapiacarita-ai - Alex Tapia

• Diseño y estilos visuales de GUI (Mejorar diseño: Ajustes y refinamientos de la GUI #18, feat: ajustar diseño segun selección del equipo #19, Mejora: Estilos visuales de la GUI #20, feat: actualizar colores en gui.py #21)
• Botón decimal con validación (Agregar función: Botón punto decimal en GUI #25, feat: implementar botón decimal con validación en la calculadora Tkinter #32)
• Botones Clear y Backspace (Agregar funcionalidad: Botones Clear y Backspace #28, feat: implementar botones C y ⌫ con su funcionalidad correspondiente #34)
• Documentación y guía de usuario (Documentación: Guía de usuario para GUI #24, docs — Añadir guía de usuario para la GUI #40)

---

🎉 Celebración

Este release marca un hito importante en el proyecto:

• ✅ De CLI simple → Aplicación completa con GUI
• ✅ De tests básicos → Testing robusto automatizado
• ✅ De desarrollo manual → Pipeline de CI/CD
• ✅ De documentación básica → Documentación profesional

¡60+ commits, 24+ PRs, 16 issues completadas!

Gracias a todo el equipo por demostrar excelentes prácticas de:

• 🤝 Colaboración en equipo
• 📝 Code reviews constructivas
• 🧪 Testing riguroso
• 📖 Documentación clara
• 🔄 Git Flow profesional

---

📚 Comparación de Versiones

v1.0.0 (2025-11-04)
└── Calculadora CLI básica
    ├── Operaciones matemáticas básicas
    ├── Funciones: abs, max, min
    └── Tests unitarios simples

v2.0.0 (2025-11-28) ← ESTE RELEASE
└── Aplicación completa con GUI
    ├── Todo lo de v1.0.0
    ├── Interfaz gráfica con tkinter
    ├── Soporte de teclado completo
    ├── Testing automatizado de GUI
    ├── CI/CD con GitHub Actions
    └── Documentación profesional

---

👥 Revisores Sugeridos

@Jhos3ph @alexricardotapiacarita-ai

Petición Final:

Este es el merge oficial del release v2.0.0 a main. Por favor:

• ✅ Revisar que todo esté correcto
• ✅ Verificar que las issues listadas sean las correctas
• ✅ Confirmar que están listos para el release
• ✅ Aprobar cuando estén de acuerdo

Una vez mergeado, procederemos a crear el tag y el GitHub Release oficial.

---

🚀 Release v2.0.0 - ¡El proyecto evoluciona! ✨

---

Branch: main ← dev
Tipo: Major Release
Versión: v2.0.0
Fecha: 2025-11-28

[alexricardotapiacarita-ai]

esta bien

[Jhos3ph]

these changes are amazig