# app/api/v1/vendor/analytics.py """ Vendor analytics and reporting endpoints. 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 from app.core.database import get_db from app.core.feature_gate import RequireFeature from app.services.stats_service import stats_service from models.database.feature import FeatureCode from models.database.user import User from app.modules.analytics.schemas import ( VendorAnalyticsCatalog, VendorAnalyticsImports, VendorAnalyticsInventory, VendorAnalyticsResponse, ) router = APIRouter(prefix="/analytics") 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"] ), )