Samir Boulahtit
e2cecff014
Billing module: - Create vendor_checkout.py (checkout, portal, cancel, reactivate, change-tier) - Create vendor_addons.py (addon management routes) - Update vendor.py to aggregate new routers Orders module: - Create vendor_invoices.py (invoice settings, CRUD, PDF generation) - Update vendor.py to aggregate invoices router Payments module: - Restructure routes from routes/ to routes/api/ - Add require_module_access dependency - Set is_self_contained=True for auto-discovery Remove legacy files: - app/api/v1/vendor/billing.py - app/api/v1/vendor/invoices.py - app/api/v1/vendor/payments.py Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
110 lines
3.9 KiB
Python
110 lines
3.9 KiB
Python
# app/api/v1/vendor/__init__.py
|
|
"""
|
|
Vendor API router aggregation.
|
|
|
|
This module aggregates all vendor-related JSON API endpoints.
|
|
|
|
IMPORTANT:
|
|
- This router is for JSON API endpoints only
|
|
- HTML page routes are mounted separately in main.py at /vendor/*
|
|
- Do NOT include pages.router here - it causes route conflicts
|
|
|
|
MODULE SYSTEM:
|
|
Routes can be module-gated using require_module_access() dependency.
|
|
For multi-tenant apps, module enablement is checked at request time
|
|
based on platform context (not at route registration time).
|
|
|
|
Self-contained modules (auto-discovered from app/modules/{module}/routes/api/vendor.py):
|
|
- billing: Subscription tiers, vendor billing, checkout, add-ons, features
|
|
- inventory: Stock management, inventory tracking
|
|
- orders: Order management, fulfillment, exceptions, invoices
|
|
- marketplace: Letzshop integration, product sync
|
|
- catalog: Vendor product catalog management
|
|
- cms: Content pages management
|
|
- customers: Customer management
|
|
- payments: Payment configuration, Stripe connect, transactions
|
|
"""
|
|
|
|
from fastapi import APIRouter
|
|
|
|
# Import all sub-routers (legacy routes that haven't been migrated to modules)
|
|
from . import (
|
|
analytics,
|
|
auth,
|
|
dashboard,
|
|
email_settings,
|
|
email_templates,
|
|
info,
|
|
media,
|
|
messages,
|
|
notifications,
|
|
onboarding,
|
|
profile,
|
|
settings,
|
|
team,
|
|
usage,
|
|
)
|
|
|
|
# Create vendor router
|
|
router = APIRouter()
|
|
|
|
# ============================================================================
|
|
# JSON API ROUTES ONLY
|
|
# ============================================================================
|
|
# These routes return JSON and are mounted at /api/v1/vendor/*
|
|
|
|
# IMPORTANT: Specific routes MUST be registered BEFORE catch-all routes
|
|
# The info.router has GET /{vendor_code} which catches everything,
|
|
# so it must be registered LAST
|
|
|
|
# Authentication (no prefix, specific routes like /auth/login)
|
|
router.include_router(auth.router, tags=["vendor-auth"])
|
|
|
|
# Vendor management (with prefixes: /dashboard/*, /profile/*, /settings/*)
|
|
router.include_router(dashboard.router, tags=["vendor-dashboard"])
|
|
router.include_router(profile.router, tags=["vendor-profile"])
|
|
router.include_router(settings.router, tags=["vendor-settings"])
|
|
router.include_router(email_templates.router, tags=["vendor-email-templates"])
|
|
router.include_router(email_settings.router, tags=["vendor-email-settings"])
|
|
router.include_router(onboarding.router, tags=["vendor-onboarding"])
|
|
|
|
# Business operations (with prefixes: /team/*)
|
|
router.include_router(team.router, tags=["vendor-team"])
|
|
|
|
# Services (with prefixes: /media/*, etc.)
|
|
router.include_router(media.router, tags=["vendor-media"])
|
|
router.include_router(notifications.router, tags=["vendor-notifications"])
|
|
router.include_router(messages.router, tags=["vendor-messages"])
|
|
router.include_router(analytics.router, tags=["vendor-analytics"])
|
|
router.include_router(usage.router, tags=["vendor-usage"])
|
|
|
|
|
|
# ============================================================================
|
|
# Auto-discovered Module Routes
|
|
# ============================================================================
|
|
# Routes from self-contained modules are auto-discovered and registered.
|
|
# Modules include: billing, inventory, orders, marketplace, cms, customers, payments
|
|
# Routes are sorted by priority, so catch-all routes (CMS) come last.
|
|
|
|
from app.modules.routes import get_vendor_api_routes
|
|
|
|
for route_info in get_vendor_api_routes():
|
|
# Only pass prefix if custom_prefix is set (router already has internal prefix)
|
|
if route_info.custom_prefix:
|
|
router.include_router(
|
|
route_info.router,
|
|
prefix=route_info.custom_prefix,
|
|
tags=route_info.tags,
|
|
)
|
|
else:
|
|
router.include_router(
|
|
route_info.router,
|
|
tags=route_info.tags,
|
|
)
|
|
|
|
|
|
# Vendor info endpoint - MUST BE LAST! Has catch-all GET /{vendor_code}
|
|
router.include_router(info.router, tags=["vendor-info"])
|
|
|
|
__all__ = ["router"]
|