chore: reorganize docs apps (#7228)

* reorganize docs apps

* add README

* fix directory

* add condition for old docs

www/apps/resources/app/commerce-modules/product/examples/page.mdx

@@ -0,0 +1,400 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+  title: `Examples of the Product Module`,
+}
+
+# {metadata.title}
+
+In this guide, you’ll find common examples of how you can use the Product Module in your application.
+
+## Create Product
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const products = await productModuleService.create([
+      {
+        title: "Medusa Shirt",
+        options: [
+          {
+            title: "Color",
+          },
+        ],
+        variants: [
+          {
+            title: "Black Shirt",
+            options: [
+              {
+                value: "Black",
+              },
+            ],
+          },
+        ],
+      },
+    ])
+
+    res.json({ products })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function POST(request: Request) {
+    const productModuleService = await initializeProductModule()
+
+    const products = await productModuleService.create([
+      {
+        title: "Medusa Shirt",
+        options: [
+          {
+            title: "Color",
+          },
+        ],
+        variants: [
+          {
+            title: "Black Shirt",
+            options: [
+              {
+                value: "Black",
+              },
+            ],
+          },
+        ],
+      },
+    ])
+
+    return NextResponse.json({ products })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## List Products
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const data = await productModuleService.list()
+
+    res.json({ products: data })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function GET(request: Request) {
+    const productModuleService = await initializeProductModule()
+
+    const data = await productModuleService.list()
+
+    return NextResponse.json({ products: data })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+## Retrieve a Product by its ID
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const data = await productModuleService.list({
+      id: request.params.id,
+    })
+
+    res.json({ product: data[0] })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function GET(
+    request: Request, 
+    { params }: { params: Record<string, any> }) {
+    
+    const { id } = params
+    const productModuleService = await initializeProductModule()
+
+    const data = await productModuleService.list({
+      id,
+    })
+
+    return NextResponse.json({ product: data[0] })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Retrieve a Product by its Handle
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const data = await productModuleService.list()
+
+    res.json({ products: data })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function GET(request: Request) {
+    const productModuleService = await initializeProductModule()
+
+    const data = await productModuleService.list()
+
+    return NextResponse.json({ products: data })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+## Retrieve a Product by its ID
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const data = await productModuleService.list({
+      handle: request.params.handle,
+    })
+
+    res.json({ product: data[0] })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function GET(
+    request: Request, 
+    { params }: { params: Record<string, any> }) {
+    
+    const { handle } = params
+    const productModuleService = await initializeProductModule()
+
+    const data = await productModuleService.list({
+      handle,
+    })
+
+    return NextResponse.json({ product: data[0] })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Retrieve Categories
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const data = await productModuleService.listCategories()
+
+    res.json({ categories: data })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function GET(request: Request) {
+    const productModuleService = await initializeProductModule()
+
+    const data = await productModuleService.listCategories()
+
+    return NextResponse.json({ categories: data })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Retrieve Category by Handle
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="medusa" value="Medusa API Router">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    const data = await productModuleService.listCategories({
+      handle: request.params.handle,
+    })
+
+    res.json({ category: data[0] })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="nextjs" value="Next.js App Router">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import { 
+    initialize as initializeProductModule,
+  } from "@medusajs/product"
+
+  export async function GET(
+    request: Request, 
+    { params }: { params: Record<string, any> }) {
+    
+    const { handle } = params
+    const productModuleService = await initializeProductModule()
+
+    const data = await productModuleService.listCategories({
+      handle,
+    })
+
+    return NextResponse.json({ category: data[0] })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## More Examples
+
+The [Product Module interface reference](/references/product) provides a reference to all the methods available for use with examples for each.

www/apps/resources/app/commerce-modules/product/page.mdx

@@ -0,0 +1,138 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+  title: `Product Module`,
+}
+
+# {metadata.title}
+
+The Product Module is the `@medusajs/product` NPM package that provides product-related features in your Medusa and Node.js applications.
+
+## Features
+
+### Products Management
+
+With the Product Module, store products and manage them through the main interface methods. Products have custom options, such as color or size, and each variant in the product sets the value for these options.
+
+```ts
+const products = await productService.create([
+  {
+    title: "Medusa Shirt",
+    options: [
+      {
+        title: "Color",
+      },
+    ],
+    variants: [
+      {
+        title: "Black Shirt",
+        options: [
+          {
+            value: "Black",
+          },
+        ],
+      },
+    ],
+  },
+])
+```
+
+### Product Organization
+
+The Product Module provides different data models used to organize products, including categories, collections, tags, and more.
+
+```ts
+const category = await productService.createCategory({
+  name: "Shirts",
+})
+
+const products = await productService.update([
+  {
+    id: product.id,
+    categories: [
+      {
+        id: category.id,
+      },
+    ],
+  },
+])
+```
+
+---
+
+## Configure Product Module
+
+After installing the `@medusajs/product` package in your Medusa application, add it to the `modules` object in `medusa-config.js`:
+
+```js title="medusa-config.js"
+const modules = {
+  // ...
+  productService: {
+    resolve: "@medusajs/product",
+  },
+}
+```
+
+---
+
+## How to Use Product Module's Service
+
+You can use the Product Module's main service by resolving from the Medusa container the resource `ModuleRegistrationName.PRODUCT` imported from `@medusajs/modules-sdk`.
+
+For example:
+
+<CodeTabs groupId="resource-type">
+  <CodeTab label="API Route" value="api-route">
+
+  ```ts title="src/api/store/custom/route.ts"
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const productModuleService: IProductModuleService =
+      request.scope.resolve(ModuleRegistrationName.PRODUCT)
+
+    res.json({ products: await productModuleService.list() })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Subscriber" value="subscribers">
+
+  ```ts title="src/subscribers/custom-handler.ts"
+  import { SubscriberArgs } from "@medusajs/medusa"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export default async function subscriberHandler({
+    container,
+  }: SubscriberArgs) {
+    const productModuleService: IProductModuleService =
+      container.resolve(ModuleRegistrationName.PRODUCT)
+
+    const products = await productModuleService.list()
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Workflow Step" value="workflow-step">
+
+  ```ts title="src/workflows/hello-world/step1.ts"
+  import { createStep } from "@medusajs/workflows-sdk"
+  import { IProductModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  const step1 = createStep("step-1", async (_, context) => {
+    const productModuleService: IProductModuleService =
+      context.container.resolve(ModuleRegistrationName.PRODUCT)
+
+    const products = await productModuleService.list()
+  })
+  ```
+
+  </CodeTab>
+</CodeTabs>

www/apps/resources/app/commerce-modules/product/relations-to-other-modules/page.mdx

@@ -0,0 +1,45 @@
+export const metadata = {
+  title: `Relations between Product Module and Other Modules`,
+}
+
+# {metadata.title}
+
+When Commerce Modules are used together in a Medusa application, the Medusa application handles building the relations between these modules.
+
+This document showcases the relation between the Product Module and other Commerce Modules.
+
+{/* TODO add relation to: 
+
+- shipping profile
+
+*/}
+
+## Pricing Module
+
+A product variant’s prices are stored as money amounts belonging to a price set. The Medusa application forms a relation between the `ProductVariant` and the `PriceSet` data models.
+
+![A diagram showcasing an example of how resources from the Pricing and Product Module are linked.](https://res.cloudinary.com/dza7lstvk/image/upload/v1709651464/Medusa%20Resources/product-pricing_vlxsiq.jpg)
+
+So, to add prices for a product variant, create a price set and add the prices as money amounts to it.
+
+Learn more about the `PriceSet` data model in the [Pricing Concepts](../../pricing/concepts/page.mdx#price-list)
+
+---
+
+## Sales Channel Module
+
+A product can have different availability in different sales channels. The Medusa application forms a relation between the `Product` and `SalesChannel` data models.
+
+![A diagram showcasing an example of how resources from the Product and Sales Channel modules are linked.](https://res.cloudinary.com/dza7lstvk/image/upload/v1709651840/Medusa%20Resources/product-sales-channel_t848ik.jpg)
+
+---
+
+## Inventory Module
+
+Each product variant has different inventory details. The Medusa application forms a relation between the `ProductVariant` and `InventoryItem` data models.
+
+![A diagram showcasing an example of how resources from the Product and Inventory modules are linked.](https://res.cloudinary.com/dza7lstvk/image/upload/v1709652779/Medusa%20Resources/product-inventory_kmjnud.jpg)
+
+When the `manage_inventory` field of a product variant is enabled, you can manage the variant's inventory in different locations through this relation.
+
+Learn more about the `InventoryItem` data model in the [Inventory Concepts](../../inventory/concepts/page.mdx#inventoryitem)