# Lendair iOS Notifications

## Overview
SwiftUI implementation of the notifications feature for the Lendair iOS app.

## Architecture

### MVVM Pattern
- **View**: `NotificationsView` - Main container view
- **ViewModel**: `NotificationsViewModel` - Manages notification state and business logic
- **Service**: `NotificationsService` - Data layer for API communication

### Components

#### NotificationsView (`Views/NotificationsView.swift`)
- Main navigation container for the notifications screen
- Implements pull-to-refresh functionality
- Handles empty state display
- Provides "Mark All Read" action in toolbar
- Integrates with navigation stack

#### NotificationRowView (`Views/NotificationRowView.swift`)
- Individual notification list item
- Displays notification icon, title, message, and timestamp
- Shows read/unread indicator
- Supports tap-to-mark-as-read interaction

#### NotificationsViewModel (`ViewModels/NotificationsViewModel.swift`)
- Observable object managing notification state
- Fetches notifications from service layer
- Handles mark-as-read and mark-all-as-read operations
- Calculates unread count for badge display
- Implements refresh logic

## Notification Types

The app supports the following notification types:
- `LOAN_APPROVED` - Green checkmark icon
- `LOAN_REJECTED` - Red X icon
- `PAYMENT_RECEIVED` - Green down arrow icon
- `PAYMENT_DUE` - Orange exclamation icon
- `NEW_LENDER` - Blue person icon
- `SYSTEM_UPDATE` - Gray info icon

## Integration Points

### tRPC Router (TODO)
The service layer is designed to connect to the tRPC notifications router:
```typescript
// web/src/server/api/routers/notifications.ts
notifications: router({
  list: protectedQuery(...),
  markAsRead: protectedMutation(...),
  markAllAsRead: protectedMutation(...),
})
```

### API Endpoints (TODO)
- `GET /api/notifications` - List notifications
- `PATCH /api/notifications/:id/read` - Mark single as read
- `PATCH /api/notifications/read-all` - Mark all as read

## Usage

```swift
// In your MainTabView or navigation stack
NavigationStack {
    NotificationsView()
}
```

## Testing

Run the preview in Xcode to see the notification row designs:
```swift
#Preview {
    NotificationRowView(notification: sampleNotification)
}
```

## Future Enhancements

1. **Push Notifications**: Integrate with UNUserNotificationCenter
2. **Notification Preferences**: Allow users to customize notification types
3. **Deep Linking**: Navigate to relevant screens when tapping notifications
4. **Offline Support**: Cache notifications locally with Core Data
5. **Analytics**: Track notification engagement metrics