Edited Order Highlighting & Configurable New-Item Duration.

Mockup: click to view mockup

---

Summary

• Problem: Orders already in the Completed tab can be modified (new items added). Staff often miss these new additions because completed cards look final and controls are hidden. This leads to missed items, dispatch delays, and poor customer experience.

• Proposal: When a new item is appended to a Completed order, highlight it with a light-orange background + “NEW” label for a configurable duration. A new Settings control will allow users to set this duration (in seconds). This ensures discoverability without forcing orders back to Open.

---

Why This Matters

• Completed orders visually appear “finished,” so newly injected items are ignored by the kitchen team.

• Highlighting new items increases visibility, reduces errors, speeds up response time, and improves overall throughput and customer satisfaction.

---

Target Scenarios

1. Standard Flow: Chef marks all items; card automatically moves to Completed.

2. Edited Order: POS/customer modifies a completed order and adds new items.

3. Outcome: Newly added items appear on the Completed card with a light-orange highlight + “NEW” badge for N seconds (configurable).

---

Design Decisions

• Visual Signal:

  • Light-orange background to indicate new items.

  • "NEW" badge for additional clarity.

• Behavior:

  • Completed cards’ controls (checkboxes, DONE pill) remain hidden as per current behavior.

  • Highlight is temporary and non-intrusive.

• Configuration:

  • Add a "New item highlight duration (seconds)" field in Settings.

  • Persist the value in localStorage (per device).

• Simplicity:

  • No automatic reopening of orders (avoids workflow conflicts).

  • “Recall to Open” stays a manual action.

---

Acceptance Criteria

Highlight Behavior

• When an item is added to a card in Completed:

  • It appears at the end of the items list.

  • It shows a light-orange highlight + “NEW” badge for the configured duration.

  • After the timer ends, the highlight disappears automatically.

  • Completed card still hides controls unless recalled to Open.

Settings

• Duration input: integer seconds, min 1, max 300.

• Setting must persist across sessions on the same device.

• Change applies immediately.

Accessibility

• Settings modal is fully keyboard-accessible.

---

Metrics (KPIs)

• Missed item reduction: Target 30% decrease.

• Mean time to acknowledge new item: Target < 30 seconds.

• Completion time variance: 15–25% reduction in high-edit environments.

---

Implementation Notes (Mock)

• The HTML mock includes:

  • “Simulate Add Item” button per card.

  • Settings modal with kds_new_item_highlight_seconds saved in localStorage.

• Each added item starts its own timer.

• Highlight removal uses setTimeout tied to the configured duration.

---

Edge Cases & Follow-Ups

• Multiple new items → each with independent highlight timers.

• Rapid additions should not reset previous timers.

• Future consideration:

  • Optional “Reopen on Edit” toggle.

---

Rollout Plan

1. Implement feature & test on staging.

2. Pilot in 2–3 restaurants for two weeks.

3. Gather feedback and fine-tune default duration.

4. Roll out globally with monitoring of KPIs.

---

Demo Instructions

• Open the HTML mock on desktop or EPOS browser.

• Use Settings (gear icon) to set the highlight duration.

• Click Simulate Add Item on any completed card.

• Observe the light-orange NEW highlight and timer behavior.