rails_den 2.0.0

data/app/models/rails_den/role.rb

@@ -0,0 +1,87 @@
+module RailsDen
+  class Role < ApplicationRecord
+    BUILT_IN_KEYS = %w[
+      guest
+      member
+      moderator
+      administrator
+    ].freeze
+
+    has_many :role_assignments,
+             class_name: "RailsDen::RoleAssignment",
+             inverse_of: :role,
+             dependent: :destroy
+
+    has_many :board_role_assignments,
+             class_name: "RailsDen::BoardRoleAssignment",
+             inverse_of: :role,
+             dependent: :destroy
+
+    has_many :role_permissions,
+             class_name: "RailsDen::RolePermission",
+             inverse_of: :role,
+             dependent: :destroy
+
+    has_many :board_role_permissions,
+             class_name: "RailsDen::BoardRolePermission",
+             inverse_of: :role,
+             dependent: :destroy
+
+    has_many :board_role_requirements,
+             class_name: "RailsDen::BoardRoleRequirement",
+             inverse_of: :role,
+             dependent: :destroy
+
+    has_many :category_role_requirements,
+             class_name: "RailsDen::CategoryRoleRequirement",
+             inverse_of: :role,
+             dependent: :destroy
+
+    has_many :topic_role_requirements,
+             class_name: "RailsDen::TopicRoleRequirement",
+             inverse_of: :role,
+             dependent: :destroy
+
+    validates :name,
+              presence: true
+
+    validates :key,
+              presence: true,
+              uniqueness: true,
+              format: {
+                with: /\A[a-z0-9]+(?:_[a-z0-9]+)*\z/,
+                message: "must contain only lowercase letters, numbers, and underscores"
+              }
+
+    validates :position,
+              numericality: {
+                only_integer: true,
+                greater_than_or_equal_to: 0
+              }
+
+    validate :built_in_key_is_known
+    validate :reserved_key_is_built_in
+
+    private
+
+    def built_in_key_is_known
+      return unless built_in?
+      return if key.in?(BUILT_IN_KEYS)
+
+      errors.add(
+        :key,
+        "is not a recognized built-in role"
+      )
+    end
+
+    def reserved_key_is_built_in
+      return unless key.in?(BUILT_IN_KEYS)
+      return if built_in?
+
+      errors.add(
+        :built_in,
+        "must be true for a built-in role"
+      )
+    end
+  end
+end

data/app/models/rails_den/role_assignment.rb

@@ -0,0 +1,18 @@
+module RailsDen
+  class RoleAssignment < ApplicationRecord
+    belongs_to :role,
+               class_name: "RailsDen::Role",
+               inverse_of: :role_assignments
+
+    belongs_to :user,
+               polymorphic: true
+
+    validates :role_id,
+              uniqueness: {
+                scope: %i[
+                  user_type
+                  user_id
+                ]
+              }
+  end
+end

data/app/models/rails_den/role_permission.rb

@@ -0,0 +1,41 @@
+module RailsDen
+  class RolePermission < ApplicationRecord
+    CAPABILITIES = %w[
+      view
+      post
+      reply
+      upload
+      message
+      moderate
+    ].freeze
+
+    BOARD_CAPABILITIES = %w[
+      view
+      post
+      reply
+      upload
+      moderate
+    ].freeze
+
+    belongs_to :role,
+               class_name: "RailsDen::Role",
+               inverse_of: :role_permissions
+
+    validates :capability,
+              presence: true,
+              inclusion: {
+                in: CAPABILITIES
+              },
+              uniqueness: {
+                scope: :role_id
+              }
+
+    validates :allowed,
+              inclusion: {
+                in: [
+                  true,
+                  false
+                ]
+              }
+  end
+end

data/app/models/rails_den/sluggable.rb

@@ -0,0 +1,102 @@
+module RailsDen
+  module Sluggable
+    extend ActiveSupport::Concern
+
+    MAX_SLUG_LENGTH = 200
+
+    included do
+      before_validation :generate_slug,
+                        on: :create
+    end
+
+    class_methods do
+      def slug_uniqueness_scope(*attributes)
+        if attributes.any?
+          @rails_den_slug_uniqueness_scope =
+            attributes
+              .map(&:to_sym)
+              .freeze
+        else
+          @rails_den_slug_uniqueness_scope || []
+        end
+      end
+    end
+
+    private
+
+    def generate_slug
+      return if slug.present?
+
+      base =
+        slug_base
+
+      self.slug =
+        available_slug(base)
+    end
+
+    def slug_base
+      base =
+        title
+          .to_s
+          .parameterize
+
+      base =
+        base
+          .first(MAX_SLUG_LENGTH)
+          .sub(/-+\z/, "")
+
+      base.presence || "item"
+    end
+
+    def available_slug(base)
+      candidate =
+        base
+
+      suffix =
+        2
+
+      while slug_taken?(candidate)
+        suffix_text =
+          "-#{suffix}"
+
+        available_length =
+          MAX_SLUG_LENGTH -
+          suffix_text.length
+
+        truncated_base =
+          base
+            .first(available_length)
+            .sub(/-+\z/, "")
+
+        truncated_base =
+          "item" if truncated_base.blank?
+
+        candidate =
+          "#{truncated_base}#{suffix_text}"
+
+        suffix += 1
+      end
+
+      candidate
+    end
+
+    def slug_taken?(candidate)
+      relation =
+        self.class.where(
+          slug: candidate
+        )
+
+      self.class
+        .slug_uniqueness_scope
+        .each do |attribute|
+          relation =
+            relation.where(
+              attribute =>
+                public_send(attribute)
+            )
+        end
+
+      relation.exists?
+    end
+  end
+end

