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

- internal/retention: истёкшие сессии, аудит старше RETENTION_AUDIT_DAYS и
  файлы без ссылок старше RETENTION_ORPHAN_HOURS; сиротой файл считается
  только если на него не ссылается ничего (вложения, аватары, оформление
  сервера, комнат, ролей, эмодзи, звуки, вебхуки, приглашения)
- обслуживание запускается в приложении по RETENTION_INTERVAL_SECONDS;
  команды glchat cleanup и glchat reindex делают то же вручную
- PWA: манифест с иконками и shortcuts, офлайн-страница, сервис-воркер
  (кэш только /assets/*, приватные запросы не кэшируются)
- тесты: Go на чистку (сирота удаляется, используемые файлы и свежие сироты
  остаются, истёкшая сессия уходит), Vitest на манифест и регистрацию воркера
This commit is contained in:
2026-09-21 19:42:12 +03:00
parent 72537e9ff9
commit 5afcfee744
19 changed files with 813 additions and 12 deletions
+91
View File
@@ -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())),
);
});