Module: EffectiveMembershipsApplicant
- Extended by:
- ActiveSupport::Concern
- Defined in:
- app/models/concerns/effective_memberships_applicant.rb
Overview
EffectiveMembershipsApplicant
Mark your owner model with effective_memberships_applicant to get all the includes
Defined Under Namespace
Modules: Base, ClassMethods
Instance Method Summary
collapse
Instance Method Details
#applicant_course(applicant_course_name: nil) ⇒ Object
620
621
622
623
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 620
def applicant_course(applicant_course_name: nil)
applicant_courses.find { |ac| ac.applicant_course_name_id == applicant_course_name.id } ||
applicant_courses.build(applicant_course_name: applicant_course_name, applicant_course_area: applicant_course_name.applicant_course_area)
end
|
#applicant_course_area_sum(applicant_course_area:) ⇒ Object
625
626
627
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 625
def applicant_course_area_sum(applicant_course_area:)
applicant_courses.select { |ac| ac.applicant_course_area_id == applicant_course_area.id }.sum { |ac| ac.amount.to_i }
end
|
#applicant_course_areas_collection ⇒ Object
612
613
614
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 612
def applicant_course_areas_collection
Effective::ApplicantCourseArea.deep.sorted
end
|
#applicant_course_names_collection(applicant_course_area:) ⇒ Object
616
617
618
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 616
def applicant_course_names_collection(applicant_course_area:)
applicant_course_area.applicant_course_names
end
|
#applicant_courses_sum ⇒ Object
629
630
631
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 629
def applicant_courses_sum
applicant_courses.sum { |ac| ac.amount.to_i }
end
|
#applicant_endorsements_required? ⇒ Boolean
652
653
654
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 652
def applicant_endorsements_required?
required_steps.include?(:endorsements) && min_applicant_endorsements > 0
end
|
#applicant_references_required? ⇒ Boolean
643
644
645
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 643
def applicant_references_required?
required_steps.include?(:references) && min_applicant_references > 0
end
|
#applicant_reviews_required? ⇒ Boolean
Completed -> Reviewed requirements
738
739
740
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 738
def applicant_reviews_required?
(min_applicant_reviews > 0 || applicant_reviews.present?)
end
|
#apply_to_join? ⇒ Boolean
504
505
506
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 504
def apply_to_join?
applicant_type == 'Apply to Join'
end
|
#approve! ⇒ Object
Admin approves an applicant. Registers the owner. Sends an email.
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 781
def approve!
raise('already approved') if was_approved?
raise('applicant must have been submitted to approve!') unless was_submitted?
wizard_steps[:checkout] ||= Time.zone.now
wizard_steps[:submitted] ||= Time.zone.now
assign_attributes(missing_info_reason: nil)
approved!
if apply_to_join?
EffectiveMemberships.Registrar.register!(
owner,
to: to_category,
status: to_status,
date: approved_membership_date.presence, number: approved_membership_number.presence )
elsif reclassification?
EffectiveMemberships.Registrar.reclassify!(owner, to: to_category, status: to_status)
elsif reinstatement?
EffectiveMemberships.Registrar.reinstate!(owner, from: from_status)
else
raise('unsupported approval applicant_type')
end
save!
after_commit { send_email(:applicant_approved) }
true
end
|
#approve_email_templates ⇒ Object
767
768
769
770
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 767
def approve_email_templates
raise('expected EffectiveEmailTemplates') unless defined?(EffectiveEmailTemplates)
Effective::EmailTemplate.where('template_name ILIKE ?', 'applicant_approve%').order(:template_name)
end
|
#build_organization(params = {}) ⇒ Object
500
501
502
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 500
def build_organization(params = {})
self.organization = EffectiveMemberships.Organization.new(params)
end
|
#can_apply_applicant_types_collection ⇒ Object
566
567
568
569
570
571
572
573
574
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 566
def can_apply_applicant_types_collection
if owner.blank? || owner.membership.blank? || owner.membership.categories.blank?
['Apply to Join']
elsif owner.membership.statuses.any?(&:reinstatable?)
['Apply for Reinstatement', 'Apply to Join']
else
['Apply to Reclassify']
end
end
|
#can_apply_categories_collection ⇒ Object
577
578
579
580
581
582
583
584
585
586
587
588
589
590
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 577
def can_apply_categories_collection
categories = EffectiveMemberships.Category.sorted.can_apply
if user.blank? || !user.is?(:member)
return categories.where(can_apply_new: true)
end
category_ids = user.membership.category_ids
categories.select do |cat|
cat.can_apply_existing? ||
(cat.can_apply_restricted? && (category_ids & cat.can_apply_restricted_ids).present?)
end
end
|
#complete! ⇒ Object
706
707
708
709
710
711
712
713
714
715
716
717
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 706
def complete!
raise('applicant must have been submitted to complete!') unless was_submitted?
assign_attributes(missing_info_reason: nil)
completed!
after_commit { send_email(:applicant_completed) }
true
end
|
#completed_requirements ⇒ Object
When an application is submitted, these must be done to go to completed. An Admin can override this and just set them to completed.
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 687
def completed_requirements
requirements = {}
return requirements unless category.present?
if applicant_endorsements_required?
requirements['Applicant Endorsements'] = (applicant_endorsements.count(&:completed?) >= min_applicant_endorsements)
end
if applicant_references_required?
requirements['Applicant References'] = (applicant_references.count(&:completed?) >= min_applicant_references)
end
if transcripts_required?
requirements['Applicant Transcripts'] = transcripts_received?
end
requirements
end
|
#decline! ⇒ Object
Admin approves an applicant. Registers the owner. Sends an email.
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 815
def decline!
raise('already declined') if was_declined?
raise('previously approved') if was_approved?
raise('applicant must have been submitted to decline!') unless was_submitted?
wizard_steps[:checkout] ||= Time.zone.now
wizard_steps[:submitted] ||= Time.zone.now
declined!
save!
after_commit { send_email(:applicant_declined) }
true
end
|
#done? ⇒ Boolean
528
529
530
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 528
def done?
approved? || declined?
end
|
#in_progress? ⇒ Boolean
524
525
526
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 524
def in_progress?
!approved? && !declined?
end
|
#individual? ⇒ Boolean
516
517
518
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 516
def individual?
!(owner.kind_of?(EffectiveMemberships.Organization) && category&.organization?)
end
|
#min_applicant_courses ⇒ Object
608
609
610
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 608
def min_applicant_courses
category&.min_applicant_courses.to_i
end
|
#min_applicant_educations ⇒ Object
603
604
605
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 603
def min_applicant_educations
category&.min_applicant_educations.to_i
end
|
#min_applicant_endorsements ⇒ Object
648
649
650
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 648
def min_applicant_endorsements
category&.min_applicant_endorsements.to_i
end
|
#min_applicant_equivalences ⇒ Object
657
658
659
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 657
def min_applicant_equivalences
category&.min_applicant_equivalences.to_i
end
|
#min_applicant_experiences_months ⇒ Object
634
635
636
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 634
def min_applicant_experiences_months
category&.min_applicant_experiences_months.to_i
end
|
#min_applicant_files ⇒ Object
671
672
673
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 671
def min_applicant_files
category&.min_applicant_files.to_i
end
|
#min_applicant_references ⇒ Object
639
640
641
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 639
def min_applicant_references
category&.min_applicant_references.to_i
end
|
#min_applicant_reviews ⇒ Object
742
743
744
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 742
def min_applicant_reviews
category&.min_applicant_reviews.to_i
end
|
#missing! ⇒ Object
719
720
721
722
723
724
725
726
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 719
def missing!
raise('applicant must have been submitted to missing!') unless was_submitted?
missing_info!
after_commit { send_email(:applicant_missing_info) }
true
end
|
#organization? ⇒ Boolean
520
521
522
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 520
def organization?
owner.kind_of?(EffectiveMemberships.Organization) && category&.organization?
end
|
#owner ⇒ Object
492
493
494
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 492
def owner
organization || user
end
|
#owner_symbol ⇒ Object
496
497
498
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 496
def owner_symbol
organization? ? :organization : :user
end
|
#reclassification? ⇒ Boolean
508
509
510
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 508
def reclassification?
applicant_type == 'Apply to Reclassify'
end
|
#reinstatement? ⇒ Boolean
512
513
514
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 512
def reinstatement?
applicant_type == 'Apply for Reinstatement'
end
|
#resubmit! ⇒ Object
728
729
730
731
732
733
734
735
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 728
def resubmit!
raise('applicant must have been submitted and missing info to resubmit!') unless was_submitted? && was_missing_info?
raise('already submitted') if submitted?
raise('expected a purchased order') unless submit_order&.purchased?
assign_attributes(skip_to_step: :submitted, submitted_at: Time.zone.now)
submitted!
end
|
#review! ⇒ Object
759
760
761
762
763
764
765
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 759
def review!
raise('applicant must have been submitted to review!') unless was_submitted?
reviewed!
end
|
#reviewed_requirements ⇒ Object
When an application is completed, these must be done to go to reviewed An Admin can override this and just set them to reviewed.
748
749
750
751
752
753
754
755
756
757
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 748
def reviewed_requirements
requirements = {}
return requirements unless category.present?
if applicant_reviews_required?
requirements['Applicant Reviews'] = (applicant_reviews.count(&:completed?) >= min_applicant_reviews)
end
requirements
end
|
#select! ⇒ Object
592
593
594
595
596
597
598
599
600
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 592
def select!
raise('cannot select a submitted applicant') if was_submitted?
raise('cannot select a purchased applicant') if orders.any? { |order| order.purchased? }
assign_attributes(wizard_steps: wizard_steps.slice(:start, :select))
save!
end
|
#stamp ⇒ Object
676
677
678
679
680
681
682
683
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 676
def stamp
stamps.first || stamps.build(
owner: owner,
name: owner.to_s,
shipping_address: (owner.try(:shipping_address) || owner.try(:billing_address)),
price: 0
)
end
|
#status_label ⇒ Object
532
533
534
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 532
def status_label
(status_was || status).to_s.gsub('_', ' ')
end
|
#summary ⇒ Object
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 536
def summary
case status_was
when 'draft'
"Applicant has not yet completed the #{category} wizard steps or paid to submit this application. This application will transition to 'submitted' after payment has been collected."
when 'submitted'
summary = "Application has been purchased and submitted."
tasks = "The following tasks remain before it can be completed:"
approval = "Waiting on approval."
items = completed_requirements.map { |item, done| "<li>#{item}: #{done ? 'Complete' : 'Incomplete'}</li>" }.join
completed_requirements.present? ? "<p>#{summary} #{tasks}</p><ul>#{items}</ul>" : "#{summary} #{approval}"
when 'completed'
if applicant_reviews_required?
"All required materials have been provided. This application will transition to 'reviewed' after all reviewers have voted."
else
"This application has been completed and is now ready for an admin to approve or decline it. If approved, prorated fees will be generated."
end
when 'missing_info'
"Missing the following information: <ul><li>#{missing_info_reason}</li></ul>"
when 'reviewed'
"This application has been reviewed and is now ready for an admin to approve or decline it. If approved, prorated fees will be generated."
when 'approved'
"The application has been approved! All done!"
when 'declined'
"This application has been declined."
else
raise("unexpected status #{status}")
end.html_safe
end
|
#to_category ⇒ Object
772
773
774
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 772
def to_category
category
end
|
#to_s ⇒ Object
486
487
488
489
490
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 486
def to_s
return 'New Applicant' if applicant_type.blank? || category.blank? || owner.blank?
"#{owner} - #{applicant_type} to #{category}"
end
|
#to_status ⇒ Object
776
777
778
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 776
def to_status
nil
end
|
#transcripts_received? ⇒ Boolean
662
663
664
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 662
def transcripts_received?
transcripts_received_on_was.present?
end
|
#transcripts_required? ⇒ Boolean
666
667
668
|
# File 'app/models/concerns/effective_memberships_applicant.rb', line 666
def transcripts_required?
required_steps.include?(:transcripts)
end
|