Dashboard cards: rebuild deployable dists

plugins/warranty/api/routes.py

@@ -5,7 +5,7 @@ never stored. Warranties link to assets many-to-many via warrantyassets, though
 the common case is one warranty per asset.
 """
 
-from datetime import date, datetime, timezone
+from datetime import date, datetime, timedelta, timezone
 
 from flask import Blueprint, request
 from flask_jwt_extended import jwt_required
@@ -391,3 +391,54 @@ def warranty_report():
         'counts': {k: len(v) for k, v in buckets.items()},
         'buckets': buckets,
     })
+
+
+@warranty_bp.route('/dashboard/expiring', methods=['GET'])
+@jwt_required()
+@require_permission('warranty.view')
+def dashboard_expiring():
+    """Warranties running out, and ones that already have.
+
+    Already-expired first, then soonest. Expired stays on the list rather than
+    dropping off: a machine out of warranty is a purchasing decision someone
+    still has to make, and silently removing it the day it lapses is how it gets
+    missed entirely.
+
+    Horizon is a setting because 90 days suits a site that budgets quarterly and
+    nobody else (ADR-015).
+    """
+    from shopdb.api import Setting
+
+    days = 90
+    setting = Setting.query.filter_by(key='warranty_expiringdays').first()
+    if setting and (setting.value or '').strip():
+        try:
+            days = int(setting.value)
+        except (TypeError, ValueError):
+            pass
+
+    today = date.today()
+    horizon = today + timedelta(days=days)
+
+    rows = []
+    query = (db.session.query(Warranty, WarrantyAsset, Asset)
+             .join(WarrantyAsset, WarrantyAsset.warrantyid == Warranty.warrantyid)
+             .join(Asset, Asset.assetid == WarrantyAsset.assetid)
+             .filter(Warranty.isactive.is_(True),
+                     Warranty.enddate.isnot(None),
+                     Warranty.enddate <= horizon,
+                     Asset.isactive.is_(True)))
+
+    for warranty, _link, asset in query.all():
+        remaining = (warranty.enddate - today).days
+        rows.append({
+            'assetid': asset.assetid,
+            'assetnumber': asset.assetnumber or asset.name or str(asset.assetid),
+            'enddate': warranty.enddate.isoformat(),
+            'provider': warranty.provider,
+            'daysleft': remaining,
+            'state': 'expired' if remaining < 0 else 'expiring',
+        })
+
+    rows.sort(key=lambda r: r['daysleft'])
+    return success_response(rows[:50])