Scopes Laravel Package

Product Decisions This Supports

• Database Query Optimization: Enables cleaner, more maintainable query logic by encapsulating complex filtering rules (e.g., role-based access, soft deletes, or multi-tenant scopes) as reusable components. Reduces technical debt from scattered WHERE clauses or ad-hoc query builders.
• Developer Velocity: Accelerates feature delivery by standardizing scope definitions (e.g., "active users," "premium features") across the codebase, reducing duplication and onboarding time for new engineers.
• Security & Compliance: Simplifies implementation of access control (e.g., isAdminScope, auditLogScope) by centralizing logic, reducing human error in permission checks.
• Roadmap Flexibility: Supports future-proofing for dynamic filtering (e.g., A/B testing scopes, feature flags) without modifying core business logic.
• Build vs. Buy: Justifies building this capability in-house (vs. third-party tools) for teams already using Laravel, avoiding vendor lock-in and aligning with existing PHP ecosystems.

When to Consider This Package

• Adopt if:

  • Your Laravel app has repeated query patterns (e.g., "show only verified users," "filter by region") that are currently hardcoded or duplicated.
  • You prioritize developer experience over minimalist frameworks (e.g., prefer readability of User::active()->premium() over raw SQL or Eloquent chaining).
  • Your team lacks a standardized way to apply filters across models, leading to inconsistent or brittle query logic.
  • You need dynamic scopes (e.g., runtime-scoped queries for dashboards) without bloating model classes.

• Look elsewhere if:

  • Your queries are extremely simple (e.g., single-table WHERE clauses) and don’t benefit from abstraction.
  • You’re using a non-Laravel PHP framework (this package is Laravel-specific).
  • Your team prefers SQL-first approaches (e.g., raw queries or ORM-agnostic tools like QueryBuilder).
  • You need advanced analytics (e.g., window functions, CTEs) that scopes don’t natively support.

How to Pitch It (Stakeholders)

For Executives: "This package lets us write cleaner, more secure database queries by packaging common filters (like ‘active users’ or ‘admin-only’) into reusable components. Think of it like a ‘copy-paste’ for query logic—no more scattered WHERE clauses or debugging permission issues. It speeds up development, reduces bugs, and makes our code easier to maintain, especially as we scale features like multi-tenancy or role-based access."

For Engineering: "Scopes standardizes how we filter data across the app. Instead of repeating WHERE logic or mixing it with business logic, we define scopes once (e.g., User::scopeActive()) and reuse them everywhere. It’s lightweight, Laravel-native, and plays well with Eloquent. Perfect for teams tired of ad-hoc query builders or SQL in controllers. Let’s prototype it on a high-impact model (e.g., Order) to prove the win."

For Developers: "No more hunting for ‘where did this filter come from?’—scopes keep query logic DRY and organized. Want to add a ‘soft-deleted’ filter? One scope definition, applied everywhere. Plus, it’s dead simple to chain: User::active()->premium()->limit(10). Ready to try it on a messy query you’ve been avoiding?"