AlarmaSueño es una aplicación de escritorio para Windows, desarrollada en C# con Windows Forms, cuyo objetivo es mejorar la rutina de sueño mediante una alarma inteligente, frases motivacionales, ejecución en segundo plano y una arquitectura sólida y mantenible.
El proyecto aplica Clean Architecture, principios SOLID e Inyección de Dependencias (DI), con énfasis en persistencia de estado, confiabilidad, experiencia de usuario e integración profunda con el sistema operativo.
📦 Distribución: el proyecto se entrega como archivo ejecutable (.exe) listo para usar, disponible en la sección Releases del repositorio.
- ✨ Características
- 🏗️ Arquitectura
- ⚙️ Conceptos Clave
- 🧪 Pruebas Unitarias
- 📸 Capturas de Pantalla
- 📋 Requisitos
- 🚀 Uso
- 📦 Distribución Profesional
- 🛡️ Seguridad y Buenas Prácticas
- 🤝 Contribuciones
- 👤 Autor
- 📄 Licencia
- ⏰ Ejecución automática de alarmas mediante el Programador de Tareas de Windows
- 💬 Frases motivacionales dinámicas al activarse la alarma
- 🔔 Reproducción de audio integrada (NAudio)
- 💤 Función posponer (Snooze) configurable
- 🔒 Sistema de Bloqueo de configuración para evitar cambios accidentales
- 🚀 Inicio automático con Windows (opcional)
- 🧠 Persistencia completa del estado (alarma, bloqueo y snooze sobreviven reinicios)
- 🌐 Soporte multi‑idioma (I18n)
- 🖥️ Ejecución en segundo plano con icono en la bandeja del sistema (Tray Icon)
- 🔁 Ejecución de una sola instancia de la aplicación
- 🎨 Interfaz Moderna con Botones Personalizados:
- Efectos visuales de presión sincronizados (Imagen + Texto).
- Centrado óptico de precisión en el texto de los botones.
- Diálogos personalizados y logotipo dinámico.
- 🛡️ Firma Digital: Ejecutable firmado digitalmente para garantizar la integridad y autoría.
El proyecto está organizada siguiendo Clean Architecture, garantizando separación de responsabilidades y facilidad de mantenimiento:
AlarmaSueño
│
├── AlarmaSueño.Core (.NET 9)
│ ├── AlarmManager
│ ├── SettingsManager
│ ├── PhraseProvider
│ ├── AudioPlayer
│ ├── TrayIconManager
│ ├── WindowsIntegration
│ └── Interfaces
│
├── AlarmaSueño.UI (WinForms .NET 9)
│ ├── MainForm
│ ├── Dialogs (ConfirmationDialog, AboutForm, etc.)
│ ├── ResourceLoader
│ └── Custom Controls (PressableImageButton, etc.)
│
├── AlarmaSueño.Infrastructure
│ ├── Persistencia basada en archivos
│ ├── Logging
│ └── Integración con el sistema operativo
│
└── Assets / Resources
├── Imágenes
├── Iconos
└── Audio
- ✔️ Inyección de dependencias con Microsoft.Extensions.DependencyInjection
- ✔️ UI desacoplada de la lógica de negocio
- ✔️ Preparado para futuras migraciones WPF / MAUI
🔁 Persistencia del Estado
- El estado de snooze se conserva incluso si la aplicación se cierra o el sistema se reinicia.
- El bloqueo de la alarma se mantiene activo hasta que el usuario lo deshabilita explícitamente.
🖥️ Integración con Windows
- Uso del Programador de Tareas de Windows para garantizar la ejecución de la alarma.
- Icono en la bandeja del sistema para restaurar o cerrar la aplicación.
- Prevención de múltiples instancias mediante mensajería de Windows.
🔒 Lógica de Bloqueo y Posposición
- El usuario puede bloquear la configuración de la alarma.
- Durante el snooze, toda la interfaz queda deshabilitada hasta que expire.
El proyecto incluye pruebas unitarias utilizando Moq para validar la lógica crítica:
AlarmManagerSettingsManagerPhraseProvider
- ✔️ Todas las pruebas se ejecutan correctamente.
- ✔️ Sin dependencias directas de UI.
- ✔️ Enfoque en confiabilidad y regresión.
- Sistema Operativo: Windows 10 u 11.
- .NET Runtime:
- No es necesario instalar nada. El ejecutable es autocontenido y portable.
- Ejecuta
AlarmaSueño.exe. - Configura la hora de la alarma.
- (Opcional) Bloquea la configuración.
- Se cierra o minimiza la aplicación automáticamente (continúa en segundo plano).
- Al activarse la alarma:
- Se reproduce el audio.
- Se muestra una frase motivacional.
- Puedes cerrar o posponer la alarma.
- Ve a la sección Releases del repositorio: 👉 https://github.com/Pablitus666/Sleep---Alarm/releases
- Descarga el archivo
AlarmaSueño.exe.
📌 Características del Ejecutable:
- Portable: Un único archivo sin carpetas externas.
- Autocontenido: Incluye el runtime de .NET 9.
- Firmado Digitalmente: Certificado de autoría Digital.
- Sin PDB: Versión optimizada de producción.
- Manejo seguro de excepciones con logging
- Liberación correcta de recursos (
Dispose) - Separación estricta de capas
- Sin rutas del sistema codificadas de forma rígida
- Código preparado para pruebas y refactorización
Las contribuciones son bienvenidas:
- Fork del repositorio
- Crear rama feature / fix
- Enviar un Pull Request bien documentado
Walter Pablo Téllez Ayala
Software Developer
📍 Bolivia 🇧🇴 
📧 pharmakoz@gmail.com
© 2026 — AlarmaSueño - Tool
Este proyecto está licenciado bajo la GNU General Public License v3.0 (GPLv3)
Consulta el archivo LICENSE para más información. Más detalles en: https://www.gnu.org/licenses/gpl-3.0.html