qr_code_batches + qr_codes tables. State machine via
spatie/laravel-model-states (unassigned → allocated → active → used,
plus expired/voided). Serial format PH-{area}-{YYMM}-{batch}-{code}-
{checksum} with 2-char SHA-256-derived checksum. BatchGenerator
bulk-inserts in chunks. QrAllocator allocates free codes to verified
households (prefers area-targeted batch, falls back to any). Real
HouseholdVerified listener replaces the placeholder. QrBalanceLow
event for Module 11.
Admin: batch CRUD, mark-printed, void code, lifecycle search, PDF
print sheet (24/A4 via dompdf + endroid/qr-code + picqer/barcode).
Resident: list own codes, balance with low_balance flag, activate
allocated codes.
Removed explicit Event::listen for HouseholdVerified — Laravel 11
auto-discovers it via handle() type-hint, and double-registering was
causing double-dispatch.
130 feature tests passing.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
62 lines
1.4 KiB
PHP
62 lines
1.4 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
use Illuminate\Database\Eloquent\SoftDeletes;
|
|
|
|
class QrCodeBatch extends Model
|
|
{
|
|
use HasFactory, SoftDeletes;
|
|
|
|
public const PURPOSE_FREE = 'free_allocation';
|
|
public const PURPOSE_STORE = 'store_inventory';
|
|
public const PURPOSE_PROMO = 'promotional';
|
|
|
|
protected $table = 'qr_code_batches';
|
|
|
|
protected $fillable = [
|
|
'batch_number',
|
|
'quantity',
|
|
'purpose',
|
|
'target_area_id',
|
|
'target_store_id',
|
|
'created_by_admin_id',
|
|
'printed_at',
|
|
'expires_at',
|
|
'notes',
|
|
];
|
|
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'printed_at' => 'datetime',
|
|
'expires_at' => 'datetime',
|
|
'quantity' => 'integer',
|
|
];
|
|
}
|
|
|
|
public function getRouteKeyName(): string
|
|
{
|
|
return 'batch_number';
|
|
}
|
|
|
|
public function targetArea(): BelongsTo
|
|
{
|
|
return $this->belongsTo(ServiceArea::class, 'target_area_id');
|
|
}
|
|
|
|
public function createdBy(): BelongsTo
|
|
{
|
|
return $this->belongsTo(User::class, 'created_by_admin_id');
|
|
}
|
|
|
|
public function codes(): HasMany
|
|
{
|
|
return $this->hasMany(QrCode::class, 'batch_id');
|
|
}
|
|
}
|