effective_mentorships 0.0.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d38ae69a59937ebf5e1c21dad2407001277481495e60af6a1d1870609c9c6fb
-  data.tar.gz: a8d9c6644d62270c9f2c28662d94e3e833ecbf57ee1daa99b5ac2668f3dbc234
+  metadata.gz: 171010bae5f93974f5ba6044bd82f880f2b552bd913c7ca0137122b362859262
+  data.tar.gz: cffbb49649eff6aba7a73456241ef7a8e86e3521225144230534bdbba6955b31
 SHA512:
-  metadata.gz: f99ac651786e4cbcc30363b4170ace9ba1d44537fe174a8dd67d35ff004a4bb7d2b0e5556015952c0a20450c9d4871b706f659a1cce42074b726233a3d958a0a
-  data.tar.gz: 62124e0a9999292cc0d61e736d808c619f1e942a027edab3fc4c912dda2639fe605cb87bc8b82b87dca3ca8ead57b8b8c6a95c70f312713f752fd3cba3907be8
+  metadata.gz: e6e1290b4d9b47a3518db1d17e22cb003ffe6bb1e5fdb5e3453671c2fe006b4d0c32f239f6df299b88932b2f30884c9a2e5e24a21c78282effa16ef805784d9b
+  data.tar.gz: 599848b64d0f1c77f2141a6de91d748443c9f00c18531fb2c27c0e9fa86236e92280842394013da0d41b37e1578addaab5162f23fde71ab485430900568be1ab

data/app/controllers/admin/mentorship_group_users_controller.rb

@@ -0,0 +1,17 @@
+module Admin
+  class MentorshipGroupUsersController < ApplicationController
+    before_action(:authenticate_user!) if defined?(Devise)
+    before_action { EffectiveResources.authorize!(self, :admin, :effective_mentorships) }
+
+    include Effective::CrudController
+
+    resource_scope -> { Effective::MentorshipGroupUser.deep.all }
+
+    private
+
+    def permitted_params
+      params.require(:effective_mentorship_group_user).permit!
+    end
+
+  end
+end

data/app/controllers/admin/mentorship_groups_controller.rb

@@ -0,0 +1,18 @@
+module Admin
+  class MentorshipGroupsController < ApplicationController
+    before_action(:authenticate_user!) if defined?(Devise)
+    before_action { EffectiveResources.authorize!(self, :admin, :effective_mentorships) }
+
+    include Effective::CrudController
+
+    resource_scope -> { EffectiveMentorships.MentorshipGroup.deep.all }
+    datatable -> { EffectiveResources.best('Admin::EffectiveMentorshipGroupsDatatable').new }
+
+    private
+
+    def permitted_params
+      model = (params.key?(:effective_mentorship_group) ? :effective_mentorship_group : :mentorship_group)
+      params.require(model).permit!
+    end
+  end
+end

data/app/controllers/admin/mentorship_registrations_controller.rb

@@ -0,0 +1,19 @@
+module Admin
+  class MentorshipRegistrationsController < ApplicationController
+    before_action(:authenticate_user!) if defined?(Devise)
+    before_action { EffectiveResources.authorize!(self, :admin, :effective_mentorships) }
+
+    include Effective::CrudController
+
+    resource_scope -> { EffectiveMentorships.MentorshipRegistration.deep.all }
+    datatable -> { EffectiveResources.best('Admin::EffectiveMentorshipRegistrationsDatatable').new }
+
+    private
+
+    def permitted_params
+      model = (params.key?(:effective_mentorship_registration) ? :effective_mentorship_registration : :mentorship_registration)
+      params.require(model).permit!
+    end
+
+  end
+end

data/app/controllers/effective/mentorship_groups_controller.rb

@@ -0,0 +1,9 @@
+module Effective
+  class MentorshipGroupsController < ApplicationController
+    before_action(:authenticate_user!) if defined?(Devise)
+
+    include Effective::CrudController
+
+    resource_scope -> { EffectiveMentorships.MentorshipGroup.deep.all }
+  end
+end

data/app/controllers/effective/mentorship_registrations_controller.rb

@@ -0,0 +1,12 @@
+module Effective
+  class MentorshipRegistrationsController < ApplicationController
+    before_action(:authenticate_user!) if defined?(Devise)
+
+    include Effective::CrudController
+
+    resource_scope do
+      cycle = Effective::MentorshipCycle.find(params[:mentorship_cycle_id])
+      EffectiveMentorships.MentorshipRegistration.deep.where(mentorship_cycle: cycle)
+    end
+  end
+end

data/app/datatables/admin/effective_mentorship_cycles_datatable.rb

@@ -1,5 +1,13 @@
 module Admin
   class EffectiveMentorshipCyclesDatatable < Effective::Datatable
+    filters do
+      scope :all
+      scope :registrable
+      scope :available
+      scope :upcoming
+      scope :past
+    end
+
     datatable do
       order :start_at, :desc
 
@@ -8,15 +16,20 @@ module Admin
       col :updated_at, visible: false
 
       col :title
-      col :start_at
-      col :end_at
 
-      col :registration_start_at
-      col :registration_end_at
+      col :start_at, as: :date
+      col :end_at, as: :date
+      col :registration_start_at, as: :date
+      col :registration_end_at, as: :date
 
       col :max_pairings_mentor, label: "Max #{mentorships_mentors_label}"
       col :max_pairings_mentee, label: "Max #{mentorships_mentees_label}"
 
+      col :mentorship_registrations_count, label: mentorship_registrations_label
+      col :mentorship_groups_count, label: mentorship_groups_label
+
+      col :rich_text_registration_content, label: "#{mentorship_registration_label} opt-in content", visible: false
+
       actions_col
     end
 

