mirror of
https://github.com/seaweedfs/seaweedfs.git
synced 2026-09-20 13:30:46 +02:00
Engine execution layer for V2 replication protocol: - RebuildInstaller: full state handoff (dirty map, WAL, superblock, flusher) - TruncateToLSN: exact safety predicate (checkpointLSN == truncateLSN), ErrTruncationUnsafe escalation to NeedsRebuild - SyncReceiverProgress: unconditional Store for post-rebuild alignment - V2StatusSnapshot: CommittedLSN = nextLSN-1 for sync_all V2 bridge real I/O executors: - TransferFullBase: TCP streaming + RebuildInstaller + second catch-up - TransferSnapshot: SHA-256 verified streaming to disk - TruncateWAL: ErrTruncationUnsafe detection + escalation - StreamWALEntries: rebuild-mode TCP apply Engine executor interfaces: - CatchUpIO.TruncateWAL, RebuildIO.TransferFullBase returns achievedLSN - CatchUpExecutor truncation-only skip, NeedsRebuild escalation - RebuildExecutor uses achievedLSN for progress tracking Design docs reorganized: superseded planning docs removed, protocol truths and closure map added. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
# V2 Design
|
|
|
|
This directory now keeps the current design and process entrypoints for the active V2 line.
|
|
|
|
Historical planning/review documents were moved to `../docs/archive/design/` to keep this directory smaller and easier to navigate.
|
|
|
|
## Read First
|
|
|
|
- `v2-protocol-truths.md`
|
|
- `v2-product-completion-overview.md`
|
|
- `v2-phase-development-plan.md`
|
|
- `v2-semantic-methodology.zh.md`
|
|
- `v2-protocol-closure-map.zh.md`
|
|
- `v2-algorithm-overview.md`
|
|
- `v2-algorithm-overview.zh.md`
|
|
- `v2-detailed-algorithm.zh.md`
|
|
|
|
## Active Process / Workflow
|
|
|
|
- `protocol-development-process.md`
|
|
- `agent_dev_process.md`
|
|
|
|
## Active Supporting Design
|
|
|
|
- `v2-acceptance-criteria.md`
|
|
- `v2-open-questions.md`
|
|
- `v2_scenarios.md`
|
|
- `v2-scenario-sources-from-v1.md`
|
|
- `v1-v15-v2-comparison.md`
|
|
- `wal-replication-v2.md`
|
|
- `wal-replication-v2-state-machine.md`
|
|
- `wal-replication-v2-orchestrator.md`
|
|
- `wal-v2-tiny-prototype.md`
|
|
- `wal-v1-to-v2-mapping.md`
|
|
- `v2-dist-fsm.md`
|
|
|
|
## Historical / Archived
|
|
|
|
See `../docs/archive/design/README.md` for archived:
|
|
|
|
- old roadmaps
|
|
- first-slice planning docs
|
|
- passed readiness/slicing reviews
|
|
- phase-specific design maps for closed phases
|
|
|
|
## Execution Note
|
|
|
|
- active development tracking lives under `../.private/phase/`
|
|
- current phase contract and slice packages live there rather than in this directory
|
|
|
|
The original project-level copies under `learn/projects/sw-block/design/` remain as shared references for now.
|