3
0
Fork 0
mirror of https://github.com/nanoy42/coope synced 2024-12-27 01:13:47 +00:00
coope/gestion/models.py
2019-05-03 21:09:32 +02:00

447 lines
15 KiB
Python

from django.db import models
from django.contrib.auth.models import User
from simple_history.models import HistoricalRecords
from django.core.validators import MinValueValidator
from preferences.models import PaymentMethod
from django.core.exceptions import ValidationError
class Category(models.Model):
"""
A product category
"""
class Meta:
verbose_name="Catégorie"
name = models.CharField(max_length=100, verbose_name="Nom", unique=True)
order = models.IntegerField(default=0)
"""
The name of the category
"""
def __str__(self):
return self.name
@property
def active_products(self):
"""
Return active producs of this category
"""
return self.product_set.filter(is_active=True)
class Product(models.Model):
"""
Stores a product.
"""
class Meta:
verbose_name = "Produit"
name = models.CharField(max_length=40, verbose_name="Nom", unique=True)
"""
The name of the product.
"""
amount = models.DecimalField(max_digits=5, decimal_places=2, verbose_name="Prix de vente", validators=[MinValueValidator(0)])
"""
The price of the product.
"""
stockHold = models.IntegerField(default=0, verbose_name="Stock en soute")
"""
Number of product in the hold.
"""
stockBar = models.IntegerField(default=0, verbose_name="Stock en bar")
"""
Number of product at the bar.
"""
barcode = models.CharField(max_length=20, unique=True, verbose_name="Code barre")
"""
The barcode of the product.
"""
category = models.ForeignKey('Category', on_delete=models.PROTECT, verbose_name="Catégorie")
"""
The category of the product
"""
needQuantityButton = models.BooleanField(default=False, verbose_name="Bouton quantité")
"""
If True, a javascript quantity button will be displayed
"""
is_active = models.BooleanField(default=True, verbose_name="Actif")
"""
If True, will be displayed on the :func:`gestion.views.manage` view.
"""
volume = models.PositiveIntegerField(default=0)
"""
The volume, if relevant, of the product
"""
deg = models.DecimalField(default=0,max_digits=5, decimal_places=2, verbose_name="Degré", validators=[MinValueValidator(0)])
"""
Degree of alcohol, if relevant
"""
adherentRequired = models.BooleanField(default=True, verbose_name="Adhérent requis")
"""
If True, only adherents will be able to buy this product
"""
showingMultiplier = models.PositiveIntegerField(default=1)
"""
On the graphs on :func:`users.views.profile` view, the number of total consumptions is divised by the showingMultiplier
"""
history = HistoricalRecords()
def __str__(self):
return self.name
def user_ranking(self, pk):
"""
Return the user ranking for the product
"""
user = User.objects.get(pk=pk)
consumptions = Consumption.objects.filter(customer=user).filter(product=self)
if consumptions:
return (user, consumptions[0].quantity)
else:
return (user, 0)
@property
def ranking(self):
"""
Get the first 25 users with :func:`~gestion.models.user_ranking`
"""
users = User.objects.all()
ranking = [self.user_ranking(user.pk) for user in users]
ranking.sort(key=lambda x:x[1], reverse=True)
return ranking[0:25]
def isPinte(id):
product = Product.objects.get(id=id)
if product.category != Product.P_PRESSION:
raise ValidationError(
('%(product)s n\'est pas une pinte'),
params={'product': product},
)
def isDemi(id):
product = Product.objects.get(id=id)
if product.category != Product.D_PRESSION:
raise ValidationError(
('%(product)s n\'est pas un demi'),
params={'product': product},
)
def isGalopin(id):
product = Product.objects.get(id=id)
if product.category != Product.G_PRESSION:
raise ValidationError(
('%(product)s n\'est pas un galopin'),
params={'product': product},
)
class Keg(models.Model):
"""
Stores a keg.
"""
class Meta:
verbose_name = "Fût"
permissions = (
("open_keg", "Peut percuter les fûts"),
("close_keg", "Peut fermer les fûts")
)
name = models.CharField(max_length=20, unique=True, verbose_name="Nom")
"""
The name of the keg.
"""
stockHold = models.IntegerField(default=0, verbose_name="Stock en soute")
"""
The number of this keg in the hold.
"""
barcode = models.CharField(max_length=20, unique=True, verbose_name="Code barre")
"""
The barcode of the keg.
"""
amount = models.DecimalField(max_digits=7, decimal_places=2, verbose_name="Prix du fût", validators=[MinValueValidator(0)])
"""
The price of the keg.
"""
capacity = models.IntegerField(default=30, verbose_name="Capacité (L)")
"""
The capacity, in liters, of the keg.
"""
pinte = models.ForeignKey(Product, on_delete=models.PROTECT, related_name="futp", validators=[isPinte])
"""
The related :class:`~gestion.models.Product` for pint.
"""
demi = models.ForeignKey(Product, on_delete=models.PROTECT, related_name="futd", validators=[isDemi])
"""
The related :class:`~gestion.models.Product` for demi.
"""
galopin = models.ForeignKey(Product, on_delete=models.PROTECT, related_name="futg", validators=[isGalopin],null=True, blank=True)
"""
The related :class:`~gestion.models.Product` for galopin.
"""
is_active = models.BooleanField(default=False, verbose_name="Actif")
"""
If True, will be displayed on :func:`~gestion.views.manage` view
"""
history = HistoricalRecords()
def __str__(self):
return self.name
class KegHistory(models.Model):
"""
Stores a keg history, related to :class:`~gestion.models.Keg`.
"""
class Meta:
verbose_name = "Historique de fût"
keg = models.ForeignKey(Keg, on_delete=models.PROTECT, verbose_name="Fût")
"""
The :class:`~gestion.models.Keg` instance.
"""
openingDate = models.DateTimeField(auto_now_add=True, verbose_name="Date ouverture")
"""
The date when the keg was opened.
"""
quantitySold = models.DecimalField(decimal_places=2, max_digits=5, default=0, verbose_name="Quantité vendue")
"""
The quantity, in liters, sold.
"""
amountSold = models.DecimalField(decimal_places=2, max_digits=5, default=0, verbose_name="Somme vendue")
"""
The quantity, in euros, sold.
"""
closingDate = models.DateTimeField(null=True, blank=True, verbose_name="Date fermeture")
"""
The date when the keg was closed
"""
isCurrentKegHistory = models.BooleanField(default=True, verbose_name="Actuel")
"""
If True, it corresponds to the current Keg history of :class:`~gestion.models.Keg` instance.
"""
history = HistoricalRecords()
def __str__(self):
res = "Fût de " + str(self.keg) + " (" + str(self.openingDate) + " - "
if(self.closingDate):
res += str(self.closingDate) + ")"
else:
res += "?)"
return res
class Reload(models.Model):
"""
Stores reloads.
"""
class Meta:
verbose_name = "Rechargement"
customer = models.ForeignKey(User, on_delete=models.PROTECT, related_name="reload_taken", verbose_name="Client")
"""
Client (:class:`django.contrib.auth.models.User`).
"""
amount = models.DecimalField(max_digits=7, decimal_places=2, verbose_name="Montant", validators=[MinValueValidator(0)])
"""
Amount of the reload.
"""
PaymentMethod = models.ForeignKey(PaymentMethod, on_delete=models.PROTECT, verbose_name="Moyen de paiement")
"""
:class:`Payment Method <preferences.models.PaymentMethod>` of the reload.
"""
coopeman = models.ForeignKey(User, on_delete=models.PROTECT, related_name="reload_realized")
"""
Coopeman (:class:`django.contrib.auth.models.User`) who collected the reload.
"""
date = models.DateTimeField(auto_now_add=True)
"""
Date of the reload.
"""
history = HistoricalRecords()
def __str__(self):
return "Rechargement effectue par {0} le {1} ({2} euros, coopeman : {3})".format(self.customer, self.date, self.amount, self.coopeman)
class Refund(models.Model):
"""
Stores refunds.
"""
class Meta:
verbose_name = "Remboursement"
date = models.DateTimeField(auto_now_add=True)
"""
Date of the refund
"""
customer = models.ForeignKey(User, on_delete=models.PROTECT, related_name="refund_taken", verbose_name="Client")
"""
Client (:class:`django.contrib.auth.models.User`).
"""
amount = models.DecimalField(max_digits=7, decimal_places=2, verbose_name="Montant", validators=[MinValueValidator(0)])
"""
Amount of the refund.
"""
coopeman = models.ForeignKey(User, on_delete=models.PROTECT, related_name="refund_realized")
"""
Coopeman (:class:`django.contrib.auth.models.User`) who realized the refund.
"""
history = HistoricalRecords()
def __str__(self):
return "{0} remboursé de {1} le {2} (effectué par {3})".format(self.customer, self.amount, self.date, self.coopeman)
class Menu(models.Model):
"""
Stores menus.
"""
name = models.CharField(max_length=255, verbose_name="Nom")
"""
Name of the menu.
"""
amount = models.DecimalField(max_digits=7, decimal_places=2, verbose_name="Montant", validators=[MinValueValidator(0)])
"""
Price of the menu.
"""
barcode = models.CharField(max_length=20, unique=True, verbose_name="Code barre")
"""
Barcode of the menu.
"""
articles = models.ManyToManyField(Product, verbose_name="Produits")
"""
Stores :class:`Products <gestion.models.Product>` contained in the menu
"""
is_active = models.BooleanField(default=False, verbose_name="Actif")
"""
If True, the menu will be displayed on the :func:`gestion.views.manage` view
"""
history = HistoricalRecords()
def __str__(self):
return self.name
@property
def adherent_required(self):
"""
Test if the menu contains a restricted :class:`~gestion.models.Product`
"""
res = False
for article in self.articles.all():
res = res or article.adherentRequired
return res
class MenuHistory(models.Model):
"""
Stores MenuHistory related to :class:`~gestion.models.Menu`.
"""
class Meta:
verbose_name = "Historique de menu"
customer = models.ForeignKey(User, on_delete=models.PROTECT, related_name="menu_taken", verbose_name="Client")
quantity = models.PositiveIntegerField(default=0, verbose_name="Quantité")
"""
Client (:class:`django.contrib.auth.models.User`).
"""
paymentMethod = models.ForeignKey(PaymentMethod, on_delete=models.PROTECT, verbose_name="Moyen de paiement")
"""
:class:`Payment Method <preferences.models.PaymentMethod>` of the Menu purchased.
"""
date = models.DateTimeField(auto_now_add=True)
"""
Date of the purhcase.
"""
menu = models.ForeignKey(Menu, on_delete=models.PROTECT)
"""
:class:`gestion.models.Menu` purchased.
"""
amount = models.DecimalField(max_digits=7, decimal_places=2, default=0, verbose_name="Montant")
"""
Price of the purchase.
"""
coopeman = models.ForeignKey(User, on_delete=models.PROTECT, related_name="menu_selled")
"""
Coopeman (:class:django.contrib.auth.models.User`) who collected the money.
"""
history = HistoricalRecords()
def __str__(self):
return "{2} a consommé {0} {1}".format(self.quantity, self.menu, self.customer)
class ConsumptionHistory(models.Model):
"""
Stores consumption history related to Product
"""
class Meta:
verbose_name = "Consommation"
customer = models.ForeignKey(User, on_delete=models.PROTECT, related_name="consumption_taken", verbose_name="Client")
"""
Client (:class:`django.contrib.auth.models.User`).
"""
quantity = models.PositiveIntegerField(default=0, verbose_name="Quantité")
"""
Quantity of :attr:`gestion.models.ConsumptionHistory.product` taken.
"""
paymentMethod = models.ForeignKey(PaymentMethod, on_delete=models.PROTECT, verbose_name="Moyen de paiement")
"""
:class:`Payment Method <preferences.models.PaymentMethod>` of the product purchased.
"""
date = models.DateTimeField(auto_now_add=True)
"""
Date of the purhcase.
"""
product = models.ForeignKey(Product, on_delete=models.PROTECT, verbose_name="Produit")
"""
:class:`gestion.models.product` purchased.
"""
amount = models.DecimalField(max_digits=7, decimal_places=2, default=0, verbose_name="Montant")
"""
Price of the purchase.
"""
coopeman = models.ForeignKey(User, on_delete=models.PROTECT, related_name="consumption_selled")
"""
Coopeman (:class:django.contrib.auth.models.User`) who collected the money.
"""
history = HistoricalRecords()
def __str__(self):
return "{0} {1} consommé par {2} le {3} (encaissé par {4})".format(self.quantity, self.product, self.customer, self.date, self.coopeman)
class Consumption(models.Model):
"""
Stores total consumptions.
"""
class Meta:
verbose_name = "Consommation totale"
customer = models.ForeignKey(User, on_delete=models.PROTECT, related_name="consumption_global_taken", verbose_name="Client")
"""
Client (:class:`django.contrib.auth.models.User`).
"""
product = models.ForeignKey(Product, on_delete=models.PROTECT, verbose_name="Produit")
"""
A :class:`gestion.models.Product` instance.
"""
quantity = models.PositiveIntegerField(default=0, verbose_name="Quantité")
"""
The total number of :attr:`gestion.models.Consumption.product` consumed by the :attr:`gestion.models.Consumption.consumer`.
"""
history = HistoricalRecords()
def __str__(self):
return "Consommation de " + str(self.customer) + " concernant le produit " + str(self.product)
class Pinte(models.Model):
"""
Stores a physical pinte
"""
current_owner = models.ForeignKey(User, on_delete=models.PROTECT, null=True, default=None, related_name="pintes_owned_currently")
"""
The current owner (:class:`django.contrib.auth.models.User`).
"""
previous_owner = models.ForeignKey(User, on_delete=models.PROTECT, null=True, default=None, related_name="pintes_owned_previously")
"""
The previous owner (:class:`django.contrib.auth.models.User`).
"""
last_update_date = models.DateTimeField(auto_now=True)
"""
The last update date
"""
history = HistoricalRecords()