Panoramica dell'Applicazione

CETA SPA Quote Generator è un'applicazione professionale per la generazione automatica di offerte tecniche per tribune e impianti sportivi. L'applicazione permette di:

  • Caricare file Excel dal configuratore tribune e estrarre automaticamente le specifiche
  • Generare documenti Word professionali con descrizioni migliorate dall'AI
  • Gestire un database di prodotti con immagini e descrizioni bilingue (IT/EN)
  • Personalizzare i template Word per ogni tipo di offerta
  • Configurare i prompt AI per ottimizzare le descrizioni generate

Genera Offerta

Questa è la funzione principale dell'applicazione. Per generare un'offerta:

Passo 1: Preparare il File Excel

Il file Excel deve essere esportato dal configuratore tribune. L'applicazione legge automaticamente:

  • Il tab "OUTPUT OFFERTA"
  • La colonna E (descrizione) a partire dalla riga 173

Passo 2: Caricare il File

  1. Vai alla pagina "Genera Offerta" dal menu laterale
  2. Clicca sull'area di upload o trascina il file Excel
  3. Formati supportati: .xlsx, .xlsm, .xls

Passo 3: Configurare le Opzioni

  • Nome Cliente: Inserisci il nome del cliente per l'intestazione
  • Template: Seleziona il template Word da utilizzare
  • Lingua: Scegli Italiano o Inglese per le descrizioni
  • Miglioramento AI: Attiva per riscrivere le descrizioni in modo professionale

Passo 4: Generare e Scaricare

  1. Clicca "Genera Offerta"
  2. Attendi l'elaborazione (può richiedere alcuni secondi con AI attiva)
  3. Scarica il documento Word generato
Suggerimento: Il documento generato include automaticamente le schede prodotto con immagini per tutti i prodotti rilevati nel testo dell'offerta.

Gestione Prodotti

Il database prodotti è fondamentale per l'applicazione. I prodotti vengono automaticamente inseriti nelle offerte quando menzionati nel testo.

Aggiungere un Prodotto

  1. Vai a "Gestione Prodotti"
  2. Clicca "Aggiungi Prodotto"
  3. Compila i campi richiesti:
    • Nome IT/EN: Nome del prodotto in entrambe le lingue
    • Descrizione Estesa IT/EN: Descrizione tecnica dettagliata
    • Keywords: Parole chiave per il riconoscimento automatico
    • Categoria: Sedute, Strutture, Accessori, ecc.
    • Immagine: Foto del prodotto (formato PNG, JPG)
  4. Clicca "Salva Prodotto"

Keywords per il Riconoscimento

Le keywords sono fondamentali per il riconoscimento automatico dei prodotti nel testo dell'offerta. Inserisci tutte le varianti possibili del nome prodotto, separate da virgole o spazi:

Esempio: "sedili drop, drop seats, sedute drop, sedili senza schienale"

Miglioramento AI delle Descrizioni

Puoi utilizzare l'AI per migliorare le descrizioni dei prodotti:

  1. Inserisci una descrizione anche breve nel campo testo
  2. Clicca il pulsante "Migliora con AI"
  3. Verifica il testo migliorato e accetta o modifica

Template Word

I template Word definiscono il layout e lo stile dei documenti generati.

Caricare un Template

  1. Vai a "Template Word"
  2. Clicca "Aggiungi Template"
  3. Carica un file .docx
  4. Inserisci nome e descrizione

Placeholder Supportati

Nel template Word puoi utilizzare i seguenti placeholder che verranno sostituiti automaticamente:

Placeholder Descrizione
{{cliente}} Nome del cliente
{{data}} Data di generazione (formato DD/MM/YYYY)
{{codice_doc}} Codice univoco del documento
{{descrizione}} Descrizione tecnica dell'offerta (dopo questo placeholder vengono inserite le schede prodotto)
Importante: Le schede prodotto con immagini vengono inserite automaticamente subito dopo il placeholder {{descrizione}}.

Configurazione AI

I prompt AI determinano come l'intelligenza artificiale riscrive e migliora i testi. Puoi personalizzarli per ottenere risultati più adatti alle tue esigenze.

Tipi di Prompt

  • Miglioramento Descrizione Prodotto: Usato quando migliori la descrizione di un singolo prodotto
  • Riscrittura Offerta: Usato quando generi un'offerta con AI attiva

Modificare un Prompt

  1. Vai a "Prompt AI"
  2. Seleziona il prompt da modificare
  3. Modifica il testo del prompt in italiano e/o inglese
  4. Clicca "Salva"

Best Practice per i Prompt

  • Sii specifico sul tono e lo stile desiderato
  • Indica chiaramente cosa NON fare (es. non inventare specifiche)
  • Specifica la lunghezza approssimativa del testo finale
  • Mantieni coerenza tra le versioni italiana e inglese

FAQ - Domande Frequenti

L'AI non funziona, cosa devo fare?

Verifica che la chiave API OpenAI sia configurata correttamente nei Secrets dell'applicazione. La chiave deve essere nominata OPENAI_API_KEY.

I prodotti non vengono riconosciuti automaticamente

Controlla che le keywords del prodotto contengano tutte le varianti del nome usate nel file Excel. Il riconoscimento è case-insensitive ma deve trovare una corrispondenza nelle keywords.

Le immagini non appaiono nel documento Word

Verifica che l'immagine sia stata caricata correttamente nella scheda prodotto. I formati supportati sono PNG, JPG e JPEG.

Come cambio la lingua dell'interfaccia?

Usa i pulsanti IT/EN in fondo alla barra laterale sinistra per cambiare lingua.

Posso usare più template contemporaneamente?

No, ogni offerta usa un solo template. Puoi però caricare più template e selezionare quello appropriato per ogni offerta.