data/app/datatables/admin/effective_mentorship_group_users_datatable.rb

@@ -0,0 +1,22 @@
+module Admin
+  class EffectiveMentorshipGroupUsersDatatable < Effective::Datatable
+    datatable do
+      order :updated_at
+
+      col :updated_at, visible: false
+      col :created_at, visible: false
+      col :id, visible: false
+
+      col :mentorship_cycle
+      col :mentorship_group
+      col :mentorship_role
+      col :user
+
+      actions_col
+    end
+
+    collection do
+      Effective::MentorshipGroupUser.deep.all
+    end
+  end
+end

data/app/datatables/admin/effective_mentorship_groups_datatable.rb

@@ -0,0 +1,37 @@
+module Admin
+  class EffectiveMentorshipGroupsDatatable < Effective::Datatable
+    filters do
+      scope :all
+      scope :archived
+    end
+
+    datatable do
+      order :updated_at
+
+      col :updated_at, visible: false
+      col :created_at, visible: false
+      col :id, visible: false
+      col :token, visible: false
+
+      col :mentorship_cycle
+      col :title
+      col :rich_text_admin_notes, label: "Admin notes"
+
+      col :mentorship_group_users, search: :string do |mentorship_group|
+        mentorship_group.mentorship_group_users.map do |mentorship_group_user| 
+          content_tag(:div, class: 'col-resource_item') do
+            mentorship_role_badge(mentorship_group_user.mentorship_role) + ' ' + mentorship_group_user.name
+          end
+        end.join.html_safe
+      end
+
+      col :archived
+
+      actions_col
+    end
+
+    collection do
+      EffectiveMentorships.MentorshipGroup.deep.all
+    end
+  end
+end

data/app/datatables/admin/effective_mentorship_registrations_datatable.rb

@@ -0,0 +1,42 @@
+module Admin
+  class EffectiveMentorshipRegistrationsDatatable < Effective::Datatable
+    filters do
+      scope :all
+      scope :opt_in
+      scope :opt_out
+    end
+
+    datatable do
+      order :updated_at
+
+      col :updated_at, visible: false
+      col :created_at, visible: false
+      col :id, visible: false
+      col :token, visible: false
+
+      col :mentorship_cycle
+      col :user
+
+      col :opt_in
+
+      col :mentorship_role, search: mentorship_roles_collection() do |registration|
+        mentorship_role_label(registration.mentorship_role)
+      end
+
+      col :category, search: EffectiveMentorships.MentorshipRegistration.categories
+      col :venue, search: EffectiveMentorships.MentorshipRegistration.venues
+      col :location, search: EffectiveMentorships.MentorshipRegistration.locations
+      col :mentor_multiple_mentees, visible: false
+      col :mentor_multiple_mentees_limit, visible: false
+
+      col :parent, visible: false
+      col :rich_text_comments, label: "Comments", visible: false
+
+      actions_col
+    end
+
+    collection do
+      EffectiveMentorships.MentorshipRegistration.deep.all
+    end
+  end
+end

data/app/datatables/effective_mentorships_available_cycles_datatable.rb

@@ -0,0 +1,40 @@
+# Dashboard - the cycles we can register for
+class EffectiveMentorshipsAvailableCyclesDatatable < Effective::Datatable
+  datatable do
+    order :start_at, :desc
+
+    col :title
+
+    col :registration, label: "Registration available" do |mentorship_cycle|
+      mentorship_cycle.registrable_date
+    end
+
+    col :available, label: "Schedule" do |mentorship_cycle|
+      mentorship_cycle.available_date
+    end
+
+    col :start_at, visible: false
+
+    actions_col(actions: []) do |cycle|
+      registration = current_user.mentorship_registration(mentorship_cycle: cycle)
+
+      if registration.blank?
+        if EffectiveResources.authorized?(self, :new, EffectiveMentorships.MentorshipRegistration)
+          dropdown_link_to('Register', effective_mentorships.new_mentorship_cycle_mentorship_registration_path(cycle))
+        end
+      else
+        if EffectiveResources.authorized?(self, :edit, registration)
+          dropdown_link_to('Edit', effective_mentorships.edit_mentorship_cycle_mentorship_registration_path(cycle, registration))
+        end
+
+        if EffectiveResources.authorized?(self, :destroy, registration)
+          dropdown_link_to('Delete', effective_mentorships.mentorship_cycle_mentorship_registration_path(cycle, registration), 'data-confirm': "Really delete #{registration}?", 'data-method': :delete)
+        end
+      end
+    end
+  end
+
+  collection do
+    Effective::MentorshipCycle.where(id: current_user.registrable_mentorship_cycles)
+  end
+end

data/app/datatables/effective_mentorships_groups_datatable.rb

@@ -0,0 +1,25 @@
+# Dashboard - My mentorship groups
+class EffectiveMentorshipsGroupsDatatable < Effective::Datatable
+  datatable do
+    order :mentorship_cycle
+
+    col :mentorship_cycle
+    col :title
+
+    col :mentorship_group_users, search: :string do |mentorship_group|
+      mentorship_group.mentorship_group_users.map do |mentorship_group_user| 
+        user = mentorship_group_user.user
+
+        content_tag(:div, class: 'col-resource_item') do
+          mentorship_role_badge(mentorship_group_user.mentorship_role) + ' ' + link_to(user, "mailto:#{user.try(:public_email).presence || user.email}")
+        end
+      end.join.html_safe
+    end
+
+    actions_col
+  end
+
+  collection do
+    EffectiveMentorships.MentorshipGroup.deep.unarchived.where(id: current_user.mentorship_groups)
+  end
+end

data/app/datatables/effective_mentorships_registrations_datatable.rb

