🎨 wireframes

Story 1.20: Automated Notification Center - Wireframe

Story: Epic 1, Story 1.20 - Event Management Service

Last updated: October 22, 2025 Reading time: 8 minutes File size: 16.08 KB

Automated Notification Center

┌─────────────────────────────────────────────────────────────────────────────────────┐
│ ← Back                     Notification Center                   [User Settings]    │
├─────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                       │
│  Unread: 3     Total: 47                                                             │
│                                                                                       │
│  ┌─── INBOX ────────────────────────────────────────────────────────────────────────┐ │
│  │                                                                                   │ │
│  │ [All] [Unread] [Critical] [Team]                                                 │ │
│  │                                                                                   │ │
│  │ ┌────────────────────────────┐                                                   │ │
│  │ │ 🔴 CRITICAL - 14:45        │                                                   │ │
│  │ │ Speaker dropout detected   │                                                   │ │
│  │ │ Dr. Weber cancelled talk   │                                                   │ │
│  │ │ [Find Replacement]         │                                                   │ │
│  │ │ [Contact Waitlist]         │                                                   │ │
│  │ └────────────────────────────┘                                                   │ │
│  │                                                                                   │ │
│  │ ┌────────────────────────────┐                                                   │ │
│  │ │ ⚠️ WARNING - 14:30         │                                                   │ │
│  │ │ Abstract needs revision    │                                                   │ │
│  │ │ Marc B. - Too long (1250)  │                                                   │ │
│  │ │ [Review] [Contact Speaker] │                                                   │ │
│  │ └────────────────────────────┘                                                   │ │
│  │                                                                                   │ │
│  │ ┌────────────────────────────┐                                                   │ │
│  │ │ ℹ️ INFO - 13:15            │                                                   │ │
│  │ │ Publishing milestone hit   │                                                   │ │
│  │ │ 5 speakers now confirmed   │                                                   │ │
│  │ │ Ready for partial publish  │                                                   │ │
│  │ │ [Publish Now] [Review]     │                                                   │ │
│  │ └────────────────────────────┘                                                   │ │
│  │                                                                                   │ │
│  │ View older notifications...                                                       │ │
│  └───────────────────────────────────────────────────────────────────────────────────┘ │
│                                                                                       │
│  ┌─── ESCALATION WORKFLOWS ─────────────────────────────────────────────────────┐   │
│  │                                                                                │   │
│  │  Active Escalations:                                                          │   │
│  │                                                                                │   │
│  │  Speaker Non-Response → Day 1: Email → Day 3: Call → Day 5: Replace          │   │
│  │  ├─ Peter M: Day 3 (calling today)                                           │   │
│  │  └─ Lisa C: Day 1 (email sent)                                               │   │
│  │                                                                                │   │
│  │  Venue Issues → Hour 1: Notify team → Hour 4: Call venue → Day 1: Escalate   │   │
│  │  └─ All clear ✓                                                               │   │
│  │                                                                                │   │
│  │  Quality Problems → Immediate: Speaker → Day 1: Moderator → Day 2: Lead      │   │
│  │  └─ Marc B. abstract: Moderator notified                                     │   │
│  │                                                                                │   │
│  │  [Configure Escalations] [View History] [Pause All]                          │   │
│  └────────────────────────────────────────────────────────────────────────────────┘  │
│                                                                                       │
└─────────────────────────────────────────────────────────────────────────────────────┘

Key Interactive Elements

Notification Inbox: Prioritized notifications with severity levels
Escalation Workflows: Multi-step escalation paths with time-based progression

Functional Requirements Met

FR20: Intelligent automated notifications across workflow
Multi-Channel: Platform, email notifications
Priority Levels: Critical, warning, info classifications
Escalation Paths: Automated escalation for unresolved issues

User Interactions

View Notifications: Filter by type, priority, and status
Take Action: Inline buttons for common responses
Configure Escalations: Set up multi-step escalation workflows

Technical Notes

Event-driven architecture with notification service
Multi-channel delivery system (email, platform notifications)
Escalation scheduler with time-based progression
Notification history and audit trail
Integration with workflow steps for automatic triggering

API Requirements

Initial Page Load APIs

