6.5 KiB
6.5 KiB
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_idauf(fuel_id)idx_vehicles_license_plateauf(license_plate)idx_vehicles_manufacturerauf(manufacturer)idx_vehicles_modelauf(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_idauf(vehicle_id)idx_logs_log_typeauf(log_type)idx_logs_datetimeauf(datetime)idx_logs_vehicle_datetimeauf(vehicle_id, datetime)
SQL - Erstellungsstatement
Siehe auch: internal/db/migration.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_odometerwird automatisch aktualisiert wenn ein Log-Eintrag mitlog_type = 'tankung'einen höheren Kilometerstand hat.- Der
unit-Feld inlogswird beim Anlegen eines Eintrags aus derfuels-Tabelle kopiert, um historische Konsistenz zu gewährleisten. log_typeist auf vier Werte beschränkt:tankung,wartung,reparatur,notiz.