Azcuy App - Proyecto Móvil | Portafolio de Nicolás

Resumen

Que es

Azcuy App es una aplicación móvil desarrollada en Flutter para consultar stock de materiales por obra y gestionar solicitudes de transferencia entre obras. El MVP implementa un flujo operativo para jefes de obra y administradores, con persistencia en Supabase y separacion de roles.

Enfoque académico

Proyecto académico de ORT desarrollado con Flutter y Dart.
App móvil-first con login, dashboard, solicitudes y panel administrativo.
MVP funcional completado para el cierre académico con Supabase configurado.

Relación con Azcuy Planix

La app está relacionada con Azcuy Planix como complemento móvil/paralelo del proyecto final. Mientras Azcuy Planix trabaja el control de obras desde una mirada más amplia de cashflows, órdenes de compra, cobertura y reportes, Azcuy App lleva al celular un flujo operativo puntual: consulta de stock por obra, solicitud de materiales, aprobación administrativa y recepción en destino.

Ambos proyectos comparten el dominio de materiales y obras, y usan Supabase como pieza central de autenticación y datos.

Problema que resuelve

En una organización con varias obras, el control de materiales puede volverse poco claro: una obra puede tener faltantes mientras otra conserva stock disponible. La app centraliza la consulta de stock por obra y ordena el pedido de materiales mediante solicitudes con estado, origen, destino y responsable.

Alcance de la app

Implementado

Login con Supabase Auth y restauracion de sesión valida.
Roles de Jefe de Obra y Administrador.
Dashboard de stock para jefe de obra.
Consulta, búsqueda, filtros y paginación de materiales.
Creacion de solicitudes desde materiales con stock bajo o crítico.
Aprobación y rechazo de solicitudes por administrador.
Marcado de solicitud como recibida por jefe de obra.
Historial de movimientos de stock por obra.
Gestión administrativa de materiales, usuarios, obras y stock por obra.
Esquema SQL, seed y politicas RLS para Supabase.

Alcance del MVP académico

Aplicación funcional para consultar stock y gestionar solicitudes entre obras.
Flujos diferenciados para Jefe de Obra y Administrador.
Persistencia de materiales, obras, solicitudes e historial mediante Supabase.
Proyecto presentado como MVP académico con capturas de las pantallas implementadas.

Arquitectura

La app está construida con Flutter y Dart. Usa Provider y ChangeNotifier para el estado, Supabase Flutter para autenticación y datos, flutter_dotenv para variables de entorno y Material Design para la interfaz.

Estructura por capas

