Class: User

Inherits:
ApplicationRecord show all
Includes:
Awardee, Disabling, Mumuki::Domain::Helpers::User, Mumuki::Domain::Syncable, WithDiscussionCreation, WithNotifications, WithPreferences, WithProfile, WithReminders, WithTermsAcceptance, WithUserNavigation
Defined in:
app/models/user.rb

Constant Summary collapse

PLACEHOLDER_IMAGE_URL = 
'user_shape.png'.freeze

Instance Method Summary collapse

Methods included from WithUserNavigation

#navigable_name, #navigation_end?

Methods included from WithReminders

#build_reminder, #remind!, #should_remind?, #try_remind_with_lock!

Methods included from WithNotifications

#read_notification!, #unread_messages, #unread_notifications

Methods included from Awardee

#acquired_medals, #unacquired_medals

Methods included from Disabling

#disable!, #disabled?, #enabled?, #ensure_enabled!

Methods included from WithTermsAcceptance

#accept_forum_terms!, #accept_profile_terms!, #forum_terms, #has_accepted?, #has_forum_terms_to_accept?, #has_profile_terms_to_accept?, #has_role_terms_to_accept?, #profile_terms, #role_specific_terms

Methods included from Mumuki::Domain::Helpers::User

#any_granted_organizations, #discusser_of?, #full_name, #has_immersive_main_organization?, #has_role?, #has_student_granted_organizations?, #immersive_organization_at, #immersive_organization_with_content_at, #immersive_organizations_at, #immersive_organizations_with_content_at, #main_organization, #merge_permissions!, #platform_class_name, #profile_completed?, #to_param

Methods included from Mumuki::Domain::Syncable

#platform_class_name, #sync_key

Methods inherited from ApplicationRecord

active_between, aggregate_of, all_except, defaults, #delete, #destroy!, enum_prefixed_translations_for, numbered, organic_on, resource_fields, #save, #save_and_notify_changes!, serialize_symbolized_hash_array, teaser_on, #update_and_notify!, update_or_create!, whitelist_attributes, with_temporary_token

Instance Method Details

#abbreviated_name ⇒ Object 



214
215
216
 
# File 'app/models/user.rb', line 214

def abbreviated_name
  "#{first_name} #{last_name.first.capitalize + '.' if last_name.present?}".strip
end

#accept_invitation!(invitation) ⇒ Object 



105
106
107
 
# File 'app/models/user.rb', line 105

def accept_invitation!(invitation)
  make_student_of! invitation.course_slug
end

#age ⇒ Object 



250
251
252
253
254
 
# File 'app/models/user.rb', line 250

def age
  if birthdate.present?
    @age ||= Time.now.round_years_since(birthdate.to_time)
  end
end

#attach!(role, course) ⇒ Object 



140
141
142
143
 
# File 'app/models/user.rb', line 140

def attach!(role, course)
  add_permission! role, course.slug
  save_and_notify!
end

#build_assignment(exercise, organization) ⇒ Object 



222
223
224
 
# File 'app/models/user.rb', line 222

def build_assignment(exercise, organization)
  Assignment.build_for(self, exercise, organization)
end

#bury! ⇒ Object 



170
171
172
173
 
# File 'app/models/user.rb', line 170

def bury!
  # TODO change avatar
  update! self.class.buried_profile.merge(accepts_reminders: false, gender: nil, birthdate: nil)
end

#can_access_teacher_info_in?(organization) ⇒ Boolean

Returns:

  • (Boolean) 


206
207
208
 
# File 'app/models/user.rb', line 206

def can_access_teacher_info_in?(organization)
  teacher_of?(organization) || organization.teacher_training?
end

#can_discuss_here? ⇒ Boolean

Returns:

  • (Boolean) 


202
203
204
 
# File 'app/models/user.rb', line 202

def can_discuss_here?
  can_discuss_in? Organization.current
end

#can_discuss_in?(organization) ⇒ Boolean

Tells if the given user can discuss in an organization

This is true only when this organization has the forum enabled and the user has the discusser pseudo-permission and the discusser is trusted

Returns:

  • (Boolean) 


194
195
196
 
# File 'app/models/user.rb', line 194

def can_discuss_in?(organization)
  organization.forum_enabled? && discusser_of?(organization) && trusted_as_discusser_in?(organization) && !banned_from_forum?
end

#certificate_in(certificate_program, certificate_h) ⇒ Object 



309
310
311
312
313
 
# File 'app/models/user.rb', line 309

def certificate_in(certificate_program, certificate_h)
  return if certificated_in?(certificate_program)
  certificate = certificates.create certificate_h.merge(certificate_program: certificate_program)
  UserMailer.certificate(certificate).deliver_later
end

#certificated_in?(certificate_program) ⇒ Boolean

Returns:

  • (Boolean) 


305
306
307
 
