effective_cpd 0.6.9 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fc9c5614b8c87479aef3067320ae4f432255f4214f65d5fb6558cb389c557aa
-  data.tar.gz: 6196e732aaa80aeaf16c8be346d2b28e3fba2251f749bc7038319954cc97d494
+  metadata.gz: 5b9ef412f128415399ade394ba5ee59d6799d9f13a600904bccfc6c88aa80fd6
+  data.tar.gz: 3c193fe0263c126908e9e2029ea303cfc9842b41d80de7e0bd29761afd97d870
 SHA512:
-  metadata.gz: 30b45d45efa81a63adeab41b0da5ce2811e718eb447b77b3419aadddb04b47d01aa9c55d3a71c9615ee56dd19f8a8bfe19b477dd31cc02e2ade811cdbd32038f
-  data.tar.gz: 7af185b1632ff2928c814efca3e8262a4e1c3b366fdbc511cedfecf93e07cadcea7a8da999d4b8d6a18995bffb75f95af0669f5fa384f5d458e4b0ded953b753
+  metadata.gz: b8f785d86dedc5821fb7118a7e8ea2e7c5baedc29abcd470e0c420c8e1352e51aaa4bcd364a0822e75d013778fcfdd21ad20ab5337ee55223f12cda03bf7bcee
+  data.tar.gz: 8a817518db9ab7b7a7104f3d6eb4991e9422bce880a4d5817bf9dd6e8917a6fd4070f96fdae059bd978bb6b6f6888faf781e0ee8c84ea959fb39ed9be6d0c129

data/app/controllers/admin/cpd_audit_levels_controller.rb

@@ -5,8 +5,14 @@ module Admin
 
     include Effective::CrudController
 
+    resource_scope -> { EffectiveCpd.AuditLevel.deep.all }
+    datatable -> { Admin::EffectiveCpdAuditLevelsDatatable.new }
+
+    private
+
     def permitted_params
-      params.require(:effective_cpd_audit_level).permit!
+      model = (params.key?(:effective_cpd_audit_level) ? :effective_cpd_audit_level : :cpd_audit_level)
+      params.require(model).permit!
     end
 
   end

data/app/controllers/admin/cpd_audit_reviews_controller.rb

@@ -5,8 +5,14 @@ module Admin
 
     include Effective::CrudController
 
+    resource_scope -> { EffectiveCpd.AuditReview.deep.all }
+    datatable -> { Admin::EffectiveCpdAuditReviewsDatatable.new }
+
+    private
+
     def permitted_params
-      params.require(:effective_cpd_audit_review).permit!
+      model = (params.key?(:effective_cpd_audit_review) ? :effective_cpd_audit_review : :cpd_audit_review)
+      params.require(model).permit!
     end
 
   end

data/app/controllers/admin/cpd_audits_controller.rb

@@ -5,6 +5,9 @@ module Admin
 
     include Effective::CrudController
 
+    resource_scope -> { EffectiveCpd.CpdAudit.deep.all }
+    datatable -> { Admin::EffectiveCpdAuditsDatatable.new }
+
     submit :resolve_conflict, 'Resolve Conflict of Interest', success: -> {
       [
         "Successfully resolved #{resource}",
@@ -33,8 +36,11 @@ module Admin
       ].compact.join(' ')
     }
 
+    private
+
     def permitted_params
-      params.require(:effective_cpd_audit).permit!
+      model = (params.key?(:effective_cpd_audit) ? :effective_cpd_audit : :cpd_audit)
+      params.require(model).permit!
     end
 
   end

data/app/controllers/effective/cpd_statements_controller.rb

@@ -14,6 +14,15 @@ module Effective
       CpdScorer.new(user: resource.user).score!
     end
 
+    # Enforce one statement per user per cycle. Redirect them to an existing statement for this cycle.
+    before_action(only: [:new, :show]) do
+      existing = resource_scope.where.not(id: resource).first
+
+      if existing.present?
+        redirect_to effective_cpd.cpd_cycle_cpd_statement_build_path(existing.cpd_cycle, existing, existing.next_step)
+      end
+    end
+
     # Enforce cycle availability
     before_action(only: [:show, :update]) do
       cycle = resource.cpd_cycle

