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

52 lines
2.3 KiB
Markdown

# 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:
```bash
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:
```bash
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.