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>
81 lines
2.4 KiB
Python
81 lines
2.4 KiB
Python
# app/modules/payments/definition.py
|
|
"""
|
|
Payments module definition.
|
|
|
|
Defines the payments module including its features, menu items,
|
|
and route configurations.
|
|
|
|
The payments module provides gateway abstractions that can be used by:
|
|
- billing module: For platform subscriptions and invoices
|
|
- orders module: For customer checkout payments
|
|
|
|
This separation allows:
|
|
1. Using payments standalone (e.g., one-time payments without subscriptions)
|
|
2. Billing without orders (platform subscription only)
|
|
3. Orders without billing (customer payments only)
|
|
"""
|
|
|
|
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.payments.routes.api.admin import admin_router
|
|
|
|
return admin_router
|
|
|
|
|
|
def _get_vendor_router():
|
|
"""Lazy import of vendor router to avoid circular imports."""
|
|
from app.modules.payments.routes.api.vendor import vendor_router
|
|
|
|
return vendor_router
|
|
|
|
|
|
# Payments module definition
|
|
payments_module = ModuleDefinition(
|
|
code="payments",
|
|
name="Payment Gateways",
|
|
description=(
|
|
"Payment gateway integrations for Stripe, PayPal, and bank transfers. "
|
|
"Provides payment processing, refunds, and payment method management."
|
|
),
|
|
version="1.0.0",
|
|
features=[
|
|
"payment_processing", # Process payments
|
|
"payment_refunds", # Issue refunds
|
|
"payment_methods", # Store payment methods
|
|
"stripe_gateway", # Stripe integration
|
|
"paypal_gateway", # PayPal integration
|
|
"bank_transfer", # Bank transfer support
|
|
"transaction_history", # Transaction records
|
|
],
|
|
menu_items={
|
|
FrontendType.ADMIN: [
|
|
"payment-gateways", # Configure payment gateways
|
|
],
|
|
FrontendType.VENDOR: [
|
|
"payment-methods", # Manage stored payment methods
|
|
],
|
|
},
|
|
is_core=False,
|
|
is_internal=False,
|
|
is_self_contained=True, # Enable auto-discovery from routes/api/
|
|
)
|
|
|
|
|
|
def get_payments_module_with_routers() -> ModuleDefinition:
|
|
"""
|
|
Get payments module with routers attached.
|
|
|
|
This function attaches the routers lazily to avoid circular imports
|
|
during module initialization.
|
|
"""
|
|
payments_module.admin_router = _get_admin_router()
|
|
payments_module.vendor_router = _get_vendor_router()
|
|
return payments_module
|
|
|
|
|
|
__all__ = ["payments_module", "get_payments_module_with_routers"]
|