2021-02-28 22:00:11 +00:00
|
|
|
from typing import Optional
|
|
|
|
|
2023-01-02 21:13:25 +00:00
|
|
|
from django.contrib.postgres.constraints import ExclusionConstraint
|
|
|
|
from django.contrib.postgres.fields import DateRangeField
|
|
|
|
from django.contrib.postgres.fields import RangeOperators
|
2018-06-23 19:08:56 +00:00
|
|
|
from django.db import models
|
2021-02-28 22:00:11 +00:00
|
|
|
from django.utils import timezone
|
2018-06-23 19:08:56 +00:00
|
|
|
from django.utils.translation import gettext as _
|
|
|
|
|
2023-01-02 21:13:25 +00:00
|
|
|
from utils.mixins import CreatedModifiedAbstract
|
2018-06-23 19:08:56 +00:00
|
|
|
|
|
|
|
|
2023-01-02 21:13:25 +00:00
|
|
|
class SubscriptionPeriod(CreatedModifiedAbstract):
|
|
|
|
"""
|
|
|
|
Denotes a period for which members should pay their membership fee for.
|
|
|
|
"""
|
|
|
|
|
|
|
|
period = DateRangeField(verbose_name=_("period"))
|
2018-06-23 19:08:56 +00:00
|
|
|
|
|
|
|
class Meta:
|
2023-01-02 21:13:25 +00:00
|
|
|
constraints = [
|
|
|
|
ExclusionConstraint(
|
|
|
|
name="exclude_overlapping_periods",
|
|
|
|
expressions=[
|
|
|
|
("period", RangeOperators.OVERLAPS),
|
|
|
|
],
|
|
|
|
),
|
|
|
|
]
|
2018-06-23 19:08:56 +00:00
|
|
|
|
|
|
|
|
|
|
|
class Membership(CreatedModifiedAbstract):
|
|
|
|
"""
|
2021-02-28 22:00:11 +00:00
|
|
|
Tracks that a user has membership of a given type for a given period.
|
2018-06-23 19:08:56 +00:00
|
|
|
"""
|
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
class QuerySet(models.QuerySet):
|
|
|
|
def for_user(self, user):
|
|
|
|
return self.filter(user=user)
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
def _current(self):
|
2023-01-02 21:13:25 +00:00
|
|
|
return self.filter(period__period__contains=timezone.now())
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
def current(self) -> Optional["Membership"]:
|
|
|
|
try:
|
|
|
|
return self._current().get()
|
|
|
|
except self.model.DoesNotExist:
|
|
|
|
return None
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
def previous(self):
|
|
|
|
# A naïve way to get previous by just excluding the current. This
|
|
|
|
# means that there must be some protection against "future"
|
|
|
|
# memberships.
|
|
|
|
return self.all().difference(self._current())
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
objects = QuerySet.as_manager()
|
2018-06-23 19:08:56 +00:00
|
|
|
|
|
|
|
class Meta:
|
2021-02-28 22:00:11 +00:00
|
|
|
verbose_name = _("membership")
|
|
|
|
verbose_name_plural = _("memberships")
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
user = models.ForeignKey("auth.User", on_delete=models.PROTECT)
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
membership_type = models.ForeignKey(
|
|
|
|
"membership.MembershipType",
|
2019-08-31 22:27:36 +00:00
|
|
|
related_name="memberships",
|
2018-06-23 19:08:56 +00:00
|
|
|
verbose_name=_("subscription type"),
|
|
|
|
on_delete=models.PROTECT,
|
|
|
|
)
|
|
|
|
|
2023-01-02 21:13:25 +00:00
|
|
|
period = models.ForeignKey(
|
|
|
|
"membership.SubscriptionPeriod", on_delete=models.PROTECT
|
|
|
|
)
|
2018-06-23 19:08:56 +00:00
|
|
|
|
2021-02-28 22:00:11 +00:00
|
|
|
def __str__(self):
|
|
|
|
return f"{self.user} - {self.period}"
|
|
|
|
|
|
|
|
|
|
|
|
class MembershipType(CreatedModifiedAbstract):
|
|
|
|
"""
|
|
|
|
Models membership types. Currently only a name, but will in the future
|
|
|
|
possibly contain more information like fees.
|
|
|
|
"""
|
2018-06-23 19:08:56 +00:00
|
|
|
|
|
|
|
class Meta:
|
2021-02-28 22:00:11 +00:00
|
|
|
verbose_name = _("membership type")
|
|
|
|
verbose_name_plural = _("membership types")
|
|
|
|
|
|
|
|
name = models.CharField(verbose_name=_("name"), max_length=64)
|
|
|
|
|
|
|
|
def __str__(self):
|
|
|
|
return self.name
|