trails/openspec/specs/planner-session/spec.md
Ullrich Schäfer f7e0f904a9
Update planner-session spec with collaborative notes requirements
Added scenarios for character-level notes sync and cursor awareness
between participants.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 02:55:36 +02:00

1.4 KiB

MODIFIED Requirements

Requirement: Real-time collaborative editing

The Planner SHALL synchronize waypoint edits, route options, and overlay preferences across all connected participants in real-time using Yjs CRDTs.

Scenario: Add waypoint

  • WHEN participant A adds a waypoint to the map
  • THEN participant B sees the waypoint appear within 500ms

Scenario: Reorder waypoints

  • WHEN participant A drags a waypoint to reorder it
  • THEN participant B sees the updated waypoint order within 500ms

Scenario: Concurrent edits

  • WHEN participant A and B both add waypoints simultaneously
  • THEN both waypoints appear for both participants without conflict

Scenario: Overlay sync

  • WHEN participant A enables the "Hillshading" tile overlay
  • THEN participant B sees hillshading appear on their map within 500ms

Scenario: POI category sync

  • WHEN participant A enables the "Drinking water" POI category
  • THEN participant B sees drinking water markers appear on their map

Scenario: Collaborative notes editing

  • WHEN participant A types in the notes editor
  • THEN participant B sees the text appear character-by-character in real-time
  • AND participant B sees participant A's cursor position and name

Scenario: Notes cursor awareness

  • WHEN participant A selects text in the notes editor
  • THEN participant B sees participant A's selection highlighted in A's assigned color