Zum Hauptinhalt springen
Schneespur
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 User mit 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.

FeldTypBeschreibung
idintPrimärschlüssel
namestringVollständiger Name
emailstringEindeutige E-Mail
passwordhashedLogin-Passwort
roleUserRole enumBrückenspalte, nicht zur Autorisierung verwenden (siehe oben)
phonestringTelefonnummer
localestringOberflächensprache (nullable; null = App-Standard). Jede in LocaleRegistry registrierte Sprache. Seit 1.1.3
notestextAdmin-Notizen
default_vehicle_idFKBevorzugtes Fahrzeug
owntracks_usernamestringOwnTracks-GPS-Benutzername
owntracks_password_hashstringOwnTracks-Passwort (bcrypt)
dsgvo_informed_atdatetimeDSGVO-Bestätigung
anonymized_atdatetimeZeitpunkt 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.

FeldTypBeschreibung
idintPrimärschlüssel
namestringFirmen-/Kundenname
contact_namestringAnsprechpartner
emailstringHaupt-E-Mail
phonestringTelefon
auto_notify_emailboolEinsatz-Benachrichtigungen automatisch senden
notification_emailstringAbweichende E-Mail für Benachrichtigungen
localestringBevorzugte Oberflächensprache — jede in LocaleRegistry registrierte Sprache
passwordhashedPortal-Login-Passwort
portal_enabledboolPortalzugang aktiv
portal_show_gpsboolGPS im Portal anzeigen
portal_show_photosboolFotos im Portal anzeigen
portal_show_driver_nameboolFahrername im Portal anzeigen
street, zip, city, statestring, nullEigene 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:

  1. Der Kunde hat eine eigene Adresse (mindestens eines der vier Felder ist gefüllt; das prüft auch Customer::hasOwnAddress()) → sie gibt den Customer zurück.
  2. Keine eigene Adresse und genau ein Objekt → sie gibt dieses CustomerObject zurück.
  3. Keine eigene Adresse und kein oder mehrere Objekte → sie gibt null zurü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.

FeldTypBeschreibung
idintPrimärschlüssel
customer_idFKÜbergeordneter Kunde
namestringObjektname (z. B. „Haupteingang“)
street, zip, citystringAdresse
statestring(64), nullBundesland, Provinz oder Kanton. Seit 1.2.1 Teil der Adresse; gedruckt nach der Einstellung address_format des Betreibers.
lat, londecimal(7)Koordinaten für Wetter/GPS
contact_name, contact_email, contact_phonestringKontakt vor Ort
price_amount_centsint, nullGrundpreis in Cent. Gilt für jede Einsatzart, die in customer_object_prices keine eigene Zeile hat.
price_unitstring, nullper_job, per_hour, monthly oder seasonal (JobPricing::UNITS; per_hour seit 1.2.1). Ein Betrag ohne Einheit ist kein Preis.
plow_threshold_valuedecimal(5,2), nullRäumschwelle so, wie der Betreiber sie eingegeben hat. Ersetzt in 1.2.1 plow_threshold_cm.
plow_threshold_unitstring(4), nullcm oder in. Null, wenn keine Schwelle gesetzt ist.
salt_enabledboolOb Streuen anwendbar ist
site_notes, access_notestextHinweise für Fahrer
auto_notify_emailboolAuto-Benachrichtigung für dieses Objekt
notification_emailstringObjektspezifische 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.

FeldTypBeschreibung
idintPrimärschlüssel
customer_object_idFKDas Objekt. Wird beim Löschen mitgelöscht (cascade).
job_typestring(32)Wert einer Einsatzart. Eine einfache Zeichenkette, kein Fremdschlüssel: Module registrieren Einsatzarten zur Laufzeit in der JobTypeRegistry.
amount_centsunsigned intPreis in Cent
unitstring(32)per_job, per_hour, monthly oder seasonal
created_at, updated_attimestamps

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.

