Vintec – Gestionale Agenti e Provvigioni
Tipologia prodotto
Gestionale
Cliente
Vince
Stato
In produzione
Descrizione
API REST gestionale per VintecSRL: clienti, agenti, lead, installazioni di impianti e calcolo provvigioni gerarchiche.
Vintec è una piattaforma gestionale di classe Enterprise progettata e sviluppata per informatizzare l'intera catena del valore di VintecSRL, società specializzata nell'installazione di impianti industriali e civili. L'applicazione risponde alla necessità di mappare un modello di business complesso, unificando in un unico ecosistema headless (API-first) il ciclo di vita del cliente: dalla lead generation e preventivazione a catalogo, fino alla pianificazione del cantiere e all'elaborazione contabile delle spettanze finanziarie per la forza vendita. Esposta interamente tramite API REST protette, la piattaforma si interfaccia in modo trasparente con frontend dedicati, applicazioni mobile e landing page esterne.
Finalità
Applicazione gestionale per VintecSRL, azienda che opera nell’installazione di impianti. Centralizza l’anagrafica clienti (privati e aziende), la rete di agenti commerciali, la gestione dei lead (anche da fonti esterne come landing page), il tracciamento delle installazioni e il calcolo delle provvigioni secondo gerarchie commerciali. Espone tutto come backend API REST consumabile da un frontend dedicato.
Tecnologie
– Laravel 12 / PHP 8.2 (architettura modulare in stile nwidart/laravel-modules)
– MySQL 8.0; Redis 7 per cache e code
– Laravel Sanctum per autenticazione token-based (Bearer)
– spatie/laravel-permission per ruoli e permessi
– Vite per il tooling frontend; PHPUnit per i test; Laravel Pint
– Docker Compose + Traefik per il deploy
Note
Progetto reale e ben documentato. Repository GitLab (Soull3ss/vintec). Condivide lo skeleton Laravel con altri progetti “wiva” della stessa base, ma e un progetto distinto orientato al cliente VintecSRL.
Funzionalità principali
– Autenticazione API (register, login, logout, reset password) con notifiche email (SMTP Aruba)
– Moduli di dominio: Auth, Agents, Clients, Lead, Catalog (prodotti/categorie/kit/immagini), Installations, Commissions, Accounting
– Sistema di ruoli (Amministratore, Contabilita, Agente) con filtro automatico dei dati per agente (un agente vede solo i propri clienti/installazioni via `agent_id`)
– Gestione installazioni con upload e download di documenti e foto
– Gerarchie provvigionali e generazione massiva delle provvigioni (`/api/accounting/generate-all`)
– Ingresso lead da fonti esterne (`/api/external/leads`)
Particolarità
Architettura fortemente modulare: ogni dominio vive in `Modules/<Nome>/` con controller, modelli, migrazioni e rotte propri, autoload PSR-4 dedicato. Il filtro dati per agenti e implementato in modo trasversale su index/show/store/update con fallback di sicurezza (404 sugli accessi a record altrui). Documentazione interna estesa (AUTH_SYSTEM, API_AUTH, AGENT_FILTERING, PROJECT.md, FUNCTIONAL.md).
Hai bisogno di aiuto per sviluppare il tuo progetto?
Vuoi dare vita al tuo website, a un e-commerce a un’app o a un software personalizzato? Ti servono informazioni? Non sai da dove iniziare?