Vai al contenuto
ConstructHub
Torna ai progetti

pdfai.constructhub.org

PDFai

Schede tecniche prodotto con AI

Genera schede tecniche e documenti PDF a partire da input prodotto, con elaborazione AI e coda asincrona per risultati affidabili.

Tecnologia

Stack utilizzato per lo sviluppo del prodotto.

  • PHP 8.2+ e Laravel 12
  • Blade, Tailwind CSS 4 e Vite 7
  • MySQL e code Laravel (database driver)
  • Groq API per la descrizione tecnica AI
  • DomPDF per l’export scheda Letter
  • OAuth Google e GitHub (Socialite)
  • Import/export Excel

Architettura

Come è strutturato il sistema: interfacce, backend, infrastruttura e flusso operativo.

PDFai system architecture

Funzionalità

Cosa fa il prodotto, nel dettaglio.

  • 01

    Catalogo pubblico prodotti

    Home con ricerca, filtro categoria e paginazione. Dettaglio prodotto con overview, specifiche, applicazioni e immagine.

  • 02

    Generazione scheda tecnica PDF con AI

    Job asincrono: Groq scrive la descrizione tecnica HTML, DomPDF produce una scheda Letter monofoglio salvata in storage.

  • 03

    Download PDF on-demand dal sito pubblico

    Se il PDF manca, “Scarica scheda PDF” avvia la generazione con polling dello stato; quando pronto, apre il PDF inline nel browser.

  • 04

    CRUD admin e import/export Excel

    Creazione, modifica ed eliminazione prodotti (campi tecnici, categorie, immagini). Export Excel filtrato, import CSV/XLSX con upsert per part number e template scaricabile.

  • 05

    Generazione massiva e stati job

    Genera PDF singoli o tutti i mancanti. Stati idle → queued → processing → ready/failed, con rate-limit Groq e retry automatico.

  • 06

    Accesso admin OAuth

    Login solo OAuth (Google/GitHub), allowlist email opzionale e area `/admin` protetta da middleware admin.

  • 07

    Analytics e dashboard KPI

    Contatori di views, click tile e download PDF. Dashboard con copertura PDF, coda e salute Groq, più pagina Statistiche.

  • 08

    Localizzazione IT / EN

    Switcher lingua in UI pubblica e admin. La lingua passa al job PDF così descrizione AI e scheda restano allineate.