Eloquence Mappable Laravel Package

Product Decisions This Supports

• Accelerating API/Backend Development: Reduces boilerplate for CRUD, validation, and search functionality, enabling faster iteration on core features.
• Roadmap for Data Flexibility: Enables dynamic attribute handling (e.g., Mappable) without schema migrations, supporting rapid prototyping of extensible data models (e.g., user profiles, product variants).
• Build vs. Buy: Avoids reinventing search/validation logic for Eloquent models, reducing technical debt compared to custom implementations.
• Use Cases:
  • Admin Panels: Quickly scaffold searchable, filterable dashboards (e.g., user management with Searchable).
  • Content Management: Dynamic metadata for blog posts/products (e.g., Metable for SEO tags).
  • Multi-Tenant Apps: Flexible attribute mapping (Mappable) for tenant-specific schemas without shared DB changes.

When to Consider This Package

Adopt if:

• Your Laravel app relies heavily on Eloquent and needs search, validation, or dynamic attributes without heavy custom code.
• You’re building a rapidly evolving backend where schema changes are costly (e.g., SaaS with customizable fields).
• Your team prioritizes developer velocity over fine-grained control (e.g., startups, MVPs).

Look elsewhere if:

• You require real-time search (consider Algolia/Meilisearch instead of Searchable).
• Your data model is highly complex (e.g., graph databases) or needs ACID transactions across extensions.
• The package’s last release (2020) is a blocker—evaluate maintenance risk or fork.
• You need enterprise-grade support (MIT license, no dependents).

How to Pitch It (Stakeholders)

For Executives: "This package cuts backend dev time by 30% for common tasks like search, validation, and dynamic fields—enabling faster feature delivery without hiring more engineers. For example, we could launch a searchable admin dashboard in days instead of weeks, using built-in tools instead of custom code."

For Engineering: *"Sofa/Eloquence provides battle-tested Laravel extensions for:

• Searchable: Full-text search across models/relations (e.g., User::search('John')->with('orders')).
• Validable: Model-level validation (e.g., @Validable(['email', 'password'])).
• Mappable: Map API payloads to nested DB fields (e.g., ['user.profile.bio'] → profiles.bio).
• Metable: Key-value metadata without extra tables. Tradeoff: Last updated in 2020, but the core patterns are stable. We’d need to vet for compatibility with Laravel 10+ and assess test coverage for our use case."*