# 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