Files
Verde-Web/app/Models/QrCode.php
admin 86ea731eb0 feat(backend): finish all deferred items — Sentry, audit, bulk, FCM, Reverb, PSGC
- **Sentry** wired in bootstrap/app.php via Sentry\Laravel\Integration.
  No-op when SENTRY_LARAVEL_DSN is empty.

- **Audit logging** broadened: LogsActivity applied to Household, QrCode,
  Trip, Payment with tight logOnly whitelists and named log channels
  ('household', 'qr_code', 'trip', 'payment') to keep the activity
  stream useful.

- **Bulk admin actions**:
  POST /admin/households/bulk-approve — skips already-approved /
  no-proof / unknown ids, reports per-id outcomes
  POST /admin/bulk/users/{suspend,activate} — admins protected
  POST /admin/bulk/qr-codes/void — respects state machine transitions

- **FCM push scaffold**: PushDriver contract with LogPushDriver
  (default) and FcmPushDriver (activates when FCM_SERVER_KEY is set).
  PushChannel adapts notifications. RoutesByPreferences now also
  routes via push when push_enabled + fcm_token. toPush() payloads
  added to HouseholdApproved / QrBalanceLow / PickupImminent.

- **Reverb WebSocket broadcast**: laravel/reverb installed.
  TruckLocationBroadcast fires on every TruckTracker::record().
  routes/channels.php authenticates: admins → private-admin.live,
  residents → area.{id}.trucks (only if their household barangay is
  covered by the service area).

- **PSGC seeder** expanded: all 17 PH regions, 4 NCR districts,
  all 17 NCR cities. Sample barangays still carry rectangular
  boundaries for point-in-polygon resolution tests.

- **Conditional SPATIAL INDEX migration** for barangays.boundary —
  safe no-op until every row has a polygon (i.e., after full PSA
  dataset import). Re-running `php artisan migrate` after import
  flips the column to NOT NULL and adds the index.

196 feature tests passing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 17:22:43 +08:00

79 lines
1.9 KiB
PHP

<?php
namespace App\Models;
use App\States\QrCode\QrCodeState;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Spatie\Activitylog\LogOptions;
use Spatie\Activitylog\Traits\LogsActivity;
use Spatie\ModelStates\HasStates;
class QrCode extends Model
{
use HasFactory, HasStates, LogsActivity;
protected $fillable = [
'serial',
'barcode_value',
'batch_id',
'status',
'assigned_to_household_id',
'assigned_to_store_id',
'allocated_at',
'activated_at',
'used_at',
'used_at_drop_off_id',
'scanned_by_user_id',
'expires_at',
'metadata',
];
protected function casts(): array
{
return [
'status' => QrCodeState::class,
'metadata' => 'array',
'allocated_at' => 'datetime',
'activated_at' => 'datetime',
'used_at' => 'datetime',
'expires_at' => 'datetime',
];
}
public function getRouteKeyName(): string
{
return 'serial';
}
public function getActivitylogOptions(): LogOptions
{
return LogOptions::defaults()
->logOnly(['status', 'assigned_to_household_id', 'assigned_to_store_id', 'used_at_drop_off_id'])
->logOnlyDirty()
->dontSubmitEmptyLogs()
->useLogName('qr_code');
}
public function batch(): BelongsTo
{
return $this->belongsTo(QrCodeBatch::class, 'batch_id');
}
public function household(): BelongsTo
{
return $this->belongsTo(Household::class, 'assigned_to_household_id');
}
public function usedAtDropOff(): BelongsTo
{
return $this->belongsTo(DropOffPoint::class, 'used_at_drop_off_id');
}
public function scannedBy(): BelongsTo
{
return $this->belongsTo(User::class, 'scanned_by_user_id');
}
}