dorfteich/packages/shared/i18n/en/system.json
Claude Fable 5 5cef359b8f
All checks were successful
CI / Lint, typecheck, test (push) Successful in 3m45s
CD / Build and push images (push) Successful in 3m49s
CI / Build container images (push) Has been skipped
CD / Deploy to Test (push) Successful in 9s
CD / Smoke tests against Test (push) Successful in 1m18s
CD / Promote to Int (push) Successful in 11s
CI / Auth e2e pack (push) Successful in 5m35s
CI / Import/export fidelity gate (push) Successful in 47s
Nextcloud backup target: admin-configured, manual + scheduled uploads, in-app restore (#103)
Off-host backups for every self-hoster, configured entirely in the admin
UI — supersedes the host-specific mirror plan behind #84.

shared:
- webdav.ts (new package entry like token-crypto): minimal WebDAV client
  with basic auth — PROPFIND (tolerant multistatus parser), MKCOL, PUT
  (streamed), GET, DELETE; Nextcloud DAV path derived from the plain
  server URL, explicit DAV bases pass through
- backup-status.ts: additive remote-upload status in status.json, the
  restore-status.json contract (running/succeeded/failed + staleness
  bound), the backup_command/backup_maintenance NOTIFY channels, and the
  one-bundle-per-set naming (dorfteich-backup-<id>.tar.gz)
- backup-set.ts moved here from apps/backup (api lists local sets)

backup sidecar:
- reads the backup.* instance settings directly from the database (admin
  changes apply next run; local retention row overrides the env) and the
  app password from the secret store
- after each successful set: bundle dump + files archive + manifest into
  ONE self-contained tar.gz, upload via WebDAV per schedule
  (off/daily/weekly; manual runs always upload), prune remote bundles —
  never the newest — and record the outcome in status.json; upload
  failures alert via a new backupUploadFailed mail (de+en)
- command listener on backup_command (run / restore) with a serial queue
  against the nightly timer
- restore orchestrator: restore-status.json → maintenance NOTIFY →
  grace → (remote: download + manifest-verify bundle) → terminate other
  DB connections → shared perform-restore path (same code as restore.sh)
  → final status + maintenance exit

api:
- MaintenanceGuard (global, registered before the setup gate): 503
  maintenance_mode while restore-status says running; health endpoints
  and the new public GET /backup/restore-status stay exempt; a stale
  running state (crashed sidecar) unblocks after 30 min
- MaintenanceStateService watches the file and restarts the api after a
  successful restore (fresh caches, migrate-on-start for older dumps);
  main.ts refuses to touch the database while a restore runs — a
  container restarting mid-restore must not race pg_restore with
  migrate deploy
- worker sweeps (conversion, mail outbox, scheduler) catch transient
  database failures instead of dying on an unhandled rejection — the
  restore's connection termination crashed the api in verification
- backup admin endpoints under /admin/system/backup: settings (live
  connection test before save, password write-only into the secret
  store), nextcloud/test, sets (local via the ro backups mount + remote
  via WebDAV), run + restore (type-to-confirm backstop, source
  validation) — commands travel as NOTIFY payloads; audit actions
  backup.settings_changed/run_triggered/restore_requested
- readyz: new warning-level backup_remote check while a target is
  configured (26 h daily / 170 h weekly bound)

collab:
- maintenance listener: on enter, persist + close every live session and
  refuse new connections until exit (failsafe timeout 30 min) — no
  in-memory document may write pre-restore content back afterwards

web:
- Admin → System backup section: status card with remote facts and a
  "Back up now" button, the Nextcloud settings form with test button,
  and the restore picker (local + remote sets, type-to-confirm)
- global maintenance screen: any 503 maintenance_mode flips the SPA to a
  status page polling the exempt endpoint, reloading when the instance
  returns

Verified end-to-end against a live stack (fresh DB, native api + sidecar,
fake WebDAV server): configure → test → manual backup → bundle upload →
readyz/sets/status surfaces → remote restore with maintenance gate,
marker rollback and api restart; suites: shared 21, backup 9, collab 11,
api 58 files green, lint + i18n:check + typecheck clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EwZ4jR4KFAPvpjWevfUGX1
2026-07-12 10:39:18 +02:00

193 lines
6.9 KiB
JSON

{
"title": "System",
"backLink": "Back to settings",
"settingsLink": "System panel",
"jobs": {
"title": "Maintenance jobs",
"columns": {
"job": "Job",
"cadence": "Cadence",
"lastRun": "Last run",
"duration": "Duration",
"outcome": "Outcome",
"actions": "Actions"
},
"names": {
"trash-purge": "Trash purge",
"version-thinning": "Version thinning",
"page-compaction": "Page compaction",
"data-export-purge": "Data-export purge"
},
"outcome": {
"ok": "OK",
"running": "Running",
"failed": "Failed",
"never": "Never ran"
},
"unregistered": "No longer registered in this build",
"run": "Run now",
"runPending": "Running…",
"triggered": {
"succeeded": "Run finished successfully.",
"failed": "Run failed — see the error in the row.",
"already_running": "Already running elsewhere — try again in a moment."
},
"cadence": {
"days_one": "every day",
"days_other": "every {{count}} days",
"hours_one": "hourly",
"hours_other": "every {{count}} hours",
"minutes_one": "every minute",
"minutes_other": "every {{count}} minutes",
"seconds_other": "every {{count}} seconds"
}
},
"backup": {
"title": "Backups",
"fresh": "Fresh",
"stale": "Stale — older than {{hours}} h",
"unavailable": "No backup status found. The backup sidecar has not run yet (or is not deployed) — see deploy/monitoring.md.",
"lastSuccess": "Last successful backup",
"lastRun": "Last run",
"outcome": {
"succeeded": "succeeded",
"failed": "failed"
},
"never": "none yet",
"sizes": "Dump {{dump}}, files {{archive}}",
"retention": "Retention: {{days}} days",
"error": "Last error",
"runNow": "Back up now",
"runPending": "Requesting…",
"runRequested": "Backup requested — the sidecar is running it in the background. This card refreshes automatically.",
"remote": {
"title": "Nextcloud target",
"notConfigured": "No Nextcloud target configured — backups stay on this host only.",
"lastUpload": "Last upload",
"lastSuccessfulUpload": "Last successful upload",
"bundleSize": "bundle {{size}}"
},
"settings": {
"title": "Backup settings",
"localRetention": "Local retention (days)",
"localRetentionHint": "Empty = keep the container default (BACKUP_RETENTION_DAYS).",
"remoteRetention": "Nextcloud retention (days)",
"enabled": "Upload backups to Nextcloud",
"baseUrl": "Nextcloud address (URL)",
"baseUrlHint": "The plain server address, e.g. https://cloud.example.com — the WebDAV path is derived.",
"username": "Username",
"password": "App password",
"passwordStored": "Stored — leave empty to keep it",
"passwordHint": "Create one in Nextcloud under Settings → Security → Devices & sessions.",
"folder": "Folder",
"schedule": "Upload schedule",
"scheduleOptions": {
"off": "Manual only",
"daily": "After every backup (daily)",
"weekly": "Weekly"
},
"test": "Test connection",
"testPending": "Testing…",
"testOk": "Connection ok — folder is reachable.",
"save": "Save backup settings",
"savePending": "Saving…",
"saved": "Backup settings saved."
},
"restore": {
"title": "Restore",
"open": "Restore a backup…",
"warning": "Restoring replaces ALL current content, files and settings of this instance with the state of the selected backup. The instance goes into maintenance mode while the restore runs.",
"loading": "Loading backup sets…",
"localTitle": "On this host",
"remoteTitle": "On Nextcloud",
"empty": "No restorable sets found.",
"remoteError": "The Nextcloud sets could not be listed: {{error}}",
"confirmLabel": "Type the backup id to confirm: {{id}}",
"button": "Restore this backup",
"pending": "Requesting restore…",
"requested": "Restore requested — the instance is entering maintenance mode.",
"status": {
"running": "Restore of {{id}} is running (started {{startedAt}})…",
"succeeded": "Restore of {{id}} succeeded ({{finishedAt}}).",
"failed": "Restore of {{id}} failed: {{error}}"
}
}
},
"audit": {
"title": "Audit log",
"filters": {
"actor": "Actor (username)",
"action": "Action",
"actionAny": "All actions",
"from": "From",
"to": "Until",
"apply": "Filter"
},
"columns": {
"time": "Time",
"actor": "Actor",
"action": "Action",
"target": "Target",
"details": "Details"
},
"systemActor": "System",
"empty": "No entries match the filter.",
"pager": "Page {{page}} of {{pageCount}} ({{total}} entries)",
"previous": "Previous",
"next": "Next",
"actions": {
"grant.created": "Access rule created",
"grant.deleted": "Access rule deleted",
"member.added": "Member added",
"member.role_changed": "Member role changed",
"member.removed": "Member removed",
"user.disabled_set": "User disabled/enabled",
"user.verification_resent": "Verification mail resent",
"user.deleted": "User deleted",
"user.site_admin_set": "Site-Admin role changed",
"user.pseudonymized": "User pseudonymized",
"quota.override_set": "Quota override set",
"quota.override_cleared": "Quota override cleared",
"plugin.installed": "Plugin installed",
"plugin.mode_set": "Plugin mode changed",
"plugin.uninstalled": "Plugin uninstalled",
"plugin.pond_toggled": "Pond plugin toggled",
"settings.changed": "Instance setting changed",
"setup.preseeded": "Setup pre-seeded",
"setup.admin_created": "Setup: admin created",
"setup.smtp_stored": "Setup: SMTP stored",
"setup.completed": "Setup completed",
"auth.signup": "Sign-up",
"auth.email_verified": "E-mail verified",
"auth.login_failed": "Login failed",
"auth.login_succeeded": "Login",
"auth.password_reset": "Password reset",
"job.triggered": "Job triggered manually",
"backup.settings_changed": "Backup settings changed",
"backup.run_triggered": "Manual backup triggered",
"backup.restore_requested": "Backup restore requested"
}
},
"storage": {
"title": "Storage",
"total": "Total usage: {{total}}",
"columns": {
"pond": "Pond",
"type": "Type",
"used": "Used"
},
"types": {
"personal": "personal",
"shared": "shared"
},
"empty": "No usage recorded yet."
},
"maintenance": {
"title": "Maintenance mode",
"body": "A backup is being restored. The instance is temporarily unavailable.",
"waiting": "Waiting for the instance to come back…",
"failed": "The restore failed: {{error}}",
"reload": "Reload"
}
}