Wiki / Help AutoGest.ia

Guida utente delle videate, documentazione del progetto e mappa del codice.

Vai alle istruzioni

Istruzioni passo passo per ogni videata

Le procedure sono già aperte: segui nell’ordine i passaggi numerati, poi controlla il risultato atteso e le avvertenze.

17 aree · 51 procedure
Dashboard2 procedure dettagliateApri

A cosa serveControllare vendite, scadenze, valore e anzianità dello stock.

Apri la videata

Prima di iniziare

  • Registrare veicoli, vendite e scadenze.
  • Impostare il tasso bancario in Impostazioni.

Campi e dati coinvolti

  • Vendite del mese
  • Costo stock
  • Valore bancario
  • Valore di mercato
  • Svalutazione
  • Giorni medi stock

1Leggere gli indicatori

  1. Controllare il periodo mostrato.
  2. Confrontare costo stock, valore bancario e mercato.
  3. Selezionare una scheda per aprire l'archivio collegato.

Risultato: Si individua dove intervenire su vendite o capitale immobilizzato.

2Aprire una risposta annuncio

  1. Controllare l'icona automobile in alto a sinistra.
  2. Se mostra un numero, selezionarla.
  3. Aprire l'annuncio indicato e leggere Risposte.

Risultato: Si raggiunge l'annuncio con una richiesta da gestire.

Clienti5 procedure dettagliateApri

A cosa serveCreare persone/aziende, acquisire documenti e collegare più veicoli allo stesso cliente.

Apri la videata

Prima di iniziare

  • Cercare il soggetto per evitare duplicati.
  • Preparare CIE oppure patente e tessera sanitaria; per extra UE anche permesso di soggiorno.

Campi e dati coinvolti

  • Nome o ragione sociale
  • Tipologia
  • Codice fiscale/P.IVA
  • Residenza e contatti
  • Targhe veicoli
  • Fascicolo documenti

1Cercare un soggetto

  1. Digitare anche un solo carattere nel campo Cerca.
  2. Aprire Filtri e scegliere Nome, Codice fiscale o Città.
  3. Aprire la riga corretta con la matita.

Risultato: La scheda esistente viene aperta senza creare un doppione.

2Creare e collegare veicoli

  1. Premere Nuovo proprietario.
  2. Compilare Nome, Tipologia e Codice fiscale.
  3. Premere Avanti: associa veicoli.
  4. Selezionare una o più targhe e premere Salva.

Risultato: Il proprietario viene salvato con tutti i veicoli selezionati.

3Scansionare CIE

  1. Premere File / scanner oppure Fotocamera smartphone.
  2. Acquisire fronte e retro con documento intero, luce uniforme e senza riflessi.
  3. Attendere il riconoscimento locale e aprire Testo OCR completo.
  4. Correggere nome, nascita, luogo, provincia, documento e codice fiscale.
  5. Premere Copia dati verificati e salvare la scheda.

Risultato: I dati OCR confermati vengono copiati nell’anagrafica Web.

4Scansionare patente e tessera sanitaria

  1. Acquisire patente fronte/retro.
  2. Acquisire tessera sanitaria fronte/retro.
  3. Confrontare i dati proposti dai due documenti.
  4. Correggere eventuali errori OCR e copiare nell'anagrafica.

Risultato: I dati verificati sostituiscono l'inserimento manuale e le immagini restano nel fascicolo.

5Allegare permesso di soggiorno

  1. Impostare il soggetto come extra UE/SEE.
  2. Acquisire fronte e retro del permesso.
  3. Controllare la leggibilità e salvare il fascicolo.

Risultato: Le due immagini vengono archiviate senza estrazione automatica dei dati.

Veicoli e stock3 procedure dettagliateApri

A cosa serveRegistrare il veicolo e controllare costo, permanenza, mercato e svalutazione.

Apri la videata

Prima di iniziare

  • Disporre di targa o VIN.
  • Avere il proprietario già censito quando disponibile.

Campi e dati coinvolti

  • Marca/modello
  • Targa
  • Telaio VIN
  • Data ingresso
  • Costo acquisto
  • Valore mercato
  • Proprietario

1Cercare e scorrere

  1. Digitare un carattere di targa, telaio, marca o modello.
  2. Scegliere una colonna con Filtri.
  3. Scorrere verticalmente la griglia e aprire con la matita.

