ims laravel admin starter

Über dieses Projekt

ims-laravel-admin-starter ist eine optimierte Admin-Panel- und API-Starteranwendung, die auf dem leistungsstarken Laravel 10-Framework und Filment 3 basiert.

Unser Hauptaugenmerk liegt darauf, Ihnen ein problemloses und einsatzbereites Starterprojekt für die lokale Entwicklung bereitzustellen.

Im Gegensatz zu herkömmlichen API-Generatoren oder Codegeneratoren vereinfacht dieses Projekt den Prozess der Einrichtung Ihrer lokalen Entwicklungsumgebung. Es ermöglicht Ihnen, Ihre Laravel-basierte API-Entwicklung und Admin-Panel-Entwicklung ohne unnötige Komplexität zu starten. Dadurch können Sie sich auf den Aufbau Ihrer Anwendungslogik konzentrieren, anstatt Zeit mit der Ersteinrichtung zu verbringen.

Merkmale

• Vollständiges Authentifizierungssystem : Implementieren Sie ein robustes Authentifizierungssystem mit dem Laravel Jetstream-Paket für sichere Benutzerverwaltung und Anmeldefunktionen.

• Rollen- und berechtigungsbasiertes Autorisierungssystem : Erstellen Sie ein flexibles Autorisierungssystem mit dem Laravel-Permission-Paket, mit dem Sie Rollen und Berechtigungen für eine fein abgestimmte Zugriffskontrolle definieren können.

• Benutzerverwaltung : Verwalten Sie Benutzer effizient, einschließlich Benutzerregistrierung, Profilaktualisierungen und Benutzerrollen.

• Profileinstellungen : Ermöglichen Sie Benutzern die Anpassung ihrer Profile, einschließlich persönlicher Informationen und Präferenzen.

• Unterstützung mehrerer Sprachen : Machen Sie Ihre Anwendung mithilfe der Pakete Filament Translations und Laravel Lang für mehrsprachige Unterstützung einem globalen Publikum zugänglich.

• Theme-Anpassung : Passen Sie das Erscheinungsbild und die Benutzeroberfläche der Anwendung mithilfe von Tailwind CSS an, um optisch ansprechende Designs zu erstellen.

• Docker-Unterstützung : Stellen Sie Ihre Anwendung ganz einfach in einem Docker-Container bereit und verwalten Sie sie mit dem Komfort von Laravel Sail für optimierte Entwicklungs- und Bereitstellungsworkflows.

Versionsanforderungen

• Knoten 16+
• PHP-Version 8.1+
• MYSQL-Version 8.0+

Schnellstart

1. Wählen Sie Ihr lokales Entwicklungstool:

   Wählen Sie Ihr bevorzugtes lokales Entwicklungstool aus, z. B. Laragon, XAMPP, WAMP oder ein anderes Tool, das Ihren Anforderungen entspricht.

2. Konfigurieren Sie Ihre Umgebung:

   Aktualisieren Sie Ihre .env Datei mit den richtigen Datenbankanmeldeinformationen.

3. Abhängigkeiten installieren:

   Führen Sie den folgenden Befehl aus, um erforderliche Abhängigkeiten mit Composer zu installieren:

   composer install

   Führen Sie den folgenden Befehl aus, um erforderliche Abhängigkeiten mit npm zu installieren und zu erstellen:

   npm install
   npm run build

4. Migrieren und Seeding der Datenbank: Initialisieren und Seeding der Datenbank mit Standarddaten mithilfe von:

   php artisan migrate --seed

   Jetzt ist Ihr Projekt einsatzbereit. Sie können über die angegebene Route auf das Admin-Panel zugreifen. Wenn Sie den Seed-Befehl ausgeführt haben, melden Sie sich mit den bereitgestellten Anmeldeinformationen an. Passen Sie Ihre Anwendung nach Bedarf an und erweitern Sie sie.

Zugriff auf das Admin-Panel

Sobald Sie das Projekt mithilfe der bereitgestellten Anweisungen eingerichtet haben, können Sie auf das Admin-Panel zugreifen, indem Sie die Route /admin in Ihrem Webbrowser aufrufen.

