cards-native/Sources/Core/Notifications/NotificationManager.swift
Till JS a1770fbc6a v0.7.0 — Phase β-6 Native-Polish
Drei Sub-Pakete: Keyboard-Shortcuts, Daily-Reminder-Notifications,
WidgetKit-Extension mit App-Group-Daten-Sharing. Siri-Shortcuts
und Share-Extension auf β-7 verschoben — niedrige Priorität, die
drei großen Brocken decken 90% des Native-Polish ab.

Keyboard-Shortcuts:
- Hidden Buttons in StudySessionView mit .keyboardShortcut
- Space = flip, 1/2/3/4 = again/hard/good/easy
- iPad-Magic-Keyboard + macOS-tauglich

Daily-Reminders:
- NotificationManager @Observable mit UNUserNotificationCenter
- Authorization-State + Permission-Request-Flow
- UNCalendarNotificationTrigger täglich zur konfigurierten Zeit
- SettingsView in AccountView mit Toggle + DatePicker
- UserDefaults-Persistierung von Hour/Minute/Enabled

WidgetKit-Extension:
- WidgetSnapshot Codable mit topDecks (Top-3 by dueCount) + totalDueCount
- WidgetSnapshotStore schreibt in group.ev.mana.cards-Container
- DeckListStore.refresh schreibt Snapshot + WidgetCenter.reloadAllTimelines
- CardsWidgetExtension-Target im project.yml (app-extension)
- CardsWidgetBundle + CardsDueWidget mit 5 Familien (small/medium/
  accessoryCircular/accessoryInline/accessoryRectangular)
- DueProvider TimelineProvider mit 30-min-Refresh
- DueWidgetView Family-Switch
- WidgetSnapshot.swift shared in beiden Targets via XcodeGen sources
- App-Group im Haupt- und Widget-Entitlement

35 Tests grün (keine neuen Tests in β-6 — WidgetKit + Notifications
sind System-API-Integrationen, Tests wären überwiegend Mocks).
Build inkl. Widget-Extension grün.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 01:00:04 +02:00

86 lines
3 KiB
Swift

import Foundation
import Observation
import UserNotifications
/// Lokale tägliche Reminder. Reines `UNUserNotificationCenter`
/// keine Push-Backend-Anbindung, keine Crash-Reporter, kein SaaS
/// (Compliance, siehe `mana/docs/COMPLIANCE.md`).
@MainActor
@Observable
final class NotificationManager {
enum AuthorizationStatus: Sendable {
case unknown
case authorized
case denied
}
private(set) var authorization: AuthorizationStatus = .unknown
private let identifier = "ev.mana.cards.dailyReminder"
private let store = UserDefaults.standard
/// Persistiert User-Pref. Format: ISO-Stunde:Minute (default 18:00).
var reminderHour: Int {
get { store.object(forKey: "reminderHour") as? Int ?? 18 }
set { store.set(newValue, forKey: "reminderHour") }
}
var reminderMinute: Int {
get { store.object(forKey: "reminderMinute") as? Int ?? 0 }
set { store.set(newValue, forKey: "reminderMinute") }
}
var remindersEnabled: Bool {
get { store.bool(forKey: "remindersEnabled") }
set { store.set(newValue, forKey: "remindersEnabled") }
}
func refreshAuthorization() async {
let settings = await UNUserNotificationCenter.current().notificationSettings()
switch settings.authorizationStatus {
case .authorized, .provisional, .ephemeral:
authorization = .authorized
case .denied:
authorization = .denied
default:
authorization = .unknown
}
}
/// Permission anfragen. Beim ersten Aufruf zeigt iOS den System-Prompt.
func requestAuthorization() async -> Bool {
let center = UNUserNotificationCenter.current()
do {
let granted = try await center.requestAuthorization(options: [.alert, .badge, .sound])
authorization = granted ? .authorized : .denied
return granted
} catch {
authorization = .denied
return false
}
}
/// Tägliche Reminder neu planen. Bei `remindersEnabled = false`
/// werden alle bestehenden Notifications gecancelt.
func reschedule() async {
let center = UNUserNotificationCenter.current()
center.removePendingNotificationRequests(withIdentifiers: [identifier])
guard remindersEnabled, authorization == .authorized else { return }
let content = UNMutableNotificationContent()
content.title = "Cards"
content.body = "Ein paar Karten warten auf dich."
content.sound = .default
var components = DateComponents()
components.hour = reminderHour
components.minute = reminderMinute
let trigger = UNCalendarNotificationTrigger(dateMatching: components, repeats: true)
let request = UNNotificationRequest(identifier: identifier, content: content, trigger: trigger)
do {
try await center.add(request)
} catch {
Log.app.error("Notification schedule failed: \(error.localizedDescription, privacy: .public)")
}
}
}