From 246f17113f07f49c4b575c4ced9b0402f644a67a Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Wed, 13 Nov 2024 06:49:48 +1100
Subject: [PATCH] Fix for locate item plugins (#8473)

* A hook for caching active plugins

* Add LocateItemButton

* Implement "locate" button for location detail page too

* Fix for StockApiMixin.get_serializer

- Recent refactoring removed 'path_detail' attribute

* Fix offloading of 'locate'

* Remove debug msg

* Add custom message

* Remove force_async call

* Add playwright tests
---
 .../InvenTree/plugin/base/locate/api.py       |  6 +-
 src/backend/InvenTree/plugin/registry.py      |  4 +-
 .../integration/test_scheduled_task.py        |  6 +-
 src/backend/InvenTree/stock/api.py            |  1 +
 .../src/components/buttons/AdminButton.tsx    | 11 +--
 .../src/components/items/ActionDropdown.tsx   |  1 -
 .../components/plugins/LocateItemButton.tsx   | 94 +++++++++++++++++++
 src/frontend/src/enums/ApiEndpoints.tsx       |  3 +
 src/frontend/src/hooks/UsePlugins.tsx         | 45 +++++++++
 src/frontend/src/pages/build/BuildDetail.tsx  |  2 +-
 .../src/pages/company/CompanyDetail.tsx       |  2 +-
 .../pages/company/ManufacturerPartDetail.tsx  |  2 +-
 .../src/pages/company/SupplierPartDetail.tsx  |  2 +-
 .../src/pages/part/CategoryDetail.tsx         |  2 +-
 src/frontend/src/pages/part/PartDetail.tsx    |  2 +-
 .../pages/purchasing/PurchaseOrderDetail.tsx  |  2 +-
 .../src/pages/sales/ReturnOrderDetail.tsx     |  2 +-
 .../src/pages/sales/SalesOrderDetail.tsx      |  2 +-
 .../src/pages/stock/LocationDetail.tsx        |  4 +-
 src/frontend/src/pages/stock/StockDetail.tsx  |  4 +-
 .../src/tables/settings/GroupTable.tsx        |  2 +-
 src/frontend/tests/pui_plugins.spec.ts        | 32 +++++++
 22 files changed, 204 insertions(+), 27 deletions(-)
 create mode 100644 src/frontend/src/components/plugins/LocateItemButton.tsx
 create mode 100644 src/frontend/src/hooks/UsePlugins.tsx

diff --git a/src/backend/InvenTree/plugin/base/locate/api.py b/src/backend/InvenTree/plugin/base/locate/api.py
index 86962d543d..8d6414ae55 100644
--- a/src/backend/InvenTree/plugin/base/locate/api.py
+++ b/src/backend/InvenTree/plugin/base/locate/api.py
@@ -6,7 +6,7 @@ from rest_framework.generics import GenericAPIView
 from rest_framework.response import Response
 
 from InvenTree.tasks import offload_task
-from plugin.registry import registry
+from plugin.registry import call_plugin_function, registry
 from stock.models import StockItem, StockLocation
 
 
@@ -59,7 +59,7 @@ class LocatePluginView(GenericAPIView):
                 StockItem.objects.get(pk=item_pk)
 
                 offload_task(
-                    registry.call_plugin_function,
+                    call_plugin_function,
                     plugin,
                     'locate_stock_item',
                     item_pk,
@@ -78,7 +78,7 @@ class LocatePluginView(GenericAPIView):
                 StockLocation.objects.get(pk=location_pk)
 
                 offload_task(
-                    registry.call_plugin_function,
+                    call_plugin_function,
                     plugin,
                     'locate_stock_location',
                     location_pk,
diff --git a/src/backend/InvenTree/plugin/registry.py b/src/backend/InvenTree/plugin/registry.py
index 0cfc287d0f..68b77da66f 100644
--- a/src/backend/InvenTree/plugin/registry.py
+++ b/src/backend/InvenTree/plugin/registry.py
@@ -159,7 +159,7 @@ class PluginsRegistry:
         # Update the registry hash value
         self.update_plugin_hash()
 
-    def call_plugin_function(self, slug, func, *args, **kwargs):
+    def call_plugin_function(self, slug: str, func: str, *args, **kwargs):
         """Call a member function (named by 'func') of the plugin named by 'slug'.
 
         As this is intended to be run by the background worker,
@@ -807,7 +807,7 @@ class PluginsRegistry:
 registry: PluginsRegistry = PluginsRegistry()
 
 
-def call_function(plugin_name, function_name, *args, **kwargs):
+def call_plugin_function(plugin_name: str, function_name: str, *args, **kwargs):
     """Global helper function to call a specific member function of a plugin."""
     return registry.call_plugin_function(plugin_name, function_name, *args, **kwargs)
 
diff --git a/src/backend/InvenTree/plugin/samples/integration/test_scheduled_task.py b/src/backend/InvenTree/plugin/samples/integration/test_scheduled_task.py
index ae2b173424..b2426a4e06 100644
--- a/src/backend/InvenTree/plugin/samples/integration/test_scheduled_task.py
+++ b/src/backend/InvenTree/plugin/samples/integration/test_scheduled_task.py
@@ -5,7 +5,7 @@ from django.test import TestCase
 from plugin import InvenTreePlugin, registry
 from plugin.helpers import MixinImplementationError
 from plugin.mixins import ScheduleMixin
-from plugin.registry import call_function
+from plugin.registry import call_plugin_function
 
 
 class ExampleScheduledTaskPluginTests(TestCase):
@@ -67,10 +67,10 @@ class ExampleScheduledTaskPluginTests(TestCase):
     def test_calling(self):
         """Check if a function can be called without errors."""
         # Check with right parameters
-        self.assertEqual(call_function('schedule', 'member_func'), False)
+        self.assertEqual(call_plugin_function('schedule', 'member_func'), False)
 
         # Check with wrong key
-        self.assertEqual(call_function('does_not_exist', 'member_func'), None)
+        self.assertEqual(call_plugin_function('does_not_exist', 'member_func'), None)
 
 
 class ScheduledTaskPluginTests(TestCase):
diff --git a/src/backend/InvenTree/stock/api.py b/src/backend/InvenTree/stock/api.py
index 62c18c3ff5..0e25e47c11 100644
--- a/src/backend/InvenTree/stock/api.py
+++ b/src/backend/InvenTree/stock/api.py
@@ -880,6 +880,7 @@ class StockApiMixin:
 
             for key in [
                 'part_detail',
+                'path_detail',
                 'location_detail',
                 'supplier_part_detail',
                 'tests',
diff --git a/src/frontend/src/components/buttons/AdminButton.tsx b/src/frontend/src/components/buttons/AdminButton.tsx
index 0bd5093077..27a7977f96 100644
--- a/src/frontend/src/components/buttons/AdminButton.tsx
+++ b/src/frontend/src/components/buttons/AdminButton.tsx
@@ -11,7 +11,7 @@ import { ActionButton } from './ActionButton';
 
 export type AdminButtonProps = {
   model: ModelType;
-  pk: number | undefined;
+  id: number | undefined;
 };
 
 /*
@@ -46,12 +46,12 @@ export default function AdminButton(props: Readonly<AdminButtonProps>) {
     }
 
     // No primary key provided
-    if (!props.pk) {
+    if (!props.id) {
       return false;
     }
 
     return true;
-  }, [user, props.model, props.pk]);
+  }, [user, props.model, props.id]);
 
   const openAdmin = useCallback(
     (event: any) => {
@@ -63,7 +63,7 @@ export default function AdminButton(props: Readonly<AdminButtonProps>) {
       }
 
       // Generate the URL for the admin interface
-      const url = `${host}/${server.server.django_admin}${modelDef.admin_url}${props.pk}/`;
+      const url = `${host}/${server.server.django_admin}${modelDef.admin_url}${props.id}/`;
 
       if (event?.ctrlKey || event?.shiftKey) {
         // Open the link in a new tab
@@ -72,7 +72,7 @@ export default function AdminButton(props: Readonly<AdminButtonProps>) {
         window.open(url, '_self');
       }
     },
-    [props.model, props.pk]
+    [props.model, props.id]
   );
 
   return (
@@ -80,7 +80,6 @@ export default function AdminButton(props: Readonly<AdminButtonProps>) {
       icon={<IconUserStar />}
       color='blue'
       size='lg'
-      radius='sm'
       variant='filled'
       tooltip={t`Open in admin interface`}
       hidden={!enabled}
diff --git a/src/frontend/src/components/items/ActionDropdown.tsx b/src/frontend/src/components/items/ActionDropdown.tsx
index 81dad21e06..ad098e91f0 100644
--- a/src/frontend/src/components/items/ActionDropdown.tsx
+++ b/src/frontend/src/components/items/ActionDropdown.tsx
@@ -72,7 +72,6 @@ export function ActionDropdown({
         <Menu.Target>
           <Tooltip label={tooltip} hidden={!tooltip} position='bottom'>
             <Button
-              radius='sm'
               variant={noindicator ? 'transparent' : 'light'}
               disabled={disabled}
               aria-label={menuName}
diff --git a/src/frontend/src/components/plugins/LocateItemButton.tsx b/src/frontend/src/components/plugins/LocateItemButton.tsx
new file mode 100644
index 0000000000..0bcaea9327
--- /dev/null
+++ b/src/frontend/src/components/plugins/LocateItemButton.tsx
@@ -0,0 +1,94 @@
+import { t } from '@lingui/macro';
+import { IconRadar } from '@tabler/icons-react';
+import { useEffect, useMemo, useState } from 'react';
+import { ApiEndpoints } from '../../enums/ApiEndpoints';
+import { useCreateApiFormModal } from '../../hooks/UseForm';
+import { usePluginsWithMixin } from '../../hooks/UsePlugins';
+import { apiUrl } from '../../states/ApiState';
+import { ActionButton } from '../buttons/ActionButton';
+import type { ApiFormFieldSet } from '../forms/fields/ApiFormField';
+import type { PluginInterface } from './PluginInterface';
+
+export default function LocateItemButton({
+  stockId,
+  locationId
+}: {
+  stockId?: number;
+  locationId?: number;
+}) {
+  const locatePlugins = usePluginsWithMixin('locate');
+
+  const [selectedPlugin, setSelectedPlugin] = useState<string | undefined>(
+    undefined
+  );
+
+  useEffect(() => {
+    // Ensure that the selected plugin is in the list of available plugins
+    if (selectedPlugin && locatePlugins) {
+      const plugin = locatePlugins.find(
+        (plugin: PluginInterface) => plugin.key === selectedPlugin
+      );
+      if (!plugin) {
+        setSelectedPlugin(undefined);
+      }
+    } else {
+      setSelectedPlugin(locatePlugins[0]?.key ?? undefined);
+    }
+  }, [selectedPlugin, locatePlugins]);
+
+  const locateFields: ApiFormFieldSet = useMemo(() => {
+    return {
+      plugin: {
+        field_type: 'choice',
+        value: selectedPlugin,
+        onValueChange: (value: string) => {
+          setSelectedPlugin(value);
+        },
+        choices: locatePlugins.map((plugin: PluginInterface) => {
+          return {
+            value: plugin.key,
+            display_name: plugin.meta?.human_name ?? plugin.name
+          };
+        })
+      },
+      item: {
+        hidden: true,
+        value: stockId
+      },
+      location: {
+        hidden: true,
+        value: locationId
+      }
+    };
+  }, [stockId, locationId, locatePlugins]);
+
+  const locateForm = useCreateApiFormModal({
+    url: apiUrl(ApiEndpoints.plugin_locate_item),
+    method: 'POST',
+    title: t`Locate Item`,
+    fields: locateFields,
+    successMessage: t`Item location requested`
+  });
+
+  if (!locatePlugins || locatePlugins.length === 0) {
+    return null;
+  }
+
+  if (!stockId && !locationId) {
+    return null;
+  }
+
+  return (
+    <>
+      {locateForm.modal}
+      <ActionButton
+        icon={<IconRadar />}
+        variant='outline'
+        size='lg'
+        tooltip={t`Locate Item`}
+        onClick={locateForm.open}
+        tooltipAlignment='bottom'
+      />
+    </>
+  );
+}
diff --git a/src/frontend/src/enums/ApiEndpoints.tsx b/src/frontend/src/enums/ApiEndpoints.tsx
index b9cba5e779..a630e908dd 100644
--- a/src/frontend/src/enums/ApiEndpoints.tsx
+++ b/src/frontend/src/enums/ApiEndpoints.tsx
@@ -203,6 +203,9 @@ export enum ApiEndpoints {
   // User interface plugin endpoints
   plugin_ui_features_list = 'plugins/ui/features/:feature_type/',
 
+  // Special plugin endpoints
+  plugin_locate_item = 'locate/',
+
   // Machine API endpoints
   machine_types_list = 'machine/types/',
   machine_driver_list = 'machine/drivers/',
diff --git a/src/frontend/src/hooks/UsePlugins.tsx b/src/frontend/src/hooks/UsePlugins.tsx
new file mode 100644
index 0000000000..c5d8141933
--- /dev/null
+++ b/src/frontend/src/hooks/UsePlugins.tsx
@@ -0,0 +1,45 @@
+import { useCallback } from 'react';
+import type { PluginInterface } from '../components/plugins/PluginInterface';
+import { ApiEndpoints } from '../enums/ApiEndpoints';
+import { useInstance } from './UseInstance';
+
+export interface UsePluginResult {
+  plugins: PluginInterface[];
+  withMixin: (mixin: string) => PluginInterface[];
+}
+
+/**
+ * Hook for storing information on active plugins
+ */
+export const usePlugins = (): UsePluginResult => {
+  const pluginQuery = useInstance({
+    endpoint: ApiEndpoints.plugin_list,
+    defaultValue: [],
+    hasPrimaryKey: false,
+    refetchOnMount: true,
+    refetchOnWindowFocus: false,
+    params: {
+      active: true
+    }
+  });
+
+  const pluginsWithMixin = useCallback(
+    (mixin: string) => {
+      return pluginQuery.instance.filter((plugin: PluginInterface) => {
+        return !!plugin.mixins[mixin];
+      });
+    },
+    [pluginQuery.instance]
+  );
+
+  return {
+    plugins: pluginQuery.instance,
+    withMixin: pluginsWithMixin
+  };
+};
+
+export const usePluginsWithMixin = (mixin: string): PluginInterface[] => {
+  const plugins = usePlugins();
+
+  return plugins.withMixin(mixin);
+};
diff --git a/src/frontend/src/pages/build/BuildDetail.tsx b/src/frontend/src/pages/build/BuildDetail.tsx
index 1324fea172..8b80d43b07 100644
--- a/src/frontend/src/pages/build/BuildDetail.tsx
+++ b/src/frontend/src/pages/build/BuildDetail.tsx
@@ -466,7 +466,7 @@ export default function BuildDetail() {
         color='green'
         onClick={completeOrder.open}
       />,
-      <AdminButton model={ModelType.build} pk={build.pk} />,
+      <AdminButton model={ModelType.build} id={build.pk} />,
       <BarcodeActionDropdown
         model={ModelType.build}
         pk={build.pk}
diff --git a/src/frontend/src/pages/company/CompanyDetail.tsx b/src/frontend/src/pages/company/CompanyDetail.tsx
index 48217a920a..5cebb7a1e8 100644
--- a/src/frontend/src/pages/company/CompanyDetail.tsx
+++ b/src/frontend/src/pages/company/CompanyDetail.tsx
@@ -287,7 +287,7 @@ export default function CompanyDetail(props: Readonly<CompanyDetailProps>) {
 
   const companyActions = useMemo(() => {
     return [
-      <AdminButton model={ModelType.company} pk={company.pk} />,
+      <AdminButton model={ModelType.company} id={company.pk} />,
       <OptionsActionDropdown
         tooltip={t`Company Actions`}
         actions={[
diff --git a/src/frontend/src/pages/company/ManufacturerPartDetail.tsx b/src/frontend/src/pages/company/ManufacturerPartDetail.tsx
index 82c5ad5c9f..c68136fe01 100644
--- a/src/frontend/src/pages/company/ManufacturerPartDetail.tsx
+++ b/src/frontend/src/pages/company/ManufacturerPartDetail.tsx
@@ -234,7 +234,7 @@ export default function ManufacturerPartDetail() {
       <AdminButton
         key='admin'
         model={ModelType.manufacturerpart}
-        pk={manufacturerPart.pk}
+        id={manufacturerPart.pk}
       />,
       <OptionsActionDropdown
         key='options'
diff --git a/src/frontend/src/pages/company/SupplierPartDetail.tsx b/src/frontend/src/pages/company/SupplierPartDetail.tsx
index 8dab3c9e88..9d95f3a8f1 100644
--- a/src/frontend/src/pages/company/SupplierPartDetail.tsx
+++ b/src/frontend/src/pages/company/SupplierPartDetail.tsx
@@ -276,7 +276,7 @@ export default function SupplierPartDetail() {
 
   const supplierPartActions = useMemo(() => {
     return [
-      <AdminButton model={ModelType.supplierpart} pk={supplierPart.pk} />,
+      <AdminButton model={ModelType.supplierpart} id={supplierPart.pk} />,
       <BarcodeActionDropdown
         model={ModelType.supplierpart}
         pk={supplierPart.pk}
diff --git a/src/frontend/src/pages/part/CategoryDetail.tsx b/src/frontend/src/pages/part/CategoryDetail.tsx
index 247c197f3d..83fd0ce3bc 100644
--- a/src/frontend/src/pages/part/CategoryDetail.tsx
+++ b/src/frontend/src/pages/part/CategoryDetail.tsx
@@ -223,7 +223,7 @@ export default function CategoryDetail() {
       <AdminButton
         key='admin'
         model={ModelType.partcategory}
-        pk={category.pk}
+        id={category.pk}
       />,
       <OptionsActionDropdown
         key='category-actions'
diff --git a/src/frontend/src/pages/part/PartDetail.tsx b/src/frontend/src/pages/part/PartDetail.tsx
index 7b02ccf8e5..f0186ae375 100644
--- a/src/frontend/src/pages/part/PartDetail.tsx
+++ b/src/frontend/src/pages/part/PartDetail.tsx
@@ -996,7 +996,7 @@ export default function PartDetail() {
 
   const partActions = useMemo(() => {
     return [
-      <AdminButton model={ModelType.part} pk={part.pk} />,
+      <AdminButton model={ModelType.part} id={part.pk} />,
       <BarcodeActionDropdown
         model={ModelType.part}
         pk={part.pk}
diff --git a/src/frontend/src/pages/purchasing/PurchaseOrderDetail.tsx b/src/frontend/src/pages/purchasing/PurchaseOrderDetail.tsx
index 7591bccdf6..74b0727346 100644
--- a/src/frontend/src/pages/purchasing/PurchaseOrderDetail.tsx
+++ b/src/frontend/src/pages/purchasing/PurchaseOrderDetail.tsx
@@ -413,7 +413,7 @@ export default function PurchaseOrderDetail() {
         color='green'
         onClick={completeOrder.open}
       />,
-      <AdminButton model={ModelType.purchaseorder} pk={order.pk} />,
+      <AdminButton model={ModelType.purchaseorder} id={order.pk} />,
       <BarcodeActionDropdown
         model={ModelType.purchaseorder}
         pk={order.pk}
diff --git a/src/frontend/src/pages/sales/ReturnOrderDetail.tsx b/src/frontend/src/pages/sales/ReturnOrderDetail.tsx
index e13738e15f..bd68d5d3e9 100644
--- a/src/frontend/src/pages/sales/ReturnOrderDetail.tsx
+++ b/src/frontend/src/pages/sales/ReturnOrderDetail.tsx
@@ -412,7 +412,7 @@ export default function ReturnOrderDetail() {
         color='green'
         onClick={() => completeOrder.open()}
       />,
-      <AdminButton model={ModelType.returnorder} pk={order.pk} />,
+      <AdminButton model={ModelType.returnorder} id={order.pk} />,
       <BarcodeActionDropdown
         model={ModelType.returnorder}
         pk={order.pk}
diff --git a/src/frontend/src/pages/sales/SalesOrderDetail.tsx b/src/frontend/src/pages/sales/SalesOrderDetail.tsx
index 7a7426a6fe..a5503311f4 100644
--- a/src/frontend/src/pages/sales/SalesOrderDetail.tsx
+++ b/src/frontend/src/pages/sales/SalesOrderDetail.tsx
@@ -453,7 +453,7 @@ export default function SalesOrderDetail() {
         color='green'
         onClick={completeOrder.open}
       />,
-      <AdminButton model={ModelType.salesorder} pk={order.pk} />,
+      <AdminButton model={ModelType.salesorder} id={order.pk} />,
       <BarcodeActionDropdown
         model={ModelType.salesorder}
         pk={order.pk}
diff --git a/src/frontend/src/pages/stock/LocationDetail.tsx b/src/frontend/src/pages/stock/LocationDetail.tsx
index f9f9e6c4fa..9aaf256c2a 100644
--- a/src/frontend/src/pages/stock/LocationDetail.tsx
+++ b/src/frontend/src/pages/stock/LocationDetail.tsx
@@ -25,6 +25,7 @@ import NavigationTree from '../../components/nav/NavigationTree';
 import { PageDetail } from '../../components/nav/PageDetail';
 import type { PanelType } from '../../components/panels/Panel';
 import { PanelGroup } from '../../components/panels/PanelGroup';
+import LocateItemButton from '../../components/plugins/LocateItemButton';
 import { ApiEndpoints } from '../../enums/ApiEndpoints';
 import { ModelType } from '../../enums/ModelType';
 import { UserRoles } from '../../enums/Roles';
@@ -275,7 +276,8 @@ export default function Stock() {
 
   const locationActions = useMemo(
     () => [
-      <AdminButton model={ModelType.stocklocation} pk={location.pk} />,
+      <AdminButton model={ModelType.stocklocation} id={location.pk} />,
+      <LocateItemButton locationId={location.pk} />,
       <ActionButton
         icon={<InvenTreeIcon icon='stocktake' />}
         onClick={notYetImplemented}
diff --git a/src/frontend/src/pages/stock/StockDetail.tsx b/src/frontend/src/pages/stock/StockDetail.tsx
index 5ec82dcb88..af474ccfe9 100644
--- a/src/frontend/src/pages/stock/StockDetail.tsx
+++ b/src/frontend/src/pages/stock/StockDetail.tsx
@@ -39,6 +39,7 @@ import AttachmentPanel from '../../components/panels/AttachmentPanel';
 import NotesPanel from '../../components/panels/NotesPanel';
 import type { PanelType } from '../../components/panels/Panel';
 import { PanelGroup } from '../../components/panels/PanelGroup';
+import LocateItemButton from '../../components/plugins/LocateItemButton';
 import { StatusRenderer } from '../../components/render/StatusRenderer';
 import { formatCurrency } from '../../defaults/formatters';
 import { ApiEndpoints } from '../../enums/ApiEndpoints';
@@ -653,7 +654,8 @@ export default function StockDetail() {
       stockitem.quantity == 1;
 
     return [
-      <AdminButton model={ModelType.stockitem} pk={stockitem.pk} />,
+      <AdminButton model={ModelType.stockitem} id={stockitem.pk} />,
+      <LocateItemButton stockId={stockitem.pk} />,
       <BarcodeActionDropdown
         model={ModelType.stockitem}
         pk={stockitem.pk}
diff --git a/src/frontend/src/tables/settings/GroupTable.tsx b/src/frontend/src/tables/settings/GroupTable.tsx
index 9f2dd3c25f..d57d21d1fc 100644
--- a/src/frontend/src/tables/settings/GroupTable.tsx
+++ b/src/frontend/src/tables/settings/GroupTable.tsx
@@ -115,7 +115,7 @@ export function GroupDrawer({
         <Title order={5}>
           <Trans>Permission set</Trans>
         </Title>
-        <AdminButton model={ModelType.group} pk={instance.pk} />
+        <AdminButton model={ModelType.group} id={instance.pk} />
       </Group>
       <Group>{permissionsAccordion}</Group>
     </Stack>
diff --git a/src/frontend/tests/pui_plugins.spec.ts b/src/frontend/tests/pui_plugins.spec.ts
index c3dfd1526d..e6029583c6 100644
--- a/src/frontend/tests/pui_plugins.spec.ts
+++ b/src/frontend/tests/pui_plugins.spec.ts
@@ -94,3 +94,35 @@ test('Plugins - Custom Admin', async ({ page, request }) => {
   await page.getByText('foo: bar').waitFor();
   await page.getByText('hello: world').waitFor();
 });
+
+test('Plugins - Locate Item', async ({ page, request }) => {
+  await doQuickLogin(page, 'admin', 'inventree');
+
+  // Ensure that the sample location plugin is enabled
+  await setPluginState({
+    request,
+    plugin: 'samplelocate',
+    state: true
+  });
+
+  await page.waitForTimeout(500);
+
+  // Navigate to the "stock item" page
+  await page.goto(`${baseUrl}/stock/item/287/`);
+
+  // "Locate" this item
+  await page.getByLabel('action-button-locate-item').click();
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByText('Item location requested').waitFor();
+
+  // Show the location
+  await page.getByLabel('breadcrumb-1-factory').click();
+  await page.waitForTimeout(500);
+
+  await page.getByLabel('action-button-locate-item').click();
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByText('Item location requested').waitFor();
+
+  await page.waitForTimeout(2500);
+  return;
+});