data/app/models/rails_den/sponsor.rb

@@ -0,0 +1,20 @@
+module RailsDen
+  class Sponsor < ApplicationRecord
+    has_many :community_sponsorships,
+             class_name: "RailsDen::CommunitySponsorship",
+             inverse_of: :sponsor,
+             dependent: :restrict_with_error
+
+    has_many :category_sponsorships,
+             class_name: "RailsDen::CategorySponsorship",
+             inverse_of: :sponsor,
+             dependent: :restrict_with_error
+
+    has_many :board_sponsorships,
+             class_name: "RailsDen::BoardSponsorship",
+             inverse_of: :sponsor,
+             dependent: :restrict_with_error
+
+    validates :name, presence: true
+  end
+end

data/app/models/rails_den/sponsorship.rb

@@ -0,0 +1,87 @@
+module RailsDen
+  module Sponsorship
+    extend ActiveSupport::Concern
+
+    included do
+      belongs_to :sponsor,
+                 class_name: "RailsDen::Sponsor",
+                 inverse_of: inverse_association_name
+
+      validates :start_date,
+                :end_date,
+                presence: true
+
+      validates :destination_url,
+                format: {
+                  with: /\Ahttps?:\/\/[^\s]+\z/i,
+                  message: "must begin with http:// or https://"
+                },
+                allow_blank: true
+
+      validate :end_date_is_not_before_start_date
+      validate :date_range_does_not_overlap
+
+      scope :active_on, ->(date) {
+        where(
+          start_date: ..date,
+          end_date: date..
+        )
+      }
+    end
+
+    def active_on?(date)
+      start_date.present? &&
+        end_date.present? &&
+        start_date <= date &&
+        date <= end_date
+    end
+
+    def status_on(date)
+      return "Upcoming" if start_date.present? &&
+                           date < start_date
+
+      return "Expired" if end_date.present? &&
+                          date > end_date
+
+      "Active"
+    end
+
+    private
+
+    def end_date_is_not_before_start_date
+      return if start_date.blank? ||
+                end_date.blank? ||
+                end_date >= start_date
+
+      errors.add(
+        :end_date,
+        "must be on or after the start date"
+      )
+    end
+
+    def date_range_does_not_overlap
+      return if start_date.blank? ||
+                end_date.blank? ||
+                end_date < start_date
+
+      overlaps =
+        self.class.where.not(id: id)
+
+      overlaps =
+        overlaps.where(overlap_scope) if
+          overlap_scope.present?
+
+      overlaps =
+        overlaps
+          .where(start_date: ..end_date)
+          .where(end_date: start_date..)
+
+      if overlaps.exists?
+        errors.add(
+          :base,
+          overlap_error_message
+        )
+      end
+    end
+  end
+end

data/app/models/rails_den/tag.rb

@@ -0,0 +1,61 @@
+module RailsDen
+  class Tag < ApplicationRecord
+    include RailsDen::Sluggable
+
+    has_many :topic_tags,
+             class_name: "RailsDen::TopicTag",
+             inverse_of: :tag,
+             dependent: :destroy
+
+    has_many :topics,
+             through: :topic_tags
+
+    validates :title,
+              presence: true
+
+    validates :slug,
+              presence: true,
+              uniqueness: true,
+              format: {
+                with: /\A[a-z0-9]+(?:-[a-z0-9]+)*\z/,
+                message: "must contain only lowercase letters, numbers, and hyphens"
+              }
+
+    validates :position,
+              numericality: {
+                only_integer: true,
+                greater_than_or_equal_to: 0
+              }
+
+    validates :color,
+              format: {
+                with: /\A#[0-9a-fA-F]{6}\z/,
+                message: "must be a six-digit hex color such as #c83b32"
+              },
+              allow_blank: true
+
+    validates :icon,
+              length: {
+                maximum: 32
+              },
+              allow_blank: true
+
+    scope :ordered,
+          -> {
+            order(
+              :position,
+              :title,
+              :id
+            )
+          }
+
+    def self.model_name
+      @model_name ||=
+        ActiveModel::Name.new(
+          self,
+          nil,
+          "RailsDen::Tag"
+        )
+    end
+  end
+end

data/app/models/rails_den/theme_selection.rb

@@ -0,0 +1,4 @@
+module RailsDen
+  class ThemeSelection < ApplicationRecord
+  end
+end