feat: extract inventory, orders, and marketplace modules (Phase 4)

Extract three additional modules following the billing module pattern:

Inventory Module (app/modules/inventory/):
- Stock management and tracking
- Inventory locations
- Low stock alerts
- Admin and vendor routes with module access control

Orders Module (app/modules/orders/):
- Order management and fulfillment
- Order item exceptions
- Bulk operations and export
- Admin and vendor routes with module access control

Marketplace Module (app/modules/marketplace/):
- Letzshop integration
- Product sync
- Marketplace import
- Depends on inventory module
- Admin and vendor routes with module access control

Admin router updated:
- Uses module routers with require_module_access dependency
- Legacy router includes commented out
- Routes verified: 15 inventory, 16 orders, 42 marketplace

All 31 module tests passing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/modules/orders/__init__.py

@@ -0,0 +1,23 @@
+# app/modules/orders/__init__.py
+"""
+Orders Module - Order processing and fulfillment.
+
+This module provides:
+- Order management and tracking
+- Order fulfillment workflow
+- Order item exceptions handling
+- Bulk order operations
+- Order export and reporting
+
+Routes:
+- Admin: /api/v1/admin/orders/*, /api/v1/admin/order-item-exceptions/*
+- Vendor: /api/v1/vendor/orders/*, /api/v1/vendor/order-item-exceptions/*
+
+Menu Items:
+- Admin: orders
+- Vendor: orders
+"""
+
+from app.modules.orders.definition import orders_module
+
+__all__ = ["orders_module"]

app/modules/orders/definition.py

@@ -0,0 +1,68 @@
+# app/modules/orders/definition.py
+"""
+Orders module definition.
+
+Defines the orders module including its features, menu items,
+and route configurations.
+"""
+
+from app.modules.base import ModuleDefinition
+from models.database.admin_menu_config import FrontendType
+
+
+def _get_admin_router():
+    """Lazy import of admin router to avoid circular imports."""
+    from app.modules.orders.routes.admin import admin_router
+
+    return admin_router
+
+
+def _get_vendor_router():
+    """Lazy import of vendor router to avoid circular imports."""
+    from app.modules.orders.routes.vendor import vendor_router
+
+    return vendor_router
+
+
+# Orders module definition
+orders_module = ModuleDefinition(
+    code="orders",
+    name="Order Management",
+    description=(
+        "Order processing, fulfillment tracking, order item exceptions, "
+        "and bulk order operations."
+    ),
+    features=[
+        "order_management",  # Basic order CRUD
+        "order_bulk_actions",  # Bulk status updates
+        "order_export",  # Export orders to CSV/Excel
+        "automation_rules",  # Order automation rules
+        "fulfillment_tracking",  # Shipping and tracking
+        "shipping_management",  # Carrier integration
+        "order_exceptions",  # Order item exception handling
+    ],
+    menu_items={
+        FrontendType.ADMIN: [
+            "orders",  # Platform-wide order management
+        ],
+        FrontendType.VENDOR: [
+            "orders",  # Vendor order management
+        ],
+    },
+    is_core=False,
+)
+
+
+def get_orders_module_with_routers() -> ModuleDefinition:
+    """
+    Get orders module with routers attached.
+
+    This function attaches the routers lazily to avoid circular imports
+    during module initialization.
+    """
+    orders_module.admin_router = _get_admin_router()
+    orders_module.vendor_router = _get_vendor_router()
+    return orders_module
+
+
+__all__ = ["orders_module", "get_orders_module_with_routers"]

app/modules/orders/routes/__init__.py

@@ -0,0 +1,12 @@
+# app/modules/orders/routes/__init__.py
+"""
+Orders module route registration.
+
+This module provides functions to register orders routes
+with module-based access control.
+"""
+
+from app.modules.orders.routes.admin import admin_router
+from app.modules.orders.routes.vendor import vendor_router
+
+__all__ = ["admin_router", "vendor_router"]

app/modules/orders/routes/admin.py

@@ -0,0 +1,40 @@
+# app/modules/orders/routes/admin.py
+"""
+Orders module admin routes.
+
+This module wraps the existing admin orders routes and adds
+module-based access control. Routes are re-exported from the
+original location with the module access dependency.
+
+Includes:
+- /orders/* - Order management
+- /order-item-exceptions/* - Exception handling
+"""
+
+from fastapi import APIRouter, Depends
+
+from app.api.deps import require_module_access
+
+# Import original routers
+from app.api.v1.admin import orders as orders_routes
+from app.api.v1.admin import order_item_exceptions as exceptions_routes
+
+# Create module-aware router for orders
+admin_router = APIRouter(
+    prefix="/orders",
+    dependencies=[Depends(require_module_access("orders"))],
+)
+
+# Re-export all routes from the original orders module
+for route in orders_routes.router.routes:
+    admin_router.routes.append(route)
+
+# Create separate router for order item exceptions
+# This is included separately in the admin __init__.py
+admin_exceptions_router = APIRouter(
+    prefix="/order-item-exceptions",
+    dependencies=[Depends(require_module_access("orders"))],
+)
+
+for route in exceptions_routes.router.routes:
+    admin_exceptions_router.routes.append(route)

app/modules/orders/routes/vendor.py

@@ -0,0 +1,39 @@
+# app/modules/orders/routes/vendor.py
+"""
+Orders module vendor routes.
+
+This module wraps the existing vendor orders routes and adds
+module-based access control. Routes are re-exported from the
+original location with the module access dependency.
+
+Includes:
+- /orders/* - Order management
+- /order-item-exceptions/* - Exception handling
+"""
+
+from fastapi import APIRouter, Depends
+
+from app.api.deps import require_module_access
+
+# Import original routers
+from app.api.v1.vendor import orders as orders_routes
+from app.api.v1.vendor import order_item_exceptions as exceptions_routes
+
+# Create module-aware router for orders
+vendor_router = APIRouter(
+    prefix="/orders",
+    dependencies=[Depends(require_module_access("orders"))],
+)
+
+# Re-export all routes from the original orders module
+for route in orders_routes.router.routes:
+    vendor_router.routes.append(route)
+
+# Create separate router for order item exceptions
+vendor_exceptions_router = APIRouter(
+    prefix="/order-item-exceptions",
+    dependencies=[Depends(require_module_access("orders"))],
+)
+
+for route in exceptions_routes.router.routes:
+    vendor_exceptions_router.routes.append(route)