Orchestrare input cliente, opzioni tecniche, generazione AI, revisione umana, servizi di prezzo e documenti finali in un flusso governabile.
Cosa e stato studiato
Il lavoro e partito dalla fase piu fragile della vendita tecnica: passare da una richiesta ancora informale a un documento comprensibile, stimabile e discutibile con il cliente. Sono stati separati input cliente, contesto aziendale, scelte tecniche, output generati, revisione e prezzo, evitando di trattare l'AI come una scorciatoia magica.
Cosa e stato fatto
E stata costruita una piattaforma PHP che registra aziende, clienti, progetti, opzioni tecniche, output generati, log di elaborazione, servizi e preventivi. La generazione assistita produce descrizioni, specifiche, workflow, flowchart e bozze database; il preventivo resta pero governato da servizi, opzioni, imponibile, IVA e PDF finale.
Come e stato fatto
La soluzione usa PHP custom, MariaDB, integrazione OpenAI, JavaScript/DataTables e generazione PDF. Le scelte tecniche sono state orientate a rendere ogni output tracciabile: input salvato, elaborazione registrata, risultato revisionabile e prezzo composto da elementi controllabili. In questo modo l'AI entra nel processo senza diventare l'unica fonte di verita.
Architettura e tecnologie
Come lo stack e stato usato nel progetto
Dominio prevendita e dati collegati
Preventiamo modella aziende, clienti, progetti, opzioni, servizi, output AI e preventivi come entita collegate. Questa architettura consente di leggere una proposta non come PDF isolato, ma come risultato di un processo: richiesta iniziale, scelte tecniche, materiali generati, revisione e composizione economica.
OpenAI dentro un flusso revisionabile
L'integrazione OpenAI viene usata per produrre bozze e materiali di supporto, non per chiudere automaticamente una vendita. Gli output sono salvati e possono essere controllati, corretti o scartati. Il vantaggio architetturale e mantenere l'AI dentro un percorso verificabile, con log e responsabilita umana.
Listino, opzioni e PDF finale
La parte economica resta separata dalla generazione testuale. Servizi, sottoservizi e opzioni consentono di costruire un preventivo con regole piu stabili, mentre il PDF diventa la sintesi pubblicabile del percorso. Questa separazione evita che il testo generato determini da solo importi, margini o condizioni commerciali.
Interfacce amministrative e controllo operativo
Le viste amministrative servono a governare progetti, output, opzioni e preventivi con un uso quotidiano concreto. DataTables e interfacce dense sono state preferite dove conta confrontare record, verificare stati e intervenire velocemente. Il prodotto e pensato per chi deve usare il sistema durante una trattativa, non solo per archiviare documenti.
Pattern implementativi
Dettagli tecnici che hanno guidato le scelte
Prompt orchestration e persistenza degli output
La generazione viene trattata come pipeline: si raccolgono input strutturati, si costruisce il contesto, si invia la richiesta al modello e si salva l'output con metadati utili. Questo permette di verificare cosa e stato prodotto, evitare perdita di contesto e rendere la revisione parte del flusso applicativo.
Separazione tra suggerimento AI e dato ufficiale
Un output generato non coincide automaticamente con una specifica definitiva. Il dato ufficiale nasce dopo revisione o approvazione, mentre l'AI resta un acceleratore di scrittura e organizzazione. Questa separazione riduce il rischio di trasformare un suggerimento plausibile in promessa commerciale non verificata.
Preventivo come albero di servizi
La stima economica viene modellata con servizi, sottoservizi, opzioni, flag e totali. Il pattern consente di cambiare listino, raccomandazioni o struttura del preventivo senza riscrivere tutto il documento. Il prezzo resta una composizione controllabile, non un testo libero.
Audit minimo su elaborazioni e documenti
Log di elaborazione, output salvati e PDF finali permettono di ricostruire come una proposta e stata costruita. Questo non sostituisce un sistema documentale completo, ma fornisce un audit minimo utile nella prevendita tecnica: cosa e stato chiesto, cosa e stato generato, cosa e stato consegnato.
Risultati e apprendimenti
Base gestionale online per trasformare richieste software in elaborati, specifiche e preventivi piu coerenti, mantenendo revisione umana e regole di prezzo controllate.
- l'AI nella prevendita funziona se resta dentro un processo revisionabile
- prezzo e testo commerciale devono restare separati
- la tracciabilita degli output e utile quanto la velocita di generazione