feat(revisions): add pruning estimate and cleanup endpoints

Implemented new endpoints for estimating and pruning revisions, including detailed schemas for requests and responses. The `RevisionPruneEstimate` and `RevisionPruneResult` components were added to the OpenAPI documentation, enhancing the API's functionality for managing revision retention. Updated the backend to support these operations and integrated them into the tenant settings UI for improved user interaction.

web/src/lib/components/tenant-settings/TenantRevisionSettingsCard.svelte

@@ -2,10 +2,17 @@
 	import { onMount } from 'svelte';
 	import { defaults, superForm } from 'sveltekit-superforms';
 	import { zod4 } from 'sveltekit-superforms/adapters';
+	import type { AuthSession } from '$lib/api/types.js';
+	import { apiJSON } from '$lib/api/client.js';
 	import {
 		emptyRevisionSettingsForm,
 		revisionSettingsSchema
 	} from '$lib/settings/revision-settings.schema.js';
+	import {
+		fetchRevisionPruneEstimate,
+		pruneRevisionsNow,
+		type RevisionPruneEstimate
+	} from '$lib/settings/revision-prune-api.js';
 	import {
 		buildPayloadFromFormFields,
 		loadSettings,
@@ -13,6 +20,7 @@
 		patchSettings
 	} from '$lib/settings/settings-api.js';
 	import { REVISION_SETTING_KEYS } from '$lib/settings/settings-known-keys.js';
+	import { formatBytes } from '$lib/monitoring/postgres.js';
 	import { Button } from '$lib/ui/core/button/index.js';
 	import {
 		Card,
@@ -23,12 +31,18 @@
 	} from '$lib/ui/core/card/index.js';
 	import { Input } from '$lib/ui/core/input/index.js';
 	import FormField from '$lib/ui/patterns/form/form-field.svelte';
+	import { confirm } from '$lib/ui/patterns/confirm/confirm-state.svelte.js';
 	import { notify, notifyApiError } from '$lib/ui/app/toast.js';
 	import Save from '@lucide/svelte/icons/save';
+	import Trash2 from '@lucide/svelte/icons/trash-2';
 
 	let loading = $state(false);
 	let saving = $state(false);
+	let pruning = $state(false);
 	let loaded = $state(false);
+	let session = $state<AuthSession | null>(null);
+	let estimateLoading = $state(false);
+	let estimate = $state<RevisionPruneEstimate | null>(null);
 
 	const { form, errors, reset, validateForm } = superForm(
 		defaults(emptyRevisionSettingsForm(), zod4(revisionSettingsSchema)),
@@ -39,13 +53,60 @@
 		}
 	);
 
-	let hasValidationErrors = $derived(Boolean($errors.revision_retention_minutes?.length));
+	const isOperator = $derived(session?.role === 'operator');
+	const hasValidationErrors = $derived(Boolean($errors.revision_retention_minutes?.length));
 
