📦 AppVentas — Control de Ventas para Rodantes

Aplicación móvil rápida y sencilla para vendedores ambulantes que quieren llevar el control de sus ganancias.

Ver Demo · Características · Instalación

---

💡 ¿Qué es AppVentas?

AppVentas nació para resolver un problema real: los vendedores rodantes (también conocidos como vendedores de chacharas) necesitan saber cuánto están ganando realmente, sin complicaciones.

No es una app de punto de venta corporativa. Es una herramienta ligera, rápida y sin internet que permite:

• Registrar productos con su precio de venta y costo real.
• Controlar el inventario por lotes de compra.
• Vender a varios clientes al mismo tiempo (hasta 3 carritos).
• Calcular la ganancia neta usando costo promedio ponderado.
• Exportar balances diarios, semanales o mensuales a CSV y PDF.
• Todo desde el celular, sin necesidad de conexión a internet.

🎯 Objetivo: Que el vendedor sepa al final del día cuánto ganó, cuánto le costó la mercancía y cuánto le queda en stock.

---

✨ Características

🛍️ Gestión de Productos

• Alta, edición y eliminación de productos.
• Control de stock por lotes de compra (cada lote con su propio costo).
• Promociones tipo 2x1, 3x$50, etc.
• Foto del producto para identificación rápida.

🛒 Ventas Multi-Cliente

• Hasta 3 carritos simultáneos (tabs independientes).
• Cada carrito puede tener un nombre: "Cliente 1", "El indeciso", etc.
• Cálculo automático de totales aplicando promociones.
• Cobro rápido con un solo tap.

💰 Costo Promedio Ponderado

La app calcula automáticamente el costo real de cada producto según los lotes comprados:

Nuevo Costo Promedio = (Costo Total Acumulado + Costo del Nuevo Lote) / (Unidades Totales)

Esto garantiza que la ganancia mostrada sea real, no estimada.

📊 Balances y Analytics

• Resumen del día: ventas, costos y ganancia neta.
• Comparativa semanal y mensual con gráficos.
• Productos más vendidos y menos vendidos.
• Historial completo por calendario.

📝 Notas Rápidas

• Anotaciones del día: "El proveedor subió precio la próxima semana", "Traer más gorras azules", etc.

⚙️ Ajustes

• Modo oscuro / claro.
• Diseño responsive para teléfono y tablet.
• Sin animaciones lentas: todo es instantáneo.

---

📱 Capturas de Pantalla

🚧 Próximamente...

---

🏗️ Arquitectura

lib/
├── app/
│   ├── data/               # Modelos, base de datos (Drift), enums
│   ├── modules/            # 8 módulos independientes
│   │   ├── home/           # Dashboard principal
│   │   ├── products/       # Catálogo y lotes
│   │   ├── sales/          # Punto de venta multi-carrito
│   │   ├── analytics/      # Balances y gráficos
│   │   ├── calendar/       # Historial por fecha
│   │   ├── notes/          # Notas rápidas
│   │   ├── cash_register/  # Apertura de caja
│   │   └── settings/       # Preferencias
│   ├── routes/             # Navegación con GetX
│   ├── core/               # Temas, utilidades, strings
│   └── global_widgets/     # Componentes reutilizables
└── main.dart

• Flutter 3.10+ con soporte iOS, Android y Web.
• GetX para state management, routing e inyección de dependencias.
• Drift (SQLite) como base de datos local multiplataforma.
• fl_chart para visualización de datos.
• pdf + csv + share_plus para exportación de reportes.

---

🚀 Instalación

# 1. Clonar el repositorio
git clone https://github.com/ebravo-dev/appventasrodante.git
cd appventasrodante

# 2. Instalar dependencias
flutter pub get

# 3. Generar código de base de datos (Drift)
dart run build_runner build

# 4. Ejecutar
flutter run

Requisitos

• Flutter SDK ^3.10.1
• Dart ^3.0.0

---

🧪 Testing

# Tests unitarios
flutter test

# Tests E2E (web)
flutter run -d chrome --web-port=3000

---

📄 Licencia

Este proyecto es de uso personal y educativo.
Desarrollado por Eder J. G. Bravo.

---

"Hecho con 💙 para los que salen a vender todos los días."