data/app/datatables/admin/effective_cpd_audit_levels_datatable.rb

@@ -28,7 +28,7 @@ module Admin
     end
 
     collection do
-      Effective::CpdAuditLevel.all.deep
+      EffectiveCpd.CpdAuditLevel.all.deep
     end
   end
 end

data/app/datatables/admin/effective_cpd_audit_reviews_datatable.rb

@@ -30,7 +30,7 @@ module Admin
     end
 
     collection do
-      Effective::CpdAuditReview.all.deep
+      EffectiveCpd.CpdAuditReview.all.deep
     end
   end
 end

data/app/datatables/admin/effective_cpd_audits_datatable.rb

@@ -94,7 +94,7 @@ module Admin
     end
 
     collection do
-      Effective::CpdAudit.all.deep
+      EffectiveCpd.CpdAudit.all.deep
     end
   end
 end

data/app/models/concerns/effective_cpd_audit.rb

@@ -0,0 +1,425 @@
+# frozen_string_literal: true
+
+# EffectiveCpdAudit
+#
+# Mark your owner model with effective_cpd_audit to get all the includes
+
+module EffectiveCpdAudit
+  extend ActiveSupport::Concern
+
+  module Base
+    def effective_cpd_audit
+      include ::EffectiveCpdAudit
+    end
+  end
+
+  module ClassMethods
+    def effective_cpd_audit?; true; end
+  end
+
+  included do
+    acts_as_email_form
+    acts_as_tokened
+    acts_as_reportable if respond_to?(:acts_as_reportable)
+    log_changes(except: [:wizard_steps, :cpd_audit_reviews]) if respond_to?(:log_changes)
+
+    acts_as_statused(
+      :opened,                # Just Opened
+      :started,               # First screen clicked
+      :conflicted,            # Auditee has declared a conflict of interest
+      :conflicted_resolved,   # The conflict of interest has been resolved
+      :exemption_requested,   # Auditee has requested an exemption
+      :exemption_granted,     # Exemption granted -> Audit is cancelled. Exit state.
+      :exemption_denied,      # Exemption denied
+      :extension_requested,   # Audittee has requested an extension
+      :extension_granted,     # Extension granted
+      :extension_denied,      # Extension denied
+      :submitted,             # Audittee has completed questionnaire submitted. Audittee is done.
+      :reviewed,              # All audit reviews completed. Ready for a determination.
+      :closed                 # Determination made by admin and/or audit committee. Exit state. All done.
+    )
+
+    acts_as_wizard(
+      start: 'Start',
+      information: 'Information',
+      instructions: 'Instructions',
+
+      # These 4 steps are determined by audit_level settings
+      conflict: 'Conflict of Interest',
+      exemption: 'Request Exemption',
+      extension: 'Request Extension',
+      waiting: 'Waiting',
+      cpd: 'CPD',
+
+      questionnaire: 'Questionnaire',
+      # ... There will be one step per cpd_audit_level_sections here
+      files: 'Upload Resume',
+
+      submit: 'Confirm & Submit',
+      complete: 'Complete'
+    )
+
+    attr_accessor :current_user
+    attr_accessor :current_step
+    attr_accessor :admin_process_request
+
+    # App scoped
+    belongs_to :cpd_audit_level, polymorphic: true
+    belongs_to :user, polymorphic: true  # The user being audited
+
+    has_many :cpd_audit_reviews, -> { order(:id) }, inverse_of: :cpd_audit, dependent: :destroy
+    accepts_nested_attributes_for :cpd_audit_reviews, allow_destroy: true
+
+    # Effective Scoped
+    has_many :cpd_audit_responses, -> { Effective::CpdAuditResponse.sorted }, class_name: 'Effective::CpdAuditResponse', inverse_of: :cpd_audit, dependent: :destroy
+    accepts_nested_attributes_for :cpd_audit_responses
+
+    has_many_attached :files
+
+    ADMIN_PROCESS_REQUEST_OPTIONS = ['Granted', 'Denied']
+    COMPLETED_STATES = [:exemption_granted, :closed]
+    WAITING_ON_ADMIN_STATES = [:conflicted, :exemption_requested, :extension_requested, :reviewed]
+    WAITING_ON_REVIEWERS_STATES = [:submitted]
+    WAITING_ON_AUDITEE_STATES = [:opened, :started, :conflicted_resolved, :exemption_denied, :extension_granted, :extension_denied]
+
+    effective_resource do
+      due_date                 :date     # Computed due date based on notification and extension date
+
+      selection                :string
+      region                   :string
+      notes                    :text
+
+      # Anonymous Name
+      anonymous_name           :string   # Required when cpd_audit_level.anonymous?
+
+      # Important dates
+      notification_date        :date     # Can be set on CpdAudits#new, but basically created_at
+      extension_date           :date     # set by admin if extension if granted
+
+      # Final determination
+      determination            :string
+
+      # Override Deadlines
+      ignore_deadlines         :boolean
+
+      # Auditee response
+      conflict_of_interest          :boolean
+      conflict_of_interest_reason   :text
+
+      exemption_request             :boolean
+      exemption_request_reason      :text
+
+      extension_request             :boolean
+      extension_request_date        :date
+      extension_request_reason      :text
+
+      # acts_as_statused
+      status                  :string
+      status_steps            :text
+
+      # Status dates
+      started_at              :datetime
+      submitted_at            :datetime
+      reviewed_at             :datetime
+      closed_at               :datetime
+
+      # Acts as tokened
+      token                   :string
+
+      # Acts as Wizard
+      wizard_steps            :text
+
+      timestamps
+    end
+
+    scope :deep, -> { includes(:cpd_audit_level, user: [:cpd_statements], cpd_audit_reviews: [:cpd_audit_level, :user, :cpd_audit_review_items]) }
+    scope :sorted, -> { order(:id) }
+
+    scope :draft, -> { where(submitted_at: nil) }
+    scope :available, -> { where.not(status: COMPLETED_STATES) }
+    scope :completed, -> { where(status: COMPLETED_STATES) }
+
+    scope :waiting_on_admin, -> { where(status: WAITING_ON_ADMIN_STATES) }
+    scope :waiting_on_auditee, -> { where(status: WAITING_ON_AUDITEE_STATES) }
+    scope :waiting_on_reviewers, -> { where(status: WAITING_ON_REVIEWERS_STATES) }
+
+    # effective_reports
+    def reportable_scopes
+      { draft: nil, available: nil, completed: nil, waiting_on_admin: nil, waiting_on_auditee: nil, waiting_on_reviewers: nil }
+    end
+
+    before_validation(if: -> { new_record? }) do
+      self.notification_date ||= Time.zone.now
+      self.due_date ||= deadline_to_submit()
+    end
+
+    validates :anonymous_name, presence: true, if: -> { cpd_audit_level&.anonymous? }
+
+    validates :notification_date, presence: true
+    validates :determination, presence: true, if: -> { closed? }
+
+    validates :conflict_of_interest_reason, presence: true, if: -> { conflict_of_interest? }
+    validates :exemption_request_reason, presence: true, if: -> { exemption_request? }
+    validates :extension_request_date, presence: true, if: -> { extension_request? }
+    validates :extension_request_reason, presence: true, if: -> { extension_request? }
+
+    validate(if: -> { current_step == :conflict && conflict_of_interest? && !ignore_deadlines? }) do
+      deadline = deadline_to_conflict_of_interest()
+      self.errors.add(:base, 'deadline to declare conflict of interest has already passed') if deadline && deadline < Time.zone.now
+    end
+
+    validate(if: -> { current_step == :exemption && exemption_request? && !ignore_deadlines? }) do
+      deadline = deadline_to_exemption()
+      self.errors.add(:base, 'deadline to request exemption has already passed') if deadline && deadline < Time.zone.now
+    end
+
+    validate(if: -> { current_step == :extension && extension_request? && !ignore_deadlines? }) do
+      deadline = deadline_to_extension()
+      self.errors.add(:base, 'deadline to request extension has already passed') if deadline && deadline < Time.zone.now
+    end
+
+    validate(if: -> { determination.present? }) do
+      unless cpd_audit_level.determinations.include?(determination)
+        self.errors.add(:determination, 'must exist in this audit level')
+      end
+    end
+
+    # If we're submitted. Check if we can go into reviewed?
+    before_save(if: -> { submitted? }) { review! }
+
+    after_commit(on: :create) do
+      send_email(:cpd_audit_opened)
+    end
+  end
+
+  def to_s
+    persisted? ? "#{cpd_audit_level} Audit of #{user}" : 'audit'
+  end
+
+  def dynamic_wizard_steps
+    cpd_audit_level.cpd_audit_level_sections.each_with_object({}) do |section, h|
+      h["section#{section.position+1}".to_sym] = section.title
+    end
+  end
+
+  def can_visit_step?(step)
+    return (step == :complete) if was_submitted?  # Can only view complete step once submitted
+    can_revisit_completed_steps(step)
+  end
+
+  def required_steps
+    steps = [:start, :information, :instructions]
+
+    steps << :conflict if cpd_audit_level.conflict_of_interest?
+
+    steps << :exemption if cpd_audit_level.can_request_exemption?
+
+    unless exemption_requested?
+      steps << :extension if cpd_audit_level.can_request_extension?
+    end
+
+    if exemption_requested? || extension_requested?
+      steps += [:waiting]
+    end
+
+    steps += [:cpd, :questionnaire] + dynamic_wizard_steps.keys + [:files, :submit, :complete]
+
+    steps
+  end
+
+  def wizard_step_title(step)
+    WIZARD_STEPS[step] || dynamic_wizard_steps.fetch(step)
+  end
+
+  def deadline_date
+    (extension_date || notification_date)
+  end
+
+  def completed?
+    COMPLETED_STATES.include?(status.to_sym)
+  end
+
+  def in_progress?
+    COMPLETED_STATES.include?(status.to_sym) == false
+  end
+
+  def cpd_audit_level_section(wizard_step)
+    position = (wizard_step.to_s.split('section').last.to_i rescue false)
+    cpd_audit_level.cpd_audit_level_sections.find { |section| (section.position + 1) == position }
+  end
+
+  # Find or build
+  def cpd_audit_response(cpd_audit_level_question)
+    cpd_audit_response = cpd_audit_responses.find { |r| r.cpd_audit_level_question_id == cpd_audit_level_question.id }
+    cpd_audit_response ||= cpd_audit_responses.build(cpd_audit: self, cpd_audit_level_question: cpd_audit_level_question)
+  end
+
+  # Auditee wizard action
+  def start!
+    started!
+  end
+
+  # Admin action
+  def resolve_conflict!
+    wizard_steps[:conflict] = nil   # Have them complete the conflict step again.
+
+    assign_attributes(conflict_of_interest: false, conflict_of_interest_reason: nil)
+    conflicted_resolved!
+    submitted!
+
+    send_email(:cpd_audit_conflict_resolved)
+    true
+  end
+
+  # Auditee wizard action
+  def exemption!
+    return started! unless exemption_request?
+
+    update!(status: :exemption_requested)
+    send_email(:cpd_audit_exemption_request)
+  end
+
+  # Admin action
+  def process_exemption!
+    case admin_process_request
+    when 'Granted' then grant_exemption!
+    when 'Denied' then deny_exemption!
+    else
+      self.errors.add(:admin_process_request, "can't be blank"); save!
+    end
+  end
+
+  def grant_exemption!
+    wizard_steps[:submit] ||= Time.zone.now
+    submitted! && exemption_granted!
+    send_email(:cpd_audit_exemption_granted)
+  end
+
+  def deny_exemption!
+    assign_attributes(exemption_request: false)
+    exemption_denied!
+    send_email(:cpd_audit_exemption_denied)
+  end
+
+  # Auditee wizard action
+  def extension!
+    return started! unless extension_request?
+
+    update!(status: :extension_requested)
+    send_email(:cpd_audit_extension_request)
+  end
+
+  # Admin action
+  def process_extension!
+    case admin_process_request
+    when 'Granted' then grant_extension!
+    when 'Denied' then deny_extension!
+    else
+      self.errors.add(:admin_process_request, "can't be blank"); save!
+    end
+  end
+
+  def grant_extension!
+    self.extension_date = extension_request_date
+    self.due_date = deadline_to_submit()
+
+    cpd_audit_reviews.each { |cpd_audit_review| cpd_audit_review.extension_granted! }
+    extension_granted!
+    send_email(:cpd_audit_extension_granted)
+  end
+
+  def deny_extension!
+    assign_attributes(extension_request: false)
+    extension_denied!
+    send_email(:cpd_audit_extension_denied)
+  end
+
+  # Require CPD step
+  def user_cpd_required?
+    return false unless user.cpd_audit_cpd_required?
+    required_cpd_cycle.present?
+  end
+
+  def user_cpd_completed?
+    return true if required_cpd_cycle.blank?
+    user.cpd_statements.any? { |s| s.completed? && s.cpd_cycle_id == required_cpd_cycle.id }
+  end
+
+  def required_cpd_cycle
+    @required_cpd_cycle ||= begin
+      last_year = ((notification_date || created_at || Time.zone.now) - 1.year).all_year
+      EffectiveCpd.CpdCycle.available.where(start_at: last_year).first
+    end
+  end
+
+  # Auditee wizard action
+  def submit!
+    if conflict_of_interest?
+      conflicted!
+      send_email(:cpd_audit_conflicted)
+    else
+      submitted!
+
+      cpd_audit_reviews.each { |cpd_audit_review| cpd_audit_review.ready! }
+      send_email(:cpd_audit_submitted)
+    end
+
+    true
+  end
+
+  # Called in a before_save. Intended for applicant_review to call in its submit! method
+  def review!
+    return false unless submitted?
+    return false unless cpd_audit_reviews.present? && cpd_audit_reviews.all?(&:completed?)
+
+    reviewed!
+    send_email(:cpd_audit_reviewed)
+  end
+
+  # Admin action
+  def close!
+    closed!
+    send_email(:cpd_audit_closed)
+  end
+
+  def email_form_defaults(action)
+    { from: EffectiveCpd.mailer_sender }
+  end
+
+  def send_email(email)
+    EffectiveCpd.send_email(email, self, email_form_params) unless email_form_skip?
+    true
+  end
+
+  def deadline_to_conflict_of_interest
+    return nil unless cpd_audit_level&.conflict_of_interest?
+    return nil unless cpd_audit_level.days_to_declare_conflict.present?
+
+    date = (notification_date || created_at || Time.zone.now)
+    EffectiveResources.advance_date(date, business_days: cpd_audit_level.days_to_declare_conflict)
+  end
+
+  def deadline_to_exemption
+    return nil unless cpd_audit_level&.can_request_exemption?
+    return nil unless cpd_audit_level.days_to_request_exemption.present?
+
+    date = (notification_date || created_at || Time.zone.now)
+    EffectiveResources.advance_date(date, business_days: cpd_audit_level.days_to_request_exemption)
+  end
+
+  def deadline_to_extension
+    return nil unless cpd_audit_level&.can_request_extension?
+    return nil unless cpd_audit_level.days_to_request_extension.present?
+
+    date = (notification_date || created_at || Time.zone.now)
+    EffectiveResources.advance_date(date, business_days: cpd_audit_level.days_to_request_extension)
+  end
+
+  def deadline_to_submit
+    return nil unless cpd_audit_level&.days_to_submit.present?
+
+    date = (extension_date || notification_date || created_at || Time.zone.now)
+    EffectiveResources.advance_date(date, business_days: cpd_audit_level.days_to_submit)
+  end
+
+end

