Skip to content

Commit 8eaebe1

Browse files
tobiajoclaude
andcommitted
Cassandra design doc: orient the reader to where the subtlety lives
The PR history's core learning (evolution-gaming#834): the conditional write looked trivial, the pitfalls were all in not fencing the legitimate owner. Say that up front so the doc's weight makes sense. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PGxViqVaLYb1xQyveED6Hs
1 parent cecc552 commit 8eaebe1

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

docs/cassandra-single-writer-design.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,10 @@ enablement, costs and rollout guidance are in
1010
[Persistence](persistence.md#protecting-against-stale-snapshot-writes). The Kafka backend solves the
1111
same problem differently — see [Kafka single-writer design](kafka-single-writer-design.md).
1212

13+
The conditional write itself is the easy part. Most of this document is about not fencing the
14+
*legitimate* owner: the delete path, the replay window and deleted-key recovery are where a
15+
lightweight-transaction guard that looks trivial turns out not to be.
16+
1317
## Problem
1418

1519
[kafka-flow#732](https://github.com/evolution-gaming/kafka-flow/issues/732): during a rebalance a

0 commit comments

Comments
 (0)