This commit completes the migration to a fully module-driven architecture: ## Models Migration - Moved all domain models from models/database/ to their respective modules: - tenancy: User, Admin, Vendor, Company, Platform, VendorDomain, etc. - cms: MediaFile, VendorTheme - messaging: Email, VendorEmailSettings, VendorEmailTemplate - core: AdminMenuConfig - models/database/ now only contains Base and TimestampMixin (infrastructure) ## Schemas Migration - Moved all domain schemas from models/schema/ to their respective modules: - tenancy: company, vendor, admin, team, vendor_domain - cms: media, image, vendor_theme - messaging: email - models/schema/ now only contains base.py and auth.py (infrastructure) ## Routes Migration - Moved admin routes from app/api/v1/admin/ to modules: - menu_config.py -> core module - modules.py -> tenancy module - module_config.py -> tenancy module - app/api/v1/admin/ now only aggregates auto-discovered module routes ## Menu System - Implemented module-driven menu system with MenuDiscoveryService - Extended FrontendType enum: PLATFORM, ADMIN, VENDOR, STOREFRONT - Added MenuItemDefinition and MenuSectionDefinition dataclasses - Each module now defines its own menu items in definition.py - MenuService integrates with MenuDiscoveryService for template rendering ## Documentation - Updated docs/architecture/models-structure.md - Updated docs/architecture/menu-management.md - Updated architecture validation rules for new exceptions ## Architecture Validation - Updated MOD-019 rule to allow base.py in models/schema/ - Created core module exceptions.py and schemas/ directory - All validation errors resolved (only warnings remain) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
59 lines
2.0 KiB
Python
59 lines
2.0 KiB
Python
# app/modules/analytics/routes/api/vendor.py
|
|
"""
|
|
Vendor Analytics API
|
|
|
|
Vendor Context: Uses token_vendor_id from JWT token (authenticated vendor API pattern).
|
|
The get_current_vendor_api dependency guarantees token_vendor_id is present.
|
|
|
|
Feature Requirements:
|
|
- basic_reports: Basic analytics (Essential tier)
|
|
- analytics_dashboard: Advanced analytics (Business tier)
|
|
"""
|
|
|
|
import logging
|
|
|
|
from fastapi import APIRouter, Depends, Query
|
|
from sqlalchemy.orm import Session
|
|
|
|
from app.api.deps import get_current_vendor_api, get_db, require_module_access
|
|
from app.core.feature_gate import RequireFeature
|
|
from app.modules.analytics.services import stats_service
|
|
from app.modules.analytics.schemas import (
|
|
VendorAnalyticsCatalog,
|
|
VendorAnalyticsImports,
|
|
VendorAnalyticsInventory,
|
|
VendorAnalyticsResponse,
|
|
)
|
|
from app.modules.billing.models import FeatureCode
|
|
from app.modules.tenancy.models import User
|
|
|
|
router = APIRouter(
|
|
prefix="/analytics",
|
|
dependencies=[Depends(require_module_access("analytics"))],
|
|
)
|
|
vendor_router = router # Alias for discovery
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@router.get("", response_model=VendorAnalyticsResponse)
|
|
def get_vendor_analytics(
|
|
period: str = Query("30d", description="Time period: 7d, 30d, 90d, 1y"),
|
|
current_user: User = Depends(get_current_vendor_api),
|
|
db: Session = Depends(get_db),
|
|
_: None = Depends(RequireFeature(FeatureCode.BASIC_REPORTS, FeatureCode.ANALYTICS_DASHBOARD)),
|
|
):
|
|
"""Get vendor analytics data for specified time period."""
|
|
data = stats_service.get_vendor_analytics(db, current_user.token_vendor_id, period)
|
|
|
|
return VendorAnalyticsResponse(
|
|
period=data["period"],
|
|
start_date=data["start_date"],
|
|
imports=VendorAnalyticsImports(count=data["imports"]["count"]),
|
|
catalog=VendorAnalyticsCatalog(
|
|
products_added=data["catalog"]["products_added"]
|
|
),
|
|
inventory=VendorAnalyticsInventory(
|
|
total_locations=data["inventory"]["total_locations"]
|
|
),
|
|
)
|