Files
gocarlog/docs/database-schema.md
T

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_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

-- 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.