initial commit

app/apps/transactions/models.py

@@ -0,0 +1,81 @@
+from django.core.exceptions import ValidationError
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+
+from apps.common.functions.decimals import truncate_decimal
+from apps.transactions.fields import MonthYearField
+from apps.transactions.validators import validate_decimal_places, validate_non_negative
+
+
+class TransactionCategory(models.Model):
+    name = models.CharField(max_length=255, verbose_name=_("Name"))
+    mute = models.BooleanField(default=False, verbose_name=_("Mute"))
+
+    class Meta:
+        verbose_name = _("Transaction Category")
+        verbose_name_plural = _("Transaction Categories")
+        db_table = "t_categories"
+
+    def __str__(self):
+        return self.name
+
+
+class TransactionTag(models.Model):
+    name = models.CharField(max_length=255, verbose_name=_("Name"))
+
+    class Meta:
+        verbose_name = _("Transaction Tags")
+        verbose_name_plural = _("Transaction Tags")
+        db_table = "tags"
+
+    def __str__(self):
+        return self.name
+
+
+class Transaction(models.Model):
+    class Type(models.TextChoices):
+        INCOME = "IN", _("Income")
+        EXPENSE = "EX", _("Expense")
+
+    account = models.ForeignKey(
+        "accounts.Account", on_delete=models.CASCADE, verbose_name=_("Account")
+    )
+    type = models.CharField(
+        max_length=2,
+        choices=Type,
+        default=Type.EXPENSE,
+        verbose_name=_("Type"),
+    )
+    is_paid = models.BooleanField(default=True, verbose_name=_("Paid"))
+    date = models.DateField(verbose_name=_("Date"))
+    reference_date = MonthYearField(verbose_name=_("Reference Date"))
+
+    amount = models.DecimalField(
+        max_digits=42,
+        decimal_places=30,
+        verbose_name=_("Amount"),
+        validators=[validate_non_negative, validate_decimal_places],
+    )
+
+    description = models.CharField(max_length=500, verbose_name=_("Description"))
+    notes = models.TextField(blank=True, verbose_name=_("Notes"))
+    category = models.ForeignKey(
+        TransactionCategory,
+        on_delete=models.CASCADE,
+        verbose_name=_("Category"),
+        blank=True,
+        null=True,
+    )
+    tags = models.ManyToManyField(TransactionTag, verbose_name=_("Tags"), blank=True)
+
+    class Meta:
+        verbose_name = _("Transaction")
+        verbose_name_plural = _("Transactions")
+        db_table = "transactions"
+
+    def save(self, *args, **kwargs):
+        self.amount = truncate_decimal(
+            value=self.amount, decimal_places=self.account.currency.decimal_places
+        )
+        self.full_clean()
+        super().save(*args, **kwargs)