Updated with Story 1.26 Consolidated Notification APIs

When the Notification Center screen loads, the following APIs are called to provide the necessary data:

GET /api/v1/notifications?filter={}&status={}&page={}
- Query params: filter={"type":"organizer"}, status=unread|read|all, page=1, limit=20
- Returns: Paginated notifications with severity, timestamp, title, description, action links, read status, related entity
- Used for: Populate notification inbox
- Consolidated: Single endpoint replaces /organizers/{id}/notifications, /organizers/{id}/notifications/summary (2 → 1)
- Performance: <200ms (P95)
GET /api/v1/notifications/count?status=unread
- Returns: Notification count
  json
```
{
  "total": 47,
  "unread": 3,
  "critical": 1
}
```
- Used for: Display summary statistics at top of page
- Consolidated: Part of Story 1.26 notification management
GET /api/v1/organizers/{organizerId}/notifications/escalations (Unchanged)
- Query params: status (active|completed|all)
- Returns: Active escalation workflows with current step, affected entities, timeline, next action
- Used for: Display escalation workflows section
- Note: Escalation workflows remain separate from general notifications

Action APIs

Notification Management (Consolidated)

PUT /api/v1/notifications/read
- Payload: { notificationIds: ["id1", "id2"] } (single or bulk)
- Response: Read status updated, new counts
  json
```
{
  "updated": 2,
  "unreadCount": 1
}
```
- Used for: Mark notification(s) as read
- Consolidated: Single endpoint handles both individual and bulk operations (replaces 2 endpoints)
- Performance: <100ms (P95)
DELETE /api/v1/notifications/{id} or DELETE /api/v1/notifications (bulk)
- Payload (bulk): { notificationIds: ["id1", "id2"] }
- Response: Deletion confirmation, updated counts
- Used for: Dismiss/delete notification(s)
- Consolidated: Supports both single and batch delete
POST /api/v1/organizers/{organizerId}/notifications/{notificationId}/snooze (Unchanged)
- Payload: { snoozeUntil: timestamp, reason }
- Response: Snooze confirmation, reminder scheduled
- Used for: Snooze notification for later
- Note: Snooze functionality remains separate for workflow management
POST /api/v1/organizers/{organizerId}/notifications/{notificationId}/action (Unchanged)
- Payload: { actionType, actionData }
- Response: Action executed, notification updated
- Used for: Execute inline action from notification (e.g., Find Replacement, Review)
- Note: Action execution remains context-specific

Escalation Workflows

POST /api/v1/organizers/{organizerId}/notifications/escalations
- Payload: { name, steps: [{ delay, action, recipients: [] }], triggerType, entityType }
- Response: Escalation workflow created, workflow ID
- Used for: Create new escalation workflow
PUT /api/v1/organizers/{organizerId}/notifications/escalations/{escalationId}
- Payload: { steps, enabled: boolean }
- Response: Escalation updated, affected instances
- Used for: Update escalation workflow configuration
PUT /api/v1/organizers/{organizerId}/notifications/escalations/{escalationId}/pause
- Payload: { pauseDuration: "1-hour|1-day|indefinite" }
- Response: Escalation paused, resume time
- Used for: Pause escalation workflow
POST /api/v1/organizers/{organizerId}/notifications/escalations/{instanceId}/resolve
- Payload: { resolution, notes }
- Response: Escalation instance resolved, removed from active
- Used for: Manually resolve escalation
GET /api/v1/organizers/{organizerId}/notifications/escalations/history
- Query params: limit (50), entityType, status, dateRange
- Returns: Historical escalations with resolution details, duration, outcome
- Used for: View escalation history from [View History]

Notification Preferences & History (Consolidated)

GET /api/v1/notifications/preferences and PUT /api/v1/notifications/preferences
- GET Returns: User notification preferences
  json
