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

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