Rails Tabler Starter
Rails-Starter-Boilerplate, mit dem Sie schnell erstellen und Prototypen erstellen können. Von der Idee bis zur Umsetzung in wenigen Stunden. Klicken Sie hier, um die Demoanwendung anzuzeigen. Schauen Sie sich die Demo-Setup-Seite an, um die Anwendungseinstellungen umzuschalten.
Ziele
Dieser Starter richtet sich an Rails-Entwickler, die mit dem Framework vertraut sind, und zielt darauf ab, eine nahtlose Entwicklung mit den folgenden Prinzipien zu ermöglichen:
- Kein DSL: Vermeiden Sie unnötige DSL-Komplexität (Domain Specific Language).
- Einfachheit vor Effizienz: Geben Sie Einfachheit bei der Implementierung Vorrang vor übermäßiger Optimierung.
- Vermeiden Sie komplexe Frontend-Funktionalitäten: Halten Sie die Frontend-Funktionalität einfach und überschaubar.
Überblick
ERD Benutzerauthentifizierung und -autorisierung
- Authentifizierung über Devise
- OmniAuth-Integration zur Erweiterung der Authentifizierung mithilfe von Drittanbietern
- Autorisierung durch Pundit
Hintergrundarbeiter und Planer
- Verwendet Sidekiq und Sidekiq-Scheduler
Rollenmanagement
- Standardrollen sind bereichsübergreifend verfügbar
- Benutzerdefinierte Rollenerstellung pro Bereich
- Unterstützt fein abgestufte Berechtigungen pro Rolle
Unterstützung mehrerer Benutzernamensräume
- Verwendet das
Space
Modell zur Darstellung von Benutzernamensräumen (z. B. Teams, Organisationen). - Ein Beispielanwendungsfall für die Aktivierung des Multispace-Modus ist eine Saas-Anwendung
- Ein Beispielanwendungsfall für das Deaktivieren des Multispace-Modus ist ein internes Organisationstool
Vorgefertigte UI-Layouts
- Hochwertige UI-Elemente und Layouts von Tabler
Entwicklungsfokussiert
- Kommentieren – Kommentieren Sie Rails-Klassen mit Schema- und Routeninformationen
- Brakeman – Ein statischer Analyse-Scanner für Sicherheitslücken
- Byebug – Einfacher Debugger
- Dotenv – Umgebungsvariablen aus
.env
laden
Aufstellen
Stellen Sie zum Einrichten des Projekts sicher, dass PostgreSQL und Redis lokal installiert sind. Verwenden Sie die folgenden Befehle, um sie zu installieren:
brew install postgresql@12 redis
Klonen Sie das Repo
git clone https://github.com/tarunvelli/rails-tabler-starter.git
Installieren Sie die erforderlichen Abhängigkeiten mit asdf oder richten Sie die Abhängigkeiten .tool-versions
mit einer anderen bevorzugten Methode ein:
Richten Sie den Entwicklungsserver ein und führen Sie ihn aus:
Um einem Benutzer Administratorrechte zu erteilen und auf Administratorfunktionen zuzugreifen, führen Sie Folgendes in der Rails-Konsole aus:
bundle exec rails c
> User.first.update(admin: true)
App-Einstellungen
Schalten Sie die App-Einstellungen unter /setup/edit
um
AppSettings.interface_layout
- Layout der App
- Werte ["VERTICAL", "VERTICAL-TRANSPARENT", "HORIZONTAL", "OVERLAP", "CONDENSED"]
AppSettings.interface_mode
- Hell/Dunkel-Modus der App
- „SYSTEM“ wählt den Modus aus den Systemeinstellungen aus
- Werte [„LICHT“, „DUNKEL“, „SYSTEM“]
AppSettings.interface_theme
- Farbthema der App
- Werte [„DEFAULT“, „COOL“]
AppSettings.login_layout
eines davon
- Layout der Anmeldebildschirme
- Werte [„DEFAULT“, „ILLUSTRATION“, „COVER“]
AppSettings.multi_tenant_mode
- Bei „true“ können sich Benutzer anmelden und Bereiche erstellen
- Bei „false“ ist es nur dem Administrator gestattet, Benutzer einzuladen und Bereiche zu erstellen
- Werte [wahr, falsch]
AppSettings.show_landing_page
- Wenn der echte Root-Pfad die Zielseite rendert
- Wenn ein falscher Root-Pfad zur Anmeldeseite umleitet
- Werte [wahr, falsch]
Einsatz
Wählen Sie Ihre bevorzugte Bereitstellungsplattform:
- Auf Fly.io bereitstellen
- Bereitstellung auf Heroku
Beitrag
Beiträge zur Verbesserung dieses Starters sind sehr erwünscht und willkommen! Fühlen Sie sich frei, Pull-Requests einzureichen und das Projekt gemeinsam zu verbessern.