Files
orion/app/modules/catalog/services/catalog_features.py
Samir Boulahtit 86e85a98b8
Some checks failed
CI / ruff (push) Successful in 9s
CI / docs (push) Has been cancelled
CI / deploy (push) Has been cancelled
CI / validate (push) Has been cancelled
CI / dependency-scanning (push) Has been cancelled
CI / pytest (push) Has been cancelled
refactor(arch): eliminate all cross-module model imports in service layer
Enforce MOD-025/MOD-026 rules: zero top-level cross-module model imports
remain in any service file. All 66 files migrated using deferred import
patterns (method-body, _get_model() helpers, instance-cached self._Model)
and new cross-module service methods in tenancy. Documentation updated
with Pattern 6 (deferred imports), migration plan marked complete, and
violations status reflects 84→0 service-layer violations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 06:13:15 +01:00

121 lines
3.5 KiB
Python

# app/modules/catalog/services/catalog_features.py
"""
Catalog feature provider for the billing feature system.
Declares catalog-related billable features (product limits, import/export)
and provides usage tracking queries for feature gating.
"""
from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import func
from app.modules.contracts.features import (
FeatureDeclaration,
FeatureScope,
FeatureType,
FeatureUsage,
)
if TYPE_CHECKING:
from sqlalchemy.orm import Session
class CatalogFeatureProvider:
"""Feature provider for the catalog module.
Declares:
- products_limit: quantitative per-store limit on product count
- product_import_export: binary merchant-level feature for import/export
"""
@property
def feature_category(self) -> str:
return "catalog"
def get_feature_declarations(self) -> list[FeatureDeclaration]:
return [
FeatureDeclaration(
code="products_limit",
name_key="catalog.features.products_limit.name",
description_key="catalog.features.products_limit.description",
category="catalog",
feature_type=FeatureType.QUANTITATIVE,
scope=FeatureScope.STORE,
default_limit=200,
unit_key="catalog.features.products_limit.unit",
ui_icon="package",
display_order=10,
),
FeatureDeclaration(
code="product_import_export",
name_key="catalog.features.product_import_export.name",
description_key="catalog.features.product_import_export.description",
category="catalog",
feature_type=FeatureType.BINARY,
scope=FeatureScope.MERCHANT,
ui_icon="upload-download",
display_order=20,
),
]
def get_store_usage(
self,
db: Session,
store_id: int,
) -> list[FeatureUsage]:
from app.modules.catalog.models.product import Product
count = (
db.query(func.count(Product.id))
.filter(Product.store_id == store_id)
.scalar()
or 0
)
return [
FeatureUsage(
feature_code="products_limit",
current_count=count,
label="Products",
),
]
def get_merchant_usage(
self,
db: Session,
merchant_id: int,
platform_id: int,
) -> list[FeatureUsage]:
from app.modules.catalog.models.product import Product
from app.modules.tenancy.services.platform_service import platform_service
from app.modules.tenancy.services.store_service import store_service
merchant_stores = store_service.get_stores_by_merchant_id(db, merchant_id)
platform_store_ids = platform_service.get_store_ids_for_platform(db, platform_id)
store_ids = [s.id for s in merchant_stores if s.id in platform_store_ids]
count = (
db.query(func.count(Product.id))
.filter(Product.store_id.in_(store_ids))
.scalar()
or 0
)
return [
FeatureUsage(
feature_code="products_limit",
current_count=count,
label="Products",
),
]
# Singleton instance for module registration
catalog_feature_provider = CatalogFeatureProvider()
__all__ = [
"CatalogFeatureProvider",
"catalog_feature_provider",
]