@@ -0,0 +1,25 @@
+# Dashboard - the cycles we have registered for but aren't in a group for yet
+class EffectiveMentorshipsRegistrationsDatatable < Effective::Datatable
+  datatable do
+    col :mentorship_cycle
+
+    col :available, label: "Schedule" do |mentorship_registration|
+      mentorship_registration.mentorship_cycle.available_date
+    end
+
+    col :opt_in
+    col :mentorship_role do |mentorship_registration|
+      if mentorship_registration.opt_in?
+        badge(mentorship_registration.mentorship_role)
+      else
+        '-'
+      end
+    end
+
+    actions_col
+  end
+
+  collection do
+    current_user.mentorship_registrations_without_groups
+  end
+end

data/app/helpers/effective_mentorships_helper.rb

@@ -4,6 +4,38 @@ module EffectiveMentorshipsHelper
     et('effective_mentorships.name')
   end
 
+  def mentorship_cycle_label
+    et(Effective::MentorshipCycle)
+  end
+
+  def mentorship_cycles_label
+    ets(Effective::MentorshipCycle)
+  end
+
+  def mentorship_registration_label
+    et(EffectiveMentorships.MentorshipRegistration)
+  end
+
+  def mentorship_registrations_label
+    ets(EffectiveMentorships.MentorshipRegistration)
+  end
+
+  def mentorship_group_label
+    et(EffectiveMentorships.MentorshipGroup)
+  end
+
+  def mentorship_groups_label
+    ets(EffectiveMentorships.MentorshipGroup)
+  end
+
+  def mentorship_group_user_label
+    ets(Effective::MentorshipGroupUser)
+  end
+
+  def mentorship_group_users_label
+    ets(Effective::MentorshipGroupUser)
+  end
+
   def mentorships_mentee_label
     et('effective_mentorships.mentee')
   end
@@ -20,20 +52,25 @@ module EffectiveMentorshipsHelper
     ets('effective_mentorships.mentor')
   end
 
-  def mentorship_cycle_label
-    et(Effective::MentorshipCycle)
+  def mentorship_roles_collection
+    EffectiveMentorships.MentorshipRegistration.mentorship_roles.map { |role| [mentorship_role_label(role), role] }
   end
 
-  def mentorship_cycles_label
-    ets(Effective::MentorshipCycle)
+  def mentorship_categories_collection
+    EffectiveMentorships.MentorshipRegistration.mentorship_categories
   end
 
-  def mentorship_group_label
-    et(EffectiveMentorships.MentorshipGroup)
+  def mentorship_role_label(role)
+    case role.to_s
+    when 'mentor' then et('effective_mentorships.mentor')
+    when 'mentee' then et('effective_mentorships.mentee')
+    else
+      raise("unexpected mentorship role: #{role}")
+    end
   end
 
-  def mentorship_groups_label
-    ets(EffectiveMentorships.MentorshipGroup)
+  def mentorship_role_badge(mentorship_role)
+    badge(mentorship_role_label(mentorship_role))
   end
 
 end

data/app/models/concerns/effective_mentorships_group.rb

@@ -18,29 +18,33 @@ module EffectiveMentorshipsGroup
   end
 
   included do
-    log_changes if respond_to?(:log_changes)
     acts_as_archived
     acts_as_tokened
 
-    # rich_text_body
+    log_changes if respond_to?(:log_changes)
+
     has_many_rich_texts
+    # rich_text_admin_notes
 
     # Effective Scoped
     belongs_to :mentorship_cycle, class_name: 'Effective::MentorshipCycle', counter_cache: true
 
-    # App Scoped
-    belongs_to :user
+    has_many :mentorship_group_users, class_name: 'Effective::MentorshipGroupUser', dependent: :delete_all
+    accepts_nested_attributes_for :mentorship_group_users, allow_destroy: true
 
     effective_resource do
-      archived      :boolean
+      title         :string
 
+      archived      :boolean
       token         :string
 
       timestamps
     end
 
-    scope :deep, -> { includes(:rich_texts) }
+    scope :deep, -> { includes(:mentorship_cycle, :rich_texts, mentorship_group_users: [:user]) }
     scope :sorted, -> { order(:id) }
+
+    validates :title, presence: true, uniqueness: true
   end
 
   # Instance Methods
@@ -48,4 +52,8 @@ module EffectiveMentorshipsGroup
     model_name.human
   end
 
+  def mentorship_group_user(user:)
+    mentorship_group_users.find { |mgu| mgu.user == user }
+  end
+
 end

data/app/models/concerns/effective_mentorships_registration.rb

@@ -17,7 +17,19 @@ module EffectiveMentorshipsRegistration
     def effective_mentorships_registration?; true; end
 
     def mentorship_roles
-      ['A Mentor', 'A Protege', 'Both']
+      [:mentor, :mentee]
+    end
+
+    def categories
+      ['General', 'Industry Specific']
+    end
+
+    def locations
+      ['Canada', 'United States']
+    end
+
+    def venues
+      ['Virtual', 'In-person', 'Either']
     end
   end
 
@@ -25,34 +37,78 @@ module EffectiveMentorshipsRegistration
     log_changes if respond_to?(:log_changes)
     acts_as_tokened
 
-    # rich_text_body
     has_many_rich_texts
+    # rich_text_comments
 
     # Effective Scoped
     belongs_to :mentorship_cycle, class_name: 'Effective::MentorshipCycle', counter_cache: true
 
     # App Scoped
     belongs_to :user
+    belongs_to :parent, polymorphic: true, optional: true # A FeePayment if this was done through a fee payment
 
     effective_resource do
-      # Preferences
-      mentorship_role   :string
+      title              :string # Auto generated
 
