Skip to content
Snippets Groups Projects
Select Git revision
  • 2dd4b91be49edabe40175707f1f8a9624160ce56
  • master default protected
  • kifplan
  • felix-master-patch-23151
4 results

models.py

Blame
  • Forked from KIF / AKPlanning
    1118 commits behind the upstream repository.
    Benjamin Hättasch's avatar
    Benjamin Hättasch authored
    Add description to category model
    Show tabbed list of different categories of AKs on submission overview
    0ef613db
    History
    Code owners
    Assign users and groups as approvers for specific file changes. Learn more.
    models.py 9.70 KiB
    # Create your models here.
    from django.db import models
    from django.utils.translation import gettext_lazy as _
    
    
    class Event(models.Model):
        """ An event supplies the frame for all Aks.
        """
        name = models.CharField(max_length=64, unique=True, verbose_name=_('Name'),
                                help_text=_('Name or iteration of the event'))
        slug = models.SlugField(max_length=32, unique=True, verbose_name=_('Short Form'),
                                help_text=_('Short name of letters/numbers/dots/dashes/underscores used in URLs.'))
        start = models.DateTimeField(verbose_name=_('Start'), help_text=_('Time the event begins'))
        end = models.DateTimeField(verbose_name=_('End'), help_text=_('Time the event ends'))
        place = models.CharField(max_length=128, blank=True, verbose_name=_('Place'),
                                 help_text=_('City etc. the event takes place in'))
        active = models.BooleanField(verbose_name=_('Active State'), help_text=_('Marks currently active events'))
    
        class Meta:
            verbose_name = _('Event')
            verbose_name_plural = _('Events')
            ordering = ['name']
    
        def __str__(self):
            return self.name
    
        @staticmethod
        def get_by_slug(slug):
            return Event.objects.get(slug=slug)
    
    
    class AKOwner(models.Model):
        """ An AKOwner describes the person organizing/holding an AK.
        """
        name = models.CharField(max_length=256, verbose_name=_('Nickname'), help_text=_('Name to identify an AK owner by'))
        email = models.EmailField(max_length=128, blank=True, verbose_name=_('E-Mail Address'), help_text=_('Contact mail'))
        institution = models.CharField(max_length=128, blank=True, verbose_name=_('Institution'), help_text=_('Uni etc.'))
        link = models.URLField(blank=True, verbose_name=_('Web Link'), help_text=_('Link to Homepage'))
    
        event = models.ForeignKey(to=Event, on_delete=models.CASCADE, verbose_name=_('Event'),
                                  help_text=_('Associated event'))
    
        class Meta:
            verbose_name = _('AK Owner')
            verbose_name_plural = _('AK Owners')
            ordering = ['name']
            unique_together = [['name', 'institution']]
    
        def __str__(self):
            if self.institution:
                return f"{self.name} ({self.institution})"
            return self.name
    
    
    class AKCategory(models.Model):
        """ An AKCategory describes the characteristics of an AK, e.g. content vs. recreational.
        """
        name = models.CharField(max_length=64, unique=True, verbose_name=_('Name'), help_text=_('Name of the AK Category'))
        color = models.CharField(max_length=7, blank=True, verbose_name=_('Color'), help_text=_('Color for displaying'))
        description = models.TextField(blank=True, verbose_name=_("Description"), help_text=_("Short description of this AK Category"))
    
        class Meta:
            verbose_name = _('AK Category')
            verbose_name_plural = _('AK Categories')
            ordering = ['name']
    
        def __str__(self):
            return self.name
    
    
    class AKTrack(models.Model):
        """ An AKTrack describes a set of semantically related AKs.
        """
        name = models.CharField(max_length=64, unique=True, verbose_name=_('Name'), help_text=_('Name of the AK Track'))
        color = models.CharField(max_length=7, blank=True, verbose_name=_('Color'), help_text=_('Color for displaying'))
    
        class Meta:
            verbose_name = _('AK Track')
            verbose_name_plural = _('AK Tracks')
            ordering = ['name']
    
        def __str__(self):
            return self.name
    
    
    class AKTag(models.Model):
        """ An AKTag is a keyword given to an AK by (one of) its owner(s).
        """
        name = models.CharField(max_length=64, unique=True, verbose_name=_('Name'), help_text=_('Name of the AK Tag'))
    
        class Meta:
            verbose_name = _('AK Tag')
            verbose_name_plural = _('AK Tags')
            ordering = ['name']
    
        def __str__(self):
            return self.name
    
    
    class AKRequirement(models.Model):
        """ An AKRequirement describes something needed to hold an AK, e.g. infrastructure.
        """
        name = models.CharField(max_length=128, unique=True, verbose_name=_('Name'), help_text=_('Name of the Requirement'))
    
        event = models.ForeignKey(to=Event, on_delete=models.CASCADE, verbose_name=_('Event'),
                                  help_text=_('Associated event'))
    
        class Meta:
            verbose_name = _('AK Requirement')
            verbose_name_plural = _('AK Requirements')
            ordering = ['name']
    
        def __str__(self):
            return self.name
    
    
    class AK(models.Model):
        """ An AK is a slot-based activity to be scheduled during an event.
        """
        name = models.CharField(max_length=256, unique=True, verbose_name=_('Name'), help_text=_('Name of the AK'))
        short_name = models.CharField(max_length=64, unique=True, blank=True, verbose_name=_('Short Name'),
                                      help_text=_('Name displayed in the schedule'))
        description = models.TextField(blank=True, verbose_name=_('Description'), help_text=_('Description of the AK'))
    
        owners = models.ManyToManyField(to=AKOwner, blank=True, verbose_name=_('Owners'),
                                        help_text=_('Those organizing the AK'))
    
        # TODO generate automatically
        link = models.URLField(blank=True, verbose_name=_('Web Link'), help_text=_('Link to wiki page'))
    
        category = models.ForeignKey(to=AKCategory, on_delete=models.PROTECT, verbose_name=_('Category'),
                                     help_text=_('Category of the AK'))
        tags = models.ManyToManyField(to=AKTag, blank=True, verbose_name=_('Tags'), help_text=_('Tags provided by owners'))
        track = models.ForeignKey(to=AKTrack, blank=True, on_delete=models.SET_NULL, null=True, verbose_name=_('Track'),
                                  help_text=_('Track the AK belongs to'))
    
        reso = models.BooleanField(verbose_name=_('Resolution Intention'), default=False,
                                   help_text=_('Intends to submit a resolution'))
        present = models.BooleanField(verbose_name=_("Present this AK"), null=True, help_text=_("Present results of this AK"))
    
        requirements = models.ManyToManyField(to=AKRequirement, blank=True, verbose_name=_('Requirements'),
                                              help_text=_("AK's Requirements"))
    
        conflicts = models.ManyToManyField(to='AK', blank=True, related_name='conflict', verbose_name=_('Conflicting AKs'),
                                           help_text=_('AKs that conflict and thus must not take place at the same time'))
        prerequisites = models.ManyToManyField(to='AK', blank=True, verbose_name=_('Prerequisite AKs'),
                                               help_text=_('AKs that should precede this AK in the schedule'))
    
        notes = models.TextField(blank=True, verbose_name=_('Internal Notes'), help_text=_('Notes to organizers'))
    
        interest = models.IntegerField(default=-1, verbose_name=_('Interest'), help_text=_('Expected number of people'))
    
        event = models.ForeignKey(to=Event, on_delete=models.CASCADE, verbose_name=_('Event'),
                                  help_text=_('Associated event'))
    
        class Meta:
            verbose_name = _('AK')
            verbose_name_plural = _('AKs')
    
        def __str__(self):
            if self.short_name:
                return self.short_name
            return self.name
    
        @property
        def owners_list(self):
            return ", ".join(str(owner) for owner in self.owners.all())
    
        @property
        def wish(self):
            return self.owners.count() == 0
    
    
    class Room(models.Model):
        """ A room describes where an AK can be held.
        """
        name = models.CharField(max_length=64, verbose_name=_('Name'), help_text=_('Name or number of the room'))
        building = models.CharField(max_length=256, blank=True, verbose_name=_('Building'),
                                    help_text=_('Name or number of the building'))
        capacity = models.IntegerField(verbose_name=_('Capacity'), help_text=_('Maximum number of people'))
        properties = models.ManyToManyField(to=AKRequirement, blank=True, verbose_name=_('Properties'),
                                            help_text=_('AK requirements fulfilled by the room'))
    
        event = models.ForeignKey(to=Event, on_delete=models.CASCADE, verbose_name=_('Event'),
                                  help_text=_('Associated event'))
    
        class Meta:
            verbose_name = _('Room')
            verbose_name_plural = _('Rooms')
            ordering = ['building', 'name']
            unique_together = [['name', 'building']]
    
        def __str__(self):
            if self.building:
                return f"{self.building} {self.name}"
            return self.name
    
    
    class AKSlot(models.Model):
        """ An AK Mapping matches an AK to a room during a certain time.
        """
        ak = models.ForeignKey(to=AK, on_delete=models.CASCADE, verbose_name=_('AK'), help_text=_('AK being mapped'))
        room = models.ForeignKey(to=Room, null=True, on_delete=models.SET_NULL, verbose_name=_('Room'),
                                 help_text=_('Room the AK will take place in'))
        start = models.DateTimeField(verbose_name=_('Slot Begin'), help_text=_('Time and date the slot begins'))
        duration = models.DecimalField(max_digits=4, decimal_places=2, default=2, verbose_name=_('Duration'),
                                       help_text=_('Length in hours'))
    
        event = models.ForeignKey(to=Event, on_delete=models.CASCADE, verbose_name=_('Event'),
                                  help_text=_('Associated event'))
    
        class Meta:
            verbose_name = _('AK Slot')
            verbose_name_plural = _('AK Slots')
            ordering = ['start', 'room']
    
        def __str__(self):
            if self.room:
                return f"{self.ak} @ {self.start_simplified} in {self.room}"
            return f"{self.ak} @ {self.start_simplified}"
    
        @property
        def start_simplified(self):
            """
            Display start time of slot in format weekday + time, e.g. "Fri 14:00"
            """
            return self.start.strftime('%a %H:%M')