BalónGo — Gestión Logística Operativa

Sistema de gestión de pedidos y control de entregas en tiempo real para Distribuidora Rogas S.R.L.

Probar Demo en Vivo →

---

🎯 El Proyecto

BalónGo es un sistema de logística operativa centralizada diseñado para digitalizar la distribución de balones de gas. Elimina la dependencia de métodos manuales y optimiza la trazabilidad desde la recepción de la llamada hasta la entrega final.

Características Clave

• Panel de Control (Dashboard): Gestión integral de clientes, seguimiento de métricas diarias e histórico de ventas.
• Seguimiento Logístico Kanban: Flujo de trabajo en tiempo real (Pendiente ➡️ En proceso ➡️ Entregado).
• Asignación Eficiente: Despacho directo a repartidores con notificaciones de estado y capacidad para adjuntar evidencias fotográficas.
• Arquitectura Offline-First: Construido como Progressive Web App (PWA) para asegurar la operatividad en zonas de baja conectividad móvil.

---

🏛️ Arquitectura del Sistema

flowchart LR
    subgraph Frontend ["📱 Interfaz de Usuario (Client-Side)"]
        A["Angular 20 + Ionic 8 (PWA)"]
    end

    subgraph Backend ["☁️ Firebase (Arquitectura Serverless)"]
        B("Firebase Auth<br/>(Identidad)")
        C[("Cloud Firestore<br/>(Datos en Tiempo Real)")]
        D[/"Cloud Storage<br/>(Evidencias Multimedia)"\]
        E{"Firebase Hosting<br/>(CDN Global)"}
    end

    A --->|Descarga la App| E
    A --->|Login / Sesión| B
    A <--->|Sincronización de Pedidos| C
    A --->|Sube Fotos de Entrega| D

    B -.->|Inyecta Reglas de Acceso (RBAC)| C
    B -.->|Inyecta Tokens JWT| D
    C -.->|Reglas de Cruce (Cross-Service)| D

    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px;
    classDef front fill:#e3f2fd,stroke:#1565c0,stroke-width:2px,color:#000;
    classDef fire fill:#fff3e0,stroke:#e65100,stroke-width:2px,color:#000;

    class A front;
    class B,C,D,E fire;

Loading

---

🛡️ Seguridad

El sistema implementa Firebase Security Rules de nivel profesional:

• Control de Acceso (RBAC): Uso de colecciones estrictas (admins) para asignar permisos de administración.
• Validación Backend: Las reglas de Firestore verifican la estructura e integridad de los datos antes de guardarlos.
• Protección de Archivos: Las evidencias fotográficas solo pueden ser subidas o leídas por repartidores y administradores autorizados.

---

📸 Capturas del Sistema

Dashboard de Gestión	Gestión de Pedidos
Directorio de Clientes	Historial y Trazabilidad

---

🛠️ Stack Tecnológico

• Frontend: Angular 20, Ionic 8, TypeScript, SCSS
• Backend (BaaS): Firebase Authentication, Cloud Firestore (Base de datos NoSQL en tiempo real), Firebase Cloud Storage
• Infraestructura: Firebase Hosting (CDN Global), GitHub Actions (CI/CD Automático)

---

🚀 Despliegue Local

Para iniciar el proyecto en tu entorno local, asegúrate de tener instalado Node.js (v20+) y Angular CLI (v19+).

# 1. Clonar el repositorio
git clone https://github.com/zSnowww/BalonGo.git

# 2. Instalar dependencias
npm ci

# 3. Iniciar el servidor de desarrollo local
npm start

Nota: Para que el despliegue a producción funcione a través de GitHub Actions, es necesario configurar los secretos de Firebase (Service Account, API Keys) en la pestaña Settings > Secrets del repositorio.

---

👥 Equipo de Desarrollo

Este proyecto emplea un modelo de desarrollo colaborativo para garantizar la calidad del producto final.

• Manuel A. Vera Barboza: Programación Backend, Seguridad y Despliegue
• Alejandro O. Nuñez Centeno: Análisis de Procesos y Lógica de Negocio
• Luis E. Cruz Cholon: Diseño de Interfaces (UI/UX) y Componentes Visuales
• Ivan J. Rivera Castillo: Aseguramiento de Calidad (QA) y Pruebas Funcionales

---

_{Desarrollado para la Universidad César Vallejo (2026)}