-	let canSave = $derived.by(() => {
+	const parsedRetentionMinutes = $derived.by(() => {
+		const s = String($form.revision_retention_minutes ?? '').trim();
+		if (s === '' || !/^\d+$/.test(s)) return null;
+		const n = Number(s);
+		if (!Number.isInteger(n) || n < 15 || n > 43200) return null;
+		return n;
+	});
+
+	const canSave = $derived.by(() => {
 		if (loading || saving || hasValidationErrors || !loaded) return false;
 		return String($form.revision_retention_minutes ?? '').trim() !== '';
 	});
 
+	const canPruneNow = $derived.by(() => {
+		if (!isOperator || !loaded || pruning || saving || parsedRetentionMinutes === null)
+			return false;
+		return (estimate?.revision_count ?? 0) > 0;
+	});
+
+	async function loadSession() {
+		try {
+			session = await apiJSON<AuthSession>('/v1/auth/session');
+		} catch {
+			session = null;
+		}
+	}
+
+	async function refreshEstimate(minutes: number) {
+		estimateLoading = true;
+		try {
+			estimate = await fetchRevisionPruneEstimate(minutes);
+		} catch (e) {
+			estimate = null;
+			notifyApiError(e, 'Не удалось рассчитать оценку очистки');
+		} finally {
+			estimateLoading = false;
+		}
+	}
+
+	$effect(() => {
+		const minutes = parsedRetentionMinutes;
+		if (!loaded || minutes === null) {
+			estimate = null;
+			return;
+		}
+		const handle = setTimeout(() => {
+			void refreshEstimate(minutes);
+		}, 400);
+		return () => clearTimeout(handle);
+	});
+
 	async function load() {
 		loading = true;
 		try {
@@ -89,7 +150,46 @@
 		}
 	}
 
+	async function requestPruneNow() {
+		const minutes = parsedRetentionMinutes;
+		if (minutes === null) return;
+		let est: RevisionPruneEstimate;
+		try {
+			est = await fetchRevisionPruneEstimate(minutes);
+		} catch (e) {
+			notifyApiError(e);
+			return;
+		}
+		estimate = est;
+		if (est.revision_count === 0) {
+			notify.info('Нет ревизий для удаления по выбранному retention');
+			return;
+		}
+		void confirm({
+			title: 'Очистить старые ревизии?',
+			description: `Будет удалено ${est.revision_count} ревизий. Ориентировочно освободится ~${formatBytes(est.bytes_estimate)}. Действие необратимо.`,
+			confirmLabel: 'Очистить',
+			destructive: true,
+			onConfirm: async () => {
+				pruning = true;
+				try {
+					const res = await pruneRevisionsNow(minutes);
+					notify.success(
+						`Удалено ревизий: ${res.deleted_revisions}, освобождено ~${formatBytes(res.bytes_estimate)}`
+					);
+					await refreshEstimate(minutes);
+				} catch (e) {
+					notifyApiError(e);
+					throw e;
+				} finally {
+					pruning = false;
+				}
+			}
+		});
+	}
+
 	onMount(() => {
+		void loadSession();
 		void load();
 	});
 </script>
@@ -98,7 +198,8 @@
 	<CardHeader>
 		<CardTitle>Хранение ревизий</CardTitle>
 		<CardDescription>
-			Автоматическая очистка старых ревизий. Последняя раскатанная ревизия не удаляется.
+			Автоматическая очистка старых ревизий. Последняя ревизия и раскатанные на спикерах не
+			удаляются.
 		</CardDescription>
 	</CardHeader>
 	<CardContent class="space-y-4">
@@ -123,16 +224,54 @@
 				/>
 			</FormField>
 
+			{#if parsedRetentionMinutes !== null}
+				<div class="space-y-1 rounded-md border bg-muted/30 p-4 text-sm">
+					<p class="font-medium">Оценка очистки по введённому retention</p>
+					{#if estimateLoading}
+						<p class="text-muted-foreground">Расчёт…</p>
+					{:else if estimate}
+						<p>
+							Будет удалено ревизий: <strong>{estimate.revision_count}</strong>
+						</p>
+						<p>
+							Освободится ориентировочно: <strong>~{formatBytes(estimate.bytes_estimate)}</strong>
+						</p>
+						{#if estimate.prefix_row_count > 0}
+							<p class="text-xs text-muted-foreground">
+								Строк префиксов в снимках: {estimate.prefix_row_count}
+								{#if estimate.orphan_snapshot_count > 0}
+									· снимков: {estimate.orphan_snapshot_count}
+								{/if}
+							</p>
+						{/if}
+					{:else}
+						<p class="text-muted-foreground">Оценка недоступна</p>
+					{/if}
+					<p class="pt-1 text-xs text-muted-foreground">
+						Учитываются те же правила, что при автоочистке: последняя ревизия и раскатанные на
+						спикерах не удаляются.
+					</p>
+				</div>
+			{/if}
+
 			{#if hasValidationErrors}
 				<p class="text-sm text-destructive">
 					Есть ошибки в полях. Исправьте их, чтобы сохранить изменения.
 				</p>
 			{/if}
 
-			<Button onclick={save} disabled={!canSave}>
-				<Save />
-				{saving ? 'Сохранение…' : 'Применить параметры ревизий'}
-			</Button>
+			<div class="flex flex-wrap gap-2">
+				<Button onclick={save} disabled={!canSave}>
+					<Save />
+					{saving ? 'Сохранение…' : 'Применить параметры ревизий'}
+				</Button>
+				{#if isOperator}
+					<Button variant="destructive" disabled={!canPruneNow} onclick={requestPruneNow}>
+						<Trash2 />
+						{pruning ? 'Очистка…' : 'Очистить сейчас'}
+					</Button>
+				{/if}
+			</div>
 		{/if}
 	</CardContent>
 </Card>

web/src/lib/settings/revision-prune-api.ts

@@ -0,0 +1,30 @@
+import { apiJSON, apiMutate } from '$lib/api/client.js';
+
+export type RevisionPruneEstimate = {
+	retention_minutes: number;
+	cutoff_at: string;
+	revision_count: number;
+	prefix_row_count: number;
+	orphan_snapshot_count: number;
+	bytes_estimate: number;
+};
+
+export type RevisionPruneResult = {
+	deleted_revisions: number;
+	deleted_prefix_snapshots: number;
+	deleted_prefix_rows: number;
+	bytes_estimate: number;
+};
+
+export async function fetchRevisionPruneEstimate(
+	retentionMinutes: number
+): Promise<RevisionPruneEstimate> {
+	const q = new URLSearchParams({ retention_minutes: String(retentionMinutes) });
+	return apiJSON<RevisionPruneEstimate>(`/v1/revisions/prune-estimate?${q}`);
+}
+
+export async function pruneRevisionsNow(retentionMinutes: number): Promise<RevisionPruneResult> {
+	return apiMutate<RevisionPruneResult>('/v1/revisions/prune', 'POST', {
+		retention_minutes: retentionMinutes
+	});
+}