-      token             :string
+      # Registration
+      opt_in             :boolean # Opt in to this mentorship cycle
+      accept_declaration :boolean
+      mentorship_role    :string
+
+      # Pairing info
+      category           :string # Professional category interests
+      venue              :string # Preferred venue virtual or in person
+      location           :string # Closest city of residence
+
+      # Mentor only fields
+      mentor_multiple_mentees         :boolean
+      mentor_multiple_mentees_limit   :integer
 
+      # Mentee only fields
+      # None
+
+      token             :string
       timestamps
     end
 
+    # Always assign title
+    before_validation do
+      self.title = [user, (opt_in ? mentorship_role : 'Opt Out')].compact.join(' - ')
+    end
+
+    with_options(if: -> { opt_in? }) do
+      validates :mentorship_role, presence: true
+      validates :category, presence: true
+      validates :venue, presence: true
+      validates :location, presence: true
+      validates :accept_declaration, acceptance: true
+    end
+
+    validates :mentor_multiple_mentees_limit, numericality: { greater_than: 0 }, if: -> { opt_in? && mentor_multiple_mentees? }
+
     scope :deep, -> { includes(:rich_texts, :user, :mentorship_cycle) }
     scope :sorted, -> { order(:id) }
 
+    scope :mentors, -> { where(mentorship_role: :mentor) }
+    scope :mentees, -> { where(mentorship_role: :mentee) }
+    scope :opt_in, -> { where(opt_in: true) }
+    scope :opt_out, -> { where(opt_in: false) }
+
     # User
     validates :user_id, uniqueness: { scope: [:mentorship_cycle_id] }
-    validates :mentorship_role, presence: true, inclusion: { in: mentorship_roles }
   end
 
   # Instance Methods
   def to_s
-    mentorship_role.presence || model_name.human
+    title.presence || model_name.human
   end
+
+  def mentor?
+    mentorship_role == 'mentor'
+  end
+
+  def mentee?
+    mentorship_role == 'mentee'
+  end
+
 end

data/app/models/concerns/effective_mentorships_user.rb

@@ -17,37 +17,50 @@ module EffectiveMentorshipsUser
   end
 
   included do
-    # App Scoped
-    has_many :mentorship_groups, -> { order(:mentorship_cycle_id) }, inverse_of: :user, dependent: :destroy
-    accepts_nested_attributes_for :mentorship_groups, allow_destroy: true
+    # Effective Scoped
+    has_many :mentorship_group_users, -> { order(:mentorship_cycle_id).order(:id) }, class_name: 'Effective::MentorshipGroupUser', inverse_of: :user, dependent: :destroy
 
-    has_many :mentorship_registrations, -> { order(:mentorship_cycle_id) }, inverse_of: :user, dependent: :destroy
+    # App Scoped
+    has_many :mentorship_registrations, -> { order(:mentorship_cycle_id).order(:id) }, inverse_of: :user, dependent: :destroy
     accepts_nested_attributes_for :mentorship_registrations, allow_destroy: true
 
+    has_many :mentorship_groups, through: :mentorship_group_users
+
     scope :deep_effective_mentorships_user, -> { all }
   end
 
+  # Used for the dashboard datatables. Which cycles can we register for?
+  def registrable_mentorship_cycles
+    Effective::MentorshipCycle.registrable
+      .where.not(id: mentorship_group_users.select(:mentorship_cycle_id))
+      .where.not(id: mentorship_registrations.select(:mentorship_cycle_id))
+  end
+
+  def mentorship_registrations_without_groups
+    mentorship_registrations.where.not(mentorship_cycle_id: mentorship_group_users.select(:mentorship_cycle_id))
+  end
+
   # Find
   def mentorship_group(mentorship_cycle:)
-    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_mentorship_cycle?)
+    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_cycle?)
     mentorship_groups.find { |mentorship_group| mentorship_group.mentorship_cycle_id == mentorship_cycle.id }
   end
 
   # Find or build
   def build_mentorship_group(mentorship_cycle:)
-    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_mentorship_cycle?)
+    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_cycle?)
     mentorship_group(mentorship_cycle: mentorship_cycle) || mentorship_groups.build(mentorship_cycle: mentorship_cycle)
   end
 
   # Find
   def mentorship_registration(mentorship_cycle:)
-    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_mentorship_cycle?)
+    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_cycle?)
     mentorship_registrations.find { |mentorship_registration| mentorship_registration.mentorship_cycle_id == mentorship_cycle.id }
   end
 
   # Find or build
   def build_mentorship_registration(mentorship_cycle:)
-    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_mentorship_cycle?)
+    raise('expected an MentorshipCycle') unless mentorship_cycle.class.respond_to?(:effective_mentorships_cycle?)
     mentorship_registration(mentorship_cycle: mentorship_cycle) || mentorship_registrations.build(mentorship_cycle: mentorship_cycle)
   end
 

data/app/models/effective/mentorship_cycle.rb

@@ -1,12 +1,13 @@
 module Effective
   class MentorshipCycle < ActiveRecord::Base
     has_many_rich_texts
+    # rich_text_registration_content
+    # rich_text_group_content
 
     has_many :mentorship_groups
+    has_many :mentorship_registrations
 
-    if respond_to?(:log_changes)
-      log_changes(except: [:mentorship_groups])
-    end
+    log_changes(except: [:mentorship_groups, :mentorship_registrations]) if respond_to?(:log_changes)
 
     effective_resource do
       title                 :string       # 2021 Mentorship Program
@@ -21,6 +22,9 @@ module Effective
       max_pairings_mentor   :integer
       max_pairings_mentee   :integer
 
+      mentorship_groups_count         :integer
+      mentorship_registrations_count  :integer
+
       timestamps
     end
 
