Initial commit: gocarlog project — Milestones 1-10 completed
This commit is contained in:
@@ -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`.
|
||||
Reference in New Issue
Block a user