Recovery Center
The Recovery Center is the admin shell for import and recovery work. Admin provides the navigation, permissions, import-session resource, notifications, and fallback actions. The actual export/import/restore implementation is supplied by the optional capell-app/backup package.
This split matters: export/import is not a Core feature. If Backup is not installed, Admin can show the recovery area but import actions either stay unavailable or report that the Backup package is required.
What Admin Provides
Section titled “What Admin Provides”| Admin surface | Purpose |
|---|---|
| Import sessions | Review previous import attempts, current status, timestamps, counts, and errors. |
| Recovery navigation | Groups import/recovery screens in the admin panel. |
| Notifications | Sends completion and failure messages for import sessions. |
| Backup contracts | Defines interfaces such as page export so Backup can bind the real implementation. |
| Permissions | Installs and checks recovery/import permissions for admin users. |
What Backup Provides
Section titled “What Backup Provides”capell-app/backup owns the actual recovery workflows:
| Workflow | What it does |
|---|---|
| Page export | Packages selected pages and relations for transfer or safekeeping. |
| Site export | Packages a site and related content. |
| Package import | Reads package manifests, validates integrity, resolves relations, ingests media, and creates import sessions. |
| Restore | Restores backup state using the package’s restore services. |
| WordPress import | Reads WordPress XML and runs it through a reviewable import path. |
Backup lives in the sibling first-party packages repository. See Approved packages for where it fits in the product.
Editor Workflow
Section titled “Editor Workflow”- Open the Recovery Center from the admin navigation.
- Start an import using the package-specific screen made available by Backup.
- Review validation results, URL collisions, and relation resolution prompts.
- Confirm the import plan.
- Watch the import session until it completes or fails.
- Review imported draft content before publishing it.
When PublishingStudio is installed, imported content can be reviewed before it reaches the live site. That keeps recovery work out of the public frontend until an editor or approver signs it off.
Developer Notes
Section titled “Developer Notes”Admin references Backup through contracts and null implementations. Do not put import/export domain logic in Admin resources or Filament pages. Add package behavior in Backup, bind the relevant contracts, and expose only the required admin screens through package registration.
Related docs: