feat: complete modular platform architecture (Phases 1-5)
Phase 1 - Vendor Router Integration: - Wire up vendor module routers in app/api/v1/vendor/__init__.py - Use lazy imports via __getattr__ to avoid circular dependencies Phase 2 - Extract Remaining Modules: - Create 6 new module directories: customers, cms, analytics, messaging, dev_tools, monitoring - Each module has definition.py and route wrappers - Update registry to import from extracted modules Phase 3 - Database Table Migration: - Add PlatformModule junction table for auditable module tracking - Add migration zc2m3n4o5p6q7_add_platform_modules_table.py - Add modules relationship to Platform model - Update ModuleService with JSON-to-junction-table migration Phase 4 - Module-Specific Configuration UI: - Add /api/v1/admin/module-config/* endpoints - Add module-config.html template and JS Phase 5 - Integration Tests: - Add tests/fixtures/module_fixtures.py - Add tests/integration/api/v1/admin/test_modules.py - Add tests/integration/api/v1/modules/test_module_access.py Architecture fixes: - Fix JS-003 errors: use ...data() directly in Alpine components - Fix JS-005 warnings: add init() guards to prevent duplicate init - Fix API-001 errors: add MenuActionResponse Pydantic model - Add FE-008 noqa for dynamic number input in template Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
22
app/modules/analytics/__init__.py
Normal file
22
app/modules/analytics/__init__.py
Normal file
@@ -0,0 +1,22 @@
|
||||
# app/modules/analytics/__init__.py
|
||||
"""
|
||||
Analytics Module - Reporting and analytics.
|
||||
|
||||
This module provides:
|
||||
- Dashboard analytics
|
||||
- Custom reports
|
||||
- Data exports
|
||||
- Performance metrics
|
||||
|
||||
Routes:
|
||||
- Vendor: /api/v1/vendor/analytics/*
|
||||
- (Admin uses dashboard for analytics)
|
||||
|
||||
Menu Items:
|
||||
- Admin: (uses dashboard)
|
||||
- Vendor: analytics
|
||||
"""
|
||||
|
||||
from app.modules.analytics.definition import analytics_module
|
||||
|
||||
__all__ = ["analytics_module"]
|
||||
54
app/modules/analytics/definition.py
Normal file
54
app/modules/analytics/definition.py
Normal file
@@ -0,0 +1,54 @@
|
||||
# app/modules/analytics/definition.py
|
||||
"""
|
||||
Analytics module definition.
|
||||
|
||||
Defines the analytics 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_vendor_router():
|
||||
"""Lazy import of vendor router to avoid circular imports."""
|
||||
from app.modules.analytics.routes.vendor import vendor_router
|
||||
|
||||
return vendor_router
|
||||
|
||||
|
||||
# Analytics module definition
|
||||
analytics_module = ModuleDefinition(
|
||||
code="analytics",
|
||||
name="Analytics & Reporting",
|
||||
description="Dashboard analytics, custom reports, and data exports.",
|
||||
features=[
|
||||
"basic_reports", # Basic reporting
|
||||
"analytics_dashboard", # Analytics dashboard
|
||||
"custom_reports", # Custom report builder
|
||||
"export_reports", # Export to CSV/Excel
|
||||
],
|
||||
menu_items={
|
||||
FrontendType.ADMIN: [
|
||||
# Analytics appears in dashboard for admin
|
||||
],
|
||||
FrontendType.VENDOR: [
|
||||
"analytics", # Vendor analytics page
|
||||
],
|
||||
},
|
||||
is_core=False,
|
||||
)
|
||||
|
||||
|
||||
def get_analytics_module_with_routers() -> ModuleDefinition:
|
||||
"""
|
||||
Get analytics module with routers attached.
|
||||
|
||||
This function attaches the routers lazily to avoid circular imports
|
||||
during module initialization.
|
||||
"""
|
||||
analytics_module.vendor_router = _get_vendor_router()
|
||||
return analytics_module
|
||||
|
||||
|
||||
__all__ = ["analytics_module", "get_analytics_module_with_routers"]
|
||||
26
app/modules/analytics/routes/__init__.py
Normal file
26
app/modules/analytics/routes/__init__.py
Normal file
@@ -0,0 +1,26 @@
|
||||
# app/modules/analytics/routes/__init__.py
|
||||
"""
|
||||
Analytics module route registration.
|
||||
|
||||
This module provides functions to register analytics routes
|
||||
with module-based access control.
|
||||
|
||||
NOTE: Routers are NOT auto-imported to avoid circular dependencies.
|
||||
Import directly from vendor.py as needed:
|
||||
from app.modules.analytics.routes.vendor import vendor_router
|
||||
|
||||
Note: Analytics module has no admin routes - admin uses dashboard.
|
||||
"""
|
||||
|
||||
# Routers are imported on-demand to avoid circular dependencies
|
||||
# Do NOT add auto-imports here
|
||||
|
||||
__all__ = ["vendor_router"]
|
||||
|
||||
|
||||
def __getattr__(name: str):
|
||||
"""Lazy import routers to avoid circular dependencies."""
|
||||
if name == "vendor_router":
|
||||
from app.modules.analytics.routes.vendor import vendor_router
|
||||
return vendor_router
|
||||
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
|
||||
25
app/modules/analytics/routes/vendor.py
Normal file
25
app/modules/analytics/routes/vendor.py
Normal file
@@ -0,0 +1,25 @@
|
||||
# app/modules/analytics/routes/vendor.py
|
||||
"""
|
||||
Analytics module vendor routes.
|
||||
|
||||
This module wraps the existing vendor analytics routes and adds
|
||||
module-based access control. Routes are re-exported from the
|
||||
original location with the module access dependency.
|
||||
"""
|
||||
|
||||
from fastapi import APIRouter, Depends
|
||||
|
||||
from app.api.deps import require_module_access
|
||||
|
||||
# Import original router (direct import to avoid circular dependency)
|
||||
from app.api.v1.vendor.analytics import router as original_router
|
||||
|
||||
# Create module-aware router
|
||||
vendor_router = APIRouter(
|
||||
prefix="/analytics",
|
||||
dependencies=[Depends(require_module_access("analytics"))],
|
||||
)
|
||||
|
||||
# Re-export all routes from the original module with module access control
|
||||
for route in original_router.routes:
|
||||
vendor_router.routes.append(route)
|
||||
Reference in New Issue
Block a user