feat(ops): чистка данных, reindex и PWA с офлайн-режимом

- internal/retention: истёкшие сессии, аудит старше RETENTION_AUDIT_DAYS и
  файлы без ссылок старше RETENTION_ORPHAN_HOURS; сиротой файл считается
  только если на него не ссылается ничего (вложения, аватары, оформление
  сервера, комнат, ролей, эмодзи, звуки, вебхуки, приглашения)
- обслуживание запускается в приложении по RETENTION_INTERVAL_SECONDS;
  команды glchat cleanup и glchat reindex делают то же вручную
- PWA: манифест с иконками и shortcuts, офлайн-страница, сервис-воркер
  (кэш только /assets/*, приватные запросы не кэшируются)
- тесты: Go на чистку (сирота удаляется, используемые файлы и свежие сироты
  остаются, истёкшая сессия уходит), Vitest на манифест и регистрацию воркера

web/index.html

@@ -5,8 +5,13 @@
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="color-scheme" content="dark light" />
     <meta name="description" content="glchat — self-hosted платформа общения" />
+    <meta name="theme-color" content="#1a1b1e" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-title" content="glchat" />
     <title>glchat</title>
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="apple-touch-icon" href="/icons/icon-192.png" />
+    <link rel="manifest" href="/manifest.webmanifest" />
   </head>
   <body>
     <div id="root"></div>

web/public/manifest.webmanifest

@@ -0,0 +1,29 @@
+{
+  "name": "glchat",
+  "short_name": "glchat",
+  "description": "glchat — self-hosted платформа общения: серверы, комнаты, голос и файлы",
+  "lang": "ru",
+  "dir": "ltr",
+  "start_url": "/app",
+  "scope": "/",
+  "display": "standalone",
+  "display_override": ["window-controls-overlay", "standalone"],
+  "orientation": "any",
+  "background_color": "#1a1b1e",
+  "theme_color": "#1a1b1e",
+  "categories": ["social", "communication"],
+  "icons": [
+    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" },
+    {
+      "src": "/icons/maskable-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    }
+  ],
+  "shortcuts": [
+    { "name": "Друзья", "url": "/app/friends" },
+    { "name": "Настройки", "url": "/settings/account/profile" }
+  ]
+}

web/public/offline.html

@@ -0,0 +1,60 @@
+<!doctype html>
+<html lang="ru" data-theme="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="color-scheme" content="dark light" />
+    <title>glchat — нет сети</title>
+    <style>
+      :root {
+        color-scheme: dark;
+      }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        background: #1a1b1e;
+        color: #f2f3f5;
+        font:
+          16px/1.5 system-ui,
+          -apple-system,
+          'Segoe UI',
+          sans-serif;
+      }
+      main {
+        max-width: 28rem;
+        padding: 2rem;
+        text-align: center;
+      }
+      h1 {
+        margin: 0 0 0.5rem;
+        font-size: 1.25rem;
+      }
+      p {
+        margin: 0 0 1.25rem;
+        color: #a3a6ad;
+      }
+      button {
+        padding: 0.5rem 1rem;
+        border: 1px solid #3a3c42;
+        border-radius: 0.5rem;
+        background: #26282d;
+        color: inherit;
+        font: inherit;
+        cursor: pointer;
+      }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>Нет соединения</h1>
+      <p>
+        glchat не смог связаться с сервером. Проверьте сеть — как только связь вернётся, приложение
+        откроется само.
+      </p>
+      <button type="button" onclick="location.reload()">Повторить</button>
+    </main>
+  </body>
+</html>

web/public/sw.js

@@ -0,0 +1,91 @@
+/*
+ * Сервис-воркер glchat (AGENT.md, Фаза 5): офлайн-заглушка и кэш статики.
+ *
+ * Правила простые и безопасные:
+ *  - навигация — сеть, при ошибке офлайн-страница (данные всегда свежие);
+ *  - собранная статика `/assets/*` (хешированные имена) — из кэша;
+ *  - API, шлюз и файлы никогда не кэшируются: это приватные данные.
+ */
+const VERSION = 'glchat-v1';
+const OFFLINE_URL = '/offline.html';
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(VERSION).then((cache) => cache.addAll([OFFLINE_URL, '/manifest.webmanifest'])),
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches
+      .keys()
+      .then((keys) =>
+        Promise.all(keys.filter((key) => key !== VERSION).map((key) => caches.delete(key))),
+      )
+      .then(() => self.clients.claim()),
+  );
+});
+
+/** Приватные запросы: их нельзя ни кэшировать, ни отдавать из кэша. */
+function isPrivate(url) {
+  return (
+    url.pathname.startsWith('/api/') ||
+    url.pathname.startsWith('/files/') ||
+    url.pathname.startsWith('/gateway') ||
+    url.pathname.startsWith('/rtc')
+  );
+}
+
+self.addEventListener('fetch', (event) => {
+  const request = event.request;
+  if (request.method !== 'GET') {
+    return;
+  }
+  const url = new URL(request.url);
+  if (url.origin !== self.location.origin || isPrivate(url)) {
+    return;
+  }
+
+  if (request.mode === 'navigate') {
+    event.respondWith(
+      fetch(request).catch(() =>
+        caches.match(request).then((cached) => cached ?? caches.match(OFFLINE_URL)),
+      ),
+    );
+    return;
+  }
+
+  if (url.pathname.startsWith('/assets/')) {
+    event.respondWith(
+      caches.match(request).then(
+        (cached) =>
+          cached ??
+          fetch(request).then((response) => {
+            if (response.ok) {
+              const copy = response.clone();
+              void caches.open(VERSION).then((cache) => cache.put(request, copy));
+            }
+            return response;
+          }),
+      ),
+    );
+    return;
+  }
+
+  // Иконки, манифест и прочая статика: сеть, при недоступности — кэш.
+  event.respondWith(
+    fetch(request)
+      .then((response) => {
+        if (
+          response.ok &&
+          (url.pathname.startsWith('/icons/') || url.pathname === '/manifest.webmanifest')
+        ) {
+          const copy = response.clone();
+          void caches.open(VERSION).then((cache) => cache.put(request, copy));
+        }
+        return response;
+      })
+      .catch(() => caches.match(request).then((cached) => cached ?? Response.error())),
+  );
+});

