chore: reorganize docs apps (#7228)

* reorganize docs apps

* add README

* fix directory

* add condition for old docs

www/apps/resources/app/commerce-modules/customer/customer-accounts/page.mdx

@@ -0,0 +1,23 @@
+export const metadata = {
+  title: `Customer Accounts`,
+}
+
+# {metadata.title}
+
+In this document, you’ll learn how registered and unregistered accounts are distinguished in the Medusa application.
+
+## `has_account` field
+
+The `Customer` data model has a `has_account` field, which is a boolean that indicates whether a customer is registerd.
+
+When a guest customer places an order, a new `Customer` record is created with `has_account` set to `false`.
+
+When this or another guest customer registers an account with the same email, a new `Customer` record is created with `has_account` set to `true`.
+
+---
+
+## Email Uniqueness
+
+The above behavior means that two `Customer` records may exist of the same email. However, the main difference is the `has_account` field’s value.
+
+So, there can only be one guest customer (having `has_account=false`) and one registered customer (having `has_account=true`) with the same email. If another customer tries to create an account with the same email, they’ll get an error that an account with this email already exists.

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

@@ -0,0 +1,236 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+  title: `Examples of the Customer Module`,
+}
+
+# {metadata.title}
+
+In this guide, you’ll find common examples of how you can use the Customer Module in your application.
+
+## Create a Customer
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const customerModuleService: ICustomerModuleService =
+      request.scope.resolve(ModuleRegistrationName.CUSTOMER)
+
+    const customer = await customerModuleService.create({
+      first_name: "Peter",
+      last_name: "Hayes",
+      email: "peter.hayes@example.com",
+    })
+
+    res.json({
+      customer,
+    })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeCustomerModule,
+  } from "@medusajs/customer"
+
+  export async function POST(request: Request) {
+    const customerModuleService = await initializeCustomerModule()
+
+    const customer = await customerModuleService.create({
+      first_name: "Peter",
+      last_name: "Hayes",
+      email: "peter.hayes@example.com",
+    })
+
+    return NextResponse.json({
+      customer,
+    })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Create a Customer Group
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const customerModuleService: ICustomerModuleService =
+      request.scope.resolve(ModuleRegistrationName.CUSTOMER)
+
+    const customerGroup =
+      await customerModuleService.createCustomerGroup({
+        name: "VIP",
+      })
+
+    res.json({
+      customer_group: customerGroup,
+    })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeCustomerModule,
+  } from "@medusajs/customer"
+
+  export async function POST(request: Request) {
+    const customerModuleService = await initializeCustomerModule()
+
+    const customerGroup =
+      await customerModuleService.createCustomerGroup({
+        name: "VIP",
+      })
+
+    return NextResponse.json({
+      customer_group: customerGroup,
+    })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Add a Customer to a Group
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const customerModuleService: ICustomerModuleService =
+      request.scope.resolve(ModuleRegistrationName.CUSTOMER)
+
+    await customerModuleService.addCustomerToGroup({
+      customer_id: "cus_123",
+      customer_group_id: "cusgroup_123",
+    })
+
+    res.status(200)
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeCustomerModule,
+  } from "@medusajs/customer"
+
+  export async function POST(request: Request) {
+    const customerModuleService = await initializeCustomerModule()
+
+    await customerModuleService.addCustomerToGroup({
+      customer_id: "cus_123",
+      customer_group_id: "cusgroup_123",
+    })
+
+    return NextResponse.json({}, { status: 200 })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Remove a Customer from a Group
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const customerModuleService: ICustomerModuleService =
+      request.scope.resolve(ModuleRegistrationName.CUSTOMER)
+
+    await customerModuleService.removeCustomerFromGroup({
+      customer_id: "cus_123",
+      customer_group_id: "cusgroup_123",
+    })
+
+    res.status(200)
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  // eslint-disable-next-line prettier/prettier
+  import {
+    initialize as initializeCustomerModule,
+  } from "@medusajs/customer"
+
+  export async function POST(request: Request) {
+    const customerModuleService = await initializeCustomerModule()
+
+    await customerModuleService.removeCustomerFromGroup({
+      customer_id: "cus_123",
+      customer_group_id: "cusgroup_123",
+    })
+
+    return NextResponse.json({}, { status: 200 })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## More Examples
+
+The [module interface reference](/references/customer) provides a reference to all the methods available for use with examples for each.

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

@@ -0,0 +1,120 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+  title: `Customer Module`,
+}
+
+# {metadata.title}
+
+The Customer Module is the `@medusajs/customer` NPM package that provides customer-related features in your Medusa and Node.js applications.
+
+## Features
+
+### Customer Management
+
+With the Customer Module, store and manage customers in your store.
+
+```ts
+const customer = await customerModuleService.create({
+  first_name: "Peter",
+  last_name: "Hayes",
+  email: "peter.hayes@example.com",
+})
+```
+
+### Customer Organization
+
+You can organize customers into groups. This has a lot of benefits and supports more use cases, such as provide discounts for specific customer groups using the Promotion Module.
+
+```ts
+const customerGroup =
+  await customerModuleService.createCustomerGroup({
+    name: "VIP",
+  })
+
+await customerModuleService.addCustomerToGroup({
+  customer_id: "cus_123",
+  customer_group_id: customerGroup.id,
+})
+```
+
+---
+
+## Configure Customer Module
+
+After installing the `@medusajs/customer` package in your Medusa application, add it to the `modules` object in `medusa-config.js`:
+
+```js title="medusa-config.js"
+const modules = {
+  // ...
+  customer: {
+    resolve: "@medusajs/customer",
+  },
+}
+```
+
+---
+
+## How to Use Customer Module's Service
+
+You can use the Customer Module's main service by resolving from the Medusa container the resource `ModuleRegistrationName.CUSTOMER` 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 { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    request: MedusaRequest,
+    res: MedusaResponse
+  ) {
+    const customerModuleService: ICustomerModuleService =
+      request.scope.resolve(ModuleRegistrationName.CUSTOMER)
+
+    res.json({
+      customers: await customerModuleService.list(),
+    })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Subscriber" value="subscribers">
+
+  ```ts title="src/subscribers/custom-handler.ts"
+  import { SubscriberArgs } from "@medusajs/medusa"
+  import { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export default async function subscriberHandler({
+    container,
+  }: SubscriberArgs) {
+    const customerModuleService: ICustomerModuleService =
+      container.resolve(ModuleRegistrationName.CUSTOMER)
+
+    const customers = await customerModuleService.list()
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Workflow Step" value="workflow-step">
+
+  ```ts title="src/workflows/hello-world/step1.ts"
+  import { createStep } from "@medusajs/workflows-sdk"
+  import { ICustomerModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  const step1 = createStep("step-1", async (_, context) => {
+    const customerModuleService: ICustomerModuleService =
+      context.container.resolve(ModuleRegistrationName.PRODUCT)
+
+    const customers = await customerModuleService.list()
+  })
+  ```
+
+  </CodeTab>
+</CodeTabs>

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

@@ -0,0 +1,16 @@
+export const metadata = {
+  title: `Relations between Customer 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 Customer Module and other Commerce Modules.
+
+## Cart Module
+
+A customer has a cart to purchase items from the store. The Medusa application forms a relation between the `Customer` and the `Cart` data models.
+
+![A diagram showcasing an example of how resources from the Customer and Cart modules are linked](https://res.cloudinary.com/dza7lstvk/image/upload/v1709915775/Medusa%20Resources/customer-cart_by5e7s.jpg)
+