lib/
|- core/
|- datasource/
|  `- repositories/
|- domain/
`- presentation/
   |- providers/
   |- screens/
   `- widgets/
supabase/
assets/
test/

Responsabilidades

core: rutas, tema visual y constantes.
datasource: cliente Supabase y repositorios.
domain: entidades, enums y reglas simples de dominio.
presentation: providers, pantallas y widgets reutilizables.
supabase: scripts SQL para schema, seed, Auth demo y RLS.

Roles y flujo funcional

Jefe de Obra

Inicia sesión y ve su dashboard de stock.
Consulta solo materiales asociados a su obra asignada.
Busca y filtra por texto, material y estado de stock.
Crea solicitudes para materiales con estado bajo o crítico.
Elige una obra origen con stock normal disponible.
Consulta estado de pedidos y motivo de rechazo si existe.
Marca una solicitud aprobada como recibida.
Consulta historial de movimientos de stock de su obra.

Administrador

Accede al panel administrador.
Ve el listado completo y detalle de solicitudes.
Aprueba solicitudes pendientes.
Rechaza solicitudes pendientes con comentario opcional.
Gestiona materiales, usuarios, obras y stock por obra.
No marca solicitudes como recibidas desde el flujo actual.

Flujo general

El usuario ingresa a la app y pasa por Splash.
La app intenta restaurar una sesión de Supabase.
Si no hay sesión valida, muestra Login.
Al iniciar sesión, obtiene el perfil desde la tabla de usuarios.
Según el rol, navega al Dashboard del Jefe de Obra o al Panel Administrador.
El jefe crea una solicitud para un material bajo o crítico.
El administrador aprueba o rechaza la solicitud.
Si se aprueba, se descuenta stock en origen y se registra historial.
El jefe marca el pedido como recibido y se suma stock en destino.

Modulos principales

Splash y Login

Restauracion de sesión, login con Supabase Auth y carga del perfil de usuario.

Dashboard Stock

Resumen de materiales totales, bajos y criticos para el jefe de obra.

Materiales

Consulta, búsqueda, filtros, paginación y cards con estado visual de stock.

Crear Solicitud

Pedido de reposicion o transferencia validando cantidad contra stock disponible en origen.

Solicitudes

Listado, filtros por estado/material/texto/rango de fechas, detalle y cambio a recibida.

Historial de Stock

Movimientos de stock de la obra asignada, con filtros por origen del movimiento.

Panel Administrador

Accesos a modulos de gestión y listado de solicitudes recibidas.

Gestión administrativa

ABM de materiales, usuarios, obras y materiales por obra.

Estados

Solicitudes: pendiente, aprobada, rechazada y recibida. Stock: normal, bajo y crítico.

Retos y soluciones

Separar roles operativos y administrativos -> navegación según perfil y pantallas diferenciadas para jefe de obra y administrador.
Evitar pedidos desde obras sin stock suficiente -> selección de origen solo entre obras con stock normal para ese material.
Mantener trazabilidad de stock -> historial de movimientos al aprobar solicitudes y al marcarlas como recibidas.
Ordenar transiciones de solicitudes -> estados pendiente, aprobada, rechazada y recibida con acciones disponibles según rol.
Persistencia real sin backend propio -> repositorios sobre Supabase para materiales, obras, usuarios, solicitudes e historial.

Galería

Aclaración sobre las capturas: las imágenes corresponden a entornos internos de desarrollo, demostración y pruebas académicas. Los nombres, montos, cantidades, materiales, obras, usuarios, existencias y demás datos visibles fueron utilizados únicamente con fines de prueba y presentación del sistema; no representan información operativa, comercial ni confidencial real. Las marcas, nombres comerciales y elementos identificativos mencionados pertenecen a sus respectivos titulares.

Splash y login

Pantalla splash de Azcuy App con indicador de carga para Stock de Materiales — Splash de la app

Pantalla de login de Azcuy App con campos de email y contraseña — Login

Dashboard y materiales del Jefe de Obra

Dashboard de stock del Jefe de Obra con resumen buscador filtros y materiales — Dashboard de stock

Listado paginado de materiales del Jefe de Obra con estados normal y bajo — Listado de stock

Dashboard del Jefe de Obra filtrado para mostrar materiales con stock bajo — Filtrar stock bajo

Dashboard del Jefe de Obra filtrado para mostrar materiales con stock crítico — Filtrar stock crítico

Dashboard del Jefe de Obra con selector desplegado para elegir un material — Filtrar por material

Creacion de solicitudes

Nueva solicitud del Jefe de Obra con material destino y obra de origen disponible — Crear solicitud

Nueva solicitud bloqueada porque no hay otra obra con stock normal del material — Solicitud sin stock de origen

Estado de solicitudes

Listado de pedidos del Jefe de Obra con solicitudes pendientes y rechazadas — Estado de mis pedidos

Listado de pedidos del Jefe de Obra con solicitudes rechazadas y recibidas — Pedidos resueltos

Detalle de solicitudes

Detalle para el Jefe de Obra de una solicitud rechazada con motivo y fechas — Detalle de solicitud rechazada

Detalle para el Jefe de Obra de una solicitud recibida con origen destino y cantidad — Detalle de solicitud recibida

Detalle para el Jefe de Obra de una solicitud aprobada lista para marcar como recibida — Confirmar recepción

Historial de stock

Panel del Administrador

Solicitudes del Administrador

Listado del Administrador con solicitudes recibidas en distintos estados — Solicitudes recibidas

Detalle de una solicitud pendiente con acciones para aprobarla o rechazarla — Revisar solicitud pendiente

Diálogo del Administrador para indicar el motivo antes de rechazar una solicitud — Rechazar solicitud

Gestión de materiales

Catálogo del Administrador con materiales unidades y acciones de edición y eliminación — Catálogo de materiales

Formulario del Administrador para crear un material con nombre descripción y unidad — Crear material

Diálogo de confirmación para eliminar un material del catálogo — Confirmar eliminación

Formulario del Administrador para modificar los datos de un material existente — Editar material

Gestión de usuarios

Listado de usuarios registrados con roles obras asignadas y acciones de gestión — Usuarios registrados

Formulario para crear un usuario con credenciales y obra asignada — Crear usuario

Selector de obras disponibles durante la creacion de un usuario — Asignar obra al usuario

Formulario para editar el nombre apellido y obra asignada de un usuario — Editar usuario

Selector de obras disponibles durante la edición de un usuario — Cambiar obra asignada

Diálogo de confirmación para eliminar un usuario registrado — Confirmar baja de usuario

Gestión de obras

Listado completo de obras con ubicación responsable y estado actual — Obras registradas

Historial de una obra con creacion cambios de estado y motivo de suspension — Historial de la obra

Gestión de obras filtrada para mostrar solamente las obras activas — Filtrar obras activas

Gestión de obras filtrada para mostrar solamente las obras pendientes — Filtrar obras pendientes

Gestión de obras filtrada para mostrar solamente las obras suspendidas — Filtrar obras suspendidas

Formulario para registrar una nueva obra con ubicación responsable y estado inicial — Crear obra

Selector de responsables disponibles durante la creacion de una obra — Asignar responsable

Stock de materiales por obra

Pantalla inicial para seleccionar una obra y gestionar el stock de sus materiales — Seleccionar obra

Selector desplegado con las obras disponibles para gestionar sus materiales — Elegir obra

Stock de una obra con totales estados cantidades mínimas y acciones por material — Stock de la obra

Diálogo para editar la cantidad disponible de un material en una obra — Editar cantidad de stock

Diálogo para confirmar la eliminación de un material asignado a una obra — Quitar material de la obra

Listado completo del stock por obra con aviso de que todos los materiales están asignados — Catálogo asignado completo

Listado de stock por obra con acción disponible para agregar otro material — Agregar material a la obra

Resultados

Resultado funcional

MVP académico completado con capturas reales de las pantallas implementadas.
Login contra Supabase Auth.
Cierre de sesión desde la aplicación.
Navegación por roles: Jefe de Obra y Administrador.
Consulta de materiales y stock por obra.
Persistencia real mediante repositorios Supabase.

Valor entregado

Solicitudes de materiales con estados controlados.
Aprobación y rechazo de solicitudes por administrador.
Recepción de solicitudes por jefe de obra.
Historial de movimientos de stock.
Efectos sobre stock e historial al aprobar y recibir solicitudes.