Saltar al contenido

El Chilateño App

Proyectos
(09/11) Mobile Multiplataforma - Produccion

Descripción & Contexto

Aplicación móvil privada de administración y back-office para distribuidora de gas GLP. Controla inventario, ventas, compras y reportes para el dueño y administradores. Flutter + Supabase en producción.

El Chilateño App es una aplicación móvil privada de gestión comercial y administración interna (back-office) desarrollada para una distribuidora de gas GLP en Perú. A diferencia de la landing page pública, esta aplicación está diseñada exclusivamente para uso del dueño y el personal administrativo (jefes de ventas, vendedores), facilitando la gestión integral del negocio de forma privada y segura. Permite registrar ventas y compras, controlar el inventario de balones en tiempo real, generar reportes financieros con gráficos interactivos, exportar reportes en PDF, administrar permisos de usuarios según su rol y operar de manera fluida incluso sin conexión a internet (offline-first). El backend está construido sobre Supabase (PostgreSQL + Auth + Realtime + RLS), y la aplicación está desarrollada con Flutter (móvil multiplataforma). Para asegurar la consistencia absoluta de los datos, la lógica crítica de negocio (descuento automático de stock, cálculo de totales, márgenes de ganancia/costo y la bitácora de auditoría) se delegó por completo a triggers de Postgres a nivel de servidor, evitando vulnerabilidades o discrepancias en la interfaz del cliente.

Código Privado Ver Demo
El Chilateño App

Características Clave

  • Ventas

    Registro de ventas con descuento automático de stock en tiempo real mediante triggers de Postgres.

  • Compras

    Registro de compras de abastecimiento de balones que recalculan costos y stock automáticamente.

  • Inventario

    Alta y edición de productos (balones por kilogramos y marcas) con alertas de stock mínimo.

  • Reportes

    Dashboard financiero interactivo con gráficos (fl_chart) y exportación de comprobantes o balances en PDF.

  • Seguridad & Roles

    Gestión de cuentas privadas con permisos jerárquicos aprobados por el administrador y protegidos mediante RLS.

  • Historial / Auditoría

    Registro inmutable de transacciones y operaciones para control interno del dueño.

  • Sincronización Offline

    Soporte para operar sin señal, encolando operaciones locales que se sincronizan de forma segura al detectar red.

Galería de Capturas

El Chilateño App — 1
El Chilateño App — 2
El Chilateño App — 3

Arquitectura del Sistema

La arquitectura de la aplicación está dividida en tres capas principales: * Presentación & Estado (Flutter + Riverpod): Vistas declarativas con go_router y gestión de estado reactiva con flutter_riverpod, manteniendo la interfaz desacoplada de la capa de red. * Persistencia Local & Offline Queue (Hive): Encolado local de transacciones comerciales con idempotencia para operar sin interrupciones en zonas rurales sin cobertura móvil. * Backend & Capa Transaccional (Supabase / PostgreSQL): La lógica crítica de negocio (descuento atómico de stock, cálculo de comisiones, arqueo de caja y bitácora de auditoría inmutable) se ejecuta en triggers y funciones RPC en PostgreSQL protegidas por Row Level Security (RLS).

Retos Técnicos & Soluciones

El mayor desafío consistió en diseñar una arquitectura robusta de seguridad para uso administrativo. Dado que la aplicación maneja datos sensibles de facturación e inventario, implementamos políticas estrictas de Row Level Security (RLS) en la base de datos Supabase, validando las credenciales de cada usuario en cada consulta. Además, para soportar las operaciones en zonas con cobertura de red inestable sin riesgo de corrupción de datos, estructuramos un sistema de sincronización offline con cola de peticiones locales que sincroniza el inventario de forma automática al restablecerse la conexión.

Stack Tecnológico

  • Flutter
  • Dart
  • Supabase
  • PostgreSQL
  • Riverpod
  • PDF Generation

Ficha Técnica

Rol
Arquitectura, Diseño y Desarrollo
Tipo
Mobile Multiplataforma - Produccion
Impacto & Resultados
Aplicación privada en producción real utilizada activamente por el dueño y administradores de la distribuidora El Chilateño. Ha optimizado el control de inventario y la contabilidad interna de ventas, previniendo pérdidas de stock y automatizando la generación de balances diarios en formato PDF.
Aprendizajes
Este proyecto demuestra la capacidad de entregar software de producción real: desde la arquitectura con lógica de negocio en el servidor hasta CI/CD con GitHub Actions. Cada decisión técnica fue tomada con el objetivo de robustez y seguridad en un entorno comercial real. <div
Código
Código Privado
Enlace
eirlgas.vercel.app