Open source personal finance application
docs: rename offline-queue reference to offline-first and drop dead-mechanism references
Ilya Komichevf4bd6eb19c23
diff --git a/docs/content/en/3.reference/01.architecture.md b/docs/content/en/3.reference/01.architecture.mdindex 66f6f9e9..2c9294c7 100644--- a/docs/content/en/3.reference/01.architecture.md+++ b/docs/content/en/3.reference/01.architecture.md@@ -204,4 +204,4 @@ The mobile transaction form uses a custom `BottomSheet` component with `useBotto## Next Steps- [Sync](/en/reference/sync) - how PowerSync syncs data between server and local SQLite-- [Offline-first](/en/reference/offline-queue) - offline writes, upload queue, and error handling+- [Offline-first](/en/reference/offline-first) - offline writes, upload queue, and error handlingdiff --git a/docs/content/en/3.reference/03.sync.md b/docs/content/en/3.reference/03.sync.mdindex 531f92a5..877f94f9 100644--- a/docs/content/en/3.reference/03.sync.md+++ b/docs/content/en/3.reference/03.sync.md@@ -111,5 +111,5 @@ PowerSync syncs hard deletes natively - when a row is deleted on the server the## Next Steps-- [Offline-first](/en/reference/offline-queue) - offline writes, upload queue, and fatal error handling+- [Offline-first](/en/reference/offline-first) - offline writes, upload queue, and fatal error handling- [Architecture](/en/reference/architecture) - app initialization and store patterndiff --git a/docs/content/en/3.reference/04.offline-queue.md b/docs/content/en/3.reference/04.offline-first.mdsimilarity index 91%rename from docs/content/en/3.reference/04.offline-queue.mdrename to docs/content/en/3.reference/04.offline-first.mdindex 323a4e51..5ecf11f1 100644--- a/docs/content/en/3.reference/04.offline-queue.md+++ b/docs/content/en/3.reference/04.offline-first.md@@ -59,11 +59,11 @@ The server enforces no foreign key constraints (PowerSync upload order is not guEvery store write snapshots `prev = items.value` before mutating. If the local SQLite write throws, `items.value = prev` is restored and an error toast is shown. This covers local write errors (e.g., SQLite constraint, disk full). Server-rejection errors (RLS, constraint) are handled separately by the upload-error handler.-## No Manual Offline Queue+## No Manual Queue-The hand-written offline queue (`components/offline/helpers.ts`, `replay.ts`, `replayHelpers.ts`, `types.ts`) and the `local_`-prefix frontend ID system have been removed. PowerSync provides the upload queue natively. There is no `replay()`, no `mergeOfflineOps()`, no `cleanupFrontendIds()`, and no ID remapping.+PowerSync owns the upload queue natively - there is no hand-written queue, no replay step, no op-merging, and no frontend ID remapping.-Client IDs are regular UUIDs (generated client-side via `crypto.randomUUID()` or equivalent). They are stable and do not need remapping after upload.+Client IDs are regular UUIDs (generated client-side via `crypto.randomUUID()` or equivalent). They are stable and serve as the permanent primary key on both device and server, so nothing needs remapping after upload.## Key Filesdiff --git a/docs/content/ru/3.reference/01.architecture.md b/docs/content/ru/3.reference/01.architecture.mdindex 292042f8..4740cec2 100644--- a/docs/content/ru/3.reference/01.architecture.md+++ b/docs/content/ru/3.reference/01.architecture.md@@ -204,4 +204,4 @@ signOut()## Следующие шаги- [Синхронизация](/ru/reference/sync) - как PowerSync синхронизирует данные между сервером и локальной SQLite-- [Офлайн-first](/ru/reference/offline-queue) - офлайн-записи, очередь загрузки и обработка ошибок+- [Офлайн-first](/ru/reference/offline-first) - офлайн-записи, очередь загрузки и обработка ошибокdiff --git a/docs/content/ru/3.reference/03.sync.md b/docs/content/ru/3.reference/03.sync.mdindex d7fbba70..1a44a2db 100644--- a/docs/content/ru/3.reference/03.sync.md+++ b/docs/content/ru/3.reference/03.sync.md@@ -111,5 +111,5 @@ PowerSync синхронизирует жёсткие удаления нати## Следующие шаги-- [Офлайн-first](/ru/reference/offline-queue) - офлайн-записи, очередь загрузки и обработка фатальных ошибок+- [Офлайн-first](/ru/reference/offline-first) - офлайн-записи, очередь загрузки и обработка фатальных ошибок- [Архитектура](/ru/reference/architecture) - инициализация приложения и паттерн хранилищdiff --git a/docs/content/ru/3.reference/04.offline-queue.md b/docs/content/ru/3.reference/04.offline-first.mdsimilarity index 92%rename from docs/content/ru/3.reference/04.offline-queue.mdrename to docs/content/ru/3.reference/04.offline-first.mdindex 440f5c17..30f28422 100644--- a/docs/content/ru/3.reference/04.offline-queue.md+++ b/docs/content/ru/3.reference/04.offline-first.md@@ -59,11 +59,11 @@ seo:Каждая запись в хранилище сохраняет снимок `prev = items.value` до мутации. Если локальная запись в SQLite выбрасывает исключение, восстанавливается `items.value = prev` и показывается toast. Это покрывает ошибки локальной записи (например, ограничение SQLite, нехватка места). Ошибки отказа на сервере (RLS, ограничение) обрабатываются отдельно обработчиком ошибок загрузки.-## Без ручной офлайн-очереди+## Без ручной очереди-Написанная вручную офлайн-очередь (`components/offline/helpers.ts`, `replay.ts`, `replayHelpers.ts`, `types.ts`) и система ID с префиксом `local_` были удалены. PowerSync предоставляет очередь загрузки нативно. Нет `replay()`, нет `mergeOfflineOps()`, нет `cleanupFrontendIds()`, нет переназначения ID.+Очередью загрузки нативно управляет PowerSync - нет написанной вручную очереди, нет шага replay, нет слияния операций, нет переназначения клиентских ID.-Клиентские ID - это обычные UUID (генерируются на клиенте). Они стабильны и не требуют переназначения после загрузки.+Клиентские ID - это обычные UUID (генерируются на клиенте через `crypto.randomUUID()` или аналог). Они стабильны и служат постоянным первичным ключом и на устройстве, и на сервере, поэтому ничего не нужно переназначать после загрузки.## Ключевые файлы