Risultato: Si raggiunge il veicolo senza duplicarlo.

2Inserire un veicolo

  1. Premere Nuovo veicolo.
  2. Usare File / scanner o Fotocamera smartphone per leggere carta di circolazione o Documento Unico.
  3. Verificare targa, VIN, marca, modello e anno proposti dall’OCR.
  4. Inserire costo e data ingresso e salvare.

Risultato: Il veicolo entra nell'archivio e nei conteggi stock.

3Valutare lo stock

  1. Leggere Giorni dalla data di ingresso.
  2. Confrontare Costo stock e Valore bancario.
  3. Confrontare mercato e Svalutazione.

Risultato: Si misura capitale immobilizzato e perdita di valore.

Vendite3 procedure dettagliateApri

A cosa serveRegistrare e ricercare vendite di veicoli usati o nuovi.

Apri la videata

Prima di iniziare

  • Creare prima l'acquirente.
  • Per l'usato registrare il veicolo; per il nuovo conoscere il VIN.

Campi e dati coinvolti

  • Cognome cliente
  • Veicolo nuovo
  • Targa/Telaio
  • Data
  • Importo

1Ricercare una vendita

  1. Digitare un carattere di cliente, targa o telaio.
  2. Aprire Filtri e scegliere la colonna.
  3. Usare Azzera filtri per tornare all'elenco completo.

Risultato: La griglia mostra solo le vendite corrispondenti.

2Vendere un usato

  1. Premere Nuova vendita e cercare il cliente.
  2. Lasciare Veicolo nuovo su No.
  3. Cercare la targa.
  4. Inserire data e importo e salvare.

Risultato: Cliente e veicolo usato risultano associati alla vendita.

3Vendere un nuovo

  1. Premere Nuova vendita e cercare il cliente.
  2. Impostare Veicolo nuovo su Sì.
  3. Inserire il telaio invece della targa.
  4. Inserire data e importo e salvare.

Risultato: La vendita viene identificata tramite VIN anche senza targa.

Officina e carrozzeria4 procedure dettagliateApri

A cosa serveRegistrare lavori, ricambi, ore, costo e storico per veicolo.

Apri la videata

Prima di iniziare

  • Veicolo e cliente presenti.
  • Ricambi in Magazzino.
  • Tariffe configurate in Impostazioni.

Campi e dati coinvolti

  • Lavoro
  • Veicolo
  • Cliente
  • Stato
  • Ricambi
  • Ore
  • Tariffa
  • Totali

1Aprire un lavoro

  1. Premere Nuovo lavoro.
  2. Descrivere il lavoro.
  3. Digitare la targa e scegliere il veicolo proposto.
  4. Selezionare cliente e stato.

Risultato: La commessa è collegata a cliente e veicolo.

2Aggiungere ricambi

  1. Cercare codice o descrizione nel menu Ricambi.
  2. Selezionare il prodotto e premere Aggiungi.
  3. Modificare quantità o prezzo unitario nella riga.
  4. Usare il cestino per rimuovere una riga errata.

Risultato: Totale riga e Totale ricambi vengono ricalcolati.

3Calcolare manodopera

  1. Inserire Ore lavorate.
  2. Controllare la tariffa automatica delle Impostazioni.
  3. Verificare Totale lavoro e salvare.

Risultato: Ricambi e ore confluiscono nel totale.

4Consultare lo storico

  1. Cercare targa, cliente o descrizione.
  2. Filtrare per colonna se necessario.
  3. Aprire il lavoro con la matita.

Risultato: Si consultano o aggiornano gli interventi precedenti.

Magazzino2 procedure dettagliateApri

A cosa serveVisualizzare e gestire giacenze, ubicazioni e prezzi dei ricambi.

Apri la videata

Prima di iniziare

  • Definire codici univoci e ubicazioni fisiche.

Campi e dati coinvolti

  • Codice
  • Descrizione
  • Disponibilità
  • Ubicazione
  • Prezzo unitario

1Cercare un prodotto

  1. Digitare un carattere di codice, descrizione o ubicazione.
  2. Selezionare la colonna con Filtri.
  3. Leggere disponibilità e posizione nella griglia.