@@ -30,10 +34,12 @@ module Effective
     scope :sorted, -> { order(:id) }
 
     scope :upcoming, -> { where('start_at > ?', Time.zone.now) }
+    scope :past, -> { where('end_at < ?', Time.zone.now) }
+
     scope :available, -> { where('start_at <= ? AND (end_at > ? OR end_at IS NULL)', Time.zone.now, Time.zone.now) }
-    scope :completed, -> { where('end_at < ?', Time.zone.now) }
+    scope :registrable, -> { where('registration_start_at <= ? AND (registration_end_at > ? OR registration_end_at IS NULL)', Time.zone.now, Time.zone.now) }
 
-    validates :title, presence: true
+    validates :title, presence: true, uniqueness: true
     validates :start_at, presence: true
 
     validate(if: -> { start_at.present? && end_at.present? }) do
@@ -44,18 +50,17 @@ module Effective
       errors.add(:registration_end_at, 'must be after the registration start date') unless registration_end_at > registration_start_at
     end
 
-    # before_destroy do
-    #   if (count = mentorship_groups.length) > 0
-    #     raise("#{count} groups belong to this cycle")
-    #   end
-    # end
+    before_destroy do
+      raise("cannot destroy mentorship cycle with mentorship groups") if mentorship_groups.length > 0
+      raise("cannot destroy mentorship cycle with mentorship registrations") if mentorship_registrations.length > 0
+    end
 
-    def self.effective_mentorships_mentorship_cycle?
+    def self.effective_mentorships_cycle?
       true
     end
 
     def self.latest_cycle
-      order(id: :desc).first
+      order(start_at: :desc).first
     end
 
     def to_s
@@ -64,41 +69,60 @@ module Effective
 
     # Returns a duplicated event object, or throws an exception
     def duplicate
-      MentorshipCycle.new(attributes.except('id', 'updated_at', 'created_at', 'token')).tap do |mentorship|
-        mentorship.start_at = mentorship.start_at.advance(years: 1) if mentorship.start_at.present?
-        mentorship.end_at = mentorship.end_at.advance(years: 1) if mentorship.end_at.present?
-        mentorship.registration_start_at = mentorship.registration_start_at.advance(years: 1) if mentorship.registration_start_at.present?
-        mentorship.registration_end_at = mentorship.registration_end_at.advance(years: 1) if mentorship.registration_end_at.present?
+      MentorshipCycle.new(attributes.except('id', 'updated_at', 'created_at', 'token')).tap do |resource|
+        # Duplicate mentorship cycle
+        resource.title = title + ' (Copy)'
+
+        # Duplicate all date fields and move them ahead 1-year
+        resource.start_at = start_at&.advance(years: 1)
+        resource.end_at = end_at&.advance(years: 1)
+        resource.registration_start_at = registration_start_at&.advance(years: 1)
+        resource.registration_end_at = registration_end_at&.advance(years: 1)
+
+        # Duplicate all rich texts
+        rich_texts.each { |rt| resource.send("rich_text_#{rt.name}=", rt.body) }
+      end
+    end
 
-        mentorship.title = mentorship.title + ' (Copy)'
+    def available?
+      started? && !ended?
+    end
 
-        mentorship.rich_texts.each { |rt| self.send("rich_text_#{rt.name}=", rt.body) }
-      end
+    def started?
+      start_at.present? && Time.zone.now >= start_at
     end
 
-    # def available?
-    #   started? && !ended?
-    # end
+    def ended?
+      end_at.present? && end_at < Time.zone.now
+    end
 
-    # def unavailable?
-    #   !available?
-    # end
+    def registrable?
+      registration_started? && !registration_ended?
+    end
+
+    def registration_started?
+      registration_start_at.present? && Time.zone.now >= registration_start_at
+    end
 
-    # def started?
-    #   start_at.present? && Time.zone.now >= start_at
-    # end
+    def registration_ended?
+      registration_end_at.present? && registration_end_at < Time.zone.now
+    end
 
-    # def ended?
-    #   end_at.present? && end_at < Time.zone.now
-    # end
+    def available_date
+      if start_at && end_at
+        "#{start_at.strftime('%F')} to #{end_at.strftime('%F')}"
+      elsif start_at
+        "#{start_at.strftime('%F')}"
+      end
+    end
 
-    # def available_date
-    #   if start_at && end_at
-    #     "#{start_at.strftime('%F')} to #{end_at.strftime('%F')}"
-    #   elsif start_at
-    #     "#{start_at.strftime('%F')}"
-    #   end
-    # end
+    def registrable_date
+      if registration_start_at && registration_end_at
+        "#{registration_start_at.strftime('%F')} to #{registration_end_at.strftime('%F')}"
+      elsif registration_start_at
+        "#{registration_start_at.strftime('%F')}"
+      end
+    end
 
   end
 end

data/app/models/effective/mentorship_group_user.rb

@@ -0,0 +1,43 @@
+module Effective
+  class MentorshipGroupUser < ActiveRecord::Base
+    # Effective scoped
+    belongs_to :mentorship_cycle, class_name: 'Effective::MentorshipCycle'
+
+    # App scoped
+    belongs_to :mentorship_group
+    belongs_to :user, polymorphic: true
+
+    effective_resource do
+      mentorship_role   :string
+
+      # Copied from user
+      name    :string
+      email   :string
+
+      position  :integer
+
+      timestamps
+    end
+
+    scope :deep, -> { includes(:mentorship_cycle, :mentorship_group, :user) }
+    scope :sorted, -> { order(:mentorship_cycle_id).order(:position) }
+
+    # Assign position and cycle
+    before_validation(if: -> { mentorship_group.present? }) do
+      self.position ||= (mentorship_group.mentorship_group_users.map(&:position).compact.max || -1) + 1
+      self.mentorship_cycle = mentorship_group.mentorship_cycle
+    end
+
+    # Denormalized data for searching
+    before_validation(if: -> { user.present? }) do
+      assign_attributes(name: user.to_s, email: user.email)
+    end
+
+    validates :user_id, uniqueness: { scope: [:mentorship_group_id] }
+
+    def to_s
+      user.to_s.presence || model_name.human
+    end
+
+  end
+end

