155 lines
5.4 KiB
Markdown
155 lines
5.4 KiB
Markdown
# 🚗 GoCarLog
|
||
|
||
**Fahrzeug-Verwaltung & Logbuch** — Ein modernes Web-Application für die Verwaltung von Fahrzeugen und deren Wartungshistorie, geschrieben in Go mit SQLite.
|
||
|
||
[](https://go.dev/)
|
||
[](https://www.sqlite.org/)
|
||
[](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`](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`](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
|
||
|
||
```bash
|
||
git clone https://git.jlserver.de/JLtec/gocarlog.git
|
||
cd gocarlog
|
||
go build -o gocarlog ./cmd/server
|
||
```
|
||
|
||
### Ausführen
|
||
|
||
```bash
|
||
# 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
|
||
|
||
```bash
|
||
# 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
|