Risultato: Il prodotto viene individuato rapidamente.

2Inserire o correggere

  1. Premere Nuovo ricambio oppure la matita.
  2. Compilare codice, descrizione, quantità, posizione e prezzo.
  3. Salvare e verificare la riga.

Risultato: Il prodotto è disponibile in Officina e Preventivi.

Acquisti3 procedure dettagliateApri

A cosa serveRegistrare acquisti di autoveicoli e archiviare bolle di ricambi/materiali.

Apri la videata

Prima di iniziare

  • Dati del venditore o fornitore disponibili.
  • Documento di acquisto disponibile.

Campi e dati coinvolti

  • Tipo acquisto
  • Venditore / Fornitore
  • Tipologia
  • Codice fiscale / P.IVA
  • Targa / Telaio
  • Documento
  • Data
  • Dettaglio
  • Totale

1Cercare una bolla

  1. Digitare ragione sociale o numero DDT.
  2. Scegliere la colonna con Filtri.
  3. Aprire la riga con la matita.

Risultato: Si visualizza la registrazione d'acquisto richiesta.

2Acquistare un autoveicolo

  1. Premere Acquisto autoveicolo.
  2. Compilare l’anagrafica del venditore come nella scheda Clienti.
  3. Inserire codice fiscale o P.IVA e targa o telaio.
  4. Completare documento, data, dettaglio e totale, quindi salvare.

Risultato: L’acquisto resta ricercabile con venditore e identificativo del mezzo.

3Caricare una bolla

  1. Premere Nuova bolla di carico.
  2. Cercare il fornitore e scegliere Ricambi o Officina.
  3. Inserire numero e data.
  4. Aggiungere prodotti, quantità e prezzi e salvare.

Risultato: La bolla viene archiviata e le giacenze aggiornate.

Preventivi e stampa2 procedure dettagliateApri

A cosa servePreparare preventivi con ricambi, manodopera, IVA e stampa intestata.

Apri la videata

Prima di iniziare

  • Cliente e veicolo disponibili.
  • Tariffe, logo e dati società configurati.

Campi e dati coinvolti

  • Numero
  • Cliente
  • Veicolo
  • Tipologia
  • Ricambi
  • Ore
  • Tariffa
  • IVA e totale

1Creare un preventivo

  1. Premere Nuovo preventivo.
  2. Cercare cliente e veicolo.
  3. Scegliere Officina o Carrozzeria.
  4. Aggiungere ricambi riga per riga e inserire ore.
  5. Controllare totale e salvare.

Risultato: Il preventivo conserva materiali e manodopera calcolata.

2Stampare

  1. Aprire il preventivo salvato e premere Stampa.
  2. Controllare società, proprietario e veicolo.
  3. Verificare righe, imponibile, IVA e totale.
  4. Stampare A4 o salvare PDF.

Risultato: Si ottiene il documento classico intestato.

Scadenziario2 procedure dettagliateApri

A cosa serveProgrammare revisioni, RCA, bollo e promemoria su grafico settimanale.

Apri la videata

Prima di iniziare

  • Veicolo registrato e data nota.

Campi e dati coinvolti

  • Tipo
  • Veicolo
  • Data
  • Stato

1Usare il grafico

  1. Cambiare settimana con precedente/successiva.
  2. Leggere il numero sotto ogni giorno.
  3. Selezionare il giorno.

Risultato: Una finestra mostra targhe e tipi in scadenza quel giorno.

2Creare o chiudere

  1. Premere Nuova scadenza e scegliere il tipo.
  2. Cercare la targa e inserire data/stato.
  3. Salvare; a lavoro concluso riaprire con la matita e aggiornare lo stato.

Risultato: Lista e grafico vengono aggiornati.

Statistiche2 procedure dettagliateApri

A cosa serveAnalizzare vendite mensili, capitale immobilizzato, banca e svalutazione.

Apri la videata

Prima di iniziare

  • Vendite con data/importo.
  • Veicoli con costo, ingresso e mercato.
  • Tasso bancario configurato.

Campi e dati coinvolti

  • Periodo
  • Vendite mensili
  • Totale euro
  • Costo stock
  • Valore bancario
  • Mercato
  • Svalutazione

1Analizzare vendite

  1. Selezionare il periodo.
  2. Leggere il grafico mese per mese.
  3. Confrontare numero vendite e totale euro.

Risultato: Si riconoscono andamento e mesi deboli.

2Confrontare lo stock

  1. Leggere costo complessivo.
  2. Confrontare rendimento bancario sui giorni di permanenza.
  3. Confrontare mercato e svalutazione.
  4. Aprire il dettaglio veicoli.

Risultato: Si individuano mezzi che immobilizzano capitale.

Fatturazione elettronica4 procedure dettagliateApri

A cosa serveCreare fatture e rettifiche TD04/TD05, generare XML FatturaPA e conservarne l'esito.

Apri la videata

Prima di iniziare

  • Dati fiscali completi.
  • Numerazione annuale, IVA e canale SDI configurati.

Campi e dati coinvolti

  • Numero annuale
  • Cliente
  • Data
  • Tipo TD01/TD04/TD05
  • Fattura collegata
  • Causale
  • Stato SDI
  • Imponibile
  • IVA
  • Totale

1Creare fattura

  1. Premere Nuova fattura.
  2. Cercare il cliente e verificare dati fiscali.
  3. Inserire righe, quantità, prezzi, IVA e pagamento.
  4. Controllare imponibile/totale e salvare.

Risultato: La fattura è pronta per l'XML.

2Generare e inviare XML

  1. Aprire la fattura e generare FatturaPA.
  2. Validare il file.
  3. Inviare allo SDI con il canale configurato.
  4. Archiviare ricevuta ed esito.

Risultato: Documento ed esito restano collegati.

3Annullare o ridurre una fattura inviata

  1. Nell'archivio trovare la fattura originaria.
  2. Premere Nota credito.
  3. Verificare TD04, numero/data della fattura collegata e cliente.
  4. Inserire la causale e soltanto l'importo da stornare.
  5. Controllare imponibile, IVA e totale, quindi generare/inviare il nuovo XML.

Risultato: La fattura resta immutata e la TD04 ne riduce contabilmente il valore.

4Aumentare una fattura emessa con importo insufficiente

  1. Nell'archivio trovare la fattura originaria.
  2. Premere Nota debito.
  3. Verificare TD05 e il riferimento alla fattura.
  4. Inserire causale e differenza imponibile da integrare.
  5. Controllare IVA/totale e inviare il documento allo SDI.

Risultato: La TD05 integra la fattura senza modificarla.

Registri ministeriali3 procedure dettagliateApri

A cosa serveTenere separati carico e scarico e stampare in A4 su carta vidimata.

Apri la videata

Prima di iniziare

  • Veicolo e soggetti registrati.
  • Progressivi e società configurati.

Campi e dati coinvolti

  • Data
  • Veicolo
  • Movimento
  • Operatore

1Registrare un carico

  1. Selezionare Registro di carico.
  2. Premere Nuovo carico.
  3. Compilare data, veicolo e operatore.
  4. Salvare e controllare il progressivo.

Risultato: Il movimento entra soltanto nel registro di carico.

2Registrare uno scarico

  1. Selezionare Registro di scarico.
  2. Premere Nuovo scarico.
  3. Compilare i campi e salvare.
  4. Controllare l'ordine cronologico.

Risultato: Il movimento entra soltanto nel registro di scarico.

3Stampare su carta vidimata

  1. Aprire il registro corretto e premere Stampa A4.
  2. Impostare A4, scala 100% e margini previsti.
  3. Provare prima su carta bianca.
  4. Controllare l'allineamento e poi usare la carta vidimata.

Risultato: Le righe vengono stampate sul modello scelto.

Annunci e comparabili3 procedure dettagliateApri

A cosa serveGestire annunci, risposte e prezzi consigliati Regione/Italia.

Apri la videata

Prima di iniziare

  • Veicolo completo di anno, km, kW, costi e foto.
  • Regione società e costi predefiniti configurati.

Campi e dati coinvolti

  • Veicolo
  • Canale
  • Stato
  • Risposte
  • Prezzo totale con media Regione
  • Prezzo totale con media nazionale

1Calcolare il prezzo

  1. Aprire/creare l'annuncio e cercare il veicolo.
  2. Premere Calcola prezzo.
  3. Controllare comparabili AutoScout24/Subito, anno, km, data e URL.
  4. Confrontare media Regione e Italia.

Risultato: Si ottengono due valori tracciabili quando le fonti rispondono.

2Gestire una risposta

  1. Aprire l'icona automobile di notifica.
  2. Selezionare l'annuncio con Risposte.
  3. Lavorare la richiesta e aggiornare lo stato.

Risultato: La richiesta resta collegata al veicolo.

3Pubblicare o modificare

  1. Controllare foto, descrizione e prezzo.
  2. Scegliere canale e stato.
  3. Salvare; usare la matita per correzioni.

Risultato: Canale, stato e prezzi rimangono archiviati.

Contatti commerciali3 procedure dettagliateApri

A cosa serveTrasformare le risposte agli annunci in richieste assegnate e misurabili.

Apri la videata

Prima di iniziare

  • Pubblicare almeno un annuncio o creare manualmente il contatto.
  • Configurare venditori, priorità e tempi massimi di risposta.

Campi e dati coinvolti

  • Contatto
  • Origine
  • Targa/veicolo obbligatoria
  • Fase
  • Venditore
  • Priorità
  • Rispondere entro
  • Prossima azione
  • Storico
  • Valore previsto
  • Esito

1Prendere in carico un contatto

  1. Aprire Contatti commerciali.
  2. Selezionare la scheda nella colonna Nuovo.
  3. Assegnare il venditore e scegliere la priorità.
  4. Controllare il tempo massimo di risposta calcolato e salvare.

Risultato: Il contatto ha un responsabile e un tempo massimo per la prima risposta.

2Registrare azioni e richiami

  1. Aprire il contatto.
  2. Indicare canale e prossima azione.
  3. Premere Registra contatto.
  4. Aggiornare la fase della trattativa e salvare.

Risultato: Data, canale e azione entrano nello storico; il contatto avanza tra le fasi commerciali.

3Misurare le vendite concluse

  1. Portare le opportunità concluse in Vendita conclusa o Non concluso.
  2. Indicare valore previsto ed esito.
  3. Controllare vendite concluse, risposte in ritardo e valore nei totalizzatori.

Risultato: Il responsabile commerciale vede risultati e valore delle trattative.

Visure PRA2 procedure dettagliateApri

A cosa serveImportare il PDF della visura nel fascicolo del veicolo.

Apri la videata

Prima di iniziare

  • PDF disponibile.
  • Veicolo già registrato.

Campi e dati coinvolti

  • Targa
  • Documento
  • Data
  • Operatore

1Importare

  1. Premere Importa visura.
  2. Cercare la targa.
  3. Selezionare PDF, data e operatore.
  4. Controllare l'abbinamento e salvare.

Risultato: Il PDF viene collegato al veicolo.

2Ritrovare

  1. Cercare targa, documento o operatore.
  2. Filtrare la colonna.
  3. Aprire la riga.

Risultato: Si recupera la visura richiesta.

Impostazioni4 procedure dettagliateApri

A cosa serveConfigurare stampe, rendimento bancario e tariffe automatiche.

Apri la videata

Prima di iniziare

  • Dati ufficiali della società e logo disponibili.

Campi e dati coinvolti

  • Società/P.IVA
  • Sede e contatti
  • Logo
  • Tasso bancario
  • Tariffa officina
  • Tariffa carrozzeria
  • Venditori: nome, cognome e ruolo

1Configurare le stampe

  1. Inserire società, P.IVA, sede e contatti.
  2. Caricare il logo.
  3. Premere Salva impostazioni.
  4. Aprire un preventivo e controllare l'anteprima.

Risultato: L'intestazione vale per tutti i documenti.

2Cambiare il tasso

  1. Inserire il tasso annuo.
  2. Salvare.
  3. Aprire Statistiche e controllare Valore bancario.

Risultato: Il confronto stock usa il nuovo tasso.

3Cambiare tariffe

  1. Inserire costo orario officina e carrozzeria.
  2. Salvare.
  3. Creare un nuovo lavoro/preventivo e scegliere la tipologia.

Risultato: La tariffa corretta si applica automaticamente alle ore.

4Gestire i venditori

  1. Premere Aggiungi venditore.
  2. Inserire nome, cognome e ruolo.
  3. Premere Salva impostazioni.
  4. Aprire il CRM e assegnare il contatto al venditore.

