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

Bienvenidos a la Wiki de TodoStock Mobile

Este espacio contiene la documentación técnica, legal y de gestión del proyecto TodoStock Mobile, desarrollado por el equipo CodeLab para el Proyecto Integrador II.

👥 Equipo CodeLab

  • Aylén Carolina Bartolino Luna - Scrum Master / Desarrollo Android
  • Candelaria Jazmín Barjollo - Desarrollo Android
  • Miguel Angel Flores Meehan - Desarrollo Android
  • Pedro González - Desarrollo Android
  • Virginia García - Desarrollo Android
  • Octavio Javier Arnaudo García Molina - Documentación, Legales y Testing (QA)

🛠️ Infraestructura Técnica

  • Stack: Java Nativo / Material Design
  • Red: Retrofit / OkHttp (JWT Auth)
  • Persistencia y Cifrado: EncryptedSharedPreferences (JWT Tokens)
  • Backend: Django REST Framework API (MySQL)

📑 Secciones de la Wiki

  1. Guía de Aclaraciones Docente: Orientación para la cátedra, credenciales y arquitectura.
  2. Product Backlog: Historias de Usuario, Tareas Técnicas y Estimaciones (Sprint 1 y Sprint 2).
  3. Gestión Scrum y Ceremonias: Registros de Planning, Dailies, Reviews y Retrospectivas del Sprint 1 y Sprint 2.
  4. Especificación IEEE830: Requerimientos funcionales y no funcionales (Usuarios, Productos, Multimedia y Legislación).
  5. Testing y Calidad: Plan de pruebas, casos de uso, Espresso, MockWebServer, Accesibilidad y reporte de bugs.
  6. Ciberseguridad: Plan de seguridad, tokens JWT y cifrado con EncryptedSharedPreferences.
  7. Protección de Datos y Legislación: Términos y Condiciones, Política de Privacidad (Ley 25.326) y Botón de Arrepentimiento.
  8. Anexo II - IEEE830: Capturas de pantalla, diagramas y evidencias de UI.
  9. Diagrama de Navegabilidad: Flujo entre Activities, mapa de navegación por roles (Administrador / Empleado) y matriz de Intents.
  10. Accesibilidad Mobile y Normativa: Estándares internacionales (WCAG 2.2 / EN 301 549), normativa nacional de Argentina (Disposición ONTI 6/2019, Ley 26.653, Ley 26.378) y auditoría técnica de componentes TalkBack y Touch Targets (#TK75..#TK79, #TK96).

📂 Repositorio Abierto de Evidencias, Release y Bitácora (Acceso Docente)

👉 📦 Versión Oficial Release v1.0.0 (APK & Tag en GitHub)

👉 Acceso Abierto a la Carpeta de Evidencias en Google Drive

👉 Acceso Abierto al video presentación grupal

👉 Acceso Abierto al video de ciberseguridad

👉 Roadmap Interactivo del Proyecto en GitHub Pages (Acceso protegido — Username: CodeLab | Password: RoadMap-2026-Mobile)

📱 Demostraciones en Video (MVP)

🔹 MVP Sprint 1

📹 Ver Video Demostrativo - MVP Sprint 1 (Demostración del flujo de navegación base, autenticación y visualización de las 7 pantallas en emulador / dispositivo físico).

🔹 MVP Sprint 2

📹 Ver Video Demostrativo - MVP Sprint 2 (Demostración del incremento: 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, contacto y suite de pruebas unitarias).

[!TIP] Para el flujo de trabajo en Git, consulte el Product Backlog.

🔍 Análisis Integrado del Sistema (Frontend, Backend e Issues)

El ecosistema TodoStock se compone de tres proyectos interconectados y auditables:

  1. Cliente Móvil Android Nativo (TodoStock-AppMovil): Desarrollado en Java Nativo con Material Design 3, Retrofit, OkHttp con interceptor de tokens JWT y persistencia cifrada mediante EncryptedSharedPreferences (SesionManager).
  2. Submódulo Backend y Documentación Centralizada: Aloja la API REST en Django 6 + Django REST Framework con base de datos MySQL/MariaDB en producción (servidor Alwaysdata https://todostock.alwaysdata.net/api/), la SPA Web en Angular 21 en Vercel, y la carpeta técnica Docs/ con los Registros de Decisiones de Arquitectura (ADR-0001 a ADR-0009) y especificaciones OpenAPI/Swagger.
  3. Gestión e Trazabilidad Ágil: Consolidación auditada de 212 ítems registrados en GitHub (142 Issues y 70 Pull Requests), garantizando trazabilidad completa desde la estimación en Story Points hasta la integración por Pull Request hacia la rama develop y empaquetado final en main.

📊 Resumen Ejecutivo de Trazabilidad del Proyecto

Componente Capa / Módulo Estado de Entrega Artefacto / Submódulo Evidencia e Integración PR
Autenticación & JWT Login, Sesión y Tokens ✅ Operativo SesionManager / AuthInterceptor PRs #49, #50, #160 (ADR-0004)
Registro & Permisos Registro +18, RBAC, Lista y Edición Usuarios ✅ Operativo RegistroActivity, UsuariosActivosFragment PRs #173, #174, #223, #290, #300 (ADR-0008)
Sucursales & Inventario Selección, Stock y Alertas ✅ Operativo SeleccionSucursalActivity / GestionStockActivity PRs #185, #216, #220
Carga & Edición Productos Alta, Edición y Baja Lógica (Admin) ✅ Operativo CargaProductoActivity / InventarioApiService PRs #197, #287, #296 (TK39 / ADR-0010)
Movimientos Atómicos Traslados entre Sucursales ✅ Operativo MovimientosActivity PR #185 (ADR-0002)
Soporte & Legislación Contacto, T&C, Baja ✅ Operativo ContactoActivity / TerminosActivity PRs #192, #195, #217 (Ley 25.326)
Perfil Propio Datos de Usuario y Edición ✅ Operativo PerfilActivity / EditarPerfilActivity PR #180 (ADR-0008)
Quality Assurance Unit, Network & Espresso UI Testing (POM / MockWebServer) ✅ Operativo ValidadoresTest, StockItemTest, LoginViewModelTest, ParseoRespuestasTest, AuthRepositoryTest, LoginFlujoTest PRs #213, #226, #277, #292, #293, #295, #297, #298, #299 (Suite 100% verde)