rails tabler starter

Pemula Meja Rel

Boilerplate starter rel yang dapat Anda gunakan untuk membuat dan membuat prototipe dengan cepat. Mulai dari ide hingga implementasi dalam hitungan jam.

Klik di sini untuk melihat aplikasi demo. Periksa halaman penyiapan Demo untuk mengubah pengaturan aplikasi.

Sasaran

Pemula ini ditujukan untuk pengembang Rails yang memahami kerangka kerja ini, yang bertujuan untuk memfasilitasi pengembangan yang lancar dengan prinsip-prinsip berikut:

• Tanpa DSL: Hindari kerumitan Bahasa Khusus Domain (DSL).
• Kesederhanaan dibandingkan Efisiensi: Prioritaskan kesederhanaan dalam implementasi daripada optimasi yang berlebihan.
• Hindari Fungsi Frontend yang Kompleks: Jaga agar fungsionalitas frontend tetap sederhana dan mudah dikelola.

Ringkasan

• Dilengkapi dengan model penting seperti

  • Pengguna
  • Peran
  • Rencana
  • Langganan

ERD

• Otentikasi & otorisasi pengguna

  • Otentikasi melalui Rancangan
  • Integrasi OmniAuth untuk memperluas otentikasi menggunakan penyedia pihak ketiga
  • Otorisasi melalui Pundit

• Pekerja & penjadwal latar belakang

  • Menggunakan sidekiq dan sidekiq-scheduler

• Manajemen peran

  • Peran standar tersedia di seluruh ruang
  • Pembuatan peran khusus per ruang
  • Mendukung izin terperinci per peran

• Dukungan beberapa ruang nama pengguna

  • Memanfaatkan model Space untuk mewakili ruang nama pengguna (misalnya, tim, organisasi).
  • Contoh kasus penggunaan untuk mengaktifkan mode multi-spasi adalah aplikasi saas
  • Contoh kasus penggunaan untuk mematikan mode multi-ruang adalah alat organisasi internal

• Tata letak UI yang dibuat sebelumnya

  • Elemen dan tata letak UI berkualitas tinggi dari Tabler

• Fokus pada pembangunan

  • Anotasi - Anotasi kelas Rails dengan info skema dan rute
  • Brakeman - Pemindai kerentanan keamanan analisis statis
  • Byebug - Debugger sederhana
  • Dotenv - Memuat variabel lingkungan dari .env

Pengaturan

Untuk menyiapkan proyek, pastikan Anda telah menginstal PostgreSQL dan Redis secara lokal. Gunakan perintah berikut untuk menginstalnya:

 brew install postgresql@12 redis

Kloning reponya

 git clone https://github.com/tarunvelli/rails-tabler-starter.git

Instal dependensi yang diperlukan menggunakan asdf atau atur dependensi .tool-versions dengan metode pilihan lain:

 asdf install

Siapkan dan jalankan server pengembangan:

 bin/setup
bin/dev

Untuk memberikan hak administratif kepada pengguna dan mengakses fitur admin, jalankan perintah berikut di konsol Rails:

 bundle exec rails c
> User.first.update(admin: true)

Pengaturan Aplikasi

Alihkan pengaturan aplikasi di /setup/edit

• AppSettings.interface_layout

  • Tata letak aplikasi
  • nilai ["VERTIKAL", "VERTIKAL-TRANSPARAN", "HORIZONTAL", "TUMBUH", "KEDAT"]

• AppSettings.interface_mode

  • Mode aplikasi Terang/Gelap
  • "SISTEM" memilih mode dari preferensi sistem
  • Nilai ["TERANG", "GELAP", "SISTEM"]

• AppSettings.interface_theme

  • Tema warna aplikasi
  • Nilai ["DEFAULT", "COOL"]

• AppSettings.login_layout salah satunya

  • Tata letak layar login
  • Nilai ["DEFAULT", "ILLUSTRASI", "COVER"]

• AppSettings.multi_tenant_mode

  • Ketika benar memungkinkan pengguna untuk mendaftar dan membuat ruang
  • Ketika false hanya mengizinkan admin untuk mengundang pengguna dan membuat ruang
  • Nilai [benar, salah]

• AppSettings.show_landing_page

  • Ketika jalur root yang sebenarnya merender halaman arahan
  • Ketika jalur root palsu dialihkan ke halaman masuk
  • Nilai [benar, salah]

Penyebaran

Pilih platform penerapan pilihan Anda:

• Terapkan di Fly.io
• Terapkan di Heroku

Kontribusi

Kontribusi untuk meningkatkan starter ini sangat dianjurkan dan disambut baik! Jangan ragu untuk mengirimkan permintaan penarikan dan meningkatkan proyek secara kolaboratif.