Risultato: Il venditore compare nell'elenco di assegnazione del CRM.

Ricerca e azioni comuni4 procedure dettagliateApri

A cosa serveUsare Cerca, Filtri, Nuovo, matita, cestino e Salva in tutte le griglie.

Apri la videata

Prima di iniziare

  • Aprire l'archivio interessato.

Campi e dati coinvolti

  • Cerca
  • Filtri
  • Nuovo
  • Matita
  • Cestino
  • Salva
  • Annulla

1Ricerca dal primo carattere

  1. Scrivere uno o pochi caratteri.
  2. La ricerca controlla tutte le colonne.
  3. Aprire Filtri per limitarla a una colonna.

Risultato: La griglia mostra soltanto record compatibili.

2Creare

  1. Premere Nuovo.
  2. Compilare il primo campo obbligatorio e gli altri dati.
  3. Premere Salva e attendere la chiusura.

Risultato: Il record appare nella griglia.

3Modificare

  1. Cercare il record.
  2. Premere la matita.
  3. Correggere e premere Salva.

Risultato: La riga viene aggiornata senza duplicati.

4Eliminare

  1. Premere il cestino della riga.
  2. Controllare il nome nella conferma.
  3. Premere Elimina oppure Annulla.

Risultato: Il record viene eliminato definitivamente.

Istruzioni operative e conoscenza del progetto

Apri “Guida utente videate” per usare ogni funzione. La stessa Wiki conserva inoltre architettura, decisioni e codice secondo il pattern di documentazione persistente.

FontiWiki MarkdownCodice e decisioni

Raw immutabile

Snapshot e fonti primarie non vengono riscritti. Ogni correzione entra come nuova fonte verificabile.

Wiki persistente

Pagine Markdown sintetizzate, collegate e aggiornate quando cambiano sorgenti o codice.

Schema per Codex

AGENTS.md stabilisce tassonomia, frontmatter e cicli ingest, query e lint.

Stato ufficiale del prodotto

La stessa fonte alimenta README, Wiki e controllo CI.

Aggiornato al 2026-08-19

Release

Windows 1.1.74 build 83 ricompilata il 19 agosto 2026 senza segreti nell'eseguibile; Android sorgenti 1.1.74 build 83 non ricompilati dal 14 agosto; Cloud 0.1.34-build83 pubblicata in produzione

Architettura

Cloud Next.js come riferimento grafico e funzionale; Flutter condiviso per Windows/Android; backend Neon/API, catalogo schermate, calcoli e contratti di test unici; l'azienda dei dati si risolve in un solo punto (getActiveCompanyId) e senza sessione valida nessuna maschera legge nulla

Database

Neon PostgreSQL collegato tramite API server-side; ogni lettura e scrittura filtra per azienda; archivio locale e sincronizzazione Windows/Android disponibili

Qualità

Catalogo 18 maschere e 166 campi, contratti multipiattaforma, TypeScript, ESLint; 76 prove Node fra cui la guardia che rilegge il codice e rifiuta una query su dati di azienda senza filtro o con l'azienda presa da altrove; suite Flutter 124 prove verdi su 128; controllo grafico automatico

DashboardStatisticheVeicoliAnagraficheClientiVenditeOfficinaMagazzinoBolle di carico materialiAcquisto VeicoliSchede di controlloPreventiviScadenzeFatturazioneVisure PRARegistro carico/scaricoAnnunciContatti commercialiImpostazioni

Promemoria sintetico per videata

Questa sezione è un riepilogo facoltativo; le istruzioni complete e già aperte sono all’inizio della pagina.

16 riepiloghi
Dashboard
  1. Controlla vendite, capitale immobilizzato, valore bancario, valore di mercato e giorni medi di stock.
  2. Seleziona una scheda riepilogativa per aprire il relativo archivio già filtrato.
  3. Controlla scadenze e anomalie prima di iniziare le operazioni giornaliere.
Clienti
  1. Premi Nuovo e cerca prima cognome, codice fiscale o ragione sociale per evitare duplicati.
  2. Premi File / scanner oppure Fotocamera smartphone e acquisisci CIE, patente o tessera sanitaria.
  3. Apri il testo OCR, correggi i campi proposti e premi Copia dati verificati.
  4. Nel passo Veicoli cerca targa o telaio, collega uno o più veicoli e salva.
