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