feat: implement metrics provider pattern for modular dashboard statistics

This commit introduces a protocol-based metrics architecture that allows
each module to provide its own statistics for dashboards without creating
cross-module dependencies.

Key changes:
- Add MetricsProviderProtocol and MetricValue dataclass in contracts module
- Add StatsAggregatorService in core module that discovers and aggregates
  metrics from all enabled modules
- Implement metrics providers for all modules:
  - tenancy: vendor/user counts, team members, domains
  - customers: customer counts
  - cms: pages, media files
  - catalog: products
  - inventory: stock levels
  - orders: order counts, revenue
  - marketplace: import jobs, staging products
- Update dashboard routes to use StatsAggregator instead of direct imports
- Fix VendorPlatform junction table usage (Vendor.platform_id doesn't exist)
- Add comprehensive documentation for the pattern

This architecture ensures:
- Dashboards always work (aggregator in core)
- Each module owns its metrics (no cross-module coupling)
- Optional modules are truly optional (can be removed without breaking app)
- Multi-platform vendors are properly supported via VendorPlatform table

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/modules/tenancy/definition.py

@@ -14,6 +14,14 @@ from app.modules.base import (
 )
 from app.modules.enums import FrontendType
 
+
+def _get_metrics_provider():
+    """Lazy import of metrics provider to avoid circular imports."""
+    from app.modules.tenancy.services.tenancy_metrics import tenancy_metrics_provider
+
+    return tenancy_metrics_provider
+
+
 tenancy_module = ModuleDefinition(
     code="tenancy",
     name="Tenancy Management",
@@ -151,6 +159,8 @@ tenancy_module = ModuleDefinition(
     models_path="app.modules.tenancy.models",
     schemas_path="app.modules.tenancy.schemas",
     exceptions_path="app.modules.tenancy.exceptions",
+    # Metrics provider for dashboard statistics
+    metrics_provider=_get_metrics_provider,
 )
 
 __all__ = ["tenancy_module"]