EasyPIVA 2026

EasyPIVA è una web app open source per simulazioni fiscali indicative dedicate alla Partita IVA italiana. Riunisce calcolo del regime forfettario, contributi INPS, confronto con il regime ordinario, pianificazione dei ricavi e generazione di preventivi con export PDF.

Apri EasyPIVA · Consulta le fonti fiscali · Leggi il changelog

• Tutti i calcoli vengono eseguiti localmente nel browser.
• Non richiede account, backend applicativo o telemetria.
• Le assunzioni fiscali 2026 sono centralizzate, testate e documentate con fonti primarie.
• Il codice è pubblico e distribuito con licenza MIT.

I risultati sono stime indicative e non costituiscono consulenza fiscale, legale o contabile. Per decisioni professionali è necessario rivolgersi a un consulente abilitato.

Funzionalità

• Calcolo del regime forfettario 2026.
• Confronto indicativo tra regime forfettario e ordinario.
• Simulazione dei contributi INPS per Gestione Separata, Artigiani e Commercianti.
• Calcolo inverso del fatturato necessario per raggiungere un netto obiettivo.
• Pianificazione mensile dei ricavi rispetto alle soglie del regime.
• Preventivo locale con anteprima A4, autosalvataggio nel browser ed export PDF.

Attendibilità e limiti

EasyPIVA rende verificabili le proprie assunzioni senza presentarsi come sostituto di un professionista:

• soglie, aliquote e coefficienti sono centralizzati in src/lib/fiscal-data.ts;
• la logica fiscale è isolata in funzioni pure sotto src/lib/calculations/;
• le assunzioni e le fonti normative sono documentate nell'ADR fiscale e nell'informativa pubblica;
• test unitari, UI ed end-to-end proteggono i principali casi di regressione;
• ogni cambiamento fiscale richiede aggiornamenti coordinati di codice, test, documentazione e copy pubblica.

Privacy

Il progetto segue un'architettura local-first: non invia a un server i valori inseriti nei simulatori o nel preventivo. Tema, consenso al disclaimer e bozza del preventivo possono essere salvati nel localStorage del browser. Il dettaglio è in Privacy e storage locale.

Release 1.1.1

La versione corrente del repository è 1.1.1.

• Corregge la scelta del massimale INPS 2026 per Artigiani e Commercianti in base all'anzianità contributiva.
• Rafforza accessibilità, navigazione da tastiera e gestione del menu mobile.
• Rende più robusti upload del logo, autosalvataggio ed export PDF del preventivo.
• Aggiunge controlli axe end-to-end, metadata per i crawler e aggiornamenti di sicurezza delle dipendenze.

Il dettaglio completo è nel changelog.

Stack

• React 19, React Router 8, TypeScript 6 e Vite 6.
• Tailwind CSS v4 e componenti shadcn/ui.
• Zustand, React Hook Form e Zod.
• Recharts, motion e jsPDF.
• Vitest con jsdom e Playwright con Chromium.

Sviluppo locale

Richiede Node.js 24 LTS, npm 11 e npm come package manager canonico.

git clone https://github.com/TheStreamCode/easypiva.git
cd easypiva
npm ci
npm run dev

L'app viene servita su http://127.0.0.1:3000.

Verifiche

npm run ci
npm audit

npm run ci esegue formattazione, typecheck, lint, test Vitest, build di produzione e test Playwright. Se Chromium non è ancora installato, esegui una volta npx playwright install chromium.

Gli script disponibili sono documentati in package.json; i principali sono dev, dev:e2e, typecheck, lint, test, test:e2e, build e ci.

Struttura del repository

src/
  pages/            # Route pubbliche, lazy loaded da App.tsx
  components/       # Layout, disclaimer e componenti del preventivo
  lib/
    calculations/   # Logica fiscale pura e testata
    quote/          # Modello preventivo, paginazione ed export PDF
    fiscal-data.ts  # Costanti fiscali 2026
  store/            # Store Zustand
components/ui/      # Primitivi UI condivisi
tests/e2e/          # Test end-to-end Playwright
docs/               # Architettura, privacy, ADR e governance

Deployment

La build statica prodotta in dist/ viene pubblicata su Vercel dal branch main. vercel.json gestisce il routing client-side e gli header HTTP di sicurezza. Il progetto non utilizza un backend applicativo né variabili d'ambiente runtime.

Documentazione

• Architettura
• Privacy e storage locale
• Assunzioni fiscali
• Governance repository
• Provenienza degli asset
• Contribution policy
• Security policy
• Code of Conduct

Governance e segnalazioni

Il repository è pubblico, ma la manutenzione segue un workflow maintainers-only. Sono benvenute issue riproducibili e segnalazioni fiscali corredate da fonti primarie; il repository non fornisce consulenza fiscale o supporto personalizzato. Consulta CONTRIBUTING.md prima di aprire una segnalazione e SECURITY.md per comunicare privatamente una vulnerabilità.

La CI usa permessi minimi, le GitHub Actions sono fissate a commit SHA e le pull request eseguono anche Dependency Review. Il branch main richiede review, check obbligatori, conversazioni risolte e storia lineare.

Progetto

EasyPIVA è mantenuto da Michael Gasperini (Mikesoft). Se il progetto ti è utile, puoi supportarne lo sviluppo tramite GitHub Sponsors.

Licenza

Questo progetto è distribuito con Licenza MIT.