docs: fix pricing query params in storefront guide + modules restructure (#9021)

- Fix pricing query params previously using `customer_group_id` and `customer_id` as expected / accepted queries and update information around them - Other: reorganize the introduction page of each module to show how to use it at the very beginning.
2024-09-09 06:43:43 +00:00
parent afb83b2408
commit 3eb2387746
20 changed files with 973 additions and 964 deletions
@@ -8,64 +8,6 @@ export const metadata = {

 The Inventory Module is the `@medusajs/inventory-next` NPM package that provides inventory-related features in your Medusa and Node.js applications.

-## Features
-
-### Inventory Items Management
-
-Store and manage inventory of any stock-kept item, such as product variants.
-
-Inventory items hold details of the underlying stock-kept item, as well as inventory details such as whether the item requires shipping.
-
-```ts
-const inventoryItem = await inventoryModuleService.createInventoryItems({
-  sku: "SHIRT",
-  title: "Green Medusa Shirt",
-  requires_shipping: true,
-})
-```
-
-### Inventory Across Locations
-
-Inventory items' quantities are set per locations through inventory levels. This gives you more flexibility in managing the quantity of a stock-kept item across different locations, such as different warehouses.
-
-```ts
-const inventoryLevel = await inventoryModuleService.createInventoryLevels([
-  {
-    inventory_item_id: "iitem_123",
-    location_id: "sloc_123",
-    stocked_quantity: 20,
-  },
-])
-```
-
-### Reservation Management
-
-Reserve quantities of inventory items at specific locations for orders or other purposes. The reserved quantity isn't considered for purchase, but can be deleted to revert the reservation.
-
-```ts
-const reservationItem = await inventoryModuleService.createReservationItems([
-  {
-    inventory_item_id: "iitem_123",
-    location_id: "sloc_123",
-    quantity: 10,
-  },
-])
-```
-
-### Check Inventory Availability
-
-Check whether an inventory item has the necessary quantity for purchase. Any reserved quantity is considered unavailable.
-
-```ts
-const isAvailable = await inventoryModuleService.confirmInventory(
-  inventoryItemId,
-  [locationId],
-  neededQuantity
-)
-```
-
---
-
 ## How to Use Inventory Module's Service

 You can use the Inventory Module's main service by resolving from the Medusa container the resource `ModuleRegistrationName.INVENTORY` imported from `@medusajs/utils`.
@@ -130,3 +72,61 @@ const step1 = createStep("step-1", async (_, { container }) => {

  </CodeTab>
 </CodeTabs>
+
+---
+
+## Features
+
+### Inventory Items Management
+
+Store and manage inventory of any stock-kept item, such as product variants.
+
+Inventory items hold details of the underlying stock-kept item, as well as inventory details such as whether the item requires shipping.
+
+```ts
+const inventoryItem = await inventoryModuleService.createInventoryItems({
+  sku: "SHIRT",
+  title: "Green Medusa Shirt",
+  requires_shipping: true,
+})
+```
+
+### Inventory Across Locations
+
+Inventory items' quantities are set per locations through inventory levels. This gives you more flexibility in managing the quantity of a stock-kept item across different locations, such as different warehouses.
+
+```ts
+const inventoryLevel = await inventoryModuleService.createInventoryLevels([
+  {
+    inventory_item_id: "iitem_123",
+    location_id: "sloc_123",
+    stocked_quantity: 20,
+  },
+])
+```
+
+### Reservation Management
+
+Reserve quantities of inventory items at specific locations for orders or other purposes. The reserved quantity isn't considered for purchase, but can be deleted to revert the reservation.
+
+```ts
+const reservationItem = await inventoryModuleService.createReservationItems([
+  {
+    inventory_item_id: "iitem_123",
+    location_id: "sloc_123",
+    quantity: 10,
+  },
+])
+```
+
+### Check Inventory Availability
+
+Check whether an inventory item has the necessary quantity for purchase. Any reserved quantity is considered unavailable.
+
+```ts
+const isAvailable = await inventoryModuleService.confirmInventory(
+  inventoryItemId,
+  [locationId],
+  neededQuantity
+)
+```