```
{
  "emailNotifications": true,
  "pushNotifications": false,
  "channels": ["email", "in-app"],
  "frequency": "immediate|digest",
  "categories": {
    "critical": true,
    "updates": true,
    "social": false
  }
}
```
- PUT Payload: Updated preferences
- Used for: Manage notification preferences
- Consolidated: Part of Story 1.26 preference management
- Performance: <150ms (P95)
GET /api/v1/notifications/history?timeframe={}&channel={}
- Query params: timeframe=30d, channel=email|sms|push|in-app, page, limit
- Returns: Historical notifications with delivery status, timestamps, metadata
- Used for: View notification history with delivery tracking
- Consolidated: Replaces separate history and analytics endpoints (includes delivery metrics)
GET /api/v1/organizers/{organizerId}/notifications/export (Unchanged)
- Query params: format (csv|pdf|json), dateRange, filter
- Returns: Download URL for notification history export
- Used for: Export notification data

← Back button → Navigate to Event Management Dashboard (story-1.16-event-management-dashboard.md)
- Returns to dashboard
- Preserves notification state
[User Settings] button → Scrolls to preferences section
- Shows notification preferences
- In-page navigation
- No screen change
Notification inbox filter tabs → Filters notification list
- [All], [Unread], [Critical], [Team]
- Updates displayed notifications
- No screen navigation

Notification Inbox Actions

Notification card click → Expands notification details
- Shows full message
- Reveals all action buttons
- Marks as read
- No screen navigation
[Find Replacement] button (speaker dropout) → Navigate to Speaker Matching Interface (story-3.1-speaker-matching-interface.md)
- Pre-filled search criteria
- Speaker selection
- Invitation workflow
[Contact Waitlist] button → Navigate to Waitlist Management Screen
- Waitlist viewer
- Bulk invite options
- Priority ranking
[Review] button (abstract) → Navigate to Abstract Review Screen
- Review interface
- Quality scoring
- Approval workflow
[Contact Speaker] button → Opens message composer
- Pre-filled recipient
- Template suggestions
- Sends message
- No screen navigation
[Publish Now] button → Navigate to Publishing Control Center (story-2.3-basic-publishing-engine.md)
- Publishing interface
- Content review
- Publish confirmation
View older notifications… → Loads more notifications
- Pagination
- Infinite scroll
- No screen navigation

Escalation Workflow Actions

Escalation workflow item click → Shows escalation details
- Full timeline
- Current step highlighted
- Next actions
- No screen navigation
[Configure Escalations] button → Opens escalation editor
- Workflow designer
- Step configuration
- Timing settings
- No screen navigation
[View History] button → Opens escalation history modal
- Historical escalations
- Resolution details
- Statistics
- No screen navigation
[Pause All] button → Pauses all escalations
- Confirmation dialog
- Duration selector
- Pauses workflows
- No screen navigation

New notification received → Adds to inbox
- Appears at top of list
- Increments unread count
- Shows toast notification
- May play sound
- No automatic navigation
Escalation advanced → Updates escalation display
- Moves to next step
- Updates timeline
- Shows notification
- No automatic navigation
Notification read → Updates UI
- Decrements unread count
- Changes visual state
- May hide from Unread filter
- No automatic navigation

Story 1.20: Automated Notification Center - Wireframe

Automated Notification Center

Key Interactive Elements

Functional Requirements Met

User Interactions

Technical Notes

API Requirements

Initial Page Load APIs

Action APIs

Notification Management (Consolidated)

Escalation Workflows

Notification Preferences & History (Consolidated)

Navigation Map

Primary Navigation Actions

Notification Inbox Actions

Escalation Workflow Actions

Event-Driven Navigation

Table of Contents

Story 1.20: Automated Notification Center - Wireframe

# Automated Notification Center

# Key Interactive Elements

# Functional Requirements Met

# User Interactions

# Technical Notes

# API Requirements

# Initial Page Load APIs

# Action APIs

# Notification Management (Consolidated)

# Escalation Workflows

# Notification Preferences & History (Consolidated)

# Navigation Map

# Primary Navigation Actions

# Notification Inbox Actions

# Escalation Workflow Actions

# Event-Driven Navigation

Table of Contents

Automated Notification Center

Key Interactive Elements

Functional Requirements Met

User Interactions

Technical Notes

API Requirements

Initial Page Load APIs

Action APIs

Notification Management (Consolidated)

Escalation Workflows

Notification Preferences & History (Consolidated)

Navigation Map

Primary Navigation Actions

Notification Inbox Actions

Escalation Workflow Actions

Event-Driven Navigation