netgescon-day0/docs/fornitori/tecnorepair-operativita.md

Operativita fornitore TecnoRepair

Questa nota riassume i punti introdotti nel flusso fornitore per archivio, rubrica clienti, Google e fatture elettroniche manuali.

Archivio fornitore

• Il root reale del disco locale applicativo e storage/app/private.
• I percorsi mostrati nelle pagine fornitore devono essere risolti tramite Storage::disk('local')->path(...), non costruiti a mano con storage/app/....
• Per riallineare le cartelle fisiche dei fornitori esistenti usare:

php artisan netgescon:provision-fornitori-archives

Rubrica clienti fornitore

• La rubrica clienti fornitore e materializzata in fornitore_clienti.
• La sorgente attuale non e una tabella MDB separata a runtime: il dato cliente e ricostruito da AssistenzaTecnorepairScheda.metadata['cliente'] gia importato dal legacy TecnoRepair.
• Il comando operativo e:

php artisan tecnorepair:import-rubrica-clienti {amministratore_id} --fornitore-id={fornitore_id}

• Durante l import vengono normalizzati:
  • province legacy troppo lunghe
  • campi telefono contaminati da note testuali

Google fornitore

• Gli account Google fornitore usano chiavi dedicate fornitore-{id}.
• Regola importante: un account fornitore non deve diventare il default Google dell amministratore.
• Il blocco legacy google.oauth va aggiornato solo dal default amministratore, non dagli account scoped del fornitore.
• In caso di collegamento/scollegamento fornitore, la UI amministratore deve continuare a riflettere solo l account default amministratore.

FE manuale lato fornitore

• La pagina admin-filament/fornitore/contabilita espone un import manuale FE dal menu azioni in alto.
• File ammessi: XML, P7M, ZIP.
• Il file viene accettato solo se il cedente della FE coincide con P.IVA/CF del fornitore corrente.
• Lo stabile viene risolto in modo automatico dai dati destinatario della FE, ma ristretto agli stabili dell amministratore del fornitore.
• L import riusa FatturaElettronicaImporter; non crea fornitori nuovi e non introduce acquisizioni automatiche.

Scheda intervento

• La Blade fornitore e stata resa piu compatta con tab operative:
  • Segnalazione
  • Operativo
  • Allegati
  • Storico
• L obiettivo e avvicinare la navigazione al flusso desktop TecnoRepair senza riscrivere la logica Livewire esistente.