Function log_usage_event

apps/api/src/security/features_utils/usage.py:143–170

Log a usage event for billing tracking. Called when a member/course is added or removed.

(
    org_id: int,
    feature: str,
    event_type: Literal["add", "remove"],
    db_session: AsyncSession,
)

async def log_usage_event(
    org_id: int,
    feature: str,
    event_type: Literal["add", "remove"],
    db_session: AsyncSession,
):
    """
    Log a usage event for billing tracking.
    Called when a member/course is added or removed.
    """
    if feature not in PLAN_BASED_FEATURES:
        return

    # Get current actual count
    usage_after = await _get_actual_usage(feature, org_id, db_session)

    event = UsageEvent(
        org_id=org_id,
        feature=feature,
        event_type=event_type,
        timestamp=datetime.now(),
        usage_after=usage_after,
    )
    db_session.add(event)
    await db_session.commit()

    # Invalidate usage cache
    _invalidate_usage_cache(org_id)


# ============================================================================