Dokumentation durchblättern
Module entwickeln
Kern-Datenmodell
Die Datenbank-Modelle des Kerns — Customer, Job, User, WorkShift und mehr — mit ihren Feldern, Beziehungen und dem direkten Zugriff aus einem Modul.
Ein Modul erweitert den Kern, indem es auf dessen Daten aufsetzt. Diese Seite beschreibt die zentralen Datenbank-Modelle, ihre Felder und Beziehungen — und zeigt, wie Sie aus einem eigenen Modul darauf zugreifen. Wer das Datenmodell kennt, baut Module, die mit dem Kern zusammenspielen, statt eigene Parallelwelten anzulegen.
Die Domäne in Begriffen
Schneespur verwaltet den Ablauf eines Winterdienstes. Die folgenden Begriffe ziehen sich durch das gesamte Datenmodell — sie zu kennen, erspart später viel Suchen:
- Customers sind die Auftraggeber, die den Winterdienst beauftragen.
- Customer Objects sind die konkreten Orte (Adressen), die betreut werden.
- Drivers sind die Personen, die den Dienst ausführen (als
Usermit Fahrer-Rolle). - Vehicles sind die eingesetzten Fahrzeuge oder Maschinen.
- Work Shifts halten fest, wann ein Fahrer im Einsatz ist.
- Jobs (
service_jobs) sind die einzelnen Einsätze an einem Customer Object. - GPS Points zeichnen den Standort des Fahrers während eines Einsatzes auf.
- Weather Snapshots halten die Wetterlage zu Beginn und Ende eines Einsatzes fest.
Der Job ist die zentrale Einheit: An ihm hängen Fahrer, Fahrzeug, Kunde, Ort, GPS-Track,
Wetter und Fotos zusammen. Fast jede Auswertung im System läuft über ihn.
Beziehungen im Überblick
Customer ─┬─ has many ──→ CustomerObject ──→ has many ──→ Job
└─ has many ──→ Job │
├─ belongs to ─→ User (driver)
User (driver) ──→ has many ──→ WorkShift ──→ has many ──→ Job│
├─ belongs to ─→ Vehicle
Vehicle ──────→ has many ──→ Job │
├─ has many ──→ GpsPoint
├─ has many ──→ WeatherSnapshot
├─ has many ──→ JobPhoto
└─ has many ──→ JobAudit
Ein Customer kann mehrere CustomerObject-Standorte haben, an jedem Standort entstehen
viele Job-Einsätze. Jeder Job verweist auf genau einen Fahrer, ein Fahrzeug, einen
Kunden und einen Ort — und sammelt seine GPS-Punkte, Wetter-Snapshots, Fotos und
Audit-Einträge.
Models im Detail
User
Tabelle: users
Ein User ist Administrator, Fahrer oder was immer die frei vergebbaren Rollen seit 1.1.0
hergeben. Fahrer bekommen zusätzlich OwnTracks-Zugangsdaten für das GPS-Tracking.
Prüfen Sie Berechtigungen niemals gegen users.role. Die Spalte ist eine Brücke aus der
Zeit, bevor die Rollen in die Pivot-Tabelle role_user gewandert sind, und seither schreibt
nichts mehr hinein. Sie trägt den Datenbank-Standardwert 'driver', weshalb eine Abfrage
wie where('role', 'driver') jede Benutzerzeile im System trifft: Administratoren
eingeschlossen und Konten, die nie fahren sollten.
Das ist keine theoretische Warnung. Eine Validierungsregel im Core tat genau das und ließ jede beliebige Benutzer-ID durch — einer der Befunde des Härtungs-Releases 1.2.0.
Verwenden Sie stattdessen $user->hasRole('driver'), $user->isAdmin() oder die Scopes
User::drivers() und User::admins(). Alle drei lesen die Pivot-Tabelle.
Eine Feinheit, wenn Sie Tests schreiben: User::booted() überträgt eine geänderte
users.role in die Pivot-Tabelle, als Brücke für Altdaten. Ein Benutzer, den Sie über die
alte Spalte konstruieren, ist deshalb ein echter Rolleninhaber und kein „nur-alt“-Benutzer.
Letzteren kann man gar nicht herstellen — ein Test, der das zu tun glaubt, prüft nichts.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
name | string | Vollständiger Name |
email | string | Eindeutige E-Mail |
password | hashed | Login-Passwort |
role | UserRole enum | Brückenspalte, nicht zur Autorisierung verwenden (siehe oben) |
phone | string | Telefonnummer |
locale | string | Oberflächensprache (nullable; null = App-Standard). Jede in LocaleRegistry registrierte Sprache. Seit 1.1.3 |
notes | text | Admin-Notizen |
default_vehicle_id | FK | Bevorzugtes Fahrzeug |
owntracks_username | string | OwnTracks-GPS-Benutzername |
owntracks_password_hash | string | OwnTracks-Passwort (bcrypt) |
dsgvo_informed_at | datetime | DSGVO-Bestätigung |
anonymized_at | datetime | Zeitpunkt der Fahrer-Anonymisierung |
Wichtige Methoden:
$user->isAdmin(): bool
$user->isDriver(): bool
$user->isAnonymized(): bool
$user->displayName(): string // returns anonymized label if anonymized
$user->hasRole('admin'): bool
$user->hasPermission('jobs.view'): bool
Scopes: drivers(), admins(), withAnonymized(), onlyAnonymized()
Globaler Scope: ExcludeAnonymizedScope blendet anonymisierte Nutzer standardmäßig
aus. Das ist wichtig, wenn Sie in einem Modul mit Fahrerdaten arbeiten: Ein anonymisierter
Fahrer taucht in normalen Abfragen nicht mehr auf — wer ihn trotzdem braucht (etwa für
Altdaten), nutzt withAnonymized().
Beziehungen: roles, workShifts, serviceJobs, gpsPoints, defaultVehicle,
dsgvoConfirmations
Customer
Tabelle: customers
Der Customer ist der Auftraggeber. Einige Felder steuern das optionale Kundenportal —
etwa, ob der Kunde GPS-Track, Fotos oder den Fahrernamen sehen darf.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
name | string | Firmen-/Kundenname |
contact_name | string | Ansprechpartner |
email | string | Haupt-E-Mail |
phone | string | Telefon |
auto_notify_email | bool | Einsatz-Benachrichtigungen automatisch senden |
notification_email | string | Abweichende E-Mail für Benachrichtigungen |
locale | string | Bevorzugte Oberflächensprache — jede in LocaleRegistry registrierte Sprache |
password | hashed | Portal-Login-Passwort |
portal_enabled | bool | Portalzugang aktiv |
portal_show_gps | bool | GPS im Portal anzeigen |
portal_show_photos | bool | Fotos im Portal anzeigen |
portal_show_driver_name | bool | Fahrername im Portal anzeigen |
street, zip, city, state | string, null | Eigene Adresse des Kunden, seit 1.2.1. Alle vier nullable; state ist string(64). Nicht die Adresse eines Objekts. |
Beziehungen: objects (CustomerObject), serviceJobs, notificationLogs
Die Adresse eines Kunden lesen Sie über
Customer::documentAddressSource(): Customer|CustomerObject|null. Hinzugekommen in 1.2.1.
Diese Methode ist die Stelle, die entscheidet, welche Adresse ein Dokument für einen
Kunden druckt – der Sammelbericht und die Kundenliste fragen beide sie. Was sie
zurückgibt, reichen Sie direkt an format_address() bzw. format_address_lines() weiter.
Sie unterscheidet drei Fälle:
- Der Kunde hat eine eigene Adresse (mindestens eines der vier Felder ist gefüllt; das
prüft auch
Customer::hasOwnAddress()) → sie gibt denCustomerzurück. - Keine eigene Adresse und genau ein Objekt → sie gibt dieses
CustomerObjectzurück. - Keine eigene Adresse und kein oder mehrere Objekte → sie gibt
nullzurück. Ein Dokument druckt dann keine Kundenadresse. Vor 1.2.1 wurde die Adresse des ersten Objekts verwendet – falsch für einen Kunden wie eine Hausverwaltung, deren Objekte die Gebäude anderer Leute sind.
Ein Modul, das eine Kundenadresse aus $customer->objects->first() zusammenbaut, wird den
Berichten des Core widersprechen.
CustomerObject
Tabelle: customer_objects
Ein CustomerObject ist ein konkreter Standort eines Kunden — mit Adresse, Koordinaten und
einsatzrelevanten Vorgaben wie Streu-Schwelle oder Hinweisen für die Fahrer. Die
Koordinaten lat/lon sind die Grundlage für Wetterabfragen und GPS-Zuordnung.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
customer_id | FK | Übergeordneter Kunde |
name | string | Objektname (z. B. „Haupteingang“) |
street, zip, city | string | Adresse |
state | string(64), null | Bundesland, Provinz oder Kanton. Seit 1.2.1 Teil der Adresse; gedruckt nach der Einstellung address_format des Betreibers. |
lat, lon | decimal(7) | Koordinaten für Wetter/GPS |
contact_name, contact_email, contact_phone | string | Kontakt vor Ort |
price_amount_cents | int, null | Grundpreis in Cent. Gilt für jede Einsatzart, die in customer_object_prices keine eigene Zeile hat. |
price_unit | string, null | per_job, per_hour, monthly oder seasonal (JobPricing::UNITS; per_hour seit 1.2.1). Ein Betrag ohne Einheit ist kein Preis. |
plow_threshold_value | decimal(5,2), null | Räumschwelle so, wie der Betreiber sie eingegeben hat. Ersetzt in 1.2.1 plow_threshold_cm. |
plow_threshold_unit | string(4), null | cm oder in. Null, wenn keine Schwelle gesetzt ist. |
salt_enabled | bool | Ob Streuen anwendbar ist |
site_notes, access_notes | text | Hinweise für Fahrer |
auto_notify_email | bool | Auto-Benachrichtigung für dieses Objekt |
notification_email | string | Objektspezifische Benachrichtigungs-E-Mail |
Geldbeträge liegen bewusst als Ganzzahl in Cent (price_amount_cents) vor — das vermeidet
Rundungsfehler, die bei Fließkomma-Beträgen entstehen würden.
plow_threshold_cm ist in 1.2.1 entfernt, nicht umbenannt. Ein Modul, das die Spalte
direkt abfragt – ein rohes where('plow_threshold_cm', …), ein select(), das sie nennt,
ein Bericht, der sie vom Model liest –, bricht beim Update, weil es die Spalte nicht mehr
gibt.
Lesen Sie die Schwelle über CustomerObject::plowThresholdMm(): ?float. Die zwei
Spalten gibt es, damit ein US-Betrieb, der 2″ eingibt, auch 2″ zurückliest und nicht
5,08 cm. Module sollten sie nicht einzeln lesen: Die Methode liefert für beide Einheiten
Millimeter und null, wenn keine Schwelle gesetzt ist – was nicht dasselbe ist wie null
Millimeter. Dasselbe null gilt für eine plow_threshold_unit, die weder cm noch in
ist. Eine unbekannte Einheit ist keine Schwelle von null Millimetern, sondern ein Wert, den
nichts umrechnen kann. Über das Admin-Formular sollte das nicht vorkommen; ein Modul, das
die Spalte selbst beschreibt, darf eine fremde oder fehlerhafte Einheit aber nicht als
Zentimeter behandeln.
Beziehungen: customer, serviceJobs, prices (CustomerObjectPrice)
CustomerObjectPrice
Tabelle: customer_object_prices (seit 1.2.1)
Ein Preis je Objekt und Einsatzart. Eine Zeile hat Vorrang vor dem Grundpreis am Objekt; gibt es keine, gilt der Grundpreis. So kann ein Objekt etwa fürs Streuen einen anderen Preis tragen als fürs Räumen, ohne dass die übrigen Einsatzarten einzeln gepflegt werden müssen.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
customer_object_id | FK | Das Objekt. Wird beim Löschen mitgelöscht (cascade). |
job_type | string(32) | Wert einer Einsatzart. Eine einfache Zeichenkette, kein Fremdschlüssel: Module registrieren Einsatzarten zur Laufzeit in der JobTypeRegistry. |
amount_cents | unsigned int | Preis in Cent |
unit | string(32) | per_job, per_hour, monthly oder seasonal |
created_at, updated_at | timestamps |
Eindeutiger Index auf (customer_object_id, job_type).
Beziehungen: customerObject
Job (service_jobs)
Tabelle: service_jobs
Der Job ist der einzelne Einsatz. Beachten Sie: Das Model heißt Job, die Tabelle aber
service_jobs — daher heißt die Beziehung auf anderen Models meist serviceJobs.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
work_shift_id | FK | Übergeordnete Schicht |
customer_id | FK | Kunde |
customer_object_id | FK | Einsatzort |
user_id | FK | Fahrer |
vehicle_id | FK | Eingesetztes Fahrzeug |
type | JobType enum | raumen, streuen, kontrolle, raumen_streuen |
started_at | datetime | Einsatzbeginn |
ended_at | datetime | Einsatzende |
notes | text | Fahrernotizen. Für den Kunden im Portal und auf dem Einsatznachweis sichtbar. |
internal_notes | text, null | Notiz nur für Betreiber und Fahrer, seit 1.2.1 |
price_amount_cents | unsigned int, null | Betrag dieses Einsatzes in Cent, festgeschrieben beim Abschluss. Siehe unten. |
price_unit | string(32), null | Die Einheit, die beim Abschluss galt |
price_rate_cents | unsigned int, null | Der Satz, der beim Abschluss galt |
price_increment_min | unsigned smallint, null | Abrechnungstakt in Minuten, nur bei per_hour gesetzt |
is_manual | bool | Manuell erfasst (nicht GPS-getrackt) |
internal_notes sieht der Kunde nie. Ein Modul, das ins Portal, in einen PDF-Slot oder
in eine Kunden-E-Mail rendert, darf das Feld nicht ausgeben. Der Core hält es aus jeder
View unter portal/, pdf/ und mail/ heraus;
InternalNotesTest::test_no_customer_facing_view_touches_the_internal_note schlägt fehl,
sobald eine davon das Feld nennt. Im Änderungsprotokoll des Einsatzes heißt das Feld
job.audit_field_internal_notes.
Die vier Preisspalten schreibt JobPricing::freeze() genau einmal, wenn ein Einsatz
abgeschlossen wird – wenn ein Fahrer einen laufenden Einsatz beendet oder über
JobLifecycleService::createManualJob(). Welche Spalten gefüllt sind, hängt von der Einheit
ab, die galt:
price_unit | price_amount_cents | price_rate_cents | price_increment_min |
|---|---|---|---|
per_job | der Satz | der Satz | NULL |
per_hour | Dauer, aufgerundet auf den Takt, mal Stundensatz, auf den Cent gerundet | der Stundensatz | der geltende Takt (1, 15, 30 oder 60) |
monthly | NULL | der Monatssatz | NULL |
seasonal | NULL | der Saisonsatz | NULL |
NULL (kein Preis galt) | NULL | NULL | NULL |
price_amount_cents = NULL heißt unbekannt, nicht null. Ein Einsatz mit Pauschale hat
keinen eigenen Betrag, denn die Pauschale gehört zum Zeitraum, nicht zum Einsatz. Ein
Einsatz, der ohne hinterlegten Preis abgeschlossen wurde, und jeder Einsatz von vor 1.2.1
hat weder Betrag noch Einheit. Wandeln Sie den Wert nicht in 0 um, schreiben Sie an
keiner Anzeigestelle ?? 0, und summieren Sie ihn nicht per SUM() in eine Zahl, ohne
dazuzusagen, wie viele Einsätze dabei übersprungen wurden. Nichts rechnet alte Einsätze neu:
Eine spätere Preisänderung verändert einen festgeschriebenen Einsatz nie.
Wichtige Methoden:
$job->isCompleted(): bool // has ended_at
$job->isInGracePeriod(): bool // within 24h of completion
$job->isLocked(): bool // past grace period
$job->isGpsLocked(): bool // GPS locked after completion
$job->graceDeadline(): ?Carbon
$job->durationFormatted(): string // "2h 15min"
$job->localStartedAt(): Carbon
$job->localEndedAt(): Carbon
Hinter diesen Methoden steckt das Sperr-Konzept des Einsatznachweises: Nach Abschluss
bleibt ein Einsatz noch eine begrenzte Zeit (isInGracePeriod()) änderbar, danach gilt er
als gesperrt (isLocked()). So bleibt der dokumentierte Nachweis nachträglich
unverändert — wichtig, wenn er später als Beleg dienen soll. Verlassen Sie sich in einem
Modul nicht auf eigene Datums-Vergleiche, sondern auf diese Methoden.
Beziehungen: workShift, customer, customerObject, user, vehicle, gpsPoints,
weatherSnapshots, jobPhotos, audits, notificationLogs, alertDismissals
Einen Preis lesen
Hinzugekommen in 1.2.1. Ein Modul berechnet einen Preis nicht selbst, sondern fragt die beiden Dienste des Core:
use App\Services\Pricing\JobPricing;
use App\Services\Pricing\PeriodRevenue;
// Which price applies to this site and job type? null = none
$rule = app(JobPricing::class)->resolve($customerObject, 'streuen'); // ?PriceRule {amountCents, unit}
// What did a customer cost in a period?
$summary = app(PeriodRevenue::class)->forCustomer($customer, $from, $to, $customerObject /* optional */);
$summary->jobTotalCents; // sum of the amounts frozen on the jobs
$summary->pricedJobCount; // jobs with an amount
$summary->jobsWithoutAmount; // jobs completed with no price on file
$summary->flatRateLines; // FlatRateLine[]: monthly / seasonal rates times their count
$summary->totalCents(); // jobs + flat rates
JobPricing::resolve(CustomerObject, string $jobType): ?PriceRuleliefert die Zeile für genau diese Einsatzart, sonst den Grundpreis des Objekts, sonstnull.- Beträge von Einsätzen werden gelesen, nicht neu berechnet:
PeriodRevenuesummiert die am Einsatz festgeschriebenen Spalten. Pauschalen verwenden dagegen die heutigen Sätze: gezählt je angefangenem Kalendermonat mit mindestens einem Tag in der Saison (monthly) und je berührter Saison (seasonal), unabhängig davon, ob es Einsätze gab. Ein Zeitraum außerhalb jeder Saison hat keine Pauschalzeile. - Ein umgedrehter Zeitraum (
$fromnach$to) ergibt eine leere Zusammenfassung: keine Einsätze, keine Pauschalen. - Eine bekannte Eigenschaft, keine Funktion: Der Zeitraum wird mit
started_atso verglichen, wie es gespeichert ist, ohne die Grenzen in die Anzeige-Zeitzone des Betriebs umzurechnen. Der bestehende Kundenbericht verhält sich genauso. Ein Einsatz kurz vor oder nach Mitternacht kann deshalb im Nachbartag landen; versprechen Sie keine tagesgenauen Grenzen. - Den Abrechnungstakt lesen Sie mit
JobPricing::incrementMinutes()(siehe Formate & Einheiten). - Ein Modul, das eine Einsatzart in der
JobTypeRegistryregistriert, bekommt dafür automatisch eine Preiszeile im Objektformular. Eine Zeile, deren Einsatzart nicht mehr registriert ist (weil das Modul entfernt wurde), bleibt bearbeit- und löschbar und wird als verwaist markiert. - Ob Beträge einem Kunden gezeigt werden dürfen, entscheidet
PdfReportService::revenueFor(Customer $customer, Carbon $from, Carbon $to, ?CustomerObject $object = null): ?RevenueSummary. Die Methode liefertnull, wenn der Betreiberreport_show_amountsnicht eingeschaltet hat (die Voreinstellung) oder wenn es nichts zu zeigen gibt. Ein Modul, das einen Sammelbericht oder ein anderes Dokument für einen Kunden rendert, fragt diese Methode und liestPeriodRevenuezu diesem Zweck nie direkt. Im Einsatznachweis für einen einzelnen Einsatz, auf den Portalseiten und im Text von E-Mails erscheinen nie Beträge.
Signaturen im JobLifecycleService
endJob() und createManualJob() haben in 1.2.1 je einen neuen Parameter bekommen, und
zwar ganz hinten angehängt. Jeder bestehende Aufruf funktioniert deshalb unverändert:
endJob(User $user, ?string $notes = null, array $extra = [], ?string $internalNotes = null): Job
createManualJob(User $driver, CustomerObject $customerObject, string $type, Carbon $startedAt, Carbon $endedAt,
?string $notes = null, ?Vehicle $vehicle = null, ?string $internalNotes = null): Job
Beide schreiben im selben Aufruf den Preis des Einsatzes fest (siehe oben). Ein Modul, das sie mit Positionsargumenten aufruft, darf vor dem neuen Parameter nichts einfügen.
WorkShift
Tabelle: work_shifts
Eine WorkShift klammert die Einsätze eines Fahrers zu einer Schicht. Ist ended_at noch
null, läuft die Schicht.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
user_id | FK | Fahrer |
started_at | datetime | Schichtbeginn |
ended_at | datetime | Schichtende (null = laufend) |
notes | text | Schichtnotizen |
Beziehungen: user, jobs
Vehicle
Tabelle: vehicles
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
name | string | Fahrzeugname |
license_plate | string | Kennzeichen |
owntracks_device_id | string | OwnTracks-Geräte-Kennung |
notes | text | Fahrzeugnotizen |
Wichtige Methode: displayLabel(): string — liefert „name (license_plate)“.
Beziehungen: serviceJobs
WeatherSnapshot
Tabelle: weather_snapshots
Pro Einsatz entstehen typischerweise zwei WeatherSnapshot-Einträge: einer zu Beginn
(start) und einer am Ende (end). Das Feld raw_response bewahrt die vollständige
Antwort des Wetteranbieters auf — so bleibt die Wetterlage auch dann nachvollziehbar, wenn
sich die Auswertung später ändert.
| Feld | Typ | Beschreibung |
|---|---|---|
id | int | Primärschlüssel |
job_id | FK | Übergeordneter Einsatz |
moment | WeatherMoment enum | start oder end |
provider | string | Anbieter-Slug |
temperature | decimal(2) | °C |
precipitation | decimal(2) | mm |
snow_depth | decimal(2) | cm; seit 1.2.1 leer (null), wenn der Anbieter keine Schneehöhe misst – ein gemessener Wert von 0 bleibt 0 |
wind_speed | decimal(2) | km/h |
humidity | int | % |
weather_code | int | WMO-Wettercode |
fetched_at | datetime | Abrufzeitpunkt |
raw_response | JSON | Vollständige API-Antwort |
Wichtige Methoden: providerLabel(), weatherLabel() — liefern lokalisierte
Anzeigetexte.
Enums
Mehrere Felder sind als typsichere Enums modelliert. Das verhindert ungültige Werte in der Datenbank und gibt Ihnen lesbare Konstanten statt roher Strings.
enum JobType: string {
case Raumen = 'raumen'; // Snow removal/plowing
case Streuen = 'streuen'; // Salt spreading
case Kontrolle = 'kontrolle'; // Inspection
case RaumenStreuen = 'raumen_streuen'; // Combined
}
enum WeatherMoment: string {
case Start = 'start';
case End = 'end';
}
enum UserRole: string {
case Admin = 'admin';
case Driver = 'driver';
}
Jedes Enum hat eine Methode label(): string, die einen lokalisierten Anzeigenamen
liefert. Verwenden Sie in einem Modul diese label()-Methode statt eigener Übersetzungen,
damit die Bezeichnungen mit dem Rest der Oberfläche übereinstimmen.
Weitere Models
Neben den zentralen Modellen gibt es eine Reihe unterstützender Models. Einige davon sind bewusst insert-only (nur einfügen, nie ändern oder löschen) — sie bilden den revisionssicheren Teil des Systems, etwa Audit- und Einwilligungs-Spuren.
| Model | Tabelle | Zweck |
|---|---|---|
GpsPoint | gps_points | GPS-Koordinaten während der Einsätze |
JobPhoto | job_photos | Während der Einsätze aufgenommene Fotos |
JobAudit | job_audits | Änderungsprotokoll (insert-only) |
Setting | settings | Schlüssel-Wert-Konfiguration |
Role | roles | Autorisierungs-Rollen |
Permission | permissions | Autorisierungs-Berechtigungen |
Module | modules | Installierte Module |
ModuleApiToken | module_api_tokens | API-Authentifizierungs-Token |
ModLog | mod_logs | Modul-Log-Einträge (insert-only) |
NotificationLog | notification_logs | Benachrichtigungs-Protokoll |
AlertDismissal | alert_dismissals | Verworfene Einsatz-Hinweise |
MonthlyStatistic | monthly_statistics | Vorberechnete Monatsstatistiken |
DsgvoConfirmation | driver_dsgvo_confirmations | DSGVO-Einwilligungen (insert-only) |
OwntracksCredentialEvent | owntracks_credential_events | GPS-Zugangsdaten-Protokoll (insert-only) |
Die Konfiguration läuft über Setting (Schlüssel-Wert) — wie Sie eigene Einstellungen mit
Modul-Präfix registrieren und lesen, steht unter
ServiceProvider. Rollen und Berechtigungen behandelt
Berechtigungen und Rollen.
Models aus dem Modul nutzen
Sie greifen auf die Kern-Models direkt zu, indem Sie sie aus dem App\Models-Namespace
importieren. Es gibt keine gesonderte Modul-Schnittstelle für Lesezugriffe — Sie arbeiten
mit denselben Eloquent-Models wie der Kern:
use App\Models\Customer;
use App\Models\Job;
use App\Models\User;
use App\Models\Setting;
$customers = Customer::with('objects')->get();
$recentJobs = Job::where('ended_at', '>=', now()->subDays(7))->get();
$drivers = User::drivers()->get();
Beachten Sie dabei zwei Dinge: Laden Sie Beziehungen über with(...) vor, wenn Sie sie in
einer Schleife brauchen — sonst entstehen viele Einzelabfragen. Und denken Sie an die
globalen Scopes: User::drivers() liefert dank ExcludeAnonymizedScope von sich aus keine
anonymisierten Fahrer. Wer die volle Datenbank-Migration eines Moduls aufsetzen will,
findet die Grundlagen unter
Datenbank und Migrationen.