FeldTypBeschreibung
idintPrimärschlüssel
work_shift_idFKÜbergeordnete Schicht
customer_idFKKunde
customer_object_idFKEinsatzort
user_idFKFahrer
vehicle_idFKEingesetztes Fahrzeug
typeJobType enumraumen, streuen, kontrolle, raumen_streuen
started_atdatetimeEinsatzbeginn
ended_atdatetimeEinsatzende
notestextFahrernotizen. Für den Kunden im Portal und auf dem Einsatznachweis sichtbar.
internal_notestext, nullNotiz nur für Betreiber und Fahrer, seit 1.2.1
price_amount_centsunsigned int, nullBetrag dieses Einsatzes in Cent, festgeschrieben beim Abschluss. Siehe unten.
price_unitstring(32), nullDie Einheit, die beim Abschluss galt
price_rate_centsunsigned int, nullDer Satz, der beim Abschluss galt
price_increment_minunsigned smallint, nullAbrechnungstakt in Minuten, nur bei per_hour gesetzt
is_manualboolManuell 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_unitprice_amount_centsprice_rate_centsprice_increment_min
per_jobder Satzder SatzNULL
per_hourDauer, aufgerundet auf den Takt, mal Stundensatz, auf den Cent gerundetder Stundensatzder geltende Takt (1, 15, 30 oder 60)
monthlyNULLder MonatssatzNULL
seasonalNULLder SaisonsatzNULL
NULL (kein Preis galt)NULLNULLNULL

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): ?PriceRule liefert die Zeile für genau diese Einsatzart, sonst den Grundpreis des Objekts, sonst null.
  • Beträge von Einsätzen werden gelesen, nicht neu berechnet: PeriodRevenue summiert 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 ($from nach $to) ergibt eine leere Zusammenfassung: keine Einsätze, keine Pauschalen.
  • Eine bekannte Eigenschaft, keine Funktion: Der Zeitraum wird mit started_at so 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 JobTypeRegistry registriert, 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 liefert null, wenn der Betreiber report_show_amounts nicht 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 liest PeriodRevenue zu 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.

FeldTypBeschreibung
idintPrimärschlüssel
user_idFKFahrer
started_atdatetimeSchichtbeginn
ended_atdatetimeSchichtende (null = laufend)
notestextSchichtnotizen

Beziehungen: user, jobs

Vehicle

Tabelle: vehicles

FeldTypBeschreibung
idintPrimärschlüssel
namestringFahrzeugname
license_platestringKennzeichen
owntracks_device_idstringOwnTracks-Geräte-Kennung
notestextFahrzeugnotizen

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.

FeldTypBeschreibung
idintPrimärschlüssel
job_idFKÜbergeordneter Einsatz
momentWeatherMoment enumstart oder end
providerstringAnbieter-Slug
temperaturedecimal(2)°C
precipitationdecimal(2)mm
snow_depthdecimal(2)cm; seit 1.2.1 leer (null), wenn der Anbieter keine Schneehöhe misst – ein gemessener Wert von 0 bleibt 0
wind_speeddecimal(2)km/h
humidityint%
weather_codeintWMO-Wettercode
fetched_atdatetimeAbrufzeitpunkt
raw_responseJSONVollstä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.

ModelTabelleZweck
GpsPointgps_pointsGPS-Koordinaten während der Einsätze
JobPhotojob_photosWährend der Einsätze aufgenommene Fotos
JobAuditjob_auditsÄnderungsprotokoll (insert-only)
SettingsettingsSchlüssel-Wert-Konfiguration
RolerolesAutorisierungs-Rollen
PermissionpermissionsAutorisierungs-Berechtigungen
ModulemodulesInstallierte Module
ModuleApiTokenmodule_api_tokensAPI-Authentifizierungs-Token
ModLogmod_logsModul-Log-Einträge (insert-only)
NotificationLognotification_logsBenachrichtigungs-Protokoll
AlertDismissalalert_dismissalsVerworfene Einsatz-Hinweise
MonthlyStatisticmonthly_statisticsVorberechnete Monatsstatistiken
DsgvoConfirmationdriver_dsgvo_confirmationsDSGVO-Einwilligungen (insert-only)
OwntracksCredentialEventowntracks_credential_eventsGPS-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.