effective_cpd 0.0.1

data/app/datatables/admin/effective_cpd_activities_datatable.rb

@@ -0,0 +1,31 @@
+module Admin
+  class EffectiveCpdActivitiesDatatable < Effective::Datatable
+    datatable do
+
+      if attributes[:cpd_category_id]
+        reorder :position
+      end
+
+      col :updated_at, visible: false
+      col :created_at, visible: false
+      col :id, visible: false
+
+      col :cpd_category
+      col :position, visible: false
+
+      col :title do |cpd_activity|
+        content_tag(:div, cpd_activity.title) + raw(cpd_activity.body)
+      end
+
+      col :amount_label, label: 'Amount'
+      col :amount2_label, label: 'Amount2'
+      col :require_file, label: 'Upload'
+
+      actions_col
+    end
+
+    collection do
+      Effective::CpdActivity.all.deep
+    end
+  end
+end

data/app/datatables/admin/effective_cpd_categories_datatable.rb

@@ -0,0 +1,24 @@
+module Admin
+  class EffectiveCpdCategoriesDatatable < Effective::Datatable
+    datatable do
+      length :all
+      reorder :position
+
+      col :id, visible: false
+      col :created_at, visible: false
+      col :updated_at, visible: false
+
+      col :title do |cpd_category|
+        content_tag(:div, cpd_category.title) + raw(cpd_category.body)
+      end
+
+      col :cpd_activities, label: 'Activities'
+
+      actions_col
+    end
+
+    collection do
+      Effective::CpdCategory.all.deep
+    end
+  end
+end

data/app/datatables/admin/effective_cpd_cycles_datatable.rb

@@ -0,0 +1,22 @@
+module Admin
+  class EffectiveCpdCyclesDatatable < Effective::Datatable
+    datatable do
+      order :start_at, :desc
+
+      col :id, visible: false
+      col :created_at, visible: false
+      col :updated_at, visible: false
+
+      col :title
+      col :start_at
+      col :end_at
+      col :required_score
+
+      actions_col
+    end
+
+    collection do
+      Effective::CpdCycle.all.deep
+    end
+  end
+end

data/app/datatables/admin/effective_cpd_rules_datatable.rb

@@ -0,0 +1,43 @@
+module Admin
+  class EffectiveCpdRulesDatatable < Effective::Datatable
+    filters do
+      scope :categories
+      scope :activities
+      scope :unavailable
+      scope :all
+    end
+
+    datatable do
+      col :id, visible: false
+      col :created_at, visible: false
+      col :updated_at, visible: false
+
+      col :cpd_cycle,label: cpd_cycle_label.titleize
+
+      col :ruleable, label: 'Category or Activity', search: {
+        collection: {
+          'Categories' => Effective::CpdCategory.sorted,
+          'Activities' => Effective::CpdActivity.sorted,
+        },
+        polymorphic: true
+      }
+
+      col :formula do |cpd_activity|
+        content_tag(:div, cpd_activity.formula, style: 'white-space: nowrap;')
+      end
+
+      col :credit_description
+
+      col :max_credits_per_cycle, label: 'Max ' + cpd_credits_label.titleize
+      col :max_cycles_can_carry_forward, label: 'Max ' + cpd_cycles_label.titleize
+
+      col :unavailable
+
+      actions_col
+    end
+
+    collection do
+      Effective::CpdRule.all.deep
+    end
+  end
+end

data/app/datatables/admin/effective_cpd_statements_datatable.rb

@@ -0,0 +1,30 @@
+module Admin
+  class EffectiveCpdStatementsDatatable < Effective::Datatable
+    filters do
+      scope :completed
+      scope :draft
+      scope :all
+    end
+
+    datatable do
+      order :updated_at
+
+      col :id, visible: false
+      col :token, visible: false
+      col :created_at, visible: false
+      col :updated_at, visible: false
+
+      col :cpd_cycle, label: cpd_cycle_label.titleize
+      col :user
+      col :completed_at
+      col :score
+      col :carry_forward
+
+      actions_col
+    end
+
+    collection do
+      Effective::CpdStatement.all.deep
+    end
+  end
+end

data/app/datatables/effective_cpd_datatable.rb

