PZeta Utils

Documentazione unificata delle 12 librerie utilitarie PZeta per Vue 3 — form dinamici, ricerca, kanban, attività, widget dashboard, fogli di calcolo ERP, microfrontend e altro.

Panoramica

PZeta Utils è la suite di librerie Vue 3 / TypeScript sviluppate da PZeta per costruire applicazioni ERP enterprise. Ogni libreria è pubblicata sul registry npm interno (@pzeta:registry=https://gitea.pzetatouch.it/api/packages/pzeta_touch/npm/) e segue gli stessi standard di stack, qualità e versioning.

Questo sito offre tre canali di accesso alla documentazione:

UI web per sviluppatori — sidebar navigabile, ricerca full-text (Cmd+K), live preview dei componenti
MCP server per AI assistant (Claude Code, Cursor) — interrogazione strutturata della documentazione
llms.txt / llms-full.txt — indice completo per LLM context

Indice librerie

Form, validazione e input

Libreria	Versione	Descrizione
`@pzeta/vue-form`	1.x	Sistema form schema-driven con 30+ tipi di input, 80+ validatori, layout normal/tabs/wizard/accordion, i18n integrato
`@pzeta/vue-formatters`	1.x	Composable per formattare valori italiani: valuta, date, numeri, codice fiscale, partita IVA, telefono

Ricerca e dati

Libreria	Versione	Descrizione
`@pzeta/vue-ricerca`	1.x	Toolbar di ricerca config-driven con generazione automatica di query PostgREST, preset salvabili e rule builder
`@pzeta/vue-importexport`	0.x	Wizard multi-step import/export con mapping campi sorgente→target, supporto CSV (papaparse) ed Excel (exceljs), template e tracking asincrono

Kanban, attività e workflow

Libreria	Versione	Descrizione
`@pzeta/vue-kanban`	1.x	Board kanban enterprise con fasi configurabili, drag-and-drop, eventi real-time, CRUD admin
`@pzeta/attivita`	0.x	Gestione attività e follow-up: calendario, timeline, ricorrenze (RRULE), firma digitale, partecipanti

Dashboard e widget

Libreria	Versione	Descrizione
`@pzeta/vue-widget`	0.x	50+ widget dashboard con registry dinamico, Chart.js, charts geo, i18n in 5 lingue, preset icone
`@pzeta/vue-foglidicalcolo`	1.x	Editor fogli di calcolo enterprise basato su Fortune Sheet, dati ERP via PostgREST, versioning, lock pessimistico, ACL

File, allegati e shortcuts

Libreria	Versione	Descrizione
`@pzeta/vue-attachment`	1.x	Gestione allegati upload/download/preview con adapter Strategy (axios/fetch/mock) e supporto MinIO
`@pzeta/vue-scorciatoie`	1.x	Keyboard shortcuts e command palette `Cmd+K` cross-OS, scorciatoie globali e contestuali

Internazionalizzazione e integrazione

Libreria	Versione	Descrizione
`@pzeta/vue-i18n`	1.x	Composable i18n leggero con lazy loading delle locale e cache, fallback automatico
`@pzeta/mfe-contracts`	1.x	Contratti TypeScript per integrazione microfrontend nella shell Vue: manifest, lifecycle, loader ESM, composables CRUD

Quando usare cosa

Devo...	Libreria
Costruire un form complesso con campi dinamici	`vue-form`
Aggiungere una barra di filtri a una pagina lista con backend PostgREST	`vue-ricerca`
Implementare una board kanban con fasi	`vue-kanban`
Tracciare attività, appuntamenti, follow-up	`attivita`
Mostrare una dashboard con widget metrici/grafici	`vue-widget`
Permettere all'utente di lavorare in un foglio di calcolo con dati ERP	`vue-foglidicalcolo`
Importare/esportare dati massivi con mapping	`vue-importexport`
Gestire upload e preview di file/documenti	`vue-attachment`
Aggiungere scorciatoie da tastiera e command palette	`vue-scorciatoie`
Formattare valori italiani (€, date, CF, P.IVA)	`vue-formatters`
Tradurre la UI con lazy loading delle lingue	`vue-i18n`
Esporre un microfrontend nella shell	`mfe-contracts`

Stack comune

Tutte le librerie condividono lo stesso stack:

Vue 3 Composition API (>=3.4)
TypeScript strict mode
Tailwind CSS 4 utility-first (nessun blocco <style> nei componenti)
@pzeta/vue-components come base UI di riferimento
PostgREST come pattern di accesso dati (dove applicabile)
Biome per format + lint
Vitest per test
Vite library mode per il build (con vite-plugin-dts per le type declarations)

Risorse esterne

Documentazione UI library: @pzeta/vue-components
Repository Gitea: gitea.pzetatouch.it/PZeta_Touch
MCP Server: @pzeta/docutils — interroga questa documentazione direttamente da Claude Code o Cursor

Versionamento e licenza

Tutte le librerie seguono Semantic Versioning e sono pubblicate su registry npm privato PZeta. Licenza: UNLICENSED — uso interno PZeta.