Cómo Funciona

GitScrum Studio para Android es una app nativa construida con React Native y Expo. Se conecta a la misma API de GitScrum utilizada por la aplicación web y la extensión de VS Code, asegurando que todas las plataformas se mantengan perfectamente sincronizadas.

Arquitectura de navegación

La app usa un diseño basado en pestañas con un menú lateral para acciones secundarias.

Pestañas inferiores

Dos pestañas están siempre visibles en la parte inferior de la pantalla:

Pantallas adicionales (Tareas, Detalle del Proyecto) se acceden tocando elementos en las listas — se apilan en la navegación desde las pestañas.

Menú lateral

Desliza desde el borde izquierdo o toca el ícono de menú para abrir el menú lateral. Contiene:

Acciones rápidas:

• Crear espacio de trabajo
• Crear proyecto
• Crear tarea

Herramientas:

• Notificaciones
• NoteVault

Preferencias:

• Selector de tema
• Selector de idioma
• Selector de zona horaria
• Perfil
• Workspace Selector

Flujo de datos

Autenticación

Cuando inicias sesión (vía email, GitHub, Google o Facebook), la app almacena tu token de autenticación de forma segura usando AsyncStorage. El token persiste entre sesiones — permaneces conectado hasta que cierres sesión explícitamente.

Conexión con la API

Cada pantalla obtiene datos de la API de GitScrum. Proyectos, tareas, entradas de tiempo, notas y notificaciones provienen de los mismos endpoints usados por la aplicación web. Los cambios que haces en la app móvil son visibles inmediatamente en otras plataformas.

Sincronización en tiempo real

La app mantiene una conexión WebSocket vía Laravel Reverb (protocolo Pusher). Esto permite actualizaciones en vivo sin refrescar manualmente:

• Eventos de espacio de trabajo: La creación y eliminación de proyectos aparecen instantáneamente en la pantalla principal
• Eventos de tareas: Movimientos, actualizaciones, creaciones y eliminaciones de tareas se sincronizan en todas las sesiones abiertas
• Eventos de timer: Inicios, detenciones y entradas de tiempo se transmiten a todos los clientes conectados
• Notificaciones: Las nuevas notificaciones llegan en tiempo real

Deslizar para refrescar

Cada pantalla de lista soporta deslizar para refrescar y recargar datos manualmente. Desliza hacia abajo desde la parte superior de cualquier lista para forzar una recarga.

Scroll infinito

Las listas largas (proyectos, tareas, notas, notificaciones) usan paginación con scroll infinito. A medida que te desplazas hacia abajo, las páginas adicionales se cargan automáticamente.

Arquitectura de pantallas

La app sigue una separación limpia:

• Archivos de rutas en app/ definen la estructura de navegación
• Componentes de pantalla en src/components/screens/ contienen la lógica de UI
• Modales en src/components/modals/ manejan las superposiciones (detener timer, selector de flujo de trabajo, selector de miembros)
• Servicios en src/services/ gestionan toda la comunicación con la API
• Hooks proporcionan estado compartido (autenticación, tema, traducciones, datos del espacio de trabajo)

Sistema de temas

La app incluye 54 temas organizados en 23 grupos. Cada tema define 28 tokens de color que cubren fondos, superficies, texto, acentos y colores semánticos (éxito, advertencia, error).

El sistema de temas soporta tanto temas oscuros como claros. Una insignia en cada tema del selector indica si es una variante oscura o clara.

Los temas se aplican globalmente e instantáneamente — cambiar un tema actualiza todas las pantallas inmediatamente sin necesidad de reiniciar.

Sistema de idiomas

La app soporta cuatro idiomas: English, Português, Español y Français. La detección de idioma es automática en el primer inicio (basada en el idioma de tu dispositivo) con inglés como respaldo.

Puedes cambiar el idioma en cualquier momento desde el menú lateral. La preferencia se guarda localmente y se sincroniza con tu cuenta de GitScrum.

Auto-refresco

Los paneles se refrescan automáticamente vía la conexión WebSocket. Cuando la app recibe un evento en tiempo real, la pantalla relevante se actualiza sin ninguna acción del usuario. Para refrescar manualmente, usa deslizar para refrescar en cualquier lista.

Consejos avanzados (cuando te sientas cómodo)

• Acceso rápido a proyectos: La pestaña Home muestra proyectos de tu espacio de trabajo actual. Cambia de espacio de trabajo desde el menú lateral para acceder a diferentes conjuntos de proyectos instantáneamente.

• Conciencia del timer: La pestaña Time Tracking siempre muestra tu timer activo. Úsala como verificación rápida para ver en qué estás trabajando.

• Atajos del menú lateral: El atajo Crear Tarea del menú lateral te permite capturar tareas rápidamente sin navegar a un proyecto específico primero.

Permisos

La app respeta los permisos de tu cuenta de GitScrum:

• Agency Owners y Managers: Acceso completo a todas las funcionalidades, configuraciones de proyecto y datos del equipo
• Developers: Pueden gestionar tareas, registrar tiempo y usar herramientas de colaboración
• Clients: Solo acceso de lectura (si se les otorgó acceso al proyecto)

Si una funcionalidad aparece deshabilitada o una pantalla muestra datos limitados, verifica tu rol en el proyecto en la aplicación web de GitScrum.

Cómo reportar un problema o solicitar una funcionalidad

Si la app se comporta de manera inesperada o tienes sugerencias de mejoras, envía tu retroalimentación a través de GitScrum Studio.

En la barra lateral de la aplicación web, haz clic en Support Tickets y abre un ticket describiendo tu experiencia.