Skip to content

3.0.0

Latest
Latest

Choose a tag to compare

View all tags
@nasrulhazim nasrulhazim released this 13 Nov 11:05
3.0.0
290327b

Release Notes - Laravel Running Number v3.0.0

Release Date: November 13, 2025

Version 3.0.0 is a major release featuring significant enhancements, comprehensive documentation, and breaking changes. This release modernizes the package with native PHP 8.1+ features and introduces powerful new capabilities.

🚀 Major Enhancements

Traitify Integration

  • Native PHP 8.1+ enums support (migrated from spatie/laravel-enum) - Enums Configuration
  • UUID support for all running number records via InteractsWithUuid trait
  • Enhanced enum capabilities: values(), labels(), options(), descriptions() methods

Running Number Management

  • Reset/restart functionality with custom starting points - Artisan Commands
  • Date-based formatting for time-organized numbers (e.g., INV-2024-01-001) - Date-Based Formats
  • Multiple sequences per type with scope support (branch-specific, department-specific) - Multiple Sequences
  • Custom starting numbers per type - Custom Starting Numbers
  • Number range management with overflow detection - Range Management

Generation Features

  • Preview mode to check next number without persisting - Preview & Batch
  • Bulk generation for multiple numbers in single operation - Preview & Batch
  • Improved concurrency handling for high-volume generation
  • Optional audit trail with generation history tracking

Developer Experience

  • HasRunningNumber Eloquent trait for seamless model integration - Model Integration
  • Artisan commands: list, reset, restart, preview, and statistics - Artisan Commands
  • Events system: RunningNumberGenerated and RunningNumberReset - Events
  • REST API endpoints for remote generation - REST API
  • Enhanced service container integration
  • Helper functions, facades, and improved type hints

Documentation Overhaul

  • 20+ dedicated documentation files organized in 7 major sections - Documentation
  • Progressive learning path from basics to advanced topics - Getting Started
  • Real-world examples and common scenarios - Common Scenarios
  • Advanced integration patterns - Integration Patterns
  • Custom presenters and generators guides - Custom Presenters | Custom Generators
  • Developer contribution guidelines - Contributing

⚠️ Breaking Changes

  • Enum Migration: Updated from Spatie enums to native PHP 8.1+ enums with Traitify
  • Database Schema: Added required uuid column to running_numbers table
  • Configuration: Extended with new options for reset periods, date formats, starting numbers, and audit trail
  • Minimum Requirements: PHP 8.1+ now required

Migration Guide: See Upgrade Guide for complete v3.0.0 upgrade instructions

📦 Dependencies

  • Added cleaniquecoders/traitify ^1.2.1
  • PHP 8.1 | 8.2 | 8.3 | 8.4
  • Laravel 9.x | 10.x | 11.x | 12.x

📚 Documentation

Complete documentation available at here

Full Changelog: 2.3.0...3.0.0

Assets 2
Loading