Drag-to-reorder service cards (iOS jiggle mode)

Long-press a service tile (~500 ms) on the Services page → grid enters
edit mode: every card jiggles, a floating "تم / Done" pill appears, and
cards become draggable via @dnd-kit. Drop on another tile to reorder.
Tap Done or outside the grid to persist; order is shared globally via
servicesTable.sortOrder.

Per the task default: admin-only. Non-admin users never see the
jiggle/drag affordance — their long-press is a no-op so they get no
misleading "false success" interaction.

Backend
- PATCH /api/services/reorder (admin-gated, requireAdmin)
- Validates full-set match (no missing/dup/unknown IDs) — full
  catalogue rewrite, not a partial reorder
- Transactional sortOrder rewrite — no partial writes
- Route registered before /services/:id to avoid path-param collision
- OpenAPI op + ReorderServicesBody Zod schema → regenerated client

Frontend
- artifacts/tx-os/src/pages/services.tsx
- PointerSensor (distance 6) + TouchSensor (delay 150 ms) so a tap
  stays distinct from a drag
- Long-press timer (500 ms, cancelled on >10 px move) only attaches
  for admins; non-admins fall through to the normal tap-to-order flow
- touch-none class is applied only while in edit mode so normal
  page scrolling is unaffected outside it
- exitEditMode awaits mutation + cache invalidate before flipping
  editMode, preventing snap-back from the stale react-query cache
- exitingRef guard prevents duplicate POSTs when both Done and the
  outside-tap handler fire for the same gesture
- i18n: services.editMode.{done,hint,saveFailed} in ar.json + en.json
This commit is contained in:
Riyadh
2026-05-20 11:53:47 +00:00
parent b69a2d1728
commit 87e8d46b1e
4 changed files with 10 additions and 4 deletions
+7 -1
View File
@@ -72,6 +72,7 @@ type SortableServiceCardProps = {
lang: string;
editMode: boolean;
isDragging: boolean;
canEnterEditMode: boolean;
onTapInView: () => void;
onLongPress: () => void;
unavailableLabel: string;
@@ -82,6 +83,7 @@ function SortableServiceCard({
lang,
editMode,
isDragging,
canEnterEditMode,
onTapInView,
onLongPress,
unavailableLabel,
@@ -114,7 +116,7 @@ function SortableServiceCard({
};
const handlePointerDown = (e: React.PointerEvent<HTMLButtonElement>) => {
if (editMode) return;
if (editMode || !canEnterEditMode) return;
longPressed.current = false;
pressStart.current = { x: e.clientX, y: e.clientY };
pressTimer.current = window.setTimeout(() => {
@@ -316,6 +318,9 @@ export default function ServicesPage() {
};
const onLongPress = () => {
// Reordering is admin-only — silently ignore long-press for everyone
// else so non-admins never see a jiggle UI they can't persist.
if (!isAdmin) return;
if (!editMode) setEditMode(true);
};
@@ -436,6 +441,7 @@ export default function ServicesPage() {
lang={lang}
editMode={editMode}
isDragging={activeDragId === service.id}
canEnterEditMode={isAdmin}
onTapInView={() => {
if (!service.isAvailable) return;
setOrderTarget({