re2o/deposits/models.py

# -*- mode: python; coding: utf-8 -*-
# Re2o est un logiciel d'administration développé initiallement au Rézo Metz. Il
# se veut agnostique au réseau considéré, de manière à être installable en
# quelques clics.
#
# Copyright © 2019  Arthur Grisel-Davy
# Copyright © 2020  Gabriel Détraz
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
"""
Deposit model
"""

from __future__ import absolute_import

from django.db import models
from django.utils.translation import ugettext_lazy as _

from re2o.mixins import AclMixin, RevMixin


class Deposit(RevMixin, AclMixin, models.Model):
    """
    The model for a deposit. It reprensents the fact that a user made a deposit
    as a guarantee for an item which should be returned to get the deposit
    back.

    A deposit is linked to :
        * a user (the one who made the deposit)
        * an item (borrowed in exchange for the deposit)
    Every deposit is dated throught the 'date' value.
    A deposit has a 'returned' value (default: False) which means that the item
    was returned by the user and the deposit was payed back. The
    'returned_date' attribute stores when the item was returned.
    """

    user = models.ForeignKey("users.User", on_delete=models.PROTECT)
    item = models.ForeignKey("DepositItem", on_delete=models.PROTECT)
    date = models.DateTimeField(auto_now_add=True, verbose_name=_("date"))
    returned = models.BooleanField(default=False, verbose_name=_("returned"))
    return_date = models.DateTimeField(default=None, null=True, verbose_name=_("return date"))

    class Meta:
        abstract = False
        verbose_name = _("deposit")
        verbose_name_plural = _("deposits")

    def __str__(self):
        if self.returned:
            return _(
                "Deposit from {name} for {item} at {date}, returned at {return_date}"
            ).format(
                name=self.user.get_full_name(),
                item=self.item,
                date=self.date,
                return_date=self.return_date,
            )
        else:
            return _(
                "Deposit from {name} for {item} at {date}, not yet returned"
            ).format(
                name=self.user.get_full_name(),
                item=self.item,
                date=self.date,
            )

    def can_view(self, user_request, *_args, **_kwargs):
        """Check that the user has the right to view the deposit or that it
        belongs to them."""
        if (
            not user_request.has_perm("deposits.view_deposit")
            and self.user != user_request
        ):
            return (
                False,
                _("You don't have the right to view other deposits than yours."),
                ("deposits.view_deposit",),
            )
        else:
            return True, None, None

    @staticmethod
    def can_view_all(user_request, *_args, **_kwargs):
        """Check that the user has access to the list of all tickets."""
        can = user_request.has_perm("deposits.view_deposit")
        return (
            can,
            _("You don't have the right to view the list of deposits.")
            if not can
            else None,
            ("deposits.view_deposit",),
        )


class DepositItem(RevMixin, AclMixin, models.Model):
    """An item for a deposit.

    Attributes:
        name: the name of this deposit item.
        deposit_amount: the amount needed to be deposited by users.
    """

    name = models.CharField(
        max_length=255,
        blank=False,
        null=False,
        unique=True,
        verbose_name=_("designation"),
    )
    deposit_amount = models.DecimalField(
        max_digits=5, decimal_places=2, verbose_name=_("deposit amount")
    )

    class Meta:
        verbose_name = "deposit item"
        verbose_name_plural = "deposit items"

    def __str__(self):
        return _("Deposit item {name}").format(name=self.name)