Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
82 lines (70 loc) · 4.43 KB

ARCHITECTURE.md

File metadata and controls

82 lines (70 loc) · 4.43 KB
Raw

ARCHITECTURE.md

Detailed architecture reference for Simply Filter SMS.

For project-wide patterns (MVVM, navigation, conventions), see CLAUDE.md.

Documentation Index

Document Description
docs/SCREENS.md Per-screen breakdown of all SwiftUI views, ViewModels, layouts, and supporting components
docs/FRAMEWORK.md Framework and Services layer — all managers, protocols, data flow, and the message evaluation pipeline
docs/EXTENSION.md Message Filter Extension (automatic filtering) and Reporting Extension (user-initiated junk/not-junk reporting from iOS Messages)
docs/TESTS.md Testing patterns, unit tests, UI tests, mocks, and test infrastructure
docs/DESIGN.md Visual design system — colors, typography, spacing, components, and guidelines for new features

Screen Map

Screen enum case View Presentation
appHome AppHomeView Root
onboarding EnableExtensionView Sheet (first run)
help HelpView Sheet
about AboutView Sheet
chooseAccentColor ChooseAccentColorView Sheet
enableExtension EnableExtensionView (= onboarding) Sheet
testFilters TestFiltersView Sheet
addLanguageFilter LanguageListView (mode: .blockLanguage) Sheet
addAllowFilter AddFilterView (filterType: .allow) Sheet
addDenyFilter AddFilterView (filterType: .deny) Sheet
automaticBlocking LanguageListView (mode: .automaticBlocking) Push
denyFilterList FilterListView (filterType: .deny) Push
allowFilterList FilterListView (filterType: .allow) Push
denyLanguageFilterList FilterListView (filterType: .denyLanguage) Push
reportMessage ReportMessageView Sheet
whatsNew WhatsNewView Sheet
tipJar TipJarView Sheet
countryList CountryListView Sheet
enableReportingExtension EnableExtensionView (reporting steps) Sheet
filterImport FilterTransferPreviewView Sheet
filterExport FilterTransferPreviewView Sheet

Manager Dependency Graph

AppManager (Singleton)
├── PersistanceManager ──── CoreData + CloudKit
├── DefaultsManager ─────── UserDefaults
├── NetworkSyncManager ──── NWPathMonitor + CloudKit events
│   └── depends on: PersistanceManager
├── MessageEvaluationManager ── Filter evaluation engine
│   └── app: PersistanceManager (live context) / extension: owned App Group store
├── AutomaticFilterManager ─── Community filter lists
│   └── depends on: PersistanceManager, AmazonS3Service
├── TipJarManager ─────────── StoreKit 2 IAP
├── FilterTransferManager ── Merge-only import/export
│   └── depends on: PersistanceManager
├── FlowManager ────────────── Launch-order queue
│   └── depends on: DefaultsManager
├── SchedulingManager ─────── Background refresh + inactivity reminder
│   └── depends on: AutomaticFilterManager, DefaultsManager, UserNotificationCenterService
├── AmazonS3Service ────────── HTTP → S3
│   └── depends on: NetworkSyncManager
├── ReportMessageService ───── HTTP → Lambda
│   └── depends on: NetworkSyncManager
└── UserNotificationCenterService ── UNUserNotificationCenter gateway

Message Evaluation Pipeline

When an SMS arrives, MessageEvaluationManager.evaluateMessage(body:sender:) runs these checks in order (first match wins):

  1. Allow filters → .allow (user-created allowlist)
  2. All Unknown → .junk (absolute gate — if enabled, blocks everything remaining)
  3. Automatic filters (allow) → .allow (trusted senders/body phrases from S3 community lists)
  4. Filter rules → .junk (links, numbersOnly, shortSender, email, emojis, countryAllowlist; allUnknown is handled earlier)
  5. Deny filters → .junk / .transaction / .promotion (user-created blocklist)
  6. Deny language filters → .junk (blocked languages via NLLanguageRecognizer)
  7. Automatic filters (deny) → .junk (spam keywords/senders from S3 community lists)
  8. No match → .allow (default)

See docs/FRAMEWORK.md for matching details and app vs extension store access.