# File 'app/models/user.rb', line 305

def certificated_in?(certificate_program)
  certificates.where(certificate_program: certificate_program).exists?
end

#certificates_in_organization(organization = Organization.current) ⇒ Object 



301
302
303
 
# File 'app/models/user.rb', line 301

def certificates_in_organization(organization = Organization.current)
  certificates.where certificate_program: CertificateProgram.where(organization: organization)
end

#clear_progress! ⇒ Object 



98
99
100
101
102
103
 
# File 'app/models/user.rb', line 98

def clear_progress!
  transaction do
    update! last_submission_date: nil, last_exercise: nil
    assignments.destroy_all
  end
end

#completed_containers(sequence, organization) ⇒ Object

Takes a didactic - ordered - sequence of content containers and returns those that have been completed



177
178
179
 
# File 'app/models/user.rb', line 177

def completed_containers(sequence, organization)
  sequence.take_while { |it| it.content.completed_for?(self, organization) }
end

#completed_containers_with_lookahead(sequence, organization, lookahead: 1) ⇒ Object

Like ‘completed_containers`, returns a slice of the completed containers in the sequence, but adding a configurable number of trailing, non-completed contaienrs



183
184
185
186
187
188
 
# File 'app/models/user.rb', line 183

def completed_containers_with_lookahead(sequence, organization, lookahead: 1)
  raise 'invalid lookahead' if lookahead < 1

  count = completed_containers(sequence, organization).size
  sequence[0..count + lookahead - 1]
end

#current_audience ⇒ Object 



242
243
244
 
# File 'app/models/user.rb', line 242

def current_audience
  current_organic_context&.target_audience
end

#current_immersive_context_and_content_at(path_item) ⇒ Object 



283
284
285
286
287
 
# File 'app/models/user.rb', line 283

def current_immersive_context_and_content_at(path_item)
  immersive_organization_with_content_at(path_item).tap do |orga, _|
    return [Organization.current, path_item] unless orga.present?
  end
end

#current_immersive_context_at(path_item) ⇒ Object 



260
261
262
263
264
265
266
 
# File 'app/models/user.rb', line 260

def current_immersive_context_at(path_item)
  if Organization.current?
    immersive_organization_at(path_item) || Organization.current
  else
    main_organization
  end
end

#current_organic_context ⇒ Object 



256
257
258
 
# File 'app/models/user.rb', line 256

def current_organic_context
  Organization.current? ?  Organization.current : main_organization
end

#currently_in_exam? ⇒ Boolean

Returns:

  • (Boolean) 


158
159
160
 
# File 'app/models/user.rb', line 158

def currently_in_exam?
  exams.any? { |e| e.in_progress_for? self }
end

#custom_profile_picture ⇒ Object 



162
163
164
 
# File 'app/models/user.rb', line 162

def custom_profile_picture
  avatar&.image_url || image_url
end

#detach!(role, course) ⇒ Object 



145
146
147
148
 
# File 'app/models/user.rb', line 145

def detach!(role, course)
  remove_permission! role, course.slug
  save_and_notify!
end

#formal_first_name ⇒ Object 



289
290
291
 
# File 'app/models/user.rb', line 289

def formal_first_name
  verified_first_name.presence || first_name
end

#formal_full_name ⇒ Object 



297
298
299
 
# File 'app/models/user.rb', line 297

def formal_full_name
  "#{formal_first_name} #{formal_last_name}"
end

#formal_last_name ⇒ Object 



293
294
295
 
# File 'app/models/user.rb', line 293

def formal_last_name
  verified_last_name.presence || last_name
end

#import_from_resource_h!(json) ⇒ Object 



121
122
123
 
# File 'app/models/user.rb', line 121

def import_from_resource_h!(json)
  update! self.class.slice_resource_h json
end

#incognito? ⇒ Boolean

Returns:

  • (Boolean) 


238
239
240
 
# File 'app/models/user.rb', line 238

def incognito?
  false
end

#interpolations ⇒ Object 



150
151
152
153
154
155
156
 
# File 'app/models/user.rb', line 150

def interpolations
  {
      'user_email' => email,
      'user_first_name' => first_name,
      'user_last_name' => last_name
  }
end

#last_lesson ⇒ Object 



54
55
56
 
# File 'app/models/user.rb', line 54

def last_lesson
  last_guide.try(:lesson)
end

#messages_in_organization(organization = Organization.current) ⇒ Object 



58
59
60
 
# File 'app/models/user.rb', line 58

def messages_in_organization(organization = Organization.current)
  messages.where('assignments.organization': organization)
end

#name_initials ⇒ Object 



210
211
212
 
# File 'app/models/user.rb', line 210

def name_initials
  name.split.map(&:first).map(&:capitalize).join(' ')
end

#never_submitted? ⇒ Boolean

Returns:

  • (Boolean) 


94
95
96
 
# File 'app/models/user.rb', line 94

def never_submitted?
  last_submission_date.nil?
end

#next_exercise_at(guide) ⇒ Object 



230
231
232
 
# File 'app/models/user.rb', line 230

def next_exercise_at(guide)
  guide.pending_exercises(self).order('exercises.number asc').first
end

#notify_permissions_changed! ⇒ Object 



268
269
270
271
272
273
274
275
 
# File 'app/models/user.rb', line 268

def notify_permissions_changed!
  return if permissions_before_last_save == permissions
  Mumukit::Nuntius.notify! 'user-permissions-changed', user: {
    uid: uid,
    old_permissions: permissions_before_last_save.as_json,
    new_permissions: permissions.as_json
  }
end

#passed_assignments ⇒ Object 



82
83
84
 
# File 'app/models/user.rb', line 82

def passed_assignments
  assignments.where(status: Mumuki::Domain::Status::Submission::Passed.to_i)
end

#passed_submissions_count ⇒ Object 



70
71
72
 
# File 'app/models/user.rb', line 70

def passed_submissions_count
  passed_assignments.count
end

#passed_submissions_count_in(organization) ⇒ Object 



62
63
64
 
# File 'app/models/user.rb', line 62

def passed_submissions_count_in(organization)
  assignments.where(top_submission_status: Mumuki::Domain::Status::Submission::Passed.to_i, organization: organization).count
end

#pending_siblings_at(content) ⇒ Object 



226
227
228
 
# File 'app/models/user.rb', line 226

def pending_siblings_at(content)
  content.pending_siblings_for(self)
end

#placeholder_image_url ⇒ Object 



246
247
248
 
# File 'app/models/user.rb', line 246

def placeholder_image_url
  PLACEHOLDER_IMAGE_URL
end

#profile_picture ⇒ Object 



166
167
168
 
# File 'app/models/user.rb', line 166

def profile_picture
  custom_profile_picture || placeholder_image_url
end

#progress_at(content, organization) ⇒ Object 



218
219
220
 
# File 'app/models/user.rb', line 218

def progress_at(content, organization)
  Indicator.find_or_initialize_by(user: self, organization: organization, content: content)
end

#run_submission!(submission, assignment, evaluation) ⇒ Object 



234
235
236
 
# File 'app/models/user.rb', line 234

def run_submission!(submission, assignment, evaluation)
  submission.run! assignment, evaluation
end

#save_and_notify! ⇒ Object 



277
278
279
280
281
 
# File 'app/models/user.rb', line 277

def save_and_notify!
  save!
  notify_permissions_changed!
  self
end

#solved_exercises_count ⇒ Object 



78
79
80
 
# File 'app/models/user.rb', line 78

def solved_exercises_count
  solved_exercises.count
end

#submissions_count ⇒ Object 



66
67
68
 
# File 'app/models/user.rb', line 66

def submissions_count
  assignments.pluck(:submissions_count).sum
end

#submitted_exercises_count ⇒ Object 



74
75
76
 
# File 'app/models/user.rb', line 74

def submitted_exercises_count
  submitted_exercises.count
end

#to_resource_h ⇒ Object 



125
126
127
 
# File 'app/models/user.rb', line 125

def to_resource_h
  super.merge(image_url: profile_picture)
end

#to_s ⇒ Object 



90
91
92
 
# File 'app/models/user.rb', line 90

def to_s
  "#{id}:#{name}:#{uid}"
end

#transfer_progress_to!(another) ⇒ Object 



109
110
111
112
113
114
115
116
117
118
119
 
# File 'app/models/user.rb', line 109

def transfer_progress_to!(another)
  transaction do
    assignments.update_all(submitter_id: another.id)
    if another.never_submitted? || last_submission_date.try { |it| it > another.last_submission_date }
      another.update! last_submission_date: last_submission_date,
                      last_exercise: last_exercise,
                      last_organization: last_organization
    end
  end
  reload
end

#trusted_as_discusser_in?(organization) ⇒ Boolean

Returns:

  • (Boolean) 


198
199
200
 
# File 'app/models/user.rb', line 198

def trusted_as_discusser_in?(organization)
  trusted_for_forum? || !organization.forum_only_for_trusted?
end

#unsubscribe_from_reminders! ⇒ Object 



135
136
137
 
# File 'app/models/user.rb', line 135

def unsubscribe_from_reminders!
  update! accepts_reminders: false
end

#verify_name! ⇒ Object 



129
130
131
132
133
 
# File 'app/models/user.rb', line 129

def verify_name!
  self.verified_first_name ||= first_name
  self.verified_last_name ||= last_name
  save!
end

#visit!(organization) ⇒ Object 



86
87
88
 
# File 'app/models/user.rb', line 86

def visit!(organization)
  update!(last_organization: organization) if organization != last_organization
end