data/app/views/admin/mentorship_cycles/_form_mentorship_cycle.html.haml

@@ -17,12 +17,25 @@
 
   %hr
 
+  %h2 #{mentorship_registration_label}
+  %p The online #{mentorship_registration_label.downcase} opt-in will be available between:
+
   .row
-    .col-md-6
-      %h2 Registration Opt-In
-      %p The online registration opt-in will be available between:
-      = f.datetime_field :registration_start_at, label: "Registration start", hint: "The first day that #{mentorships_mentors_label} and #{mentorships_mentees_label} can register for this #{mentorship_cycle_label}"
-      = f.datetime_field :registration_end_at, label: "Registration end", hint: "The last day that #{mentorships_mentors_label} and #{mentorships_mentees_label} can register for this #{mentorship_cycle_label}"
+    .col-md-6= f.datetime_field :registration_start_at, label: "Registration start", hint: "The first day that #{mentorships_mentors_label} and #{mentorships_mentees_label} can register for this #{mentorship_cycle_label}"
+    .col-md-6= f.datetime_field :registration_end_at, label: "Registration end", hint: "The last day that #{mentorships_mentors_label} and #{mentorships_mentees_label} can register for this #{mentorship_cycle_label}"
+
+  %h2 Content
+
+  - if defined?(EffectiveArticleEditor)
+    = f.article_editor :rich_text_registration_content, label: "#{mentorship_registration_label} opt-in content", hint: "Will be displayed to the user when registering for this #{mentorship_cycle_label.downcase}"
+  - else
+    = f.rich_text_area :rich_text_registration_content, label: "#{mentorship_registration_label} opt-in content", hint: "Will be displayed to the user when registering for this #{mentorship_cycle_label.downcase}"
+
+  - if defined?(EffectiveArticleEditor)
+    = f.article_editor :rich_text_group_content, label: "#{mentorship_group_label} content", hint: "Will be displayed to the user when viewing their #{mentorship_group_label.downcase} for this #{mentorship_cycle_label.downcase}"
+  - else
+    = f.rich_text_area :rich_text_group_content, label: "#{mentorship_group_label} opt-in content", hint: "Will be displayed to the user when viewing their #{mentorship_group_label.downcase} for this #{mentorship_cycle_label.downcase}"
+
 
   = f.submit do
     = f.save 'Save'

data/app/views/admin/mentorship_group_users/_form.html.haml

@@ -0,0 +1,12 @@
+= effective_form_with(model: [:admin, mentorship_group_user], engine: true) do |f|
+  = f.select :mentorship_cycle_id, Effective::MentorshipCycle.sorted.all
+  = f.select :mentorship_group_id, EffectiveMentorships.MentorshipGroup.sorted.all
+
+  = f.select :mentorship_role, mentorship_roles_collection(), required: true, inline: true
+
+  = f.hidden_field :user_type, value: current_user.class.name
+
+  - ajax_url = (effective_resources.users_effective_ajax_index_path) unless Rails.env.test?
+  = f.select :user_id, current_user.class.all, ajax_url: ajax_url
+
+  = effective_submit(f)

data/app/views/admin/mentorship_groups/_form.html.haml

@@ -0,0 +1,8 @@
+= tabs do
+  = tab(EffectiveResources.et(mentorship_group.class)) do
+    = render '/admin/mentorship_groups/form_mentorship_group', mentorship_group: mentorship_group
+
+  - if mentorship_group.persisted? 
+    - if mentorship_group.respond_to?(:logs_datatable)
+      = tab 'Logs' do
+        = render_datatable(mentorship_group.logs_datatable, inline: true)

data/app/views/admin/mentorship_groups/_form_mentorship_group.html.haml

@@ -0,0 +1,27 @@
+= effective_form_with(model: [:admin, mentorship_group], engine: true) do |f|
+  = f.select :mentorship_cycle_id, Effective::MentorshipCycle.sorted.all
+  = f.text_field :title
+
+  - if defined?(EffectiveArticleEditor)
+    = f.article_editor :rich_text_admin_notes, label: "Admin Notes"
+  - else
+    = f.rich_text_area :rich_text_admin_notes, label: "Admin Notes"
+
+  = f.check_box :archived, label: "Yes, this #{mentorship_group_label} is archived"
+
+  %hr
+
+  %h4= mentorship_group_users_label
+  - ajax_url = (effective_resources.users_effective_ajax_index_path) unless Rails.env.test?
+
+  = f.has_many :mentorship_group_users do |fu|
+    = card do
+      .row
+        .col-md-3
+          = fu.select :mentorship_role, mentorship_roles_collection(), required: true, label: false
+
+        .col-md-9
+          = fu.hidden_field :user_type, value: current_user.class.name
+          = fu.select :user_id, current_user.class.all, label: false, ajax_url: ajax_url
+
+  = effective_submit(f)

data/app/views/admin/mentorship_registrations/_form.html.haml

@@ -0,0 +1,8 @@
+= tabs do
+  = tab(et(mentorship_registration)) do
+    = render '/admin/mentorship_registrations/form_mentorship_registration', mentorship_registration: mentorship_registration
+
+  - if mentorship_registration.persisted? 
+    - if mentorship_registration.respond_to?(:logs_datatable)
+      = tab 'Logs' do
+        = render_datatable(mentorship_registration.logs_datatable, inline: true)

