Add a shop sales dashboard with 30-day charts (#8)

## Summary
- Closes #7
- Portal Retail **Sales** page: 30-day orders/revenue/units/AOV, daily charts, top products
- Home dashboard cards for 30-day shop sales and revenue when `FEATURE_SHOP` is on
- Stacks on #6 (shop catalog). Merge that first, then retarget `master` if needed.

## Test plan
- [ ] Sales page requires login; empty state with no paid orders
- [ ] Paid/fulfilled in the last 30 days counted; draft/open/cancelled/old excluded
- [ ] Top products ranked by units; home dashboard shows 30-day sales count
- [ ] `manage.py test shop core.tests_features`

Reviewed-on: #8

site/shop/tests.py

@@ -1,11 +1,13 @@
+from datetime import timedelta
 from decimal import Decimal
 
 from django.contrib.auth import get_user_model
 from django.core import mail
 from django.test import Client, TestCase, override_settings
 from django.urls import reverse
+from django.utils import timezone
 
-from shop.models import Order, Product
+from shop.models import Order, OrderItem, Product
 from shop.services import (
     ShopError,
     add_to_cart,
@@ -15,6 +17,7 @@ from shop.services import (
     mark_paid,
     next_order_number,
 )
+from shop.stats import sales_dashboard
 
 
 def _product(**kwargs):
@@ -145,3 +148,107 @@ class ShopPortalTests(TestCase):
         self.assertEqual(adjust.status_code, 302)
         product.refresh_from_db()
         self.assertEqual(product.stock_qty, 7)
+
+
+def _sold_order(product, *, qty=1, paid_at=None, status=None, number=None):
+    n = Order.objects.count() + 1
+    order = Order.objects.create(
+        number=number or f"ORD-TEST-{n:04d}",
+        email=f"buyer{n}@example.com",
+        customer_name="Pat",
+        status=status or Order.Status.PAID,
+        amount=product.price * qty,
+        currency="usd",
+        paid_at=paid_at if paid_at is not None else timezone.now(),
+    )
+    OrderItem.objects.create(
+        order=order,
+        product=product,
+        name=product.name,
+        sku=product.sku,
+        quantity=qty,
+        unit_price=product.price,
+    )
+    return order
+
+
+class ShopSalesDashboardTests(TestCase):
+    def setUp(self):
+        User = get_user_model()
+        self.user = User.objects.create_user("merchant", password="test-pass-123")
+        self.client = Client()
+        self.client.login(username="merchant", password="test-pass-123")
+        self.dragon = _product(name="Dragon", sku="DRAGON", price=Decimal("18.00"))
+        self.fox = _product(name="Fox", sku="FOX", price=Decimal("12.00"))
+
+    def test_sales_requires_login(self):
+        anon = Client()
+        self.assertEqual(anon.get(reverse("shop_portal:sales")).status_code, 302)
+
+    def test_empty_dashboard(self):
+        data = sales_dashboard()
+        self.assertEqual(data["order_count"], 0)
+        self.assertEqual(data["revenue"], Decimal("0.00"))
+        self.assertEqual(len(data["daily_sales"]), 30)
+        self.assertFalse(data["has_sales"])
+        response = self.client.get(reverse("shop_portal:sales"))
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, "No paid orders in this window")
+        self.assertContains(response, "Sales")
+        self.assertContains(response, "Orders per day")
+        self.assertContains(response, "Top products")
+
+    def test_counts_paid_and_fulfilled_in_window(self):
+        now = timezone.now()
+        _sold_order(self.dragon, qty=2, paid_at=now)
+        _sold_order(self.fox, qty=5, paid_at=now - timedelta(days=2))
+        _sold_order(
+            self.dragon,
+            qty=1,
+            paid_at=now - timedelta(days=1),
+            status=Order.Status.FULFILLED,
+        )
+        _sold_order(
+            self.fox,
+            qty=9,
+            paid_at=now - timedelta(days=40),
+        )
+        open_order = _sold_order(self.dragon, qty=3, paid_at=None, status=Order.Status.OPEN)
+        open_order.paid_at = None
+        open_order.save(update_fields=["paid_at"])
+        cancelled = _sold_order(
+            self.fox, qty=4, paid_at=now, status=Order.Status.CANCELLED
+        )
+        self.assertEqual(cancelled.status, Order.Status.CANCELLED)
+
+        data = sales_dashboard()
+        self.assertEqual(data["order_count"], 3)
+        self.assertEqual(data["units_sold"], 8)
+        self.assertEqual(data["revenue"], Decimal("114.00"))
+        self.assertEqual(data["aov"], Decimal("38.00"))
+        self.assertEqual([row["sku"] for row in data["top_products"]], ["FOX", "DRAGON"])
+        self.assertEqual(data["top_products"][0]["units"], 5)
+        self.assertEqual(data["top_products"][1]["units"], 3)
+        today_bar = data["daily_sales"][-1]
+        self.assertEqual(today_bar["count"], 1)
+
+        response = self.client.get(reverse("shop_portal:sales"))
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, "Dragon")
+        self.assertContains(response, "Fox")
+        self.assertContains(response, "114.00")
+        self.assertContains(response, "Orders per day")
+        self.assertContains(response, "Revenue per day")
+
+    def test_portal_nav_and_home_stats(self):
+        _sold_order(self.dragon, qty=1)
+        home = self.client.get(reverse("dashboard:home"))
+        self.assertEqual(home.status_code, 200)
+        self.assertEqual(home.context["shop_sales_30d"], 1)
+        self.assertEqual(home.context["shop_revenue_30d"], Decimal("18.00"))
+        self.assertContains(home, reverse("shop_portal:sales"))
+        self.assertContains(home, "Sales (30 days)")
+        products = self.client.get(reverse("shop_portal:product_list"))
+        self.assertContains(products, "Sales")
+        sales = self.client.get(reverse("shop_portal:sales"))
+        self.assertContains(sales, 'class="active"')