Veicoli
  1. Cerca targa o telaio per controllare che il mezzo non sia già presente.
  2. Premi File / scanner o Fotocamera smartphone per leggere carta di circolazione o Documento Unico.
  3. Verifica targa, VIN, marca, modello e anno proposti, quindi completa acquisto e ingresso stock.
  4. Usa Modifica dalla griglia per aggiornare lo stato senza creare un duplicato.
Vendite
  1. Cerca il cliente dal primo carattere del cognome o del codice fiscale.
  2. Per un usato cerca il veicolo tramite targa. Per un nuovo attiva Veicolo nuovo e cerca/inserisci il telaio.
  3. Compila data, prezzo, pagamento e dati dell’operazione.
  4. Controlla fascicolo e documenti, quindi salva e genera la documentazione di vendita.
Officina e carrozzeria
  1. Cerca la targa dal primo carattere e seleziona il veicolo corretto.
  2. Cerca il cliente collegato e descrivi il lavoro.
  3. Nella griglia Ricambi cerca codice o descrizione, aggiungi quantità e controlla prezzo unitario e totale riga.
  4. Inserisci ore e tariffa modificabile; verifica totale ricambi, manodopera e totale lavoro prima di salvare.
  5. Salvando, i ricambi montati escono dal magazzino: riaprendo il lavoro per correggerlo i pezzi tornano a scaffale prima di riscaricare quelli giusti.
  6. Apri Storico lavori per consultare tutti gli interventi eseguiti.
Magazzino
  1. Usa la ricerca per codice, descrizione o ubicazione.
  2. Per un nuovo prodotto compila codice, descrizione, quantità, ubicazione e prezzo unitario.
  3. Salva e verifica la riga nella griglia; le bolle fornitore incrementano automaticamente la giacenza.
Acquisto Veicoli
  1. Scegli «Da professionista» — il venditore si cerca in anagrafica — oppure «Da privato», dove nome, codice fiscale e documento di chi vende si scrivono.
  2. Premi «Leggi il libretto» e passa la carta di circolazione sotto lo scanner: targa, telaio, marca e modello si riempiono da soli.
  3. Per uno stock comprato in blocco apri «Più veicoli in una volta»: il foglio del venditore, i libretti uno dopo l’altro, o a mano. Le tre strade si mescolano nella stessa bolla.
  4. Completa numero, date e prezzi e salva: il registro di carico si scrive da solo, con il contratto se hai comprato da un privato e la fattura se da un professionista.
Bolle di carico materiali
  1. Cerca il fornitore, o creane uno dall’anagrafica accanto.
  2. Registra le righe prodotto: dal secondo prodotto si apre la griglia.
  3. Il codice articolo è obbligatorio: il magazzino si carica per codice.
  4. Salva e controlla le giacenze aggiornate.
Preventivi
  1. Cerca cliente e veicolo nei rispettivi archivi.
  2. Descrivi il lavoro e scegli officina o carrozzeria.
  3. Cerca i ricambi nella griglia, imposta quantità e verifica i totali riga.
  4. Aggiungi ore, tariffa, sconto e IVA; controlla il totale, salva e stampa.
Scadenze
  1. Leggi il grafico: sotto ogni data è indicato il numero di scadenze giornaliere.
  2. Seleziona il giorno oppure premi Nuova scadenza.
  3. Cerca il veicolo per targa/telaio, scegli tipo, data e preavviso.
  4. Salva; quando completata usa Segna eseguita.
Statistiche
  1. Seleziona il periodo di analisi.
  2. Leggi grafico e totali delle vendite mensili.
  3. Confronta costo di acquisto, equivalente bancario, valore di mercato e svalutazione dello stock.
  4. Apri il dettaglio per controllare veicoli e giorni di permanenza.
Fatturazione elettronica
  1. Cerca il cliente e verifica i dati fiscali.
  2. Inserisci righe, quantità, prezzi, IVA e condizioni di pagamento.
  3. Controlla imponibile e totale, genera l’XML e valida il documento.
  4. Invia allo SDI solo con credenziali configurate e conserva ricevuta ed esito.