data/app/views/admin/mentorship_registrations/_form_mentorship_registration.html.haml

@@ -0,0 +1,14 @@
+= effective_form_with(model: [:admin, mentorship_registration], engine: true) do |f|
+  - # Admin only fields
+  = f.select :mentorship_cycle_id, Effective::MentorshipCycle.sorted.all
+
+  - if inline_datatable?
+    = f.hidden_field :user_id
+  - else
+    - ajax_url = (effective_resources.users_effective_ajax_index_path) unless Rails.env.test?
+    = f.select :user_id, current_user.class.all, label: 'User', ajax_url: ajax_url
+
+  - # Same fields user sees
+  = render('effective/mentorship_registrations/fields', f: f, namespace: :admin)
+
+  = effective_submit(f)

data/app/views/effective/mentorship_groups/_mentorship_group.html.haml

@@ -0,0 +1,21 @@
+- mentorship_cycle = mentorship_group.mentorship_cycle
+- raise('expected a mentorship cycle') unless mentorship_cycle.present?
+
+- if mentorship_cycle.rich_text_group_content.present?
+  .mt-4= mentorship_cycle.rich_text_group_content
+
+= effective_table_with(mentorship_group) do |f|
+  = f.static_field :mentorship_cycle
+  = f.static_field :title
+
+%h3= mentorship_group_users_label
+
+%table.table.table-sm
+  %tbody
+    - mentorship_group.mentorship_group_users.each do |mentorship_group_user|
+      - user = mentorship_group_user.user
+
+      %tr
+        %td= mentorship_role_badge(mentorship_group_user.mentorship_role)
+        %td= user
+        %td= mail_to(user.email)

data/app/views/effective/mentorship_registrations/_fields.html.haml

@@ -0,0 +1,24 @@
+- unless local_assigns[:namespace] == :admin
+  = f.hidden_field :mentorship_cycle_id
+
+= f.radios :opt_in, :boolean, label: "Do you wish to register in the #{f.object.mentorship_cycle || et('effective_mentorships.name')}?"
+
+= f.hide_if(:opt_in, false) do
+  = f.radios :mentorship_role, mentorship_roles_collection(), label: "Register as a:", required: true
+
+  = f.show_if(:mentorship_role, 'mentor') do
+    = f.radios :mentor_multiple_mentees_limit, [1, 2, 3, 4, 5], label: "How many #{mentorships_mentee_label.downcase.pluralize} are you willing to #{mentorships_mentor_label.downcase}?"
+
+  = f.select :category, f.object.class.categories(), required: true
+  = f.select :location, f.object.class.locations(), required: true
+  = f.radios :venue, f.object.class.venues(), required: true
+
+  - if mentorship_cycle.rich_text_registration_content.present?
+    .my-4= mentorship_cycle.rich_text_registration_content
+
+  = f.check_box :accept_declaration, label: "Yes, I accept the #{et('effective_mentorships.name')} agreement", required: true
+
+- if defined?(EffectiveArticleEditor)
+  = f.article_editor :rich_text_comments, label: "Comments"
+- else
+  = f.rich_text_area :rich_text_comments, label: "Comments"

data/app/views/effective/mentorship_registrations/_form.html.haml

@@ -0,0 +1,12 @@
+- mentorship_cycle = mentorship_registration.mentorship_cycle
+- raise('expected a mentorship cycle') unless mentorship_cycle.present?
+
+- url = (mentorship_registration.persisted? ? effective_mentorships.mentorship_cycle_mentorship_registration_path(mentorship_cycle, mentorship_registration) : effective_mentorships.mentorship_cycle_mentorship_registrations_path(mentorship_cycle, mentorship_registration))
+
+= card do
+  %h2= et('effective_mentorships.name')
+
+  = effective_form_with(model: mentorship_registration, url: url) do |f|
+    = f.hidden_field :user_id, value: current_user.id
+    = render('effective/mentorship_registrations/fields', f: f)
+    = f.submit

data/app/views/effective/mentorship_registrations/_mentorship_registration.html.haml

@@ -0,0 +1,6 @@
+- if mentorship_registration.present?
+  - mentorship_cycle = mentorship_registration.mentorship_cycle
+  - raise('expected a mentorship cycle') unless mentorship_cycle.present?
+
+  = effective_table_with(mentorship_registration) do |f|
+    = render('effective/mentorship_registrations/fields', f: f)

data/app/views/effective/mentorships/_dashboard.html.haml

@@ -1 +1,21 @@
 %h2 #{mentorships_name_label}
+
+- # My Groups
+- groups = EffectiveResources.best('EffectiveMentorshipsGroupsDatatable').new(self, namespace: :effective)
+
+- if groups.present?
+  %p You are a member of the following #{mentorship_groups_label.downcase}:
+  = render_datatable(groups, simple: true)
+
+-# Available Registrations
+- registered = EffectiveResources.best('EffectiveMentorshipsRegistrationsDatatable').new(self, namespace: :effective)
+- available = EffectiveResources.best('EffectiveMentorshipsAvailableCyclesDatatable').new(self, namespace: :effective)
+
+- if registered.present?
+  = render_datatable(registered, simple: true)
+
+- if available.present?
+  = render_datatable(available, simple: true)
+
+- if available.blank? && registered.blank?
+  %p There are no #{'additional ' if groups.present? || registered.present?}#{etsd(Effective::MentorshipCycle)} available for registration. When there are, we'll show them here.

data/config/locales/effective_mentorships.en.yml

@@ -8,8 +8,9 @@ en:
   activerecord:
     models:
       # Application namespace
