En muchas aplicaciones web la generación de referencias únicas para modelos es un requisito habitual. Ya sea para numerar pedidos en una tienda online, generar referencias de facturas o crear identificadores rastreables, la gestión de la generación de referencias puede complicarse rápidamente. Referenceable es un paquete para Laravel creado por Mohamed Said que simplifica esta tarea permitiendo generar números de referencia personalizables con formatos flexibles y múltiples opciones de configuración.
Principales características
Multiples estrategias de generación Random, secuencial y basada en plantillas para adaptarse a distintos escenarios.
Alta configurabilidad Prefijos, sufijos, separadores y otros parámetros personalizables.
Sistema de plantillas Placeholders como {YEAR}, {MONTH}, {SEQ}, {RANDOM} para formatos complejos.
Numeración secuencial Secuencias autoincrementales con opciones de reinicio diario, mensual o anual.
Validación y verificación Validación integrada y comprobación de unicidad.
Gestión de colisiones Detección y resolución automática de colisiones de referencias.
Soporte multitenancy Generación de referencias consciente del inquilino o tenant.
Comandos Artisan Herramientas CLI completas para administración y mantenimiento.
Rendimiento Caché optimizado, procesamiento por lotes y uso de transacciones en base de datos.
Ejemplo de uso Para almacenar referencias crea una columna reference_number en la migracion y marca la columna como unica e indexada. En el modelo utiliza el trait HasReference y configura la estrategia deseada. Por ejemplo con una plantilla puedes usar un formato tipo {PREFIX}-{YEAR}{MONTH}{SEQ} con longitud de secuencia fija y un prefijo STL para generar referencias como STL-2025090001 y STL-2025090002.
Estrategias de referencia Template o plantilla para formatos complejos, sequential para secuencias controladas por start y min_digits con posibilidad de reset_frequency como daily, monthly o yearly, y random para referencias aleatorias con control de longitud y mayusculas o minusculas. Puedes configurar estas opciones a nivel de modelo o de forma global en el archivo de configuracion referenceable.php.
Métodos y scopes útiles Generar una referencia sin guardar con generateReference, comprobar si un modelo ya tiene referencia con hasReference, buscar por referencia con findByReference y consultar referencias que empiezan por un prefijo con scope referenceStartsWith.
Instalacion Instala el paquete con Composer y ejecuta el comando de instalacion de Artisan composer require eg-mohamed/referenceable y php artisan referenceable:install. El codigo fuente puede consultarse en GitHub en el repositorio oficial del autor.
En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida con amplia experiencia en la implementacion de soluciones empresariales. Desarrollamos sistemas a medida que integran buenas practicas de arquitectura, seguridad y rendimiento, y aplicamos herramientas como Referenceable cuando es necesario garantizar referencias unicas y trazables en modelos Laravel. Si necesitas crear una aplicacion a medida o una plataforma multicanal podemos ayudarte, conoce nuestros servicios de desarrollo en desarrollo de aplicaciones y software a medida.
Ademas ofrecemos servicios avanzados de inteligencia artificial, desde ia para empresas hasta agentes IA personalizados que automatizan tareas y mejoran la toma de decisiones. Integramos capacidades de IA en procesos de negocio y productos digitales, y podemos asesorarte en soluciones de inteligencia de negocio y visualizacion con Power BI. Conoce nuestras soluciones de IA en servicios de inteligencia artificial para empresas.
Tambien cubrimos ciberseguridad y pruebas de penetracion para proteger tus referencias, datos y servicios, y proporcionamos servicios cloud en plataformas como AWS y Azure para escalar y asegurar tus aplicaciones. Palabras clave relevantes para nuestro trabajo incluyen aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi.
Si buscas una implementacion robusta de referencias unicas en Laravel o una solución completa a medida que combine desarrollo, IA, ciberseguridad y cloud contacta con Q2BSTUDIO y trabajemos en una arquitectura que cumpla requisitos de unicidad, rendimiento y seguridad.
