netgescon-day0/docs/support/FORNITORE-OPERATIVITA-ROADMAP-2026-04.md

166 lines
6.0 KiB
Markdown

# Roadmap operativa fornitore/manutentore
Data: 6 aprile 2026
## 1. Obiettivo
Rendere l area fornitore realmente usabile come backoffice operativo quotidiano, senza creare viste isolate solo per un caso specifico.
Direzione confermata:
- UI e Blade riusabili tra ruoli diversi
- differenziazione principale a livello di accesso dati e permessi
- stessa esperienza utente su ticket, rubrica, allegati e schede prodotto
## 2. Stato gia rilasciato
- correzione accesso scheda ticket/intervento fornitore
- modal rapida dalla lista ticket fornitore
- miniature allegati ticket e preview modal lato fornitore
- anteprima immediata file in scheda intervento fornitore
- ricerca subfornitore/collaboratore con pattern coerente ai ticket
- start/stop timer intervento e salvataggio allegati fornitore con naming/preview piu robusti
- primo slice pagina `Lavorazioni operative` come contenitore unico per interventi da ticket e future lavorazioni interne/ricorrenti
- sessioni intervento multiple con eventi `start`, `stop` e `checkpoint` sulla stessa scheda fornitore
- acquisizione posizione browser su start/stop/checkpoint quando il dispositivo concede geolocalizzazione
- prima rubrica clienti fornitore costruita dai ticket/interventi gia lavorati, con azioni chiamata/mail e link rapido alla scheda intervento
- prima pagina `Prodotti` fornitore agganciata al catalogo interno esistente, con ricerca per nome/codice/barcode
- materiali strutturati nel rapportino fornitore, con quantita, prezzo, barcode, sorgente e link esterno/fallback
- esposizione lato fornitore dello stato connessione Google gia presente nel backend, con riuso del flusso OAuth anche dal contesto fornitore
- verifica import TAG legacy fornitore: comando funzionante, nessun delta residuo sulle righe gia importate in staging
## 3. Rubrica unica condivisa
Decisione:
- usare sempre la stessa maschera rubrica come base comune
- i ruoli diversi devono vedere workflow coerenti
- le differenze vanno applicate nel layer DB, permessi, collegamenti e campi secondari
Impatto:
- un fix UI fatto una volta resta valido per tutti
- minore divergenza tra amministratore, fornitore e moduli tecnici
- base migliore per sincronizzazione mobile e Google Contacts
## 4. TecnoRepair e sorgente dati
Decisione tecnica:
- leggere il legacy MDB in modo sicuro
- non usare il file Access come database operativo da scrivere direttamente
- usare NetGescon come base dati di lavoro e storico operativo
- prevedere bridge di sincronizzazione verso/da sistemi esterni solo in modo controllato
Percorso consigliato:
1. import legacy TecnoRepair in staging SQL NetGescon
2. matching verso rubrica, fornitori, prodotti, seriali e schede assistenza
3. eventuale sync con Google Contacts per la parte rubrica mobile
4. eventuali export/sync di ritorno solo su connettori dedicati
## 5. Ticket interni e lavorazioni unificate
Da realizzare:
- pagina dedicata con elenco unico lavorazioni fornitore
- viste aggregate per:
- ticket assegnati dall amministratore
- ticket interni aperti dal fornitore
- lavorazioni concluse / archivio
- lavorazioni in attesa / da pianificare
Regola:
- il ticket e il contenitore del lavoro occasionale/non preventivato
- le lavorazioni interne devono convivere nello stesso pannello operativo, senza obbligare a due strumenti separati per il manutentore
## 6. Lavori ricorrenti e contratti
Dominio da introdurre separatamente dal ticket:
- contratti di servizio continuativi
- clienti serviti
- sedi/impianti/contesti serviti
- frequenza interventi
- calendario pianificato
- assegnazione operatori
- consuntivi e scostamenti
Esempi target:
- pulizie
- portierato
- disinfestazione
- manutenzione tecnica periodica
- servizi continuativi con SLA o visite programmate
## 7. Collaboratori e turni
Estensione richiesta sulla pagina collaboratori:
- riuso del componente di ricerca stile ticket
- memorizzazione come collaboratore/dipendente o subfornitore
- futura gestione orari di lavoro e disponibilita
- base per distribuire lavori ricorrenti e assegnazioni automatiche/manuali
## 8. Catalogo operativo interno
Modello richiesto:
- prodotto unico interno
- piu fornitori per lo stesso prodotto
- listini acquisto multipli comparabili
- listini vendita differenziabili per cliente o profilo cliente
- seriali singoli o multipli
- assemblati con seriali figli
- varianti modello/colore
- foto, allegati e link esterni tipo ICECAT
Decisione chiave:
- il codice pubblicato/operativo deve essere quello interno NetGescon
- i riferimenti esterni restano alias o sorgenti di import, non chiavi principali dell archivio
Slice gia attivo:
- lookup prodotti dalla scheda intervento fornitore
- uso immediato nel rapportino di materiali gia codificati
- fallback manuale per prodotto non censito
- fallback link esterno di ricerca prodotto su Amazon in attesa del referral definitivo/configurato
Nota pratica:
- la scansione barcode lato browser e gia compatibile con lettori HID/Bluetooth che scrivono nel campo come tastiera
- la lettura camera nativa del barcode puo essere aggiunta in uno step successivo con libreria dedicata o app/PWA piu spinta
## 9. Scheda fornitore per pagine separate
Separazione richiesta per la scheda fornitore:
1. dati essenziali in scheda principale
2. pagina/tab `TecnoRepair / seriali`
3. pagina/tab `Catalogo operativo interno`
Contenuto previsto in `TecnoRepair / seriali`:
- import MDB collegato al fornitore
- seriali assistenza agganciati automaticamente
- storico schede legacy
Contenuto previsto in `Catalogo operativo interno`:
- anagrafica prodotti/servizi del fornitore
- listini acquisto/vendita
- varianti e seriali
- allegati e immagini
- riferimenti esterni interni al gestionale
## 10. Prossimi slice consigliati
1. trasformare le sessioni intervento in foglio presenza/manodopera con timbrature multiple per giorno/mese e consuntivo fatturabile
2. estendere checkpoint presenza con QR/BLE/NFC dove il device/browser lo consente davvero
3. estensione collaboratori con disponibilita/orari
4. ticket interni/lavorazioni ricorrenti dentro `Lavorazioni operative`
5. staging SQL TecnoRepair per rubrica, schede e seriali