yezzmedia/laravel-ops-backups

Ops-facing backup posture, retention visibility, and restore readiness package for the Yezz Media Laravel platform.

0.1.1 2026-04-13 10:33 UTC

Requires

• php: ^8.4
• filament/filament: ^5.0
• illuminate/contracts: ^13.0
• illuminate/database: ^13.0
• illuminate/support: ^13.0
• spatie/laravel-package-tools: ^1.92
• yezzmedia/laravel-foundation: ^0.1

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.29
• mockery/mockery: ^1.6
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.4
• pestphp/pest-plugin-laravel: ^4.1

Suggests

• spatie/laravel-activitylog: Optional audit persistence driver for ops backups audit events.
• yezzmedia/laravel-ops-infrastructure: Optional infrastructure enrichment for backup target and destination visibility.
• yezzmedia/laravel-ops-security: Optional security enrichment for backup encryption readiness visibility.
• yezzmedia/laravel-ops-sites: Optional site-scoped backup target enrichment for restore-readiness visibility.

proprietary

README

yezzmedia/laravel-ops-backups is the Yezz Media ops-facing package for backup posture, retention visibility, restore readiness, and backup failure reporting.

It is intentionally a visibility and metadata package, not a backup execution engine.

V1 Scope

• backup target inventory for platform, site, or resource scopes
• backup posture summary and detail views in the ops panel
• retention visibility and restore-readiness visibility
• recent failure reporting
• package-owned metadata recording actions for targets, runs, and artifacts
• package-owned audit events for refreshes and metadata recording
• doctor checks for store readiness, recent successful backups, retention coverage, and restore artifacts availability

Non-Goals

• no real backup execution
• no real restore execution
• no artifact download UI
• no storage browsing
• no raw backup-content inspection
• no credential-bearing destination URIs in package metadata

Package Surface

Permissions

• ops.backups.view
• ops.backups.manage

Both permissions declare defaultRoleHints: ['super-admin']. Persistence and role assignment remain owned by yezzmedia/laravel-access.

Features

• backups.inventory
• backups.retention
• backups.restore_readiness
• backups.failures

Audit Events

• ops.backups.posture_refreshed
• ops.backups.target_updated
• ops.backups.run_recorded
• ops.backups.artifact_recorded

Main Building Blocks

• OpsBackupsPlatformPackage
• OpsBackupsServiceProvider
• OpsBackupsFilamentPlugin
• OpsBackupsManager
• RefreshBackupPostureAction
• UpsertBackupTargetAction
• RecordBackupRunAction
• RecordBackupArtifactAction
• OpsBackupsPage
• BackupTargetDetailsPage

Storage

The package owns these tables:

• ops_backup_targets
• ops_backup_runs
• ops_backup_artifacts

These tables store operator-safe metadata only.

Development

Package-local scripts:

composer format
composer analyse
composer test

Shared fixture verification from 1-dev-test:

composer test:ops-backups
composer test:all

Host Integration

To expose the package in a consuming host:

1. require yezzmedia/laravel-ops-backups
2. install or update dependencies in the host
3. run package migrations
4. synchronize permissions through yezzmedia/laravel-access
5. verify /ops/ops-backups

License

Proprietary. All rights reserved by Yezz Media.