@@ -0,0 +1,30 @@
+# Displays available cpd_cycles that the current_user may complete
+
+class EffectiveCpdDatatable < Effective::Datatable
+  datatable do
+    order :start_at
+
+    col :start_at, visible: false
+
+    col(:title, label: cpd_cycle_label.titleize)
+    col :available_date, label: 'Available'
+
+    actions_col(actions: []) do |cpd_cycle|
+      statement = cpd_cycle.cpd_statements.where(user: current_user).first
+
+      if statement.blank?
+        dropdown_link_to('Start', effective_cpd.cpd_cycle_cpd_statement_build_path(cpd_cycle, :new, :start))
+      elsif statement.completed?
+        'Complete'
+      else
+        dropdown_link_to('Continue', effective_cpd.cpd_cycle_cpd_statement_build_path(cpd_cycle, statement, statement.next_step))
+      end
+    end
+  end
+
+  collection do
+    raise('expected a current_user') unless current_user.present?
+    Effective::CpdCycle.available
+  end
+
+end

data/app/datatables/effective_cpd_statements_datatable.rb

@@ -0,0 +1,23 @@
+# Displays past cpd statements that were completed by the user
+
+class EffectiveCpdStatementsDatatable < Effective::Datatable
+  datatable do
+    order :cpd_cycle_id
+
+    col(:cpd_cycle_id, label: cpd_cycle_label.titleize) do |statement|
+      statement.cpd_cycle.to_s
+    end
+
+    col :completed_at, label: 'Completed'
+
+    actions_col(actions: []) do |cpd_statement|
+      dropdown_link_to('Show', effective_cpd.cpd_cycle_cpd_statement_build_path(cpd_statement.cpd_cycle, cpd_statement, cpd_statement.last_completed_step))
+    end
+  end
+
+  collection do
+    raise('expected a current_user') unless current_user.present?
+    Effective::CpdStatement.completed.where(user: current_user).includes(:cpd_cycle)
+  end
+
+end

data/app/helpers/effective_cpd_helper.rb

@@ -0,0 +1,37 @@
+module EffectiveCpdHelper
+
+  def cpd_cycle_label
+    (EffectiveCpd.cycle_label || '').to_s.html_safe
+  end
+
+  def cpd_cycles_label
+    (EffectiveCpd.cycle_label || '').to_s.pluralize.html_safe
+  end
+
+  def cpd_credit_label
+    (EffectiveCpd.credit_label || '').to_s.html_safe
+  end
+
+  def cpd_credits_label
+    (EffectiveCpd.credit_label || '').to_s.pluralize.html_safe
+  end
+
+  def cpd_rule_formula_hint(cpd_activity)
+    raise('expected a CPDActivity') unless cpd_activity.kind_of?(Effective::CpdActivity)
+
+    if cpd_activity.amount_label.present? && cpd_activity.amount2_label.present?
+      "must include 'amount' and 'amount2'. Something like (amount + (amount2 * 10))"
+    elsif cpd_activity.amount_label.present?
+      "must include 'amount'. Something like (10 * amount)"
+    elsif cpd_activity.amount2_label.present?
+      "must include 'amount2'. Something like (10 * amount2)"
+    else
+      "must be a number and may not include 'amount'. Something like 10"
+    end
+  end
+
+  def effective_cpd_categories
+    @effective_cpd_categories ||= Effective::CpdCategory.deep.sorted
+  end
+
+end

data/app/mailers/effective/cpd_mailer.rb

@@ -0,0 +1,7 @@
+module Effective
+  class CpdMailer < ActionMailer::Base
+    default from: EffectiveCpd.mailer[:default_from]
+    layout EffectiveCpd.mailer[:layout].presence || 'effective_cpd_mailer_layout'
+
+  end
+end

data/app/models/effective/cpd_activity.rb

@@ -0,0 +1,41 @@
+module Effective
+  class CpdActivity < ActiveRecord::Base
+    belongs_to :cpd_category
+
+    has_rich_text :body
+    log_changes(to: :cpd_category) if respond_to?(:log_changes)
+
+    # has_many :rules, -> { order(cycle_id: :desc) }, as: :ruleable, dependent: :delete_all
+    # accepts_nested_attributes_for :rules, allow_destroy: true
+
+    effective_resource do
+      title     :string
+      position  :integer
+
+      # The formula can include amount and amount2
+      # This is the description of the amount unit
+      amount_label          :string # 'hours of committee work', 'hours or work'
+      amount2_label         :string # 'CEUs'
+
+      # Whether the user must attach supporting documents
+      requires_upload_file  :boolean
+
+      timestamps
+    end
+
+    scope :deep, -> { with_rich_text_body.includes(:cpd_category) }
+    scope :sorted, -> { order(:position) }
+
+    before_validation(if: -> { cpd_category.present? }) do
+      self.position ||= (cpd_category.cpd_activities.map(&:position).compact.max || -1) + 1
+    end
+
+    validates :title, presence: true
+    validates :position, presence: true
+
+    def to_s
+      title.presence || 'activity'
+    end
+
+  end
+end