data/app/models/concerns/effective_cpd_audit_level.rb

@@ -0,0 +1,108 @@
+# EffectiveCpdUser
+#
+# Mark your user model with effective_cpd_user to get a few helpers
+# And user specific point required scores
+
+module EffectiveCpdAuditLevel
+  extend ActiveSupport::Concern
+
+  module Base
+    def effective_cpd_audit_level
+      include ::EffectiveCpdAuditLevel
+    end
+  end
+
+  module ClassMethods
+    def effective_cpd_audit_level?; true; end
+  end
+
+  included do
+    has_many_rich_texts
+
+    # For each cpd audit and cpd audit review wizard step
+    # rich_text_all_steps_audit_content
+    # rich_text_step_audit_content
+
+    # rich_text_all_steps_audit_review_content
+    # rich_text_step_audit_review_content
+
+    # App scoped
+    has_many :cpd_audits
+
+    has_many :cpd_audit_reviews, -> { EffectiveCpd.CpdAuditReview.sorted }, inverse_of: :cpd_audit_level, dependent: :destroy
+    accepts_nested_attributes_for :cpd_audit_reviews, allow_destroy: true
+
+    # Effective Scoped
+    has_many :cpd_audit_level_sections, -> { Effective::CpdAuditLevelSection.sorted }, class_name: 'Effective::CpdAuditLevelSection', inverse_of: :cpd_audit_level, dependent: :destroy
+    accepts_nested_attributes_for :cpd_audit_level_sections, allow_destroy: true
+
+    has_many :cpd_audit_level_questions, -> { Effective::CpdAuditLevelQuestion.sorted }, class_name: 'Effective::CpdAuditLevelQuestion', through: :cpd_audit_level_sections
+
+    if respond_to?(:log_changes)
+      log_changes(except: [:cpd_audits, :cpd_audit_reviews, :cpd_audit_level_sections, :cpd_audit_level_questions])
+    end
+
+    effective_resource do
+      title                         :string
+
+      anonymous                     :boolean
+
+      determinations                :text     # Final determination by auditor
+      recommendations               :text     # Recommendations by audit reviewers
+
+      days_to_submit                :integer  # For auditee to submit statement
+      days_to_review                :integer  # For auditor/audit_review to be completed
+
+      conflict_of_interest          :boolean      # Feature flags
+      can_request_exemption         :boolean
+      can_request_extension         :boolean
+
+      days_to_declare_conflict      :integer
+      days_to_request_exemption     :integer
+      days_to_request_extension     :integer
+
+      timestamps
+    end
+
+    serialize :determinations, Array
+    serialize :recommendations, Array
+
+    scope :deep, -> { all }
+    scope :sorted, -> { order(:title) }
+
+    validates :title, presence: true
+    validates :determinations, presence: true
+    validates :recommendations, presence: true
+
+    validates :days_to_submit, numericality: { greater_than: 0, allow_nil: true }
+    validates :days_to_review, numericality: { greater_than: 0, allow_nil: true }
+
+    validates :days_to_declare_conflict, presence: true, if: -> { conflict_of_interest? }
+    validates :days_to_declare_conflict, numericality: { greater_than: 0, allow_nil: true }
+
+    validates :days_to_request_exemption, presence: true, if: -> { can_request_exemption? }
+    validates :days_to_request_exemption, numericality: { greater_than: 0, allow_nil: true }
+
+    validates :days_to_request_extension, presence: true, if: -> { can_request_extension? }
+    validates :days_to_request_extension, numericality: { greater_than: 0, allow_nil: true }
+
+    before_destroy do
+      if (count = cpd_audits.length) > 0
+        raise("#{count} audits belong to this audit level")
+      end
+    end
+  end
+
+  def to_s
+    title.presence || 'audit level'
+  end
+
+  def determinations
+    Array(self[:determinations]) - [nil, '']
+  end
+
+  def recommendations
+    Array(self[:recommendations]) - [nil, '']
+  end
+
+end