Dev

apps/billing/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+
+
+class BillingConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.billing"
+
+    def ready(self):
+        # Importing tasks connects the task_failure signal handler defined there.
+        from apps.billing import tasks  # noqa: F401

apps/billing/constants.py

@@ -0,0 +1,34 @@
+from django.db import models
+
+
+class PlanCodeType:
+    # Plan code used as the default when provisioning a new organization.
+    FREE = "free"
+    PRO = "pro"
+
+
+class CurrencyType(models.TextChoices):
+    USD = "USD"
+    VND = "VND"
+
+
+class BillingCycle(models.TextChoices):
+    MONTHLY = "monthly"
+    YEARLY = "yearly"
+
+
+class FeatureValueType(models.TextChoices):
+    BOOLEAN = "boolean"
+    LIMIT = "limit"
+    QUOTA = "quota"
+
+
+class UsageType(models.TextChoices):
+    RESOURCE = "resource"
+    PERIOD = "period"
+
+
+BILLING_CYCLE_DAYS = {
+    BillingCycle.MONTHLY: 30,
+    BillingCycle.YEARLY: 365,
+}

apps/billing/migrations/0001_initial.py

@@ -0,0 +1,295 @@
+# Generated by Django 5.0.6 on 2026-07-08 08:19
+
+import django.core.validators
+import django.db.models.deletion
+import uuid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("organization", "0004_alter_organization_template"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="Feature",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                        unique=True,
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("code", models.CharField(max_length=128, unique=True)),
+                ("name", models.CharField(max_length=256)),
+                ("description", models.TextField(blank=True)),
+                (
+                    "value_type",
+                    models.CharField(
+                        choices=[
+                            ("boolean", "Boolean"),
+                            ("limit", "Limit"),
+                            ("quota", "Quota"),
+                        ],
+                        max_length=16,
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "features",
+            },
+        ),
+        migrations.CreateModel(
+            name="Plan",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                        unique=True,
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("name", models.CharField(max_length=256)),
+                ("code", models.CharField(max_length=64, unique=True)),
+                ("description", models.TextField(blank=True)),
+            ],
+            options={
+                "db_table": "plans",
+            },
+        ),
+        migrations.CreateModel(
+            name="PlanItem",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                        unique=True,
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "price",
+                    models.DecimalField(
+                        decimal_places=2,
+                        default=0,
+                        max_digits=10,
+                        validators=[django.core.validators.MinValueValidator(0)],
+                    ),
+                ),
+                ("icon", models.CharField(blank=True, default="", max_length=256)),
+                (
+                    "currency",
+                    models.CharField(
+                        choices=[("USD", "Usd"), ("VND", "Vnd")],
+                        default="USD",
+                        max_length=8,
+                    ),
+                ),
+                (
+                    "discount",
+                    models.IntegerField(
+                        default=0,
+                        validators=[
+                            django.core.validators.MinValueValidator(0),
+                            django.core.validators.MaxValueValidator(100),
+                        ],
+                    ),
+                ),
+                (
+                    "billing_cycle",
+                    models.CharField(
+                        choices=[("monthly", "Monthly"), ("yearly", "Yearly")],
+                        default="monthly",
+                        max_length=16,
+                    ),
+                ),
+                ("is_active", models.BooleanField(default=True)),
+                (
+                    "plan",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="plan_items",
+                        to="billing.plan",
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "plan_items",
+            },
+        ),
+        migrations.CreateModel(
+            name="PlanFeature",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                        unique=True,
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("enabled", models.BooleanField(default=True)),
+                (
+                    "limit_value",
+                    models.IntegerField(
+                        blank=True,
+                        null=True,
+                        validators=[django.core.validators.MinValueValidator(0)],
+                    ),
+                ),
+                ("metadata", models.JSONField(blank=True, default=dict)),
+                (
+                    "feature",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="plan_features",
+                        to="billing.feature",
+                    ),
+                ),
+                (
+                    "plan",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="plan_features",
+                        to="billing.plan",
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "plan_features",
+            },
+        ),
+        migrations.CreateModel(
+            name="Subscription",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                        unique=True,
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("period_start", models.DateTimeField()),
+                ("period_end", models.DateTimeField()),
+                (
+                    "organization",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="subscriptions",
+                        to="organization.organization",
+                    ),
+                ),
+                (
+                    "plan_item",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="subscriptions",
+                        to="billing.planitem",
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "subscriptions",
+            },
+        ),
+        migrations.CreateModel(
+            name="FeatureUsage",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                        unique=True,
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "usage_type",
+                    models.CharField(
+                        choices=[("resource", "Resource"), ("period", "Period")],
+                        max_length=16,
+                    ),
+                ),
+                (
+                    "used_value",
+                    models.BigIntegerField(
+                        default=0,
+                        validators=[django.core.validators.MinValueValidator(0)],
+                    ),
+                ),
+                ("billing_period", models.DateField()),
+                (
+                    "feature",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="feature_usages",
+                        to="billing.feature",
+                    ),
+                ),
+                (
+                    "subscription",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="feature_usages",
+                        to="billing.subscription",
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "feature_usages",
+            },
+        ),
+        migrations.AddConstraint(
+            model_name="planfeature",
+            constraint=models.UniqueConstraint(
+                fields=("plan", "feature"), name="unique_plan_feature"
+            ),
+        ),
+        migrations.AddConstraint(
+            model_name="planitem",
+            constraint=models.UniqueConstraint(
+                fields=("plan", "billing_cycle"), name="unique_plan_billing_cycle"
+            ),
+        ),
+        migrations.AddConstraint(
+            model_name="subscription",
+            constraint=models.CheckConstraint(
+                check=models.Q(("period_end__gt", models.F("period_start"))),
+                name="subscription_period_end_after_period_start",
+            ),
+        ),
+    ]