🚗 GoCarLog

Fahrzeug-Verwaltung & Logbuch — Ein modernes Web-Application für die Verwaltung von Fahrzeugen und deren Wartungshistorie, geschrieben in Go mit SQLite.

Go SQLite License

✨ Features

  • Fahrzeugverwaltung – Anlegen, Bearbeiten und Verwalten mehrerer Fahrzeuge
  • Logbuch – Einträge für Tankungen, Wartungen, Reparaturen und Notizen
  • Verbrauchsberechnung – Automatischer Durchschnittsverbrauch und Verbrauch pro Tankung (L/100km)
  • Automatische Odometer-Aktualisierung – Kilometerstand wird bei Tankungen aktualisiert
  • Filter & Sortierung – Logbucheinträge und Fahrzeuge nach verschiedenen Kriterien filtern und sortieren
  • Kostenübersicht – Gesamtkosten pro Log-Typ (Tankung, Wartung, Reparatur, Notiz)
  • Modernes UI – Dark Theme, responsive Design, clientseitige Sortierung

🏗 Technologie-Stack

Schicht Technologie
Backend Go (Golang) 1.19+
Datenbank SQLite (via github.com/mattn/go-sqlite3)
Frontend HTML5, CSS3, Vanilla JavaScript
Deployment Statische Single-Binary, eingebettetes Frontend

📁 Projektstruktur

gocarlog/
├── cmd/server/main.go          # Anwendungseinstiegspunkt
├── internal/                   # Interne Pakete
│   ├── db/                     # Datenbank-Schicht (Migration, Seed)
│   ├── model/                  # Datenmodelle und Business-Logik
│   ├── handler/                # HTTP-Handler für API-Endpunkte
│   ├── middleware/             # HTTP-Middleware (CORS, Logging)
│   └── router/                 # Router-Konfiguration
├── frontend/                   # Statische Web-Assets
│   ├── index.html              # Hauptseite
│   ├── css/style.css           # Stylesheet (Dark Theme)
│   ├── js/app.js               # Frontend-Logik
│   └── assets/                 # Icons, Bilder
├── tests/                      # Backend-Unit-Tests
│   ├── model_test.go
│   ├── handler_test.go
│   └── database_test.go
├── docs/                       # Dokumentation
│   ├── database-schema.md      # Datenbank-Schema
│   ├── api-spec.md             # API-Spezifikation
│   └── project-structure.md    # Projektstruktur
├── DEVELOPMENT.md              # Entwicklungsstatus
├── go.mod / go.sum             # Go-Module-Abhängigkeiten
└── gocarlog                    # Kompiliertes Binary

🗄 Datenbank-Struktur

Drei Tabellen mit Fremdschlüssel-Beziehungen:

Tabelle Beschreibung
fuels Kraftstofftypen (Diesel, Benzin, LPG, CNG, Strom) mit Mengeneinheit
vehicles Fahrzeugeigenschaften (Name, Hersteller, Modell, Kennzeichen, Odometer, etc.)
logs Logbucheinträge (Tankung, Wartung, Reparatur, Notiz)

Auto-Update: Der current_odometer eines Fahrzeugs wird automatisch aktualisiert, wenn ein Tankungs-Eintrag mit einem höheren Kilometerstand erstellt wird.

→ Siehe docs/database-schema.md für das vollständige Schema.

🔌 API

Alle Endpunkte unter /api/v1/..., Antwortformat: JSON.

Methode Pfad Beschreibung
GET /api/v1/fuels Alle Kraftstoffe
POST /api/v1/vehicles Neues Fahrzeug erstellen
GET /api/v1/vehicles Fahrzeuge auflisten (Filter: Name, Kennzeichen, Kraftstoff, etc.)
GET /api/v1/vehicles/:id Fahrzeugdetails
POST /api/v1/logs Logbucheintrag erstellen
GET /api/v1/logs Logbucheinträge (Filter: Fahrzeug, Typ, Zeitraum)
GET /api/v1/vehicles/:id/consumption Durchschnittsverbrauch berechnen

→ Siehe docs/api-spec.md für vollständige Spezifikation mit Request-/Response-Beispielen.

🚀 Installation

Voraussetzungen

  • Go 1.19 oder neuer
  • GCC (für CGO/SQLite-Unterstützung)

Kompilieren

git clone https://git.jlserver.de/JLtec/gocarlog.git
cd gocarlog
go build -o gocarlog ./cmd/server

Ausführen

# Server starten (Standard-Port: 8080)
./gocarlog

# Eigenen Port setzen
PORT=3000 ./gocarlog

Der Server liefert sowohl die API als auch das Frontend aus:

URL Funktion
http://localhost:8080/ Frontend
http://localhost:8080/api/v1/... REST API
http://localhost:8080/static/... Statische Assets

🧪 Tests

# Alle Tests
go test ./tests/...

# Mit Deckungsbericht
go test -cover ./tests/...

🖥 Frontend-Ansichten

  • Logbuch – Tabellarische Übersicht mit Filtern, Sortierung und Verbrauchsspalte
  • Fahrzeuge – Fahrzeugliste mit Filterung
  • Fahrzeugdetails – Vollständige Fahrzeugdaten + Durchschnittsverbrauch

📝 Log-Typen

Typ Beschreibung
tankung Kraftstofftankung (mit Menge, Kosten, Verbrauchsberechnung)
wartung Wartungsarbeiten
reparatur Reparaturen
notiz Freie Notiz

🔮 Geplante Erweiterungen

  • Export-Funktion (CSV/JSON)
  • Diagramme / Graphen (Verbrauch über Zeit)
  • Benutzer-Accounts & Authentifizierung
  • Verbrauch-Filter in Logbuch-Ansicht

📄 Lizenz

MIT License

S
Description
A tool to manage Maintenance and Fuel consumption for your Vehicles
Readme 8.4 MiB
Languages
Go 55.1%
JavaScript 21.5%
HTML 13%
CSS 10.4%