guidence

src/features/store-admin/pages/ConsolePage.tsx

@@ -21,11 +21,16 @@ import { KpiCard } from '@/components/KpiCard';
 import { PageHeader } from '@/components/PageHeader';
 import { SectionHeader } from '@/components/SectionHeader';
 import {
+  useLocationProducts,
   useLocationSummary,
+  useOwnTenant,
   usePosHealthByBranch,
   usePosSalesByBranch,
+  useStaff,
   useStockRequests,
+  useUploads,
 } from '@/queries/hooks';
+import { SetupChecklist } from '../SetupChecklist';
 import { useBranchScope } from '../BranchScope';
 import { DateRangePicker, presetRange, type RangePreset } from '../DateRangePicker';
 import { branchLabel, count, money, percent, share } from '../format';
@@ -68,6 +73,18 @@ export function ConsolePage() {
   const orders = useLocationSummary(tenantid || undefined);
   const posSales = usePosSalesByBranch(branchIds, range);
   const posHealth = usePosHealthByBranch(branchIds);
+  /* The checklist's data. All existing hooks — nothing new was needed on the
+     backend for it, which is most of why it is worth having. */
+  const shop = useOwnTenant(tenantid || undefined);
+  const people = useStaff(tenantid || undefined);
+  const products = useLocationProducts(tenantid || undefined, undefined, 0, { allBranches: true });
+  const uploads = useUploads(tenantid || undefined);
+  /* Drops the catalogue service has not released yet — the wait that makes
+     step 4 look stuck when it is simply not our turn. */
+  const pendingUploads = (uploads.data ?? []).filter(
+    (receipt) => receipt.laststatus === 'pending' && !receipt.runid,
+  ).length;
+
   const requests = useStockRequests(
     tenantid ? { tenantid, locationid: selected ?? undefined, status: 'Pending' } : undefined,
   );
@@ -150,6 +167,20 @@ export function ConsolePage() {
         }
       />
 
+      {/* Setup, before revenue — but only for the merchant, and only until they
+          are trading. A Store user cannot open a branch, hire anybody or edit
+          the shop profile, so the same card in their workspace would be a list
+          of things they must ask somebody else to do. */}
+      {!isPinned ? (
+        <SetupChecklist
+          shop={shop.data}
+          people={people.data ?? []}
+          branches={branches}
+          products={products.data ?? []}
+          pendingUploads={pendingUploads}
+        />
+      ) : null}
+
       {/* ── Revenue, by channel, never summed ──────────────────────────── */}
       <VStack gap={1.5}>
         <SectionHeader