feat: implement single instance lock to ensure data integrity and resource efficiency

2026-04-06 10:38:19 +07:00
parent 75deeece9f
commit 988826ac8e
2 changed files with 77 additions and 48 deletions
@@ -146,6 +146,13 @@ A fully managed update lifecycle powered by `electron-updater`. Background downl

 A transparent proxy mechanism that handles cross-origin requests by sanitizing non-standard `app://` and `file://` Origin headers on outgoing requests and injecting permissive CORS response headers on incoming responses — allowing seamless integration with cloud APIs without server-side configuration changes.

+### 🔒 Single Instance Lock & Data Integrity
+
+The application enforces a **single running instance** via `app.requestSingleInstanceLock()`. If a user attempts to launch a second instance, the duplicate process is terminated immediately and the existing window is restored and focused. This mechanism serves two critical purposes:
+
+- **Data Integrity**: Prevents race conditions and write conflicts in local databases (IndexedDB/PouchDB) that could arise from concurrent access by multiple Electron processes.
+- **Resource Efficiency**: Avoids duplicate memory allocation, IPC handler registration, and protocol handler conflicts.
+
 ---

 ## Hardened Security Perimeter