Anexos - ISPC-WEB-2025/TodoStock-AppMovil GitHub Wiki

📑 Anexo II: Diagrama de Navegabilidad y Evidencia Visual (#TK102 / #TK32)

Proyecto: TodoStock Mobile — Android Nativo
Estándar: IEEE 830-1998 — Anexo II
Responsable de Documentación: Octavio Arnaudo


📸 Evidencia Visual e Interfaces del Sistema (#TK32 / #TK102)

🔹 Sprint 1 — Interfaces Base del MVP

1. Pantalla de Bienvenida (SplashActivity) y Login (LoginActivity)

  • SplashActivity: Pantalla inicial con isotipo de TodoStock y temporizador automático de 3 segundos hacia Login.
  • LoginActivity: Formulario de inicio de sesión con validación de email/password, consumo de API JWT (POST /api/usuarios/login/) y enlace a registro.
Splash Activity Login Activity
Splash Activity
(SplashActivity)
Login Activity
(LoginActivity - TK01/05)

2. Menú Principal (MenuPrincipalActivity) y Selección de Sucursal (SeleccionSucursalActivity)

  • MenuPrincipalActivity: Hub operativo con banner de usuario activo, insignias de rol (Administrador vs Empleado) y accesos directos a las funciones.
  • SeleccionSucursalActivity: Listado dinámico de sucursales integradas con RecyclerView. Al seleccionar una sucursal, transmite sucursal_id hacia la pantalla de stock.
Menú Principal Selección de Sucursal
Menu Principal
(MenuPrincipalActivity - TK02/114)
Sucursales
(SeleccionSucursalActivity - TK09/12)

3. Gestión de Stock (GestionStockActivity) y Movimientos (MovimientosActivity)

  • GestionStockActivity: Tarjetas de catálogo de productos con filtrado por sucursal, cálculo de existencia y alerta resaltada por stock mínimo.
  • MovimientosActivity: Formulario de transferencias de inventario entre sucursales origen y destino con validación de stock disponible.
Gestión de Stock Movimientos de Stock Detalle de Movimiento
Inventario
(GestionStockActivity - TK13/16/17)
Movimientos
(MovimientosActivity - TK24/27)
Detalle Movimiento
(MovimientosActivity - Detalle)

🔹 Sprint 2 — Pantallas Nuevas del Incremento (#TK102)

4. Formulario de Registro de Usuarios (RegistroActivity - #TK34) y Términos (#TK52)

  • RegistroActivity: Permite la creación de nuevas cuentas completando Nombre, Email, DNI, Fecha de Nacimiento (entrada directa por teclado con máscara), Contraseña y Aceptación explícita de Términos y Condiciones.
  • TerminosActivity: Presenta el marco normativo de privacidad y la opción de arrepentimiento/baja de cuenta (Ley 25.326).
Registro Activity (Formulario) Términos & Condiciones (Pantalla)
Registro Formulario
(RegistroActivity - TK34)
Terminos y Condiciones
(TerminosActivity - TK52)

5. Catálogo, Alta y Edición de Productos (#TK21/#TK23/#TK38/#TK39)

  • Catálogo Completo de Productos: Módulo de listado con barra de búsqueda en tiempo real, filtrado e inhabilitación lógica (activo = False - ADR-0010).
  • Carga y Alta de Producto: Formulario administrativo para dar de alta nuevos artículos seleccionando categoría desde desplegable dinámico.
  • Edición de Producto: Edición parcial (PATCH /api/inventario/productos/{id}/) activada con EXTRA_ID_PRODUCTO en CargaProductoActivity.
Catálogo & Búsqueda de Productos Carga de Producto (Formulario) Edición de Producto
Catálogo de Productos
(CatálogoProductos - TK39)
Carga de Producto
(CargaProductoActivity - TK21/23)
Edición de Producto
(EdicionProducto - TK38/39)

6. Contacto Institucional y Soporte (ContactoActivity - #TK18/#TK19/#TK42)

  • ContactoActivity: Formulario de atención y reporte de incidencias para usuarios. Permite enviar Nombre, Email, Asunto y Mensaje al equipo de soporte.
  • Manejo de Errores y Feedback: Valida entradas mediante Validadores.java y envía la consulta vía POST /api/contacto/ mostrando alertas tipo Toast.
Formulario de Contacto y Soporte
Contacto Activity
(ContactoActivity - TK18/19/42)

7. Perfil de Usuario (PerfilActivity) y Gestión de Credenciales (EditarPerfilActivity - #TK94/#TK95)

  • PerfilActivity: Muestra el perfil del usuario autenticado, su rol en el sistema (SuperAdmin, Administrador o Empleado) y opciones de configuración de la cuenta.
  • EditarPerfilActivity / Credenciales: Permite la actualización de datos personales, cambio de contraseña y gestión de credenciales.
Perfil de Usuario Gestión de Credenciales / Clave
Perfil Activity
(PerfilActivity - TK94/95)
Gestión de Credenciales
(EditarPerfilActivity - TK94/95)

8. Administración de Usuarios (#TK36/#TK37) y Registros Pendientes (#TK109)

  • Administración y Listado de Usuarios (UsuariosActivosFragment): Panel administrativo para listar, modificar rol y gestionar cuentas de empleados y administradores con diálogo modal de edición/baja.
  • Cargar Usuario: Formulario de alta y edición de datos de usuario desde la administración.
  • Aprobación de Usuarios Pendientes (CargarUsuarioFragment): Pantalla de revisión y aprobación de registros pendientes según la jerarquía de roles (SuperAdmin aprueba Admins; Admin aprueba Empleados).
Listado & Edición de Usuarios Cargar Usuario (Formulario) Registros Pendientes
Listado Usuarios
(GestionUsuarios - TK36/37)
Cargar Usuario
(CargarUsuario - TK36)
Registros Pendientes
(AprobacionPendientes - TK109)

9. Ayuda Visual, Información del Sistema y Video Demostrativo (#TK40)

  • AyudaActivity (Instructivo Visual): Guía interactiva de usuario que explica el flujo de navegación, consulta de stock, traslados entre sucursales y gestión de productos.
  • Información del Sistema: Muestra la versión compilada de TodoStock Mobile, licencias de código abierto, entorno del servidor en Alwaysdata y soporte técnico.
  • Video Demostrativo de Ayuda: Demostración interactiva de navegación y ayuda integrada en la pantalla.
Instructivo de Ayuda Información & Créditos Video Demostrativo
Ayuda Visual
(AyudaActivity - TK40)
Información de la App
(AcercaDe / Info - TK40)
Video Demostrativo Ayuda
(Video Ayuda - TK40)

📊 4. Matriz Resumen de Cobertura de Pantallas del MVP

# Activity / Pantalla Sprint Funcionalidad / US Estado Visual & Documental
1 SplashActivity Sprint 1 Inicio y Carga de App ✅ Capturada y Documentada
2 LoginActivity Sprint 1 / 2 Autenticación JWT / US01 ✅ Capturada y Documentada
3 RegistroActivity Sprint 2 Registro de Usuario / US17 ✅ Capturada y Documentada
4 MenuPrincipalActivity Sprint 1 / 2 Hub Navegación / US01 ✅ Capturada y Documentada
5 SeleccionSucursalActivity Sprint 1 / 2 Selección Sucursal / US02 ✅ Capturada y Documentada
6 GestionStockActivity Sprint 1 / 2 Inventario y Alertas / US03 ✅ Capturada y Documentada
7 CargaProductoActivity Sprint 1 / 2 Alta y Edición de Productos / US04 ✅ Capturada y Documentada
8 Catálogo de Productos Sprint 2 Búsqueda, Edición y Baja Lógica / US09 ✅ Capturada y Documentada
9 MovimientosActivity Sprint 1 / 2 Traslado de Stock / US05 ✅ Capturada y Documentada
10 ContactoActivity Sprint 1 / 2 Soporte e Incidencias / US06 ✅ Capturada y Documentada
11 PerfilActivity Sprint 2 Perfil de Usuario ✅ Capturada y Documentada
12 EditarPerfilActivity Sprint 2 Gestión de Credenciales ✅ Capturada y Documentada
13 UsuariosActivosFragment Sprint 2 Gestión, Edición y Baja de Usuarios (#TK37) ✅ Capturada y Documentada
14 CargarUsuarioFragment Sprint 2 Aprobación de Usuarios Pendientes (#TK109) ✅ Capturada y Documentada
15 AyudaActivity Sprint 2 Instructivo de Ayuda e Info (#TK40) ✅ Capturada y Documentada
16 MenuStockActivity Sprint 2 Hub Intermedio de Gestión de Stock (#TK113) ✅ Documentada (PR #276)
17 MenuMovimientosActivity Sprint 2 Hub Intermedio de Movimientos (#TK113) ✅ Documentada (PR #276)

📑 5. Log de Evidencias Integrado

📽️ 5.1 Registro de Grabaciones de Demostración en Ejecución

  • Video Demostrativo MVP Sprint 1: Demostración en emulador/dispositivo físico del flujo de navegación base, validación de formularios y 7 pantallas principales (Ver Video Sprint 1).
  • Video Demostrativo MVP Sprint 2: Demostración del incremento completo: autenticación JWT con SesionManager, registro de usuarios con validaciones +18, perfil y baja voluntaria, gestión de stock en tiempo real, traslados entre sucursales y suite de pruebas unitarias (Ver Video Sprint 2).
  • Video Demostrativo de Tutorial (#TK40): Video tutorial e instructivo de ayuda integrado en la app (Ver Video Tutorial).
  • Versión Oficial Release v1.0.0 en GitHub: Publicación oficial del empaquetado del APK y tag del proyecto (Ver Release v1.0.0).

Volver al Home | Ver Diagrama de Navegabilidad Detallado

⚠️ **GitHub.com Fallback** ⚠️