mirror of
https://github.com/johannesjo/super-productivity.git
synced 2026-01-23 02:36:05 +00:00
docs(sync): update architecture docs for recent refactors
Update documentation to reflect recent simplifications: - OperationCaptureService now uses simple FIFO queue - OperationApplierService uses fail-fast approach - ArchiveOperationHandler is unified for local and remote operations - Update diagrams and file references - Add "Recently Completed" items for December 2025
This commit is contained in:
parent
9981c44fc4
commit
7ad78333be
3 changed files with 79 additions and 42 deletions
|
|
@ -1,10 +1,12 @@
|
|||
# Archive Write Points Documentation
|
||||
|
||||
**Last Updated:** December 8, 2025
|
||||
|
||||
This document tracks all locations where archive storage (IndexedDB) is written to, ensuring archive integrity and preventing unexpected writes.
|
||||
|
||||
## Single Source of Truth: ArchiveOperationHandler
|
||||
|
||||
All archive write operations MUST go through `ArchiveOperationHandler`. This handler is the centralized point for all archive storage operations.
|
||||
All archive write operations MUST go through `ArchiveOperationHandler`. This handler is the **unified, centralized** point for all archive storage operations, used by both local and remote operations.
|
||||
|
||||
### File Location
|
||||
|
||||
|
|
@ -12,9 +14,17 @@ All archive write operations MUST go through `ArchiveOperationHandler`. This han
|
|||
|
||||
### Entry Points
|
||||
|
||||
1. **Local Operations**: `ArchiveOperationHandlerEffects` → `ArchiveOperationHandler.handleOperation()`
|
||||
Both local and remote operations flow through the same handler:
|
||||
|
||||
1. **Local Operations**: `ArchiveOperationHandlerEffects` (using `LOCAL_ACTIONS`) → `ArchiveOperationHandler.handleOperation()`
|
||||
2. **Remote Operations**: `OperationApplierService` → `ArchiveOperationHandler.handleOperation()`
|
||||
|
||||
This unified architecture ensures:
|
||||
|
||||
- Identical behavior for local and remote operations
|
||||
- Single place to add new archive-affecting operations
|
||||
- Eliminates duplicate code between local effects and remote handling
|
||||
|
||||
## Archive-Affecting Actions
|
||||
|
||||
The following actions trigger archive writes (defined in `ARCHIVE_AFFECTING_ACTION_TYPES`):
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue