Если очередь хранится в массиве renderer-процесса или записывается только в обработчике `beforeunload`, потеря ожидаема. Окно — интерфейс, а не журнал заданий. Запишите job до того, как показать «добавлено в очередь», и верните UI её постоянный id.
Не пытайтесь спасти состояние только при закрытии. Electron документирует пути, где события graceful quit не приходят: `app.exit()` закрывает окна сразу, а на Windows `before-quit` и `will-quit` не гарантированы при shutdown/restart. Сохранность должна обеспечиваться до завершения.
Жизненный цикл окна и приложения не совпадает
| Событие | Что происходит | Очередь |
|---|---|---|
| BrowserWindow close | окно можно отменить/закрыть | остаётся у main worker |
| window-all-closed | на Windows/Linux часто ведёт к quit | уже записана |
| app.quit() | graceful последовательность событий | можно остановить выдачу новых job |
| app.exit() | немедленный выход | hook не является защитой |
| renderer crash | UI исчезает | worker/store сохраняют jobs |
| OS reboot/power loss | hooks могут не выполниться | восстановление из durable store |
State machine записывается до side effect
queued --claim+lease--> running --success--> completed
^ |
| +--retryable error--> queued
| +--permanent error--> failed
+------ expired lease ----+
job: id, type, payload_ref, state, attempt, lease_until, idempotency_keyPayload не обязан лежать целиком в таблице: крупный файл хранится отдельно, а job ссылается на него и контрольную сумму. Переходы выполняются транзакционно. SQLite поддерживает транзакции и подходит для локального single-device store, но конкретный движок выбирают по параллелизму и требованиям к данным.
IPC создаёт задание, а не передаёт владение UI
Renderer отправляет main process команду с валидированными параметрами. Main проверяет тип операции, создаёт idempotency key, записывает job и отвечает job id. После этого UI подписывается на изменения. Не открывайте renderer прямой произвольный доступ к файловой системе или SQL: preload предоставляет узкий API с context isolation.
- Ответ «queued» приходит только после commit.
- Повтор команды с тем же key возвращает существующую job.
- UI строит список из store, а не из памяти компонента.
- Секреты и большие бинарные данные не копируются в логи.
- Удаление завершённых заданий выполняет отдельная retention policy.
Running после crash не означает потерю
| Состояние при старте | Решение | Условие |
|---|---|---|
| queued | поставить worker | payload доступен |
| running, lease действует | не забирать | другой worker жив |
| running, lease истёк | retry/reconcile | операция идемпотентна |
| completed | только показать | не повторять side effect |
| failed permanent | ручное действие | есть безопасная причина |
Для загрузки файла idempotency может означать стабильный object key; для отправки платежа — idempotency key поддерживаемого API. Если внешняя операция не даёт безопасного повтора, после crash сначала выполните reconcile по внешнему идентификатору, а не отправляйте её заново.
Close handler нужен для UX, не для целостности
При обычном закрытии можно показать число активных задач и предложить скрыть окно, дождаться завершения или выйти. Но долгую запись всех jobs в `close`/`before-quit` оставлять нельзя. Electron позволяет отменить close, однако force destroy и немедленный exit обходят часть событий.
Crash-test сильнее ручного крестика
- Создать три jobs: queued, running и completed.
- Принудительно завершить renderer и проверить main/store.
- Завершить весь процесс без graceful hook.
- Запустить приложение и дождаться истечения тестового lease.
- Убедиться, что completed не повторилась, а running reconciled.
- Повторить во время обновления приложения и при повреждённом payload.
Очередь считается устойчивой, когда подтверждённая job переживает закрытие окна и kill, а side effect не выполняется дважды. Для разбора соберите Electron version, схему процессов, таблицу состояний, один job id и timeline переходов; пользовательские файлы и токены внешних сервисов не нужны.