Add shop, POS sync, event ticketing, and shipping catalog apps (#6)

## Summary - Closes #5 - Optional `shop`, `pos_sync`, `events`, and `shipping` apps gated by `FEATURE_*` flags - Deps match the catalog: shop/events need email + Stripe; POS/shipping need shop - Portal inventory, POS webhooks, capacity tickets, EasyPost/Pirate Ship shipping ## Test plan - [ ] `manage.py test` (152 passed locally) - [ ] Shop cart + paid order decrements stocked inventory - [ ] POS inbound webhook decrements SKU; paid order queues outbound reserve - [ ] Event capacity blocks overbook; paid order emails ticket codes - [ ] Shipping stub label + Pirate Ship CSV of unshipped paid orders - [ ] `validate-env.sh` rejects shop without email/payments, POS/shipping without shop Reviewed-on: #6
2026-09-06 14:00:22 -07:00
parent 97b8607bf2
commit 9cdce7a897
82 changed files with 3908 additions and 1 deletions
@@ -0,0 +1,61 @@
+from django.db import models
+
+from core.models import TimeStampedModel, UUIDPrimaryKeyModel
+
+
+class POSConnection(UUIDPrimaryKeyModel, TimeStampedModel):
+    class Provider(models.TextChoices):
+        GENERIC = "generic", "Generic REST"
+        SQUARE = "square", "Square"
+        LIGHTSPEED = "lightspeed", "Lightspeed"
+        BINDERPOS = "binderpos", "BinderPOS"
+        CRYSTALCOMMERCE = "crystalcommerce", "CrystalCommerce"
+
+    name = models.CharField(max_length=120)
+    provider = models.CharField(
+        max_length=32, choices=Provider.choices, default=Provider.GENERIC
+    )
+    api_base_url = models.URLField(blank=True)
+    api_token = models.CharField(max_length=255, blank=True)
+    webhook_secret = models.CharField(max_length=255, blank=True)
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        ordering = ["name"]
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class SyncEvent(UUIDPrimaryKeyModel, TimeStampedModel):
+    class Direction(models.TextChoices):
+        INBOUND = "inbound", "POS → site"
+        OUTBOUND = "outbound", "Site → POS"
+
+    class Status(models.TextChoices):
+        PENDING = "pending", "Pending"
+        DONE = "done", "Done"
+        FAILED = "failed", "Failed"
+
+    connection = models.ForeignKey(
+        POSConnection,
+        null=True,
+        blank=True,
+        on_delete=models.SET_NULL,
+        related_name="events",
+    )
+    direction = models.CharField(max_length=16, choices=Direction.choices)
+    status = models.CharField(
+        max_length=16, choices=Status.choices, default=Status.PENDING
+    )
+    sku = models.CharField(max_length=64)
+    quantity = models.IntegerField(default=0)
+    external_id = models.CharField(max_length=255, blank=True)
+    payload = models.JSONField(default=dict, blank=True)
+    error = models.TextField(blank=True)
+
+    class Meta:
+        ordering = ["-created_at"]
+
+    def __str__(self) -> str:
+        return f"{self.direction} {self.sku} × {self.quantity} · {self.status}"