b4um_generators 0.3.0 → 0.4.2

data/lib/generators/b4um/admin/templates/add_admin_fields_migration.rb.tt

@@ -0,0 +1,10 @@
+class AddAdminFieldsTo<%= authentication_class_name.pluralize %> < ActiveRecord::Migration[8.0]
+  def change
+<% unless admin_column_exists? -%>
+    add_column :<%= authentication_model_name.pluralize %>, :admin, :boolean, default: false, null: false
+<% end -%>
+<% unless blocked_column_exists? -%>
+    add_column :<%= authentication_model_name.pluralize %>, :blocked, :boolean, default: false, null: false
+<% end -%>
+  end
+end

data/lib/generators/b4um/admin/templates/admin_base_controller.rb.tt

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class Admin::BaseController < ApplicationController
+  before_action :require_admin
+end

data/lib/generators/b4um/admin/templates/admin_dashboard.html.erb.tt

@@ -0,0 +1,19 @@
+<%% content_for :title, "Admin" %>
+
+<div class="page-header">
+  <h1>Admin</h1>
+</div>
+
+<div class="b4um-grid">
+  <section class="b4um-card b4um-card--full">
+    <h2>User management</h2>
+
+    <p>
+      Manage registered users and administrator permissions.
+    </p>
+
+    <%%= link_to "Manage users",
+                admin_users_path,
+                class: "button button--primary" %>
+  </section>
+</div>

data/lib/generators/b4um/admin/templates/admin_dashboard_controller.rb.tt

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+class Admin::DashboardController < Admin::BaseController
+  def index
+  end
+end

data/lib/generators/b4um/admin/templates/admin_users_controller.rb.tt

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+class Admin::UsersController < Admin::BaseController
+  def index
+    @users = <%= authentication_class_name %>.all
+  end
+
+  def block
+    user = <%= authentication_class_name %>.find(params[:id])
+
+    if user == <%= current_authentication_method %>
+      redirect_to admin_users_path,
+                  alert: "You cannot block your own account."
+      return
+    end
+
+    user.update!(blocked: true)
+
+    redirect_to admin_users_path,
+                notice: "User was blocked."
+  end
+
+  def unblock
+    user = <%= authentication_class_name %>.find(params[:id])
+
+    user.update!(blocked: false)
+
+    redirect_to admin_users_path,
+                notice: "User was unblocked."
+  end
+
+  def grant_admin
+    user = <%= authentication_class_name %>.find(params[:id])
+
+    user.update!(admin: true)
+
+    redirect_to admin_users_path,
+                notice: "Administrator rights were granted."
+  end
+
+  def revoke_admin
+    user = <%= authentication_class_name %>.find(params[:id])
+
+    if user.admin? && <%= authentication_class_name %>.where(admin: true).count == 1
+      redirect_to admin_users_path,
+                  alert: "The last administrator cannot lose administrator rights."
+      return
+    end
+
+    user.update!(admin: false)
+
+    redirect_to admin_users_path,
+                notice: "Administrator rights were revoked."
+  end
+
+  def destroy
+    user = <%= authentication_class_name %>.find(params[:id])
+
+    if user == <%= current_authentication_method %>
+      redirect_to admin_users_path,
+                  alert: "You cannot delete your own account."
+      return
+    end
+
+    user.destroy!
+
+    redirect_to admin_users_path,
+                notice: "User was deleted."
+  end
+end

data/lib/generators/b4um/admin/templates/admin_users_index.html.erb.tt

