Prodotto local-first funzionale · Versione 0.1.0 non pubblicata2026

Baustelle Calculator

Workspace local-first per preventivi, esecuzione e fatturazione delle piccole imprese

Il mio ruolo

Architettura prodotto · Modellazione dominio · Full-stack · Flussi documentali · Test

01

Panoramica

Baustelle Calculator è un’applicazione browser autonoma per piccole imprese edili e di servizio che richiedono un calcolo trasparente dei lavori senza adottare un ERP completo.

Collega il calcolo dei costi in stile tedesco a un flusso pratico: posizioni con lavoro, macchine, materiali e servizi esterni; preventivo; piano operativo senza prezzi; dati reali e lavori extra approvati; infine la fattura conclusiva.

Il prodotto attuale è volutamente local-first. Progetti, dati aziendali, ricette e un numero limitato di foto restano nel browser e possono essere esportati e ripristinati tramite backup JSON versionati. L’app è funzionale e testata, ma la 0.1.0 non ha una release pubblica; XRechnung/ZUGFeRD e il runtime SaaS preparato non sono attivi.

02

Screenshot reali del prodotto

Qui verranno inseriti esclusivamente screenshot reali del prodotto, senza mockup o immagini stock.

La dashboard riunisce stato del lavoro, totali calcolati e prossimi passaggi del flusso.
Un preventivo pronto per il cliente, generato direttamente dal calcolo strutturato del progetto.

03

Architettura

Cockpit aziendale

Progetti · Stato · Ricerca · Duplicazione · Numeri automatici

Dominio di calcolo

Lavoro · Macchine · Materiali · Servizi · Costi indiretti

Flusso di esecuzione

Piano · Feedback · Foto · Lavori extra

Documenti e dati locali

Preventivo · Fattura · Foglio cantiere · localStorage · JSON

04

Stato del progetto

Realizzato

  • Motore deterministico EK/HK/SK, overhead, rischio, profitto e IVA
  • Costi per unità o una tantum e input decimali con virgola
  • Archivio progetti con ricerca, duplicazione, filtri e numeri documentali
  • Riferimenti modificabili per lavoro, macchine, materiali e servizi
  • Recipe Builder guidato e ricette salvate
  • Calcolo interno e vista cliente pulita
  • Accettazione del preventivo in un flusso senza prezzi
  • Dati reali, foto locali e extra approvati fatturabili
  • Angebot, Rechnung, Ausführungsplan e Baustellenzettel stampabili
  • Identità aziendale, controlli documentali e bozza email
  • Persistenza locale e backup/ripristino JSON versionato
  • Test Vitest e Playwright per calcolo, recovery, workflow, stampa e UI responsive

In sviluppo attivo

  • Preparazione del pilot local-first e miglioramenti pratici della UX
  • Flusso di esportazione e layout documenti più rifiniti
  • Editing più compatto su smartphone e tablet
  • Validazione sul campo di ricette e costi per unità/una tantum

Pianificato

  • Output XRechnung/ZUGFeRD strutturato e validato
  • Auth cloud, storage privato e persistenza workspace dopo il release gate
  • Workspace SaaS e abbonamenti, bloccati fino ad approvazione esplicita
  • Storage media più robusto se le foto superano i limiti del browser

05

Decisioni tecniche

Perché local-first nella prima versione?

Una piccola impresa può iniziare senza account o infrastruttura; i backup JSON versionati mantengono i dati portabili e recuperabili.

Perché collegare preventivo ed esecuzione?

Il preventivo accettato contiene già il lavoro pianificato: riutilizzarlo evita duplicazioni, nasconde i prezzi interni e porta gli extra approvati in fattura.

Perché documenti tramite stampa browser?

Offrono valore pratico subito senza dichiarare implementati o validati formati di fattura elettronica strutturata.

06

Problemi risolti

  • 01Totali deterministici tra quantità, scope e profili fiscali
  • 02Conservazione dei progetti attraverso normalizzazione e backup
  • 03Costi interni separati dai documenti cliente e squadra
  • 04Cinque documenti leggibili su A4
  • 05Usabilità da 390px al desktop
  • 06Foto progetto entro limiti pratici del browser

07

Tecnologie

Applicazione

  • React 18
  • TypeScript
  • Vite
  • CSS

Dominio

  • Motore di calcolo
  • Motore fatture
  • Profili fiscali

Dati locali

  • localStorage
  • Backup JSON versionato
  • Normalizzazione
  • Recovery UI

Qualità

  • Vitest
  • Playwright
  • ESLint
  • Prettier

08

Cosa dimostra

Baustelle Calculator dimostra come trasformo regole di costo, lavoro sul campo e requisiti documentali in un prodotto focalizzato, recuperabile e testato a fondo.

Per chi è rilevante

Rilevante per artigiani, edilizia, giardinaggio, cura degli alberi e piccole imprese di servizio che necessitano di calcoli trasparenti e un flusso semplice dal preventivo alla fattura senza ERP completo.

Ti serve un sistema simile?

Posso progettare e sviluppare una soluzione adatta al tuo flusso di lavoro, al team e agli obiettivi aziendali.

Parliamo del progetto