Come organizzare le spese dell'auto con Tracktor

Avevo ricevute del carburante accumulate nel cassetto portaoggetti per anni, appunti sugli oli cambio sparsi tra le note del telefono, e la mia polizza OSAGO finiva sempre persa nelle profondità della mia email. Ti suona familiare? Se hai due auto in famiglia o anche una motocicletta, tenere traccia della manutenzione programmata e delle scadenze delle assicurazioni diventa un'impresa a parte. La maggior parte delle app mobili per il tracciamento delle auto sono piene di pubblicità, richiedono un abbonamento a pagamento, o memorizzano i tuoi dati sui server di qualcun altro.

Recentemente mi sono imbattuto nel progetto Tracktor su GitHub. È un servizio self-hosted per la gestione del garage che riunisce rifornimenti di carburante, riparazioni, ispezioni, assicurazioni e promemoria. Ho deciso di implementarlo sul mio server di casa e vedere quanto sia comodo nella vita di tutti i giorni.

Cosa può fare il servizio

Il creatore del progetto si è concentrato sulle funzionalità essenziali di cui ogni proprietario di auto ha bisogno, senza fronzoli inutili.

La pagina principale ti accoglie con una dashboard personalizzabile. I widget possono essere trascinati per mostrare ciò che è più importante: spese recenti, consumo di carburante o un servizio imminente.

Sono integrate diverse sezioni principali.

Il garage supporta un numero illimitato di veicoli. Per ogni auto o motocicletta, puoi impostare il tipo di carburante, il chilometraggio base e le specifiche. Comodo se la famiglia ha più auto o se stai aiutando i parenti a tenere traccia della loro flotta.

Il tracciamento del carburante calcola il consumo medio e le tendenze dei costi per chilometro. Inserisci litri, importo e lettura attuale del contachilometri, e il sistema crea grafici e rileva anomalie autonomamente. Se il consumo improvvisamente inizia ad aumentare, è immediatamente visibile nei rapporti.

Il registro dei servizi memorizza la cronologia di riparazioni, sostituzioni di materiali di consumo e manutenzione programmata. Ogni voce può avere un costo e il chilometraggio a cui è stato eseguito il lavoro associato.

Il controllo dei documenti e i promemoria ti salvano dalle scadenze di assicurazione e ispezione. Inserisci la data di scadenza della polizza o l'intervallo della prossima sostituzione del liquido dei freni, e il servizio ti avvisa con largo anticipo.

I rapporti compilano le spese in grafici chiari. Puoi vedere immediatamente quale parte del tuo budget va alla benzina rispetto alla manutenzione programmata e all'assicurazione.

L'interfaccia ha toggle per i moduli: se non hai bisogno del tracciamento del certificato ambientale o di analisi dettagliate, quei blocchi possono essere disabilitati nelle impostazioni con un singolo pulsante. L'interfaccia è tradotta in 11 lingue, con il russo già incluso.

Sotto il cofano

L'architettura del progetto appare pulita e moderna. Non ci sono microservizi ingombranti o database pesanti che richiedono gigabyte di RAM.

Il frontend e il backend sono scritti in SvelteKit con il nuovo Svelte 5 e gli stili in Tailwind CSS. Per l'archiviazione dei dati, lo sviluppatore ha scelto la combinazione di SQLite e Drizzle ORM.

Questo stack offre vantaggi evidenti:

1. Consumo minimo di risorse. L'app funzionerà senza problemi su un vecchio Raspberry Pi, una macchina virtuale economica per un paio di dollari, o in un container Proxmox LXC.
2. Backup semplici. L'intero database sta in un singolo file SQLite, che è facile copiare su schedule verso un archivio locale o il cloud.
3. Interfaccia rapida e reattiva senza ritardi durante la navigazione tra le schermate.

Tuttavia, c'è un avviso nel repository: il progetto è in fase di sviluppo attivo, quindi le release potrebbero contenere modifiche incompatibili. L'autore consiglia esplicitamente di configurare backup regolari del database prima di aggiornare.

Configurazione rapida Docker

Il modo più veloce per avviare l'app è lanciare l'immagine Docker pronta all'uso tramite docker-compose.

Crea un file docker-compose.yml:

services:
  app:
    image: ghcr.io/javedh-dev/tracktor:latest
    container_name: tracktor-app
    restart: always
    ports:
      - '3333:3000'
    volumes:
      - tracktor-data:/data

volumes:
  tracktor-data:

Avvia il container con il comando:

docker compose up -d

Dopo l'avvio, l'interfaccia web sarà disponibile all'indirizzo http://localhost:3333 o tramite l'indirizzo IP del server sulla rete locale.

L'autenticazione utilizza la classica combinazione di username e password con le sessioni. Se prevedi di esporre l'accesso esternamente, è sufficiente mettere l'app dietro un reverse proxy come Nginx, Caddy o Traefik con un certificato HTTPS.

A chi sarà utile questo progetto

Tracktor è adatto a chi ama tenere i dati personali sotto il proprio controllo e valorizza l'autonomia.

Risolve bene questi compiti:

• Proprietari di più auto o motociclette che sono stanchi di destreggiarsi tra libretti di manutenzione e ricevute.
• Appassionati di hosting domestico che cercano un'alternativa leggera ai servizi commerciali di tracciamento delle spese.
• Piccole flotte familiari dove hai bisogno di visibilità trasparente sui costi totali di trasporto.

Se hai sempre voluto organizzare la cronologia di manutenzione del tuo veicolo e smettere di tenere traccia delle date di sostituzione delle candele e delle rinnovi dell'assicurazione nella tua testa, il progetto vale sicuramente la pena di provarlo. Dai un'occhiata al repository di Tracktor, avvia un container e vedi tu stesso.