-      mentorship_group: 'Mentorship Group'
-      mentorship_registration: 'Mentorship Registration'
+      app/mentorship_group: 'Mentorship group'
+      app/mentorship_registration: 'Mentorship registration'
 
       # Effective namespace
-      effective/mentorship_cycle: 'Mentorship Cycle'
+      effective/mentorship_cycle: 'Mentorship cycle'
+      effective/mentorship_group_user: 'Mentorship group user'

data/config/routes.rb

@@ -4,9 +4,24 @@ end
 
 EffectiveMentorships::Engine.routes.draw do
   scope module: 'effective' do
+    resources :mentorship_cycles, only: [] do
+      resources :mentorship_registrations, except: [:index, :show]
+    end
+
+    resources :mentorship_groups, only: [:show]
   end
 
   namespace :admin do
     resources :mentorship_cycles, except: [:show]
+    resources :mentorship_registrations, except: [:show]
+
+    resources :mentorship_groups, except: [:show] do
+      post :archive, on: :member
+      post :unarchive, on: :member
+      post :bulk_archive, on: :collection
+      post :bulk_unarchive, on: :collection
+    end
+
+    resources :mentorship_group_users, except: [:show]
   end
 end

data/db/migrate/101_create_effective_mentorships.rb

@@ -21,21 +21,55 @@ class CreateEffectiveMentorships < ActiveRecord::Migration[6.0]
 
     create_table :mentorship_groups do |t|
       t.integer :mentorship_cycle_id
-      t.integer :user_id
+
+      t.string :title
 
       t.boolean :archived, default: false
+
       t.string :token
 
       t.datetime :updated_at
       t.datetime :created_at
     end
 
+    create_table :mentorship_group_users do |t|
+      t.integer :mentorship_cycle_id
+      t.integer :mentorship_group_id
+
+      t.string :user_type
+      t.integer :user_id
+
+      t.string :mentorship_role
+
+      t.string :name
+      t.string :email
+
+      t.integer :position
+
+      t.datetime :updated_at
+      t.datetime :created_at
+    end
+
     create_table :mentorship_registrations do |t|
       t.integer :mentorship_cycle_id
       t.integer :user_id
 
+      t.string :parent_type
+      t.integer :parent_id
+
+      t.string :title
+
+      t.boolean :opt_in, default: false
+      t.boolean :accept_declaration, default: false
+
       t.string :mentorship_role
 
+      t.string :category
+      t.string :venue
+      t.string :location
+
+      t.integer :mentor_multiple_mentees_limit
+
       t.string :token
 
       t.datetime :updated_at

data/lib/effective_mentorships/version.rb

@@ -1,3 +1,3 @@
 module EffectiveMentorships
-  VERSION = '0.0.1'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: effective_mentorships
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Code and Effect
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-14 00:00:00.000000000 Z
+date: 2024-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -206,8 +206,18 @@ files:
 - app/assets/javascripts/effective_mentorships.js
 - app/assets/stylesheets/effective_mentorships.scss
 - app/controllers/admin/mentorship_cycles_controller.rb
-- app/controllers/effective/mentorship_cycles_controller.rb
+- app/controllers/admin/mentorship_group_users_controller.rb
+- app/controllers/admin/mentorship_groups_controller.rb
+- app/controllers/admin/mentorship_registrations_controller.rb
+- app/controllers/effective/mentorship_groups_controller.rb
+- app/controllers/effective/mentorship_registrations_controller.rb
 - app/datatables/admin/effective_mentorship_cycles_datatable.rb
+- app/datatables/admin/effective_mentorship_group_users_datatable.rb
+- app/datatables/admin/effective_mentorship_groups_datatable.rb
+- app/datatables/admin/effective_mentorship_registrations_datatable.rb
+- app/datatables/effective_mentorships_available_cycles_datatable.rb
+- app/datatables/effective_mentorships_groups_datatable.rb
+- app/datatables/effective_mentorships_registrations_datatable.rb
 - app/helpers/effective_mentorships_helper.rb
 - app/mailers/effective/mentorships_mailer.rb
 - app/models/concerns/effective_mentorships_group.rb
@@ -215,9 +225,19 @@ files:
 - app/models/concerns/effective_mentorships_user.rb
 - app/models/effective/mentorship_cycle.rb
 - app/models/effective/mentorship_group.rb
+- app/models/effective/mentorship_group_user.rb
 - app/models/effective/mentorship_registration.rb
 - app/views/admin/mentorship_cycles/_form.html.haml
 - app/views/admin/mentorship_cycles/_form_mentorship_cycle.html.haml
+- app/views/admin/mentorship_group_users/_form.html.haml
+- app/views/admin/mentorship_groups/_form.html.haml
+- app/views/admin/mentorship_groups/_form_mentorship_group.html.haml
+- app/views/admin/mentorship_registrations/_form.html.haml
+- app/views/admin/mentorship_registrations/_form_mentorship_registration.html.haml
+- app/views/effective/mentorship_groups/_mentorship_group.html.haml
+- app/views/effective/mentorship_registrations/_fields.html.haml
+- app/views/effective/mentorship_registrations/_form.html.haml
+- app/views/effective/mentorship_registrations/_mentorship_registration.html.haml
 - app/views/effective/mentorships/_dashboard.html.haml
 - app/views/effective/mentorships_mailer/README.md
 - config/effective_mentorships.rb

data/app/controllers/effective/mentorship_cycles_controller.rb

@@ -1,9 +0,0 @@
-module Effective
-  class MentorshipCyclesController < ApplicationController
-    before_action(:authenticate_user!) if defined?(Devise)
-
-    include Effective::CrudController
-
-    resource_scope -> { Effective::MentorshipCycle.deep.all }
-  end
-end