Mirrors/super-productivity
1
0
Fork 0
mirror of https://github.com/johannesjo/super-productivity.git synced 2026-01-23 02:36:05 +00:00
Code Issues Projects Releases Wiki Activity
super-productivity/docs/sync-and-op-log/diagrams
History
Exact
Johannes Millan 9605177fc0 docs: enhance SuperSync vs file-based comparison with detailed diagrams 
Add comprehensive comparison diagrams:
- Side-by-side architecture showing upload/download flows
- Key conceptual differences (source of truth, sequencing, etc.)
- Detailed feature comparison table with "winner" column
- Trade-offs visualization (bandwidth, setup, history, etc.)
- Concurrent edit scenario showing gap detection vs piggybacking
2026-01-08 11:31:07 +01:00
..
01-local-persistence.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00
02-server-sync.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00
03-conflict-resolution.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00
04-file-based-sync.md docs: add detailed master architecture diagram for file-based sync 2026-01-08 11:12:42 +01:00
05-meta-reducers.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00
06-archive-operations.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00
07-supersync-vs-file-based.md docs: enhance SuperSync vs file-based comparison with detailed diagrams 2026-01-08 11:31:07 +01:00
08-sync-flow-explained.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00
README.md docs: fix outdated file paths and types in diagrams 2026-01-08 11:10:29 +01:00

README.md

Operation Log Architecture Diagrams

Last Updated: January 2026

This directory contains visual diagrams explaining the Operation Log sync architecture.

Diagram Index

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

Quick Navigation

By Topic

Getting Started:

Understanding Conflicts:

Advanced Topics:

Comparisons & Overviews:

By Sync Provider

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

Related Documentation

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

Diagram Conventions

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