@@ -0,0 +1,110 @@
+<%% content_for :title, "Users" %>
+
+<div class="page-header">
+  <h1>Users</h1>
+</div>
+
+<div class="b4um-grid">
+  <section class="b4um-card b4um-card--full">
+    <%% if @users.any? %>
+      <div class="b4um-table-wrapper">
+        <table class="b4um-table">
+          <thead>
+            <tr>
+<% admin_user_display_fields.each do |field| -%>
+              <th><%= admin_user_field_label(field) %></th>
+<% end -%>
+              <th>Admin</th>
+              <th>Blocked</th>
+              <th>Actions</th>
+            </tr>
+          </thead>
+
+          <tbody>
+            <%% @users.each do |user| %>
+              <tr>
+<% admin_user_display_fields.each do |field| -%>
+                <td>
+                  <%%= user.<%= field %> %>
+                </td>
+
+<% end -%>
+                <td>
+                  <span class="b4um-badge">
+                    <%%= user.admin? ? "Yes" : "No" %>
+                  </span>
+                </td>
+
+                <td>
+                  <span class="b4um-badge">
+                    <%%= user.blocked? ? "Yes" : "No" %>
+                  </span>
+                </td>
+
+                <td>
+                  <div class="b4um-table__actions">
+                    <%% if user != <%= current_authentication_method %> %>
+                      <%% if user.blocked? %>
+                        <%%= link_to "Unblock",
+                                    unblock_admin_user_path(user),
+                                    class: "button button--secondary",
+                                    data: {
+                                      turbo_method: :patch,
+                                      turbo_confirm: "Unblock this user?"
+                                    } %>
+                      <%% else %>
+                        <%%= link_to "Block",
+                                    block_admin_user_path(user),
+                                    class: "button button--secondary",
+                                    data: {
+                                      turbo_method: :patch,
+                                      turbo_confirm: "Block this user?"
+                                    } %>
+                      <%% end %>
+
+                      <%% if user.admin? %>
+                        <%%= link_to "Remove admin",
+                                    revoke_admin_admin_user_path(user),
+                                    class: "button button--secondary",
+                                    data: {
+                                      turbo_method: :patch,
+                                      turbo_confirm: "Remove administrator rights from this user?"
+                                    } %>
+                      <%% else %>
+                        <%%= link_to "Make admin",
+                                    grant_admin_admin_user_path(user),
+                                    class: "button button--secondary",
+                                    data: {
+                                      turbo_method: :patch,
+                                      turbo_confirm: "Grant administrator rights to this user?"
+                                    } %>
+                      <%% end %>
+
+                      <%%= link_to "Delete",
+                                  admin_user_path(user),
+                                  class: "button button--secondary",
+                                  data: {
+                                    turbo_method: :delete,
+                                    turbo_confirm: "Delete this user permanently?"
+                                  } %>
+                    <%% end %>
+                  </div>
+                </td>
+              </tr>
+            <%% end %>
+          </tbody>
+        </table>
+      </div>
+    <%% else %>
+      <section class="b4um-empty-state">
+        <h2 class="b4um-empty-state__title">
+          No users yet.
+        </h2>
+
+        <p class="b4um-empty-state__text">
+          Registered users will appear here.
+        </p>
+      </section>
+    <%% end %>
+  </section>
+</div>

data/lib/generators/b4um/admin/templates/b4um_admin.rake.tt

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "io/console"
+
+namespace :b4um do
+  namespace :admin do
+    desc "Create an administrator"
+
+    task create: :environment do
+      model = <%= authentication_class_name %>
+
+      missing_columns = %w[admin blocked] - model.column_names
+
+      unless missing_columns.empty?
+        abort(
+          "Missing database columns: #{missing_columns.join(', ')}. " \
+          "Run bin/rails db:migrate before creating an administrator."
+        )
+      end
+
+      required_fields = model.validators
+                            .select do |validator|
+                              next false unless validator.is_a?(
+                                ActiveModel::Validations::PresenceValidator
+                              )
+
+                              validator.options[:if].nil? &&
+                                (
+                                  validator.options[:unless].nil? ||
+                                  validator.options[:unless] == :guest?
+                                )
+                            end
+                            .flat_map(&:attributes)
+                            .map(&:to_s)
+
+      attributes = {}
+
+<% admin_creation_fields.each do |field| -%>
+      required = required_fields.include?("<%= field %>")
+      required_marker = required ? " *" : ""
+      <%= field %> = nil
+
+      loop do
+        print "<%= admin_user_field_label(field) %>#{required_marker}: "
+        <%= field %> = STDIN.gets&.strip
+
+        break unless required && (<%= field %>.nil? || <%= field %>.empty?)
+
+        puts "<%= admin_user_field_label(field) %> cannot be empty."
+      end
+
+      unless <%= field %>.nil? || <%= field %>.empty?
+        attributes[:<%= field %>] = <%= field %>
+      end
+
+<% end -%>
+      email = nil
+      password = nil
+      password_confirmation = nil
+
+      loop do
+        print "Email *: "
+        email = STDIN.gets&.strip
+
+        break unless email.nil? || email.empty?
+
+        puts "Email cannot be empty."
+      end
+
+      if model.exists?(email: email)
+        abort "A user with this email already exists."
+      end
+
+      loop do
+        print "Password *: "
+        password = STDIN.noecho(&:gets)&.strip
+        puts
+
+        break unless password.nil? || password.empty?
+
+        puts "Password cannot be empty."
+      end
+
+      loop do
+        print "Confirm password *: "
+        password_confirmation = STDIN.noecho(&:gets)&.strip
+        puts
+
+        break if password == password_confirmation
+
+        puts "Passwords do not match."
+      end
+
+      attributes.merge!(
+        email: email,
+        password: password,
+        password_confirmation: password_confirmation,
+        admin: true
+      )
+
+      model.create!(attributes)
+
+      puts "Administrator #{email} was created successfully."
+    end
+  end
+end