150 lines
4.7 KiB
Markdown
150 lines
4.7 KiB
Markdown
# 🔔 Notifications Guide
|
|
|
|
Readur provides comprehensive real-time notifications to keep you informed about document processing, sync events, and system status.
|
|
|
|
## Notification Types
|
|
|
|
### Document Processing
|
|
- **OCR Completion** - Text extraction finished for uploaded documents
|
|
- **Processing Errors** - Failed OCR or document processing alerts
|
|
- **Batch Processing** - Status updates for multiple document uploads
|
|
- **Quality Warnings** - Low-quality OCR results requiring attention
|
|
|
|
### Sync Events
|
|
- **Source Sync Complete** - WebDAV, S3, or local folder synchronization finished
|
|
- **New Documents Found** - Fresh documents discovered during sync
|
|
- **Sync Errors** - Connection issues or permission problems
|
|
- **Conflict Resolution** - File conflicts requiring user intervention
|
|
|
|
### System Status
|
|
- **Health Alerts** - System performance warnings or failures
|
|
- **Maintenance Windows** - Scheduled maintenance notifications
|
|
- **Security Events** - Login attempts, permission changes
|
|
- **Storage Warnings** - Disk space or quota limitations
|
|
|
|
## Notification Delivery
|
|
|
|
### In-App Notifications
|
|
- **Real-time Badge** - Notification counter in the top navigation
|
|
- **Notification Panel** - Expandable list of recent alerts
|
|
- **Toast Messages** - Immediate pop-up notifications for urgent items
|
|
- **Dashboard Widgets** - Status cards showing notification summaries
|
|
|
|
### Email Notifications
|
|
- **Immediate Alerts** - Critical system or processing failures
|
|
- **Daily Digest** - Summary of processing activity and status
|
|
- **Weekly Reports** - System health and usage statistics
|
|
- **Custom Triggers** - User-configured alert conditions
|
|
|
|
## Notification Settings
|
|
|
|
### User Preferences
|
|
Access notification settings through:
|
|
1. Click your profile in the top-right corner
|
|
2. Select "Notification Settings"
|
|
3. Configure your preferences for each notification type
|
|
|
|
### Notification Categories
|
|
- **Critical** - System failures, security alerts (always enabled)
|
|
- **Important** - Processing errors, sync failures
|
|
- **Informational** - Completion notifications, status updates
|
|
- **Promotional** - Feature updates, tips (can be disabled)
|
|
|
|
### Delivery Preferences
|
|
- **In-App Only** - Notifications appear only within Readur
|
|
- **Email + In-App** - Notifications sent to both locations
|
|
- **Email Only** - Notifications sent only via email
|
|
- **Disabled** - No notifications for this category
|
|
|
|
## Advanced Configuration
|
|
|
|
### Admin Settings
|
|
Administrators can configure system-wide notification policies:
|
|
|
|
```env
|
|
# Email notification settings
|
|
SMTP_HOST=smtp.your-domain.com
|
|
SMTP_PORT=587
|
|
SMTP_USERNAME=notifications@your-domain.com
|
|
SMTP_PASSWORD=your-password
|
|
|
|
# Notification thresholds
|
|
CRITICAL_ERROR_THRESHOLD=5
|
|
WARNING_BATCH_SIZE=100
|
|
DIGEST_FREQUENCY=daily
|
|
|
|
# Webhook integrations
|
|
SLACK_WEBHOOK_URL=https://hooks.slack.com/...
|
|
TEAMS_WEBHOOK_URL=https://your-org.webhook.office.com/...
|
|
```
|
|
|
|
### Webhook Integration
|
|
Send notifications to external systems:
|
|
|
|
#### Slack Integration
|
|
```json
|
|
{
|
|
"channel": "#readur-alerts",
|
|
"username": "Readur Bot",
|
|
"text": "OCR processing completed for 15 documents",
|
|
"attachments": [
|
|
{
|
|
"color": "good",
|
|
"fields": [
|
|
{"title": "Success Rate", "value": "93%", "short": true},
|
|
{"title": "Processing Time", "value": "2m 34s", "short": true}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
#### Teams Integration
|
|
```json
|
|
{
|
|
"@type": "MessageCard",
|
|
"themeColor": "0076D7",
|
|
"summary": "Readur Notification",
|
|
"sections": [{
|
|
"activityTitle": "Document Processing Complete",
|
|
"activitySubtitle": "15 documents processed successfully",
|
|
"facts": [
|
|
{"name": "Success Rate", "value": "93%"},
|
|
{"name": "Processing Time", "value": "2m 34s"}
|
|
]
|
|
}]
|
|
}
|
|
```
|
|
|
|
## Managing Notifications
|
|
|
|
### Notification History
|
|
- **View All** - Complete history of notifications
|
|
- **Filter by Type** - Show only specific notification categories
|
|
- **Search** - Find notifications by content or date
|
|
- **Archive** - Mark notifications as read or hide them
|
|
|
|
### Bulk Actions
|
|
- **Mark All Read** - Clear all unread notification badges
|
|
- **Delete Old** - Remove notifications older than specified date
|
|
- **Export** - Download notification history as CSV or JSON
|
|
|
|
## Troubleshooting
|
|
|
|
### Missing Notifications
|
|
- Check notification settings in your profile
|
|
- Verify email address is correct and confirmed
|
|
- Check spam/junk folder for email notifications
|
|
- Ensure browser notifications are enabled
|
|
|
|
### Too Many Notifications
|
|
- Adjust notification thresholds in settings
|
|
- Disable informational categories
|
|
- Switch to daily digest mode for non-critical items
|
|
- Use filters to focus on important notifications
|
|
|
|
### Email Delivery Issues
|
|
- Verify SMTP configuration (admin only)
|
|
- Check email server reputation and SPF records
|
|
- Test email delivery with notification test feature
|
|
- Review email bounce logs in admin panel |