docs(backup): say what account copies and the JSON import can do

Several surfaces promised more than the per-account copies deliver:

- The full-backup export card said it had the same shape as the weekly
  copy. It is a portable export with documents as metadata only; it now
  says so, and that it cannot recreate an account on another server.
- The export page offered to "import from a backup". The JSON import adds
  measurements and mood entries; it is now named that way, and its help
  states the 16 MB and 10,000-entries-per-list limits from the constants
  the route enforces.
- The weekly copy is labelled an account rollback on this server, and the
  backups page says a copy cannot rebuild a lost server. The upload says
  the account must exist here. Two restore refusals pointed to a
  "disaster-recovery" copy; they now name the copies that exist.
- The instance-settings restore option was described as being for
  rebuilding a host.

docs/ops/backup-restore.md is rewritten short and accurate: what each
copy is, the deletion grace window, that database dumps keep a deleted
account until they age out, how to restore one account, and a link to
the disaster-recovery procedure for a lost server.
This commit is contained in:
Marc-André Bombeck committed 2026-10-25 13:51:15 +01:00
1 parent 63574b98a6
commit 0c5f29303b
17 files changed
+258 -571

No files matched your search

@@ -64,7 +64,7 @@ describe("RestoreRefusalNotice", () => {
const html = render(["documents"]);
expect(html).toContain("Nothing was changed");
expect(html).toContain("disaster-recovery snapshot");
expect(html).toContain("account copies or an off-host copy");
});
it("renders nothing when no section was missing", () => {
@@ -11,6 +11,10 @@ import { useTranslations } from "@/lib/i18n/context";
import { apiFetchRaw } from "@/lib/api/api-fetch";
import { ImportCardShell } from "./import-card-shell";
import { IMPORT_GUIDE_URL, MAX_PASTE_CHARS } from "./constants";
import {
JSON_IMPORT_MAX_BYTES,
JSON_IMPORT_MAX_ROWS,
} from "@/lib/import/json/limits";
import {
EXAMPLE_IMPORT_DOWNLOAD_HREF,
parseImportJson,
@@ -122,7 +126,7 @@ export function JsonImportResultView({ result }: { result: JsonImportResult }) {
}
export function JsonImportCard() {
const { t } = useTranslations();
const { t, locale } = useTranslations();
const fileInputRef = useRef<HTMLInputElement>(null);
const [text, setText] = useState("");
@@ -226,6 +230,15 @@ export function JsonImportCard() {
onChange={onFileChange}
/>
{/* What this import is, and its limits: it adds measurements and mood
entries; it is not a way back from a full backup. The numbers are
the ones the route enforces. */}
<p className="text-muted-foreground text-xs">
{t("settings.sections.export.import.json.limitsHint", {
mb: JSON_IMPORT_MAX_BYTES / (1024 * 1024),
rows: JSON_IMPORT_MAX_ROWS.toLocaleString(locale),
})}
</p>
<p className="text-muted-foreground text-xs">
{t("settings.sections.export.import.json.schemaHint")}{" "}
{/* The import guide lives on the external docs site — the app