Anexos - ISPC-WEB-2025/TodoStock-AppMovil GitHub Wiki
Proyecto: TodoStock Mobile — Android Nativo
Estándar: IEEE 830-1998 — Anexo II
Responsable de Documentación: Octavio Arnaudo
- 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 |
|---|---|
![]() (SplashActivity) |
![]() (LoginActivity - TK01/05) |
-
MenuPrincipalActivity: Hub operativo con banner de usuario activo, insignias de rol (
AdministradorvsEmpleado) y accesos directos a las funciones. -
SeleccionSucursalActivity: Listado dinámico de sucursales integradas con
RecyclerView. Al seleccionar una sucursal, transmitesucursal_idhacia la pantalla de stock.
| Menú Principal | Selección de Sucursal |
|---|---|
![]() (MenuPrincipalActivity - TK02/114) |
![]() (SeleccionSucursalActivity - TK09/12) |
- 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 |
|---|---|---|
![]() (GestionStockActivity - TK13/16/17) |
![]() (MovimientosActivity - TK24/27) |
![]() (MovimientosActivity - Detalle) |
- 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) |
|---|---|
![]() (RegistroActivity - TK34) |
![]() (TerminosActivity - TK52) |
-
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 conEXTRA_ID_PRODUCTOenCargaProductoActivity.
| Catálogo & Búsqueda de Productos | Carga de Producto (Formulario) | Edición de Producto |
|---|---|---|
![]() (CatálogoProductos - TK39) |
![]() (CargaProductoActivity - TK21/23) |
![]() (EdicionProducto - TK38/39) |
- 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.javay envía la consulta víaPOST /api/contacto/mostrando alertas tipo Toast.
| Formulario de Contacto y Soporte |
|---|
![]() (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,AdministradoroEmpleado) 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 |
|---|---|
![]() (PerfilActivity - TK94/95) |
![]() (EditarPerfilActivity - TK94/95) |
-
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 |
|---|---|---|
![]() (GestionUsuarios - TK36/37) |
![]() (CargarUsuario - TK36) |
![]() (AprobacionPendientes - TK109) |
- 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 |
|---|---|---|
![]() (AyudaActivity - TK40) |
![]() (AcercaDe / Info - TK40) |
![]() (Video Ayuda - TK40) |
| # | 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) |
- 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).




















