Samir Boulahtit
0583dd2cc4
Move letzshop-related functionality from tenancy to marketplace module: - Move admin letzshop routes to marketplace/routes/api/admin_letzshop.py - Move letzshop schemas to marketplace/schemas/letzshop.py - Remove letzshop code from tenancy module (admin_vendors, vendor_service) - Update model exports and imports Add comprehensive unit tests for vendor services: - test_company_service.py: Company management operations - test_platform_service.py: Platform management operations - test_vendor_domain_service.py: Vendor domain operations - test_vendor_team_service.py: Vendor team management Update module definitions: - billing, messaging, payments: Minor definition updates Add architecture proposals documentation: - Module dependency redesign session notes - Decouple modules implementation plan - Module decoupling proposal Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
110 lines
3.7 KiB
Python
110 lines
3.7 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, PermissionDefinition
|
|
from app.modules.enums 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=(
|
|
"Core payment gateway integrations for Stripe, PayPal, and bank transfers. "
|
|
"Provides payment processing, refunds, and payment method management. "
|
|
"Required by billing module for subscription payments."
|
|
),
|
|
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
|
|
],
|
|
# Module-driven permissions
|
|
permissions=[
|
|
PermissionDefinition(
|
|
id="payments.view_gateways",
|
|
label_key="payments.permissions.view_gateways",
|
|
description_key="payments.permissions.view_gateways_desc",
|
|
category="payments",
|
|
),
|
|
PermissionDefinition(
|
|
id="payments.manage_gateways",
|
|
label_key="payments.permissions.manage_gateways",
|
|
description_key="payments.permissions.manage_gateways_desc",
|
|
category="payments",
|
|
),
|
|
PermissionDefinition(
|
|
id="payments.view_transactions",
|
|
label_key="payments.permissions.view_transactions",
|
|
description_key="payments.permissions.view_transactions_desc",
|
|
category="payments",
|
|
),
|
|
],
|
|
menu_items={
|
|
FrontendType.ADMIN: [
|
|
"payment-gateways", # Configure payment gateways
|
|
],
|
|
FrontendType.VENDOR: [
|
|
"payment-methods", # Manage stored payment methods
|
|
],
|
|
},
|
|
is_core=True, # Core module - required for billing and subscription management
|
|
is_internal=False,
|
|
# =========================================================================
|
|
# Self-Contained Module Configuration
|
|
# =========================================================================
|
|
is_self_contained=True,
|
|
services_path="app.modules.payments.services",
|
|
models_path="app.modules.payments.models",
|
|
schemas_path="app.modules.payments.schemas",
|
|
exceptions_path="app.modules.payments.exceptions",
|
|
)
|
|
|
|
|
|
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"]
|