Tipologia
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
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`)
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.
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).