Notification Routing and the Mentions Filter

Every time a new message arrives on a job you participate in, the Vremly notification system creates a `NEW_MESSAGE` notification record. On the webapp, these appear in the bell-icon notification feed in the top navigation bar. On iOS, they appear in the Notifications Inbox (the bell tab in the tab bar) and also fire a push notification to your device if the app is backgrounded. The notification row shows who sent the message, a preview of the message content, the job address, and a relative timestamp.

The Notifications Inbox on iOS has three filter tabs: All, Unread, and Mentions. The All tab shows every notification in reverse-chronological order, grouped into Today / Yesterday / This Week / Earlier date buckets. The Unread tab filters to only notifications you have not opened yet — the unread dot disappears optimistically as soon as you tap the row, even before the server confirms the mark-read. The Mentions tab shows only `NEW_MESSAGE` notifications, since those are the notification type that contains @mention content today. Tapping any row pushes into the appropriate detail screen.

When a `NEW_MESSAGE` or `DELIVERY_COMMENT` notification is tapped, the routing logic is specific: on iOS, it calls `OrderDetailView(orderId: id, openAction: .chat)`, which means the order detail mounts and the chat sheet opens automatically. You do not land on the Appointment tab first — you go directly into the conversation. On the webapp, notification links include a `?chat=client` or `?chat=team` query parameter that sets the initial chat tab so the right channel is pre-selected when the job detail page loads.

When you are mentioned with @[Your Name] in a message, the backend records your user ID in the `mentions` array on the message record. The push notification that fires carries a title like 'You were mentioned' and lands in the same `NEW_MESSAGE` routing path, opening the chat sheet at the message that mentioned you. The mention chip in the rendered message appears as a highlighted pill with a coloured background — blue on the Customer channel, a contrasting colour in the Team channel — so the mention stands out visually inside the bubble.

Mark-all-read functionality is not yet available as a single button, but tapping individual notification rows marks each one read. The unread count on the bell icon in the webapp header and the notification badge on the iOS app icon both decrement as you clear each item. If you want to find all message-related notifications at once, the Mentions filter on iOS is the fastest way — it surfaces only the `NEW_MESSAGE` type, letting you work through your chat-originated alerts without wading through scheduling or delivery notifications.