Some checks failed
CI / Lint, typecheck, test (push) Failing after 1m39s
CI / Auth e2e pack (push) Has been skipped
CI / Import/export fidelity gate (push) Has been skipped
CI / Build container images (push) Has been skipped
CD / Build and push images (push) Successful in 3m51s
CD / Deploy to Test (push) Successful in 9s
CD / Smoke tests against Test (push) Successful in 1m10s
CD / Promote to Int (push) Successful in 11s
Token-authenticated machine access at /api/public/v1 — the foundation for the built-in MCP endpoint (#105). Personal access tokens: - api_tokens table (SHA-256 hash, scope read|write, optional pond restriction, expiry, revocation, throttled last-used) + migration; secrets are dt_pat_<random>, shown exactly once - lifecycle endpoints under /users/me/api-tokens (session-only — a leaked token can never mint more tokens) with audit entries api.token_created/api.token_revoked - settings UI section (create with scope/expiry/pond restriction, one-time reveal with copy, list with status + revoke), de+en Activation (404 semantics per #60 on both levels): - instance setting api.enabled (default off, admin settings switch) - pond setting apiEnabled (default off, pond settings toggle; the PondsService settings-merge learned the key — the #92 lesson) Surface (/api/public/v1, excluded from the SPA's global prefix): - me, ponds, pages (list/read as Markdown+HTML, create from Markdown via the shared pipeline, PATCH title/content, DELETE to trash), search (permission-filtered + narrowed to exposed ponds, highlights as **…**), markdown ZIP export, labels (tree, create/rename/recolour/move/delete, assign/unassign), comments (threads, create, resolve/reopen) - content replacement travels the collab-owned document path: the new state lands as a MANUAL version "API update", then the established restore NOTIFY applies it — open editors converge, history stays append-only, no second lineage (VersionsService.replaceContent) - hand-maintained OpenAPI 3.1 document at /openapi.json, pinned to the controller by a route-coverage test in both directions Enforcement: - PublicApiGuard: instance switch → bearer PAT auth (request.user is the token's user) → per-token rate limit (429 + Retry-After) → scope (403 scope_required) → pond opt-in + token restriction - the shared PermissionGuard then applies the unchanged permission model; PageParamSource gained pondSlugParam for the slug+slug routes - no cookies anywhere → no CSRF surface (pinned by a hostile-Origin test) - every write audit-logged as api.write with the token attributed Tests/verification: - 12-test e2e pack: lifecycle, switches, permission matrix (reader/editor/outsider × scopes), restriction, page roundtrip incl. restore-NOTIFY assertion, labels, comments incl. policy, search narrowing, ZIP export, rate limit; full api suite 60/60 green (quota fixture via per-user override — never the instance default) - new collab-pack test proves an open editor converges onto an API content replacement (green against a local seeded stack) - UI smoke against the built SPA: token create/reveal/revoke, pond opt-in persists, admin switch persists (10/10) - docs/self-hosting/public-api.md + README link Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EwZ4jR4KFAPvpjWevfUGX1
196 lines
7.0 KiB
JSON
196 lines
7.0 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",
|
|
"api.token_created": "API token created",
|
|
"api.token_revoked": "API token revoked",
|
|
"api.write": "Write via public API"
|
|
}
|
|
},
|
|
"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"
|
|
}
|
|
}
|