Azcuy Planix - Proyecto Final ORT | Portafolio de Nicolás

Resumen

Que es

Azcuy Planix es una aplicación para planificar, importar y controlar necesidades de materiales de obras. El sistema consolida cashflows, órdenes de compra y reportes de cobertura para ayudar a detectar faltantes, compras parciales y materiales ya cubiertos.

Proyecto final académico de la carrera Analista en Sistemas de ORT, finalizado.
Desarrollado para un cliente vinculado a Azcuy Planix.
MVP funcional validado y aprobado por el cliente.

Para quien

Equipos que gestionan obras con necesidades proyectadas de materiales.
Áreas que trabajan con planillas de cashflow y órdenes de compra.
Usuarios autenticados que necesitan visualizar cobertura, proyecciones y reportes.

Problema que resuelve

En la gestión de obras, la información de materiales, consumos proyectados y órdenes de compra suele quedar dispersa en planillas. Eso dificulta saber que materiales ya tienen cobertura, cuáles están en negociación y cuáles requieren acción antes de afectar el avance de obra.

Azcuy Planix centraliza ese flujo con autenticación, ingesta de archivos, persistencia en Supabase y tableros que contrastan necesidades proyectadas contra compras reales.

Alcance del sistema

Incluido en el MVP

Ingreso de usuarios autenticados con Supabase Auth.
Importación de cashflows desde archivos .xlsx, .xls y .csv.
Importación de órdenes de compra desde .xlsx, .xls, .csv y, en escritorio, .pdf si existe pdftotext.
Persistencia de obras, rubros, materiales, cashflows, OC y detalles en Supabase.
Visualización de cronogramas, base maestra, cobertura y cruce Cashflow vs OC.
Exportación a Excel de cronogramas, base maestra, reportes y proyecciones.
Estado local de materiales en negociación usando shared_preferences.

Alcance del MVP académico

Aplicación funcional para centralizar cashflows, órdenes de compra y datos de materiales.
Tableros para cronogramas, cobertura, cruce de necesidades y compras, y proyecciones.
Importación de archivos y exportación de información para acompanar la gestión.
Proyecto final académico validado y entregado como MVP.

Arquitectura

La aplicación usa Flutter / Dart con una estructura feature-first. El estado se maneja con Riverpod, la navegación protegida con GoRouter y la persistencia remota con Supabase como backend externo, auth, base de datos y storage.

Estructura principal

lib/
|- core/
|- features/
|  |- auth/
|  |- base_maestra/
|  |- compras_estrategicas/
|  |- dashboard/
|  |- ingesta_excel/
|  |- ordenes_compra/
|  |- proyecciones/
|  |- reportes/
|  `- validacion/
`- shared/
assets/
scripts/
test/
web/
windows/

Flujo de datos

El usuario inicia sesión.
Importa cashflows desde planillas.
La app parsea, normaliza y guarda datos en Supabase.
El usuario importa órdenes de compra.
La app vincula OC con materiales existentes y guarda cabecera/detalle.
Los tableros calculan cobertura cruzando necesidades contra compras registradas.
El usuario filtra, marca negociaciones locales y exporta reportes.

Backend externo

El cliente Flutter se comunica directamente con SupabaseClient. No se observo una API intermedia propia.

Persistencia

Supabase Auth para sesiones, Supabase Database para datos operativos y Supabase Storage para originales de órdenes de compra.

Plataformas

Soporte Windows incluido, Flutter Web configurado y uso de archivos locales en documentos de la app.

Modulos principales

Autenticación

Login con email y contraseña usando Supabase Auth, rutas protegidas y menú de usuario con logout.

Dashboard

Bienvenida, accesos visuales, materiales de baja cobertura y últimas órdenes de compra importadas.

Ingesta de cashflows

Importa planillas, detecta consolidado multi-obra, solicita metadata y guarda datos normalizados en Supabase.

Órdenes de compra

Importación, historial, detalle, edición, eliminación, descarga y guardado opcional del archivo original en Storage.

Compras estratégicas

Cronograma mensual desde cashflows importados, rolling forecast, filtros, KPIs, gráficos y exportación a Excel.

Base Maestra

Materiales derivados del cruce Cashflow vs OC, con filtros por obra/cobertura y exportación de grilla.

Tablero de cobertura

Clasifica necesidades en cubierto, en negociación o sin cobertura, con vista consolidada y mensual.

Cruce Cashflow vs OC

Calcula cobertura global, alertas criticas, alertas insuficientes e inversion comprometida.

Proyecciones y reportes

Consumo real, proyección futura, reportes Excel y estado de abastecimiento.

Gestión del proyecto

Calidad y verificacion

Tests unitarios, de providers, parser, servicios, widgets e integración con Supabase cuando hay entorno real.
CI con GitHub Actions para verificaciones Flutter.
Workflow de CI con entorno dummy y tests reales de Supabase desactivados por defecto.

Cierre académico

Equipo de 6 integrantes, con Nicolás en el rol de PM / Scrum Master.
Se entregaron manual de usuario, manual de arquitectura y documentación final.
La validación final incluyo 32 pruebas; los 6 ajustes detectados fueron corregidos.
El cliente aprobo el MVP y el cierre académico y documental quedo completado.

Retos y soluciones

Información dispersa en planillas -> ingesta de cashflows y órdenes de compra con normalización y persistencia centralizada en Supabase.
Cruzar necesidades contra compras reales -> tableros de cobertura, Base Maestra y cruce Cashflow vs OC con KPIs y filtros.
Solapamientos por obra/material/mes -> rolling forecast que conserva el cashflow con mes de carga más reciente.
Órdenes de compra con formatos distintos -> importación desde Excel, CSV y PDF en escritorio cuando existe pdftotext.
Duplicados y asociación de obras -> flujo para sobrescribir, crear nueva versión o cancelar, y obligacion de asociar una obra activa cuando corresponde.
Estado de negociación no compartido -> marcas locales por dispositivo mediante shared_preferences, dejando claro el límite funcional.

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.

Acceso y dashboard

Pantalla de inicio de sesión de Azcuy Planix con campos de email y contraseña — Login de Azcuy Planix

Dashboard principal de Azcuy Planix con materiales de baja cobertura y órdenes recientes — Dashboard de cobertura

Ingesta de cashflow

Pantalla para importar una planilla de cashflow y consultar el historial de archivos procesados — Importar cashflow

Dialogo para asignar obra mes y ano al cashflow consolidado antes de procesarlo — Asignar período de carga

Órdenes de compra

Detalle de una orden de compra emitida con sus materiales cantidades e impacto en el cashflow — Detalle de orden de compra

Compras estratégicas

Cronograma global de consumo con indicadores y grafico mensual agrupado por obra — Cronograma de consumo

Detalle mensual del cronograma de consumo con cantidades totales por material — Detalle mensual por material

Cronograma de consumo filtrado por obra con selector de rango mensual desplegado — Filtrar cronograma por obra

Base maestra

Base maestra de materiales con opciones para filtrar por estado de cobertura — Filtrar base por cobertura

Cobertura de materiales

Tablero consolidado de cobertura con indicadores y estados de negociación por material — Cobertura consolidada

Tablero de cobertura con selector de períodos mensuales y vista consolidada — Elegir período de cobertura

Cobertura mensual con selector desplegado para elegir una obra del sistema — Elegir obra de cobertura

Cobertura mensual de una obra con materiales cubiertos sin cobertura y en negociación — Cobertura mensual por obra

Cruce Cashflow vs OC

Cruce global de cashflow y órdenes de compra con alertas inversion y cobertura por material — Cruce Cashflow vs OC

Cruce de cashflow y órdenes de compra con selector desplegado para filtrar por obra — Filtrar cruce por obra

Cruce de cashflow y órdenes de compra con selector desplegado para filtrar por rubro — Filtrar cruce por rubro

Proyecciones y reportes

Reporte trimestral de consumo real con indicadores y validación por material — Consumo real trimestral

Reporte trimestral de consumo real con selector de obra desplegado — Filtrar consumo por obra

Reporte semestral de proyección de compras con cantidades proyectadas por material — Proyección semestral

Reporte semestral de proyección de compras con selector de obra desplegado — Filtrar proyección por obra

Resultados

Resultado funcional validado

MVP funcional validado como proyecto final académico.
Aplicación funcional para centralizar información de obras.
Login y cierre de sesión con Supabase Auth.
Ingesta de cashflows y OC con persistencia en Supabase.
Base maestra de materiales para ordenar la información principal del sistema.
Shell principal con dashboard, base maestra, ingesta, compras estratégicas, OC, proyecciones y reportes.

Cierre entregado

El cliente aprobo el MVP tras la validación final.
Manual de usuario, manual de arquitectura y documentación final entregados.
32 pruebas realizadas y 6 ajustes corregidos durante el cierre.
Tablero de cobertura para seguimiento de necesidades de materiales.
Cruce Cashflow vs OC para comparar planificación y compras.
Proyecciones y reportes exportables a Excel.
Mejor organización de la información para seguimiento de materiales.
Persistencia real en Supabase para cashflows, órdenes de compra y datos operativos.