Add analytics and documentation updates

docs/patterns/sort-order.md

@@ -27,3 +27,13 @@ async function reindexIfNeeded(items: { id: string; sort_order: number }[]) {
   }
 }
 ```
+
+## Reorder Server Actions
+
+Een drag-and-drop reorder stuurt altijd client-controlled ID-lijsten naar de server. Behandel die lijst als onbetrouwbaar.
+
+- Weiger dubbele IDs.
+- Haal alle IDs op met de parent-scope, bijvoorbeeld `product_id`, `pbi_id`, `sprint_id` of `story_id`.
+- Weiger de operatie als het aantal gevonden records niet exact gelijk is aan het aantal aangeleverde IDs.
+- Update pas daarna `sort_order` in een transactie.
+- Gebruik bij priority changes dezelfde parent uit de database, niet een los meegegeven `productId`.