Anmelden

Wenn Sie den Seed-Befehl während des Einrichtungsvorgangs ausgeführt haben, können Sie sich mit den folgenden Anmeldeinformationen anmelden:

email: [email protected]
password: 123456

email: [email protected]
password: 123456

Rollen- und berechtigungsbasierte Vorgänge

Der ims-laravel-admin-starter unterstützt rollen- und berechtigungsbasierte Vorgänge, um den Zugriff auf verschiedene Funktionen in Ihrem Admin-Panel zu steuern. Sie können Rollen mit spezifischen Berechtigungen definieren und diese nach Bedarf Benutzern zuweisen.

Entdecken Sie dieses Projekt und erleben Sie den Komfort einer vorgefertigten lokalen Entwicklungsumgebung für Ihre Laravel-basierten APIs und Admin-Panels.

Mehrsprachiger Support

Erhöhen Sie die Zugänglichkeit und Benutzerfreundlichkeit dieses Starterprojekts, indem Sie mehrere Sprachen nutzen. Mit der Unterstützung von Filament Translations und dem Laravel Lang-Paket bietet dieses Starterprojekt umfassende mehrsprachige Unterstützung.

Eine ausführliche Anleitung zum Arbeiten mit mehreren Sprachen und Übersetzungen finden Sie auf unserer speziellen Wiki-Seite.

Erschließen Sie eine Welt voller Möglichkeiten mit nahtloser Sprachlokalisierung und stellen Sie sicher, dass Ihre Anwendung bei einem globalen Publikum Anklang findet.

Ausführen der Anwendung mit Docker und Laravel Sail

Eine ausführlichere Anleitung finden Sie auf der WIKI-Seite auf GitHub:

Ausführen der Anwendung mit Docker und Laravel Sail – Wiki

Diese detaillierte Ressource bietet Schritt-für-Schritt-Anleitungen und zusätzliche Informationen, um eine reibungslose Einrichtung und Ausführung Ihrer Anwendung mit Docker und Laravel Sail zu gewährleisten.

Lauftest

Um die Zuverlässigkeit und Korrektheit Ihrer Anwendung sicherzustellen, ist die Durchführung von Tests unerlässlich. Befolgen Sie diese einfachen Schritte:

1. Erstellen Sie eine separate Testdatenbank:

   Erstellen Sie zunächst eine dedizierte Testdatenbank für Ihre Anwendung. Sie können es ims-admin-testing nennen, um es von Ihrer Produktionsdatenbank zu unterscheiden.

   Wenn Sie Docker und Laravel Sail verwenden, können Sie diesen Schritt überspringen und stattdessen die Datei phpunit.xml aktualisieren, um eine Testdatenbank hinzuzufügen:

   < env name = " DB_DATABASE " value = " testing " />

2. Führen Sie Tests durch:

   Sie haben zwei komfortable Möglichkeiten, Tests durchzuführen:

   • Verwendung von Pest:

     Führen Sie Tests mit Pest durch, einem tollen PHP-Test-Framework. Führen Sie einfach den folgenden Befehl aus:

     ./vendor/bin/pest

     Wenn Sie Sail verwenden, können Sie diesen Befehl verwenden:

     ./vendor/bin/sail test
     # or if you have an alias configured:
     sail test

   • Verwendung von Artisan:

     Das Artisan-Befehlszeilentool von Laravel bietet nahtlose Testfunktionen. Führen Sie die Tests mit dem folgenden Artisan-Befehl aus:

     php artisan test

     Wenn Sie Sail ausführen, können Sie diesen Befehl verwenden:

     ./vendor/bin/sail artisan test
     # or if you have an alias configured:
     sail artisan test

Die Durchführung von Tests ist von entscheidender Bedeutung, um die Zuverlässigkeit und Korrektheit der Funktionalität Ihrer Anwendung sicherzustellen. Die oben genannten Befehle starten den Testprozess und liefern Ihnen wertvolle Einblicke in die Qualität Ihrer Codebasis.

