Если очередь хранится в массиве 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 crashUI исчезаетworker/store сохраняют jobs
OS reboot/power losshooks могут не выполнитьсявосстановление из 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_key

Payload не обязан лежать целиком в таблице: крупный файл хранится отдельно, а 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поставить workerpayload доступен
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 сильнее ручного крестика

  1. Создать три jobs: queued, running и completed.
  2. Принудительно завершить renderer и проверить main/store.
  3. Завершить весь процесс без graceful hook.
  4. Запустить приложение и дождаться истечения тестового lease.
  5. Убедиться, что completed не повторилась, а running reconciled.
  6. Повторить во время обновления приложения и при повреждённом payload.

Очередь считается устойчивой, когда подтверждённая job переживает закрытие окна и kill, а side effect не выполняется дважды. Для разбора соберите Electron version, схему процессов, таблицу состояний, один job id и timeline переходов; пользовательские файлы и токены внешних сервисов не нужны.

Проверенные источники