stage2/models.py

   1 # -*- coding: utf-8 -*-
   2 import os
   3 import random
   4 import string
   5
   6 from django.contrib.auth.models import User
   7 from django.core.urlresolvers import reverse
   8 from django.db import models
   9 from django.db.models.signals import post_save
  10 from django.dispatch import receiver
  11 from django.utils.translation import ugettext_lazy as _
  12 from django.utils import timezone
  13 from jsonfield import JSONField
  14
  15 from contact.models import Contact
  16
  17
  18 class Participant(models.Model):
  19     contact = models.ForeignKey(Contact, verbose_name=_('contact'), null=True)
  20     key = models.CharField(_('key'), max_length=30, unique=True)
  21     first_name = models.CharField(_('first name'), max_length=100)
  22     last_name = models.CharField(_('last_name'), max_length=100)
  23     email = models.EmailField(_('email'), max_length=100, unique=True)
  24     key_sent = models.BooleanField(_('key sent'), default=False)
  25
  26     class Meta:
  27         verbose_name = _('participant')
  28         verbose_name_plural = _('participants')
  29
  30     def __unicode__(self):
  31         return ', '.join((self.last_name, self.first_name, self.email))
  32
  33     # copy-paste from wtem
  34     @classmethod
  35     def generate_key(cls):
  36         key = ''
  37         while not key or key in [record['key'] for record in cls.objects.values('key')]:
  38             key = ''.join(random.choice(string.ascii_uppercase + string.ascii_lowercase + string.digits)
  39                           for i in range(30))
  40         return key
  41
  42     # copy-paste from wtem
  43     @classmethod
  44     def create(cls, first_name, last_name, email, key=None, contact=None):
  45         return cls.objects.create(
  46             contact=contact,
  47             key=key if key else cls.generate_key(),
  48             first_name=first_name,
  49             last_name=last_name,
  50             email=email)
  51
  52     def check(self, key):
  53         return key == self.key
  54
  55     def score(self):
  56         return sum(answer.score() for answer in self.answer_set.all())
  57
  58
  59 class Assignment(models.Model):
  60     title = models.CharField(_('title'), max_length=128)
  61     content = models.TextField(_('content'))
  62     content_url = models.URLField(_('URL'))
  63     deadline = models.DateTimeField(_('deadline'))
  64     max_points = models.IntegerField(_('max points'))
  65     experts = models.ManyToManyField(User, verbose_name=_('experts'), related_name='stage2_assignments')
  66     arbiters = models.ManyToManyField(User, verbose_name=_('arbiters'), related_name='stage2_arbitrated')
  67     file_descriptions = JSONField(_('file descriptions'))
  68
  69     class Meta:
  70         ordering = ['deadline', 'title']
  71         verbose_name = _('assignment')
  72         verbose_name_plural = _('assignments')
  73
  74     def __unicode__(self):
  75         return self.title
  76
  77     def available_answers(self, expert):
  78         answers = self.answer_set.exclude(mark__expert=expert).exclude(complete=True)
  79         if expert in self.arbiters.all():
  80             answers = answers.filter(need_arbiter=True)
  81         return answers
  82
  83     def is_active(self):
  84         return self.deadline >= timezone.now()
  85
  86
  87 class Answer(models.Model):
  88     participant = models.ForeignKey(Participant)
  89     assignment = models.ForeignKey(Assignment)
  90     # useful redundancy
  91     complete = models.BooleanField(default=False)
  92     need_arbiter = models.BooleanField(default=False)
  93
  94     class Meta:
  95         unique_together = ['participant', 'assignment']
  96
  97     def update_complete(self):
  98         marks = self.mark_set.all()
  99         if len(marks) < 2:
 100             complete = False
 101             need_arbiter = False
 102         elif len(marks) == 2:
 103             mark1, mark2 = marks
 104             complete = abs(mark1.points - mark2.points) < 0.2 * self.assignment.max_points
 105             need_arbiter = not complete
 106         else:
 107             complete = True
 108             need_arbiter = False
 109         self.complete = complete
 110         self.need_arbiter = need_arbiter
 111         self.save()
 112
 113     def score(self):
 114         marks = self.mark_set.all()
 115         if len(marks) < 2:
 116             return None
 117         return self.mark_set.aggregate(models.Avg('points'))
 118
 119
 120 def attachment_path(instance, filename):
 121     answer = instance.answer
 122     return 'stage2/attachment/%s/%s/%s/%s' % (answer.participant_id, answer.assignment_id, instance.file_no, filename)
 123
 124
 125 class Attachment(models.Model):
 126     answer = models.ForeignKey(Answer)
 127     file_no = models.IntegerField()
 128     file = models.FileField(upload_to=attachment_path)
 129
 130     class Meta:
 131         ordering = ['file_no']
 132
 133     def filename(self):
 134         return os.path.basename(self.file.name)
 135
 136     def download_url(self):
 137         return reverse(
 138             'stage2_participant_file',
 139             args=(self.answer.assignment_id, self.file_no,
 140                   self.answer.participant_id, self.answer.participant.key))
 141
 142     def expert_download_url(self):
 143         return reverse('stage2_expert_download', args=[self.id])
 144
 145
 146 class Mark(models.Model):
 147     expert = models.ForeignKey(User)
 148     answer = models.ForeignKey(Answer)
 149     points = models.DecimalField(verbose_name=_('points'), max_digits=3, decimal_places=1)
 150
 151     class Meta:
 152         unique_together = ['expert', 'answer']
 153
 154
 155 @receiver(post_save, sender=Mark, dispatch_uid='update_answer')
 156 def update_answer(sender, **kwargs):
 157     mark = kwargs['instance']
 158     mark.answer.update_complete()