Leistungstipps

Einige Leistungstipps für Filament

Symbol-Cache

Um die Leistung der Filament-App zu optimieren, können Sie den Befehl php artisan icons:cache zum Zwischenspeichern von Symbolen verwenden. Dieser Befehl lädt die in Ihrer Anwendung verwendeten Symbole vorab und speichert sie zwischen, was zu schnelleren Ladezeiten führt.

php artisan icons:cache

Deaktivieren der Ansichtssammlung in Debugbar

Wenn Sie Leistungsprobleme haben und Ihre Anwendung beschleunigen möchten, sollten Sie die Ansichtssammlungsfunktion in der Debugbar deaktivieren. So können Sie es machen:

1. Navigieren Sie zur Konfigurationsdatei debugbar.php , die sich im config Ihrer App befindet.

2. In der Datei debugbar.php finden Sie ein Array mit dem Namen collectors . Suchen Sie den 'views' -Kollektor in diesem Array.

3. Um die Ansichtssammlung zu deaktivieren, setzen Sie einfach den 'views' -Kollektor auf false , wie folgt:

 ' collectors ' => [
    ...
    ' views ' => false,  // Views with their data
],

Diese Änderung verhindert, dass die Debugbar Ansichtsdaten sammelt und anzeigt, was dazu beitragen kann, die Leistung Ihrer Anwendung zu verbessern, insbesondere in einer Entwicklungsumgebung.

Zusätzliche Handwerkerbefehle

Dieses Projekt bietet zusätzliche Artisan-Befehle, um Ihren Arbeitsablauf zu vereinfachen und die Produktivität zu steigern.

IDE-Hilfsdateien generieren:

Generieren Sie allgemeine IDE-Hilfsdateien für eine verbesserte automatische Vervollständigung und Navigation des Codes, indem Sie Folgendes ausführen:

php artisan ide-helper:generate

Generieren Sie IDE-Modellhilfsdateien, ohne in Modelldateien zu schreiben, indem Sie Folgendes verwenden:

 # use any one of this two commands
php artisan ide-helper:models -N
php artisan ide-helper:models --nowrite

Führen Sie PHP CS Fixer aus

php artisan csfixer:run

Dieser Befehl stellt sicher, dass Ihr Code den vordefinierten Codierungsstandards entspricht und Ihre Codebasis sauber und lesbar macht.

Erstellen Sie einen Dienst

Das Erstellen von Diensten für Ihre Anwendung ist mühelos. Verwenden Sie den folgenden Befehl, um einen Dienst zu generieren:

php artisan make:service subfolder/ServiceName

Ersetzen Sie „subfolder“ und „ServiceName“ durch die tatsächlichen Werte, die Sie benötigen. Sie können einen Dienst auch ohne Unterordner erstellen:

php artisan make:service TestService

Der neu erstellte Dienst befindet sich unter app/Http/Services/TestService.php und ist bereit, die Geschäftslogik Ihrer Anwendung zu verarbeiten.

Generieren Sie eine Eigenschaft

Merkmale sind wiederverwendbare Codekomponenten, die die Codeorganisation verbessern. Um ein neues Merkmal zu erstellen, führen Sie einfach Folgendes aus:

php artisan make:trait TestTrait

Dieser Befehl generiert eine neue Trait-Datei für Ihr Projekt und fördert so die Wiederverwendbarkeit und Wartbarkeit des Codes.

Nutzen Sie diese Artisan-Befehle, um Ihren Entwicklungsprozess zu optimieren und eine gut strukturierte Codebasis aufrechtzuerhalten.

Autoren

• @AHS12

Lizenz

Dieses Projekt wird Ihnen von Innovix Matrix System präsentiert und als Open-Source-Software unter der MIT-Lizenz veröffentlicht.

Fühlen Sie sich frei, dieses Starterprojekt gemäß den MIT-Lizenzbedingungen zu verwenden, zu ändern und zu verbreiten. Wir fördern die Zusammenarbeit und freuen uns über Beiträge der Community, um dieses Projekt noch besser zu machen.