data/app/models/effective/cpd_category.rb

@@ -0,0 +1,35 @@
+module Effective
+  class CpdCategory < ActiveRecord::Base
+    has_rich_text :body
+    log_changes if respond_to?(:log_changes)
+
+    has_many :cpd_activities, -> { order(:position) }, inverse_of: :cpd_category, dependent: :destroy
+    accepts_nested_attributes_for :cpd_activities, allow_destroy: true
+
+    # has_many :rules, -> { order(cycle_id: :desc) }, as: :ruleable, dependent: :delete_all
+    # accepts_nested_attributes_for :rules, allow_destroy: true
+
+    effective_resource do
+      title     :string
+      position  :integer
+
+      timestamps
+    end
+
+    scope :deep, -> { with_rich_text_body.includes(cpd_activities: [:rich_text_body]) }
+    scope :sorted, -> { order(:position) }
+
+    before_validation do
+      self.position ||= (CpdCategory.all.maximum(:position) || -1) + 1
+    end
+
+    validates :title, presence: true
+    validates :position, presence: true
+    validates :body, presence: true
+
+    def to_s
+      title.presence || 'category'
+    end
+
+  end
+end

data/app/models/effective/cpd_cycle.rb

@@ -0,0 +1,113 @@
+module Effective
+  class CpdCycle < ActiveRecord::Base
+    has_rich_text :all_steps_content    # Update build_from_cycle() below if these change
+    has_rich_text :start_content
+    has_rich_text :activities_content
+    has_rich_text :agreements_content
+    has_rich_text :submit_content
+    has_rich_text :complete_content
+
+    has_many :cpd_rules, dependent: :delete_all
+    accepts_nested_attributes_for :cpd_rules, allow_destroy: true
+
+    has_many :cpd_statements
+
+    if respond_to?(:log_changes)
+      log_changes(except: [:cpd_statements])
+    end
+
+    effective_resource do
+      title                 :string       # 2021 Continuing Professional Development
+
+      start_at              :datetime
+      end_at                :datetime
+
+      required_score        :integer  # If set, a user must fill out this many activities to finish a statement
+
+      timestamps
+    end
+
+    scope :deep, -> {
+      with_rich_text_all_steps_content
+      .with_rich_text_start_content
+      .with_rich_text_activities_content
+      .with_rich_text_submit_content
+      .with_rich_text_complete_content
+      .includes(:cpd_rules)
+    }
+
+    scope :sorted, -> { order(:id) }
+
+    scope :upcoming, -> { where('start_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) }
+
+    before_validation(if: -> { new_record? && cpd_rules.blank? }) do
+      cycle = CpdCycle.latest_cycle
+      build_from_cycle(cycle: cycle) if cycle
+    end
+
+    validates :title, presence: true
+    validates :start_at, presence: true
+
+    validate(if: -> { start_at.present? && end_at.present? }) do
+      self.errors.add(:end_at, 'must be after the start date') unless end_at > start_at
+    end
+
+    def self.latest_cycle
+      order(id: :desc).first
+    end
+
+    def to_s
+      title.presence || 'New CPD Cycle'
+    end
+
+    def build_from_cycle(cycle:)
+      raise('expected a CpdCycle') unless cycle.kind_of?(CpdCycle)
+
+      # Cycle
+      attributes = cycle.dup.attributes.except('title', 'token', 'start_at', 'end_at')
+      assign_attributes(attributes)
+
+      [:all_steps_content, :start_content, :activities_content, :submit_content, :complete_content].each do |rich_text|
+        self.send("#{rich_text}=", cycle.send(rich_text))
+      end
+
+      cycle.cpd_rules.each do |rule|
+        attributes = rule.dup.attributes.except('cpd_cycle_id')
+        self.cpd_rules.build(attributes)
+      end
+
+      self
+    end
+
+    # Find or build
+    def rule_for(ruleable)
+      raise('expected a CpdCategory or CpdActivity') unless ruleable.kind_of?(CpdActivity) || ruleable.kind_of?(CpdCategory)
+
+      rule = cpd_rules.find { |rule| rule.ruleable_id == ruleable.id && rule.ruleable_type == ruleable.class.name }
+      rule ||= cpd_rules.build(ruleable: ruleable)
+    end
+
+    def available?
+      started? && !ended?
+    end
+
+    def started?
+      start_at_was.present? && Time.zone.now >= start_at_was
+    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
+
+  end
+end