# app/api/main.py
"""
API router configuration for multi-tenant ecommerce platform.

This module provides:
- API version 1 route aggregation
- Route organization by user type (admin, vendor, shop)
- Proper route prefixing and tagging
"""

from fastapi import APIRouter

from app.api.v1 import admin, shop, vendor
from app.api.v1.shared import language

api_router = APIRouter()

# ============================================================================
# ADMIN ROUTES (Platform-level management)
# Prefix: /api/v1/admin
# ============================================================================

api_router.include_router(admin.router, prefix="/v1/admin", tags=["admin"])

# ============================================================================
# VENDOR ROUTES (Vendor-scoped operations)
# Prefix: /api/v1/vendor
# ============================================================================

api_router.include_router(vendor.router, prefix="/v1/vendor", tags=["vendor"])

# ============================================================================
# SHOP ROUTES (Public shop frontend API)
# Prefix: /api/v1/shop
# ============================================================================

api_router.include_router(shop.router, prefix="/v1/shop", tags=["shop"])

# ============================================================================
# SHARED ROUTES (Cross-context utilities)
# Prefix: /api/v1
# ============================================================================

api_router.include_router(language.router, prefix="/v1", tags=["language"])