Initial commit: gocarlog project — Milestones 1-10 completed

This commit is contained in:
2026-06-07 11:57:42 +02:00
commit 1d17422093
29 changed files with 4532 additions and 0 deletions
+163
View File
@@ -0,0 +1,163 @@
# GoCarLog - Datenbankstruktur
## Übersicht
GoCarLog verwendet SQLite als eingebettete Datenbank. Das Schema besteht aus drei Tabellen:
`fuels`, `vehicles`, und `logs`.
---
## Tabelle: `fuels` (Kraftstoffe)
Speichert alle verfügbaren Kraftstofftypen mit ihrer Mengeneinheit.
| Spalte | Typ | Constraint | Beschreibung |
|-------------|-------------|-------------------|---------------------------|
| `id` | INTEGER | PRIMARY KEY | Eindeutige ID |
| `name` | TEXT | NOT NULL UNIQUE | Name des Kraftstoffs |
| `unit` | TEXT | NOT NULL | Mengeneinheit |
### Initiale Daten
| id | name | unit |
|----|--------|-------|
| 0 | Diesel | L |
| 1 | Benzin | L |
| 2 | LPG | L |
| 3 | CNG | L |
| 4 | Strom | kWh |
---
## Tabelle: `vehicles` (Fahrzeuge)
Speichert die Eigenschaften aller Fahrzeuge.
| Spalte | Typ | Constraint | Beschreibung |
|---------------------|-------------|--------------------------|-------------------------------|
| `id` | INTEGER | PRIMARY KEY AUTOINCREMENT| Eindeutige Fahrzeug-ID |
| `name` | TEXT | NOT NULL | Name/Bezeichnung des Fahrzeugs|
| `manufacturer` | TEXT | | Hersteller (optional) |
| `model` | TEXT | | Modell (optional) |
| `year` | INTEGER | | Baujahr (optional) |
| `description` | TEXT | | Beschreibung (optional) |
| `license_plate` | TEXT | | Kennzeichen (optional) |
| `purchase_date` | DATE | | Kaufdatum (optional) |
| `weight_kg` | REAL | | Gewicht in kg (optional) |
| `power_kw` | REAL | | Leistung in kW (optional) |
| `max_odometer` | REAL | | Höchster Kilometerstand (optional) |
| `current_odometer` | REAL | NOT NULL DEFAULT 0 | Aktueller Kilometerstand |
| `fuel_id` | INTEGER | NOT NULL REFERENCES fuels(id) | Fremdschlüssel zu fuels |
| `created_at` | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP | Erstellungszeitpunkt |
| `updated_at` | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP | Letzte Aktualisierung |
### Indizes
- `idx_vehicles_fuel_id` auf `(fuel_id)`
- `idx_vehicles_license_plate` auf `(license_plate)`
- `idx_vehicles_manufacturer` auf `(manufacturer)`
- `idx_vehicles_model` auf `(model)`
---
## Tabelle: `logs` (Logbuch)
Speichert alle Logbucheinträge (Tankungen, Wartung, Reparaturen, Notizen).
| Spalte | Type | Constraint | Beschreibung |
|----------------|-------------|--------------------------|--------------------------------------|
| `id` | INTEGER | PRIMARY KEY AUTOINCREMENT| Eindeutige Log-ID |
| `vehicle_id` | INTEGER | NOT NULL REFERENCES vehicles(id) | Fremdschlüssel zu vehicles |
| `fuel_id` | INTEGER | REFERENCES fuels(id) | Kraftstoff (NULL bei Wartung/Notiz) |
| `log_type` | TEXT | NOT NULL CHECK (log_type IN ('tankung', 'wartung', 'reparatur', 'notiz')) | Eintragsart |
| `odometer` | REAL | NOT NULL | Kilometerstand zum Zeitpunkt des Eintrags |
| `datetime` | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP | Zeitpunkt des Eintrags |
| `cost` | REAL | NOT NULL DEFAULT 0 | Kosten in Euro |
| `quantity` | REAL | NOT NULL DEFAULT 0 | Menge (Kraftstoff in L/kWh) |
| `unit` | TEXT | | Mengeneinheit (kopiert von fuels) |
| `note` | TEXT | | Notiz / Beschreibung (optional, multiline) |
| `created_at` | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP | Erstellungszeitpunkt |
### Indizes
- `idx_logs_vehicle_id` auf `(vehicle_id)`
- `idx_logs_log_type` auf `(log_type)`
- `idx_logs_datetime` auf `(datetime)`
- `idx_logs_vehicle_datetime` auf `(vehicle_id, datetime)`
---
## SQL - Erstellungsstatement
Siehe auch: `internal/db/migration.sql`
```sql
-- fuels
CREATE TABLE fuels (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL UNIQUE,
unit TEXT NOT NULL
);
-- vehicles
CREATE TABLE vehicles (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
manufacturer TEXT,
model TEXT,
year INTEGER,
description TEXT,
license_plate TEXT,
purchase_date DATE,
weight_kg REAL,
power_kw REAL,
max_odometer REAL,
current_odometer REAL NOT NULL DEFAULT 0,
fuel_id INTEGER NOT NULL REFERENCES fuels(id),
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
-- logs
CREATE TABLE logs (
id INTEGER PRIMARY KEY AUTOINCREMENT,
vehicle_id INTEGER NOT NULL REFERENCES vehicles(id),
fuel_id INTEGER REFERENCES fuels(id),
log_type TEXT NOT NULL CHECK (log_type IN ('tankung', 'wartung', 'reparatur', 'notiz')),
odometer REAL NOT NULL,
datetime DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
cost REAL NOT NULL DEFAULT 0,
quantity REAL NOT NULL DEFAULT 0,
unit TEXT,
note TEXT,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
-- Indizes
CREATE INDEX idx_vehicles_fuel_id ON vehicles(fuel_id);
CREATE INDEX idx_vehicles_license_plate ON vehicles(license_plate);
CREATE INDEX idx_vehicles_manufacturer ON vehicles(manufacturer);
CREATE INDEX idx_vehicles_model ON vehicles(model);
CREATE INDEX idx_logs_vehicle_id ON logs(vehicle_id);
CREATE INDEX idx_logs_log_type ON logs(log_type);
CREATE INDEX idx_logs_datetime ON logs(datetime);
CREATE INDEX idx_logs_vehicle_datetime ON logs(vehicle_id, datetime);
```
---
## Beziehungen
```
fuels 1 ─── N vehicles
vehicles 1 ─── N logs
fuels 0..1 ─── N logs (bei Tankung: fuel_id gesetzt; bei Wartung/Notiz: NULL)
```
---
## Bemerkungen
- `current_odometer` wird automatisch aktualisiert wenn ein Log-Eintrag mit `log_type = 'tankung'` einen höheren Kilometerstand hat.
- Der `unit`-Feld in `logs` wird beim Anlegen eines Eintrags aus der `fuels`-Tabelle kopiert, um historische Konsistenz zu gewährleisten.
- `log_type` ist auf vier Werte beschränkt: `tankung`, `wartung`, `reparatur`, `notiz`.