rebranding

tasks/kordant-unified-restructure/32-ios-service-screens.md

@@ -0,0 +1,136 @@
+# 32. iOS App — Dashboard and Service Screens (DarkWatch, VoicePrint, SpamShield, etc.)
+
+meta:
+  id: kordant-unified-restructure-32
+  feature: kordant-unified-restructure
+  priority: P1
+  depends_on: [kordant-unified-restructure-28, kordant-unified-restructure-29, kordant-unified-restructure-30, kordant-unified-restructure-31]
+  tags: [ios, swiftui, dashboard, services, mobile]
+
+objective:
+- Build the main dashboard and all service-specific screens for the iOS app. These should mirror the web app's functionality while using native iOS UI patterns (lists, forms, sheets, charts).
+
+deliverables:
+- `iOS/Kordant/Views/Dashboard/DashboardView.swift` — Main dashboard:
+  - Scrollable vertical stack of widgets
+  - Threat score gauge (circular progress ring)
+  - Recent alerts list (top 5)
+  - Service summary cards (DarkWatch, VoicePrint, SpamShield, HomeTitle, RemoveBrokers)
+  - Quick action buttons
+  - Pull-to-refresh
+- `iOS/Kordant/Views/Dashboard/AlertDetailView.swift` — Alert detail:
+  - Full alert information
+  - Correlated alerts section
+  - "Mark as resolved" and "False positive" actions
+- `iOS/Kordant/Views/Services/DarkWatchView.swift` — DarkWatch screen:
+  - Watchlist items list with add/remove
+  - Exposures list with severity badges
+  - Exposure detail with source info and recommendations
+  - "Run scan" button
+- `iOS/Kordant/Views/Services/VoicePrintView.swift` — VoicePrint screen:
+  - Voice enrollments list with play/delete
+  - "Enroll voice" button → opens recording sheet
+  - Analysis history list
+  - Analysis detail with confidence and verdict
+- `iOS/Kordant/Views/Services/SpamShieldView.swift` — SpamShield screen:
+  - Blocked calls/SMS statistics
+  - Custom rules list with add/edit/delete
+  - Number check input with result
+  - "Report spam" button
+- `iOS/Kordant/Views/Services/HomeTitleView.swift` — HomeTitle screen:
+  - Watched properties list with add/remove
+  - Property detail with snapshots and changes
+  - Map view showing property location (MapKit)
+  - "Run scan" button
+- `iOS/Kordant/Views/Services/RemoveBrokersView.swift` — RemoveBrokers screen:
+  - Broker registry list with search/filter
+  - Removal requests list with status
+  - Request detail with progress timeline
+  - "Start removal" button
+- `iOS/Kordant/Views/Settings/SettingsView.swift` — Settings:
+  - Account info, subscription details
+  - Notification preferences toggle
+  - Theme selection (light/dark/system)
+  - Biometric auth toggle
+  - Family group management
+  - Logout button
+
+steps:
+1. Create view directories: `Dashboard/`, `Services/`, `Settings/`.
+2. **DashboardView**:
+   - `ScrollView` with `VStack`
+   - Threat score: `Canvas` or custom `View` with circular progress ring
+   - Alerts: `ForEach` over `alerts` array, each as `ShieldCard` row
+   - Service cards: horizontal scroll or grid of compact cards
+   - Quick actions: `HStack` of icon buttons
+   - `.refreshable` modifier for pull-to-refresh
+3. **AlertDetailView**:
+   - `ScrollView` with sections
+   - Severity badge at top
+   - Description and metadata
+   - Correlated alerts in a nested list
+   - Action buttons at bottom
+4. **DarkWatchView**:
+   - `List` with sections: Watchlist, Exposures
+   - Watchlist items: swipe-to-delete, tap to edit
+   - Add button → sheet with form
+   - Exposures: tap to open detail
+5. **VoicePrintView**:
+   - Enrollments section with audio playback (AVFoundation)
+   - "Enroll" button → `RecordingView` sheet with waveform visualization
+   - Analysis list with verdict color coding
+6. **SpamShieldView**:
+   - Stats cards at top
+   - Rules list with toggle for active/inactive
+   - Number check: `ShieldTextField` + check button → result card
+7. **HomeTitleView**:
+   - Properties list with address and status
+   - Add property: address search with geocoding
+   - Property detail: `Map` view, snapshot history, changes list
+8. **RemoveBrokersView**:
+   - Broker list with category filters
+   - Request list with status badges and progress bars
+   - Start removal: sheet with broker selection and personal info form
+9. **SettingsView**:
+   - `Form` with sections: Account, Preferences, Family, Danger Zone
+   - Use native `Toggle`, `Picker`, `NavigationLink`
+   - Subscription info with upgrade button
+10. Wire all views to API client (task 31):
+    - Use `@StateObject` view models that call TRPCBridge
+    - Show `ShieldSkeleton` while loading
+    - Show `ShieldEmptyState` when lists are empty
+    - Handle errors with `ShieldToast` or inline messages
+
+steps:
+- Unit: Each view model fetches data correctly from mocked API
+- Unit: DashboardView displays correct widget count
+- Visual: All screens use theme tokens and adapt to dark mode
+- E2E: Navigate through all service screens and verify data loads
+- E2E: Perform CRUD operations (add watchlist item, delete enrollment, create rule)
+
+acceptance_criteria:
+- [ ] Dashboard displays threat score, alerts, service summaries, and quick actions
+- [ ] All 5 service screens (DarkWatch, VoicePrint, SpamShield, HomeTitle, RemoveBrokers) load and display data
+- [ ] Each service screen supports core CRUD operations
+- [ ] Alert detail shows full information and correlation group
+- [ ] Settings screen allows managing account, preferences, and family
+- [ ] Pull-to-refresh updates dashboard data
+- [ ] All screens show loading skeletons and empty states appropriately
+- [ ] Navigation between screens works smoothly with native iOS transitions
+
+validation:
+- Launch app, login, and verify dashboard renders with real data
+- Tap each service tab and verify screen loads
+- Add a watchlist item in DarkWatch and verify it appears in list
+- Delete a voice enrollment and verify it disappears
+- Create a spam rule and verify it applies
+- Toggle settings and verify preferences persist
+- Run unit tests via Xcode Cmd+U
+
+notes:
+- Use native iOS patterns: `List` for scrollable data, `Form` for settings, `Sheet` for modals, `.contextMenu` for actions.
+- For the threat score gauge, consider using a SwiftUI charting library like `SwiftUI Charts` (iOS 16+) or a custom `Canvas` drawing.
+- The map in HomeTitle should use `Map` (iOS 17+) or `MKMapView` wrapped in `UIViewRepresentable` for older versions.
+- Voice recording requires microphone permission. Add `NSMicrophoneUsageDescription` to Info.plist.
+- Keep view models separate from views for testability. View models should own the `@Published` state and API calls.
+- Consider using `Task` and `.task` modifier for async data loading instead of `onAppear` to handle cancellation correctly.