@7365admin1/layer-common 4.59.3 → 4.60.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @iservice365/layer-common
 
+## 4.60.0
+
+### Minor Changes
+
+- b43f89e: Dashboard: the Property Management and Security dashboards show a **Low Stock** tile (inventory items at or below their alert level) wherever their own inventory store serves the property; it can be hidden in Customize. Sites without a store are unchanged. Five tiles share one row.
+
 ## 4.59.3
 
 ### Patch Changes
@@ -1655,11 +1661,11 @@
   `utils/console-tier.ts` + `composables/useConsoleTier.ts` mirror the server's
   own rule from two endpoints the console already calls, unprojected:
 
-                                                                                                                                                                                                                                                                  GET /api/members/user/:user/app/admin    the Seven365 staff membership
-                                                                                                                                                                                                                                                                  GET /api/roles/id/:role                  that membership's role document
+                                                                                                                                                                                                                                                                    GET /api/members/user/:user/app/admin    the Seven365 staff membership
+                                                                                                                                                                                                                                                                    GET /api/roles/id/:role                  that membership's role document
 
-                                                                                                                                                                                                                                                                  owner  = member.type === "admin" && role.type === "admin" && role.default === true
-                                                                                                                                                                                                                                                                  staff  = member.type === "admin" && role.type === "admin"
+                                                                                                                                                                                                                                                                    owner  = member.type === "admin" && role.type === "admin" && role.default === true
+                                                                                                                                                                                                                                                                    staff  = member.type === "admin" && role.type === "admin"
 
   `role.default` is the marker because it is the only property of a platform
   staff role no API caller can set - `role.controller.ts` validates create and

package/components/DashboardMain.vue

@@ -1417,6 +1417,13 @@ const propertyWidgetPermissions: Record<string, string[]> = {
   workOrderStatus: WORK_ORDER_SEE_ALL,
   feedbacks: ["feedbacks:see-all-feedback"],
   activePatrol: ["virtual-patrol:see-all-virtual-patrol-logs"],
+  // Low Stock: shown only where the property's own inventory store serves the site.
+  supplyAlert: [
+    "inventory:view-inventory",
+    "inventory:request-stock",
+    "inventory:approve-requests",
+    "inventory:manage-inventory",
+  ],
 };
 
 const moduleWidgetPermissions: Record<string, string[]> = {
@@ -2039,6 +2046,7 @@ const propertyDefaultWidgetKeys = [
   "incidents",
   "visitors",
   "facilityBookings",
+  "supplyAlert",
   "activity",
   "upcomingEvents",
   "todayReminders",
@@ -2052,6 +2060,7 @@ const securityDefaultWidgetKeys = [
   "incidents",
   "visitors",
   "patrolCompliance",
+  "supplyAlert",
   "activity",
   "activePatrol",
   "staffStatus",
@@ -2136,6 +2145,11 @@ const customizeWidgets = computed(() => {
         title: "Facility Bookings",
         description: "View booking volume and approvals waiting for action.",
       },
+      {
+        key: "supplyAlert",
+        title: "Low Stock",
+        description: "Inventory items at or below their alert level (where your store serves this property).",
+      },
       {
         key: "activity",
         title: "This Week Activity (Line Chart)",
@@ -2193,6 +2207,11 @@ const customizeWidgets = computed(() => {
         title: "Patrol Compliance",
         description: "View missed checkpoints and ongoing patrols.",
       },
+      {
+        key: "supplyAlert",
+        title: "Low Stock",
+        description: "Inventory items at or below their alert level (where your store serves this property).",
+      },
       {
         key: "activity",
         title: "This Week Activity (Line Chart)",
@@ -2405,6 +2424,31 @@ function getPropertyKpiCards() {
       raw: facilityMetric,
       filter: undefined,
     },
+    ...inventoryLowStockCards(),
+  ];
+}
+
+/**
+ * The Low Stock tile on the Property and Security dashboards. The server sends
+ * `supplyAlert` (basis `below-alert-level`) only where this organisation's own
+ * inventory store serves the site, so a site without a store shows no tile.
+ */
+function inventoryLowStockCards() {
+  const metric = getMetric(["supplyAlert"]);
+  if ((metric as { basis?: string })?.basis !== "below-alert-level") return [];
+  return [
+    {
+      key: "supplyAlert",
+      title: "Low Stock",
+      icon: "mdi-package-variant",
+      color: KPI_TONES.info.color,
+      tint: KPI_TONES.info.tint,
+      value: "",
+      percentage: NaN,
+      meta: "",
+      raw: metric,
+      filter: undefined,
+    },
   ];
 }
 
@@ -2485,6 +2529,7 @@ function getSecurityKpiCards() {
       raw: patrolMetric,
       filter: undefined,
     },
+    ...inventoryLowStockCards(),
   ];
 }
 
@@ -2539,6 +2584,8 @@ const visibleKpiCards = computed(() =>
 // had been. Fewer tiles share the row instead.
 const kpiColLg = computed(() => {
   const shown = visibleKpiCards.value.length;
+  // Five tiles (Property / Security with Low Stock): equal widths on one row.
+  if (shown === 5) return true;
   return shown >= 4 || shown === 0 ? 3 : 12 / shown;
 });
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.59.3",
+  "version": "4.60.0",
   "author": "7365admin1",
   "main": "./nuxt.config.ts",
   "//files": "What a consumer extending this layer actually loads. Without this npm ships the whole working tree - the changesets, the CI workflows, the render harness in tools/ and any scratch directory that happened to exist at publish time. Nuxt resolves a layer by directory, so every runtime directory below has to stay listed; adding a new top-level runtime directory means adding it here too.",