Motívame - Tu Compañero de Motivación Diaria

📱 Descripción

Motívame es una aplicación Android moderna diseñada para ayudarte a mantener la motivación en tus tareas pendientes. La app te permite configurar recordatorios diarios personalizados con tus metas específicas, ayudándote a visualizar el "por qué" detrás de cada tarea.

✨ Características Principales

• 📝 Gestión de Tareas: Crea, edita y elimina tareas pendientes fácilmente
• 🎯 Definición de Metas: Asocia múltiples objetivos a cada tarea para recordar por qué es importante
• 🔔 Notificaciones Diarias: Recibe recordatorios automáticos todos los días a las 9:00 AM
• 🔊 Alertas Personalizables: Configura sonido y vibración según tus preferencias
• ⏯️ Control de Tareas: Activa o pausa tareas según tu conveniencia
• 🎨 Diseño Moderno: Interfaz Material Design 3 con colores vibrantes y motivadores
• 📊 Tareas Predeterminadas: Comienza con ejemplos inspiradores o crea las tuyas propias

🚀 Funcionalidades Técnicas

Arquitectura

• MVVM (Model-View-ViewModel): Separación clara de responsabilidades
• Jetpack Compose: UI moderna y declarativa
• WorkManager: Tareas programadas en segundo plano confiables
• DataStore: Persistencia de datos ligera y eficiente
• Kotlin Coroutines: Programación asíncrona fluida

Componentes Principales

1. Pantalla Principal

• Lista de tareas activas y pausadas
• Tarjetas visuales con gradientes
• Indicadores de estado (activo/pausado)
• Navegación rápida a configuración y agregar tareas

2. Agregar Tareas

• Campo de título de tarea
• Agregar múltiples metas personalizadas
• Validación de campos
• Interfaz intuitiva con iconos descriptivos

3. Configuración

• Activar/desactivar notificaciones
• Control de sonido
• Probar notificaciones en tiempo real
• Solicitud de permisos en Android 13+

Sistema de Notificaciones

La aplicación utiliza un sistema de notificaciones inteligente:

• Canal de Alta Prioridad: Garantiza que las notificaciones sean visibles
• Vibración Personalizada: Patrón distintivo para llamar la atención
• Mensajes Motivacionales: Cada notificación muestra una meta aleatoria de la tarea
• Sonido Configurable: Opción de activar/desactivar sonido de notificación

WorkManager - Recordatorios Diarios

• Ejecuta tareas diarias a las 9:00 AM
• Persiste incluso después de reiniciar el dispositivo
• Optimizado para el consumo de batería
• No requiere conexión a Internet

📦 Dependencias

// Core Android
androidx.core:core-ktx:1.10.1
androidx.lifecycle:lifecycle-runtime-ktx:2.6.1
androidx.activity:activity-compose:1.8.0

// Compose
androidx.compose:compose-bom:2024.09.00
androidx.compose.material3:material3
androidx.compose.material:material-icons-extended:1.5.4

// Architecture Components
androidx.lifecycle:lifecycle-viewmodel-compose:2.6.1
androidx.work:work-runtime-ktx:2.9.0
androidx.datastore:datastore-preferences:1.0.0

🔧 Requisitos

• Android SDK 24+ (Android 7.0 Nougat o superior)
• Target SDK 36
• Kotlin 2.0.21
• Gradle 9.0.1

🎨 Diseño

Paleta de Colores

• Primary: Indigo vibrante (#6366F1)
• Secondary: Rosa motivador (#EC4899)
• Tertiary: Púrpura (#8B5CF6)
• Success: Verde (#10B981)
• Error: Rojo (#EF4444)

Tipografía

• Fuentes Material Design 3
• Énfasis en títulos grandes y legibles
• Texto secundario con contraste óptimo

📱 Permisos

La aplicación solicita los siguientes permisos:

• POST_NOTIFICATIONS (Android 13+): Para mostrar recordatorios
• VIBRATE: Para alertas con vibración
• RECEIVE_BOOT_COMPLETED: Para mantener recordatorios después de reiniciar

🔄 Flujo de la Aplicación

1. Inicio: Pantalla principal con tareas predeterminadas
2. Agregar Tarea: El usuario crea una nueva tarea con sus metas
3. Configuración: Personaliza notificaciones y sonido
4. Recordatorios Automáticos: WorkManager envía notificaciones diarias
5. Interacción: Usuario puede pausar, reanudar o eliminar tareas

🏗️ Estructura del Proyecto

app/src/main/java/com/manalejandro/motivame/
├── data/
│   ├── Task.kt                  # Modelo de datos
│   └── TaskRepository.kt        # Repositorio de persistencia
├── notifications/
│   └── NotificationHelper.kt    # Gestión de notificaciones
├── ui/
│   ├── screens/
│   │   ├── MainScreen.kt        # Pantalla principal
│   │   ├── AddTaskScreen.kt     # Pantalla agregar tarea
│   │   └── SettingsScreen.kt    # Pantalla configuración
│   ├── theme/
│   │   ├── Color.kt             # Definición de colores
│   │   ├── Theme.kt             # Tema de la aplicación
│   │   └── Type.kt              # Tipografía
│   └── viewmodel/
│       └── TaskViewModel.kt     # ViewModel principal
├── worker/
│   └── DailyReminderWorker.kt   # Worker para recordatorios
└── MainActivity.kt              # Actividad principal

🚀 Compilación

# Compilar versión de depuración
./gradlew assembleDebug

# Compilar versión de lanzamiento
./gradlew assembleRelease

# Ejecutar tests
./gradlew test

# Compilar e instalar
./gradlew installDebug

💡 Casos de Uso

1. Estudiante: Recordatorios para estudiar materias específicas con metas académicas
2. Fitness: Mantener rutina de ejercicio con objetivos de salud
3. Desarrollo Personal: Hábitos diarios como lectura, meditación, etc.
4. Productividad: Tareas profesionales con objetivos de carrera

📝 Tareas Predeterminadas

La app incluye 3 tareas de ejemplo:

1. Hacer ejercicio

   • Mejorar salud cardiovascular
   • Sentirse más energético
   • Alcanzar peso ideal

2. Estudiar inglés

   • Mejores oportunidades laborales
   • Viajar sin limitaciones
   • Expandir conocimiento

3. Leer 30 minutos

   • Desarrollar hábito de lectura
   • Aprender cosas nuevas
   • Reducir tiempo en redes sociales

🎯 Roadmap Futuro

• Estadísticas de cumplimiento
• Múltiples recordatorios por día
• Widgets de pantalla de inicio
• Compartir progreso
• Temas personalizables
• Backup en la nube
• Recordatorios inteligentes basados en ubicación

👨‍💻 Autor

Desarrollado con ❤️ para ayudar a las personas a mantener su motivación

📄 Licencia

Este proyecto es de código abierto y está disponible bajo la licencia MIT.

---

¡Mantente motivado y alcanza tus metas! 🚀