docs/sync-and-op-log/diagrams/README.md
Last Updated: January 2026
This directory contains visual diagrams explaining the Operation Log sync architecture.
| Diagram | Description | Status |
|---|---|---|
| 01-local-persistence.md | Local IndexedDB persistence, hydration, compaction | Implemented |
| 02-server-sync.md | SuperSync server API, PostgreSQL, upload/download flows | Implemented |
| 03-conflict-resolution.md | LWW auto-resolution, SYNC_IMPORT filtering, vector clocks | Implemented |
| 04-file-based-sync.md | WebDAV/Dropbox/LocalFile sync via single sync-data.json | Implemented |
| 05-meta-reducers.md | Atomic multi-entity operations, state consistency | Implemented |
| 06-archive-operations.md | Archive side effects, dual-database architecture | Implemented |
| 07-supersync-vs-file-based.md | Comparison of SuperSync and file-based sync providers | Implemented |
| 08-sync-flow-explained.md | Simple explanation of how sync works | Implemented |
Getting Started:
Understanding Conflicts:
Advanced Topics:
Comparisons & Overviews:
| Provider | Primary Diagram |
|---|---|
| SuperSync | 02-server-sync.md |
| WebDAV | 04-file-based-sync.md |
| Dropbox | 04-file-based-sync.md |
| LocalFile | 04-file-based-sync.md |
| Document | Description |
|---|---|
| ../operation-log-architecture.md | Comprehensive architecture reference |
| ../operation-rules.md | Design rules and guidelines |
| ../vector-clocks.md | Vector clock implementation details |
| ../quick-reference.md | Quick lookup for common patterns |
All diagrams use Mermaid syntax and follow these conventions:
| Color | Meaning |
|---|---|
Green (#e8f5e9) | Success paths, valid states, local operations |
Blue (#e3f2fd) | Server/API operations, remote operations |
Orange (#fff3e0) | Storage, file operations, warnings |
Red (#ffebee) | Errors, conflicts, filtered operations |
Purple (#f3e5f5) | Results, outputs, final states |