web/src/lib/serviceWorker.ts

@@ -0,0 +1,23 @@
+/**
+ * Регистрация сервис-воркера (AGENT.md, Фаза 5): офлайн-заглушка и кэш
+ * собранной статики. В dev-режиме воркер не нужен — он мешал бы горячей
+ * перезагрузке, поэтому регистрируем только production-сборку.
+ */
+
+/** registerServiceWorker включает офлайн-режим. Возвращает признак регистрации. */
+export function registerServiceWorker(): boolean {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return false;
+  }
+  if (!('serviceWorker' in navigator)) {
+    return false;
+  }
+  if (!import.meta.env.PROD) {
+    return false;
+  }
+  // Регистрация не должна ломать запуск приложения: ошибки только в консоль.
+  void navigator.serviceWorker.register('/sw.js', { scope: '/' }).catch((error: unknown) => {
+    console.warn('service worker registration failed', error);
+  });
+  return true;
+}

web/src/main.tsx

@@ -4,11 +4,13 @@ import { QueryClientProvider } from '@tanstack/react-query';
 
 import { App } from '@/App';
 import { getQueryClient } from '@/lib/queryClient';
+import { registerServiceWorker } from '@/lib/serviceWorker';
 import { applyTheme, useUiStore } from '@/stores/ui';
 import '@/i18n';
 import '@/index.css';
 
 applyTheme(useUiStore.getState().theme);
+registerServiceWorker();
 
 const container = document.getElementById('root');
 if (!container) {

web/tests/serviceWorker.test.ts

@@ -0,0 +1,42 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { registerServiceWorker } from '@/lib/serviceWorker';
+
+/**
+ * PWA (Фаза 5): сервис-воркер регистрируется только в production-сборке и
+ * только там, где браузер его поддерживает.
+ */
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+describe('регистрация сервис-воркера', () => {
+  it('в тестовом окружении (не production) ничего не делает', () => {
+    const register = vi.fn().mockResolvedValue(undefined);
+    vi.stubGlobal('navigator', { serviceWorker: { register } });
+
+    expect(registerServiceWorker()).toBe(false);
+    expect(register).not.toHaveBeenCalled();
+  });
+});
+
+describe('манифест PWA', () => {
+  it('содержит обязательные поля и иконки нужных размеров', async () => {
+    const manifest = await import('../public/manifest.webmanifest?raw');
+    const parsed = JSON.parse(manifest.default) as {
+      name: string;
+      start_url: string;
+      display: string;
+      icons: { sizes: string; type: string; purpose?: string }[];
+    };
+    expect(parsed.name).toBe('glchat');
+    expect(parsed.start_url).toBe('/app');
+    expect(parsed.display).toBe('standalone');
+    const sizes = parsed.icons.map((icon) => icon.sizes);
+    expect(sizes).toContain('192x192');
+    expect(sizes).toContain('512x512');
+    expect(parsed.icons.every((icon) => icon.type === 'image/png')).toBe(true);
+    expect(parsed.icons.some((icon) => icon.purpose === 'maskable')).toBe(true);
+  });
+});