Files
Verde-Web/app/Models/QrCodeBatch.php
admin d458e74301 feat(backend): complete Module 7 — QR code system (core)
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>
2026-04-30 02:12:41 +08:00

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');
}
}