Vitalist es una aplicación móvil Android diseñada para conectar a personas que necesitan asistencia con voluntarios dispuestos a ayudar. Esta plataforma facilita la creación y gestión de solicitudes de ayuda, estableciendo un sistema basado en la comunidad donde los usuarios pueden asistir a quienes lo necesitan.
- Sistema de doble rol: Usuarios pueden registrarse como solicitantes de ayuda o como asistentes voluntarios
- Creación y gestión de solicitudes: Interfaz intuitiva para crear, aceptar y completar tareas
- Sistema de niveles y puntuación: Los usuarios acumulan puntos por completar tareas y suben de nivel
- Estadísticas visuales: Gráficos semanales que muestran la actividad del usuario
- Perfil personalizado: Gestión completa del perfil de usuario
- Botón de emergencia: Acceso rápido a servicios de emergencia (061)
- Historial de actividad: Registro de todas las actividades realizadas
- Kotlin - Lenguaje de programación principal
- Jetpack Compose - Framework moderno para UI
- Firebase Authentication - Gestión de usuarios, verificación de correo y restablecimiento de contraseña
- Firestore - Base de datos NoSQL
- Material Design 3 - Diseño de interfaz moderno
- Navigation Compose - Navegación entre pantallas
- Compose Charts - Visualización de datos estadísticos
La aplicación sigue una arquitectura MVVM (Model-View-ViewModel) con los siguientes componentes:
- Modelo: Clases de datos como
User,Request,Stats, yActivity - Vista: Pantallas Compose como
HomeScreen,ProfileInfoScreen,TasksListScreen, etc. - ViewModel: Lógica de negocio implementada en
FirestoreDataSource
- Android SDK 24+
- Dispositivo Android con versión 7.0 (Nougat) o superior
- Permisos: CALL_PHONE (para la función de emergencia)
- Clona el repositorio:
git clone --depth 1 [email protected]:LixFerox/app-tfg-2024.git- Abre el proyecto con Android Studio
- Configura tu archivo google-services.json para Firebase
- Ejecuta la aplicación en un emulador o dispositivo físico
- Login/Registro: Autenticación de usuarios
- Home: Pantalla principal con resumen de actividad
- Búsqueda: Explorar solicitudes de ayuda disponibles
- Tareas: Gestión de tareas aceptadas
- Estadísticas: Análisis de actividad y nivel
- Perfil: Información y configuración del usuario
- Ayudantes: Usuarios que ofrecen asistencia y aceptan tareas
- Solicitantes: Usuarios que crean solicitudes de ayuda
- Web informativa: http://vitalist.lixferox.es
Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Este proyecto fue desarrollado como Trabajo Final de Grado (TFG) para el curso académico 2024-2025.