Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,98 @@
+---
+title: Tracktor
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, tracking, vehicules, maintenance, carburant, self-hosted]
+confidence: medium
+contested: false
+sources: [https://selfh.st/apps/tracktor, https://github.com/javedh-dev/tracktor]
+---
+
+# Tracktor
+
+> Un système de gestion de flotte automobile pour suivre la consommation de carburant, la maintenance, les assurances et les documents réglementaires de vos véhicules.
+
+| Métadonnée | Valeur |
+| :--- | :--- |
+| **Site web** | https://tracktor.bytedge.in/ |
+| **GitHub** | https://github.com/javedh-dev/tracktor |
+| **License** | MIT |
+| **Langage principal** | Svelte / TypeScript |
+| **Étoiles GitHub** | ⭐933 |
+| **Dernière MAJ** | 2026-03-30 (v1.4.1) |
+| **Catégorie** | [[cat-tracking]] |
+
+## Description
+
+> ⚠️ **Note** : malgré son nom générique, Tracktor est en réalité un **tracker de véhicules** (gestion de flotte automobile), et non un outil de time tracking pour freelances. Cette fiche reflète la nature réelle du projet.
+
+Tracktor est une application web open source conçue pour la **gestion complète d'un ou plusieurs véhicules** : voiture, moto, scooter, utilitaire. Elle centralise toutes les informations utiles au propriétaire : pleins de carburant, entretiens mécaniques, contrôles techniques, échéances d'assurance, certificats de pollution, et plus généralement tout document associé à un véhicule.
+
+Le **tableau de bord** propose une visualisation synthétique des métriques clés (consommation moyenne, coût au kilomètre, prochaines échéances) et liste les alertes à venir. Chaque véhicule peut être ajouté avec son type de carburant (essence, diesel, électrique, hybride), ses caractéristiques techniques, et ses différents rappels configurables. L'application supporte nativement plusieurs véhicules, ce qui en fait un outil pertinent pour les familles ou les petits gestionnaires de flotte.
+
+L'**architecture technique** est volontairement légère : SvelteKit en frontend et backend, SQLite avec Drizzle ORM pour la persistance, et un déploiement Docker trivial. Le code est encore jeune (v1.x) et l'auteur avertit explicitement d'un risque de breaking changes : des sauvegardes régulières de la base SQLite sont donc recommandées. Les notifications multicanal (Email, Webhook, Gotify) permettent d'être prévenu à temps des renouvellements importants.
+
+## Installation
+### Via Docker (recommandé)
+```yaml
+services:
+  tracktor:
+    container_name: tracktor
+    image: ghcr.io/javedh-dev/tracktor:latest
+    restart: unless-stopped
+    ports:
+      - "3010:3000"
+    volumes:
+      - tracktor-db:/app/database
+      - tracktor-uploads:/app/uploads
+    environment:
+      - TZ=Europe/Paris
+volumes:
+  tracktor-db:
+  tracktor-uploads:
+```
+Lancer `docker compose up -d`, puis créer le premier compte depuis l'interface.
+
+### Installation manuelle
+1. Cloner : `git clone https://github.com/javedh-dev/tracktor.git`
+2. Installer Node.js 20+ et pnpm : `pnpm install`
+3. Lancer les migrations : `pnpm db:push`
+4. Démarrer en dev : `pnpm dev` ou build prod avec `pnpm build && pnpm start`
+
+## Configuration
+
+- À la première connexion, **créer le compte administrateur** (authentification username/password avec gestion de session).
+- Configurer le **fuseau horaire** (`TZ`) dès l'installation pour des dates cohérentes.
+- Activer ou désactiver les **modules** (carburant, maintenance, assurances, etc.) via les feature toggles selon vos besoins.
+- Brancher les **notifications** : Email SMTP, Webhook générique, ou Gotify pour des alertes push auto-hébergées.
+- Sauvegarder régulièrement le volume `tracktor-db` (la base SQLite) car le projet est en développement actif.
+
+## Alternatives
+### Open source
+- **Hammudi** — tracker de véhicules similaire en PHP
+- **Rezvoy** — gestion de flotte plus complète (PHP/MySQL)
+- **Fuelio** (mobile) — suivi carburant, mais propriétaire et Android uniquement
+- [[app-dumbassets]] — pour les inventaires d'objets en général (pas spécifiquement véhicules)
+### Propriétaires
+- **Drivy/Getaround** — plateformes de location entre particuliers avec suivi intégré
+- **AUTOsist** — gestion de flotte commerciale (payant, freemium limité)
+
+## Sécurité
+
+- Authentification par **username/password** avec gestion de session serveur (cookies httpOnly).
+- **Pas de chiffrement at-rest** par défaut : protéger le volume `tracktor-db` au niveau du système de fichiers (LUKS, ZFS natif).
+- **HTTPS obligatoire** en production : déployer derrière un reverse proxy (Caddy, Traefik, NPM).
+- **Sauvegardes SQLite fréquentes** : le projet étant en v1.x, les migrations futures pourraient casser le schéma.
+- Restreindre l'accès réseau au port interne par un firewall ou un réseau Docker isolé.
+
+## Ressources
+- Démo en ligne : https://tracktor.bytedge.in/
+- Dépôt GitHub : https://github.com/javedh-dev/tracktor
+- Image GHCR : https://github.com/users/javedh-dev/packages/container/package/tracktor
+- Script Proxmox Helper : https://community-scripts.github.io/ProxmoxVE/scripts?id=tracktor
+- Discussion Reddit : https://www.reddit.com/r/selfhosted/comments/1m9c1sf/
+
+## Pages Liées
+- [[cat-tracking]]
+- [[recettes-docker-compose]]