Un sistema ágil de auditoría de flotas diseñado para validar el stock físico de vehículos en campo, garantizando la integridad y precisión de los datos mediante un control de agentes por invitación y geolocalización.
En la gestión de flotas, el GPS y los sistemas digitales no siempre cuentan toda la historia. Un sistema puede indicar que un vehículo está en el parking A, pero físicamente está en el B (o no está).
Esta discrepancia genera dos problemas de negocio:
- Errores de Ubicación: Decisiones logísticas (como enviar un conductor) se toman con datos incorrectos.
- Gestión de Capacidad: Es imposible saber la ocupación real de un parking, impidiendo optimizar el envío de nuevas unidades.
Vehicle Stock Control es un prototipo funcional que ataca este reto con un enfoque en la seguridad y la usabilidad de los datos.
El Admin tiene una vista de 360° de toda la operación, diseñada para la gestión y el análisis de datos.
- Dashboard "Overview": Una vista de 10 segundos con los KPIs clave: scans totales, scans de hoy, sesiones activas, agentes activos y un feed de actividad en vivo.
- Gestión de Usuarios: Control total sobre quién accede a la app. Incluye creación/revocación de códigos de invitación, activación/desactivación de agentes y asignación de roles.
- Gestión de Localizaciones: Permite crear, editar y filtrar parkings o zonas. Se puede configurar la capacidad (en m² y en unidades) y su estado (Activo/Inactivo).
- Log de Auditoría "All Scan Data": Un registro inmutable de cada VIN escaneado, detallando hora, Session ID, VIN, localización, agente y método de captura.
- Exportación de Datos: Todos los logs y datos se pueden exportar a .csv para cruzarlos con sistemas internos (ERP, TMS) e identificar discrepancias.
Una interfaz "Mobile-First" diseñada para ser rápida, precisa y segura.
- Alta Segura por Invitación: Los agentes solo pueden crear una cuenta si poseen un código de invitación válido generado por un Admin.
- Sistema de Sesiones: El agente debe seleccionar la localización donde se encuentra (de la lista creada por el Admin) antes de empezar.
- Geolocalización Obligatoria: La app requiere acceso a la geolocalización del dispositivo para añadir una capa crucial de verificación a cada registro.
- Múltiples Métodos de Entrada:
- Escáner de Cámara: Reconoce el VIN directamente (ver
CamScannerScreen.jpg). - Manual: Ingreso de 17 dígitos con validación.
- Upload/Video: Carga de archivos para registro.
- Escáner de Cámara: Reconoce el VIN directamente (ver
- Validación Anti-Duplicados: El sistema avisa y previene el registro del mismo VIN dos veces dentro de la misma sesión.
- Revisión de Sesión: El agente puede ver un listado de los VINs que ha registrado y exportar su sesión a CSV desde el móvil.
| Admin: Overview Vista de 10 segundos de la operación. |
Admin: Gestión de Usuarios Control de agentes y códigos de invitación. |
|
 |
| Admin: Gestión de Localizaciones Configuración de capacidad y estado. |
Admin: Log de Todos los Scans Auditoría completa de cada registro. |
 |
 |
| Agente: Login y Selección Inicio de sesión y elección de parking. |
Agente: Escáner de Cámara Reconocimiento de VIN en acción. |
|
 |
| Agente: Entrada Manual Alternativa de ingreso de 17 dígitos. |
Agente: Resumen de Sesión Revisión y exportación de sesión a CSV. |
 |
 |
- Lógica de la Aplicación: Construida con Google AI Studio (Gemini) para generar la funcionalidad de los perfiles, la gestión de sesiones, la lógica de validación y las interacciones de la base de datos.
- Entorno de Ejecución: Node.js
- Frontend: React.js (construido con Vite)
- Enfoque: Demostrar cómo se puede pasar de una idea a un prototipo funcional (MVP) de alta fidelidad en tiempo récord.
Para proteger las API Keys, este proyecto está diseñado para ejecutarse localmente.
- Node.js (v18 o superior recomendado)
- Git (para clonar el repositorio)
-
Clona este repositorio en tu máquina:
git clone https://github.com/goyoaga/VehicleStockControl.git cd VehicleStockControl -
Instala todas las dependencias del proyecto:
npm install
-
Configura tu API Key de Gemini:
- Crea un archivo llamado
.env.localen la raíz del proyecto. - Añade tu API Key dentro de ese archivo, así:
GEMINI_API_KEY=TU_API_KEY_VA_AQUI - Crea un archivo llamado
-
Ejecuta la aplicación en modo de desarrollo:
npm run dev
-
¡Listo! Abre
http://localhost:3000(o el puerto que te indique la terminal) en tu navegador para ver la aplicación.
La aplicación incluye dos usuarios de prueba para un testing inmediato, como se ve en la pantalla de Login. Una vez dentro, puedes crear, desactivar o modificar los usuarios que quieras desde el panel de Admin.
- Usuario Admin:
- Email:
admin@admin.com - Contraseña:
admin
- Email:
- Usuario Agente:
- Email:
agent@agent@agent.com - Contraseña:
agent
- Email:
Este proyecto es un prototipo y no utiliza datos reales ni está afiliado a ninguna empresa. Todos los datos para pruebas (VINs, usuarios) son ficticios.
