5.4 KiB
5.4 KiB
🚗 GoCarLog
Fahrzeug-Verwaltung & Logbuch — Ein modernes Web-Application für die Verwaltung von Fahrzeugen und deren Wartungshistorie, geschrieben in Go mit SQLite.
✨ 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