Registri carico e scarico
  1. Apri il registro corretto: carico e scarico hanno progressivi separati.
  2. Cerca il veicolo e completa i campi ministeriali dell’operazione.
  3. Salva rispettando l’ordine cronologico.
  4. Usa Stampa A4, controlla anteprima, margini e allineamento prima della carta vidimata.
Annunci e prezzo ipotetico
  1. Cerca e seleziona il veicolo; controlla anno, chilometri, modello e fotografie.
  2. Indica la regione della società e premi Calcola prezzo.
  3. AutoGest.ia ricerca comparabili reali su AutoScout24 e Subito.it, filtra anno e chilometraggio e separa Regione e Italia.
  4. Controlla numero di comparabili, data, URL e portali riusciti; se un portale è bloccato il risultato lo dichiara.
  5. Usa il prezzo consigliato solo dopo la verifica degli annunci sorgente, quindi salva la bozza.
Contatti commerciali
  1. Apri il contatto collegato alla targa del veicolo.
  2. Assegna venditore e priorità, quindi controlla entro quando rispondere.
  3. Registra contatti, canale e prossima azione nello storico.
  4. Sposta il contatto tra le fasi fino a Vendita conclusa o Non concluso e controlla risultati e valore.
Ricerca globale
  1. La casella in cima a ogni pagina cerca in tutti gli archivi insieme: veicoli, clienti, vendite, contatti, magazzino, fatture, registro, officina e preventivi.
  2. Servono almeno due lettere: con una sola si trova mezzo archivio, che è come non trovare niente.
  3. La targa si può scrivere con o senza spazio: «GA123AB» trova anche «GA 123AB».
  4. Ogni risultato dice in quale archivio sta e in quale colonna è stata trovata la parola; si apre la riga per andare alla scheda.
  5. Su Windows la stessa ricerca è nella barra in alto, con la scelta fra Anagrafiche, Veicoli e Ricambi e il numero dei risultati accanto a ciascuno.

Flusso applicativo

Browser o PWA → Next.js → API/Server Actions autenticate → PostgreSQL con RLS → audit.

Stato del backend

Neon PostgreSQL collegato tramite API server-side; ogni lettura e scrittura filtra per azienda; archivio locale e sincronizzazione Windows/Android disponibili. Le limitazioni ancora aperte sono dichiarate nello stato ufficiale sopra.

Guida, documentazione e codice

Il pannello mostra la guida utente e i file reali del repository, letti durante la generazione statica.

7 sorgenti indicizzate
Markdownllm-wiki/wiki/index.md

Catalogo principale: il primo file che un LLM deve leggere.

---
title: Indice AutoGest.ia Cloud
updated: 2026-09-01
status: active
sources:
  - ../raw/001-project-snapshot.md
  - ../raw/002-karpathy-pattern.md
  - ../raw/003-build83-handoff.md
code: []
---

# Indice

Leggere questa pagina per prima. La wiki descrive lo stato effettivo dei sorgenti, non una promessa commerciale.

## Progetto

- [Panoramica](overview.md) — identità, utenti e confini della webapp.
- [Architettura](architecture.md) — frontend, backend, dati, PWA, GitHub e Vercel.
- [Moduli funzionali](modules.md) — le videate, cosa fa ognuna e dove sta.
- [Motore dei contatti](motore-crm.md) — le regole che assegnano, misurano i ritardi e dicono cosa fare adesso.
- [Guida utente delle videate](GUIDA_UTENTE_VIDEATE.md) — il manuale operativo, passo per passo.
- [Modello dati](data-model.md) — tabelle PostgreSQL, tenant e Row Level Security.
- [Mappa del codice](code-map.md) — file chiave e percorso di lettura consigliato.
- [Migrazione Flutter](migration.md) — provenienza e fasi di trasferimento.
- [Operazioni](operations.md) — sviluppo locale, build e distribuzione.
- [Decisioni](decisions.md) — scelte confermate e motivazioni.
- [Questioni aperte](open-questions.md) — funzionalità ancora da implementare o decidere.

## Passaggio di consegne corrente

- [Checkpoint build 83](../../docs/HANDOFF_BUILD83.md) — stato verificato, limiti, artefatti e procedura per riprendere senza dichiarazioni premature.

## Registro

- [Log append-only](log.md) — cronologia di ingest, query e lint.