Files/ComputerAssignments/CA2/code/android/docs/FileArchitecture.md

# Air Mouse – Complete File Architecture & Project Structure

This document provides the **ultimate, definitive architectural blueprint** of the Air Mouse Android application. It maps every single file, package, and module, explaining their exact roles and how they interconnect to form a cohesive, production-grade system following **Clean Architecture** and **Unidirectional Data Flow (MVI)**.

---

## 1. High-Level Architecture (Clean Architecture)

The project is strictly divided into 4 concentric layers, ensuring that the UI is completely decoupled from the database and network logic.

```
┌─────────────────────────────────────────────────────────────────────┐
│                    PRESENTATION LAYER (UI)                         │
│  Activities, Compose Screens, ViewModels, Navigation, Theme       │
│  Dependencies: Domain Layer                                       │
└───────────────────────────────┬─────────────────────────────────────┘
                                │ (Observes State, Sends Events)
┌───────────────────────────────▼─────────────────────────────────────┐
│                         DOMAIN LAYER (Core)                        │
│  Business Models, Repository Interfaces, Use Cases                 │
│  Dependencies: Pure Kotlin/Java (No Android SDK)                  │
└───────────────────────────────┬─────────────────────────────────────┘
                                │ (Implements Interfaces)
┌───────────────────────────────▼─────────────────────────────────────┐
│                           DATA LAYER                               │
│  Repository Implementations, Data Sources (Room/Preferences/Remote)│
│  Mappers, Entities                                                 │
└───────────────────────────────┬─────────────────────────────────────┘
                                │ (Uses Infrastructure)
┌───────────────────────────────▼─────────────────────────────────────┐
│                       INFRASTRUCTURE LAYER                         │
│  Network, Sensors, Notifications, Utilities, Background Services   │
└─────────────────────────────────────────────────────────────────────┘
```

### Dependency Rule
> **Dependencies point inward.** The Presentation layer depends on Domain. The Data layer depends on Domain and Infrastructure. Infrastructure depends on external libraries (OkHttp, Android SDK).

---

## 2. Root Project Structure (`app/src/main/java/com/airmouse/`)

Here is the complete directory tree with every file categorized.

```
com.airmouse/
│
├── # =================== APPLICATION ROOT ===================
├── AirMouseApplication.kt               # Application class, Hilt setup, logging, crash reporting.
│
├── # =================== PRESENTATION LAYER ===================
├── presentation/
│   ├── ui/                              # All Screens (Activity & Compose)
│   │   ├── home/
│   │   │   ├── HomeActivity.kt          # Main entry point, permissions, sensor binding.
│   │   │   ├── HomeScreen.kt            # Dashboard with connection, sensors, gestures.
│   │   │   ├── HomeViewModel.kt         # Manages sensor, gesture, connection, stats.
│   │   │   └── HomeUiState.kt           # State models for Home screen.
│   │   ├── settings/
│   │   │   ├── SettingsScreen.kt        # Full settings hub (Cursor, Gesture, AI, etc.).
│   │   │   ├── SettingsViewModel.kt     # Persists settings, import/export, reset.
│   │   │   └── SettingsState.kt         # UiState, Events, Effects.
│   │   ├── calibration/
│   │   │   ├── CalibrationScreen.kt     # Step-by-step wizard (Gyro/Mag/Accel).
│   │   │   ├── CalibrationResultScreen.kt # Quality assessment & summary.
│   │   │   ├── CalibrationGuideDialog.kt # Animated instruction dialog.
│   │   │   ├── CalibrationViewModel.kt  # Sampling logic, sensor coordination.
│   │   │   ├── CalibrationUiState.kt    # State, phases, progress.
│   │   │   └── CalibrationComponents.kt # Reusable Calibration UI widgets.
│   │   ├── touchpad/
│   │   │   ├── TouchpadScreen.kt        # Full gesture capture surface.
│   │   │   ├── TouchpadViewModel.kt     # Gesture parsing, haptics, network sending.
│   │   │   ├── TouchpadState.kt         # State, events, effects, presets.
│   │   │   └── TouchpadSettingsScreen.kt # (DEPRECATED) – Delete.
│   │   ├── voice/
│   │   │   ├── VoiceCommandsScreen.kt   # Voice control with wake word and custom commands.
│   │   │   └── VoiceCommandsViewModel.kt # TTS, permission, command matching.
│   │   ├── themes/
│   │   │   ├── ThemesScreen.kt          # Theme picker with previews.
│   │   │   ├── ThemesViewModel.kt       # Theme/Accent persistence.
│   │   │   └── ThemesState.kt           # AccentColor, ThemeOption definitions.
│   │   ├── accessibility/
│   │   │   ├── AccessibilityScreen.kt   # Display, feedback, gesture, voice settings.
│   │   │   ├── AccessibilityViewModel.kt # Accessibility preferences.
│   │   │   └── AccessibilityUiState.kt  # High contrast, haptics, color blind modes.
│   │   ├── profiles/
│   │   │   ├── ProfilesScreen.kt        # User profile CRUD, favorites, defaults.
│   │   │   ├── ProfilesViewModel.kt     # Profile data handling.
│   │   │   └── ProfileSettings.kt       # Profile data class.
│   │   ├── proximity/
│   │   │   ├── ProximityScreen.kt       # Bluetooth proximity lock/unlock.
│   │   │   └── ProximityViewModel.kt    # RSSI calculation, auto-lock logic.
│   │   ├── logs/
│   │   │   ├── ServerLogsScreen.kt      # Real-time log viewer, filters, export.
│   │   │   ├── ServerLogsViewModel.kt   # Log capture, persistence, formatting.
│   │   │   └── ServerLogsState.kt       # LogEntry, LogLevel, SortOrder.
│   │   ├── help/
│   │   │   ├── HelpScreen.kt            # Searchable help center with categories.
│   │   │   ├── HelpViewModel.kt         # Search, favorites, expanded sections.
│   │   │   └── HelpModels.kt            # HelpCategory, HelpSection.
│   │   ├── onboarding/
│   │   │   ├── OnboardingActivity.kt    # 4-page walkthrough with animations.
│   │   │   ├── OnboardingItem.kt        # Data class for onboarding pages.
│   │   │   └── OnboardingPagerAdapter.kt # ViewPager adapter.
│   │   ├── about/
│   │   │   └── AboutScreen.kt           # ❌ MISSING (Partially in Settings).
│   │   ├── statistics/
│   │   │   └── StatisticsScreen.kt      # ❌ MISSING
│   │   ├── sensor/
│   │   │   └── SensorVisualizerScreen.kt # ❌ MISSING
│   │   ├── gesture/
│   │   │   └── GestureStudioScreen.kt   # ❌ MISSING
│   │   ├── edge/
│   │   │   └── EdgeGesturesScreen.kt    # ❌ MISSING
│   │   ├── network/
│   │   │   └── NetworkDiscoveryScreen.kt # ❌ MISSING
│   │   ├── battery/
│   │   │   └── BatteryScreen.kt         # ❌ MISSING
│   │   ├── files/
│   │   │   └── FileTransferScreen.kt    # ❌ MISSING
│   │   └── main/
│   │       └── MainScreen.kt            # Root navigation host with drawer & bottom bar.
│   │
│   ├── navigation/
│   │   ├── Destinations.kt              # Routes, titles, icons for all screens.
│   │   ├── NavigationActions.kt         # Abstraction for NavController.
│   │   ├── AirMouseNavHost.kt           # NavHost graph with composable mappings.
│   │   └── AirMouseBottomBar.kt         # Bottom navigation bar component.
│   │
│   ├── theme/
│   │   ├── Theme.kt                     # AirMouseTheme wrapper, Material 3 integration.
│   │   ├── ThemeColors.kt               # ThemeColorScheme, AccentColor, color families.
│   │   ├── Color.kt                     # Static color definitions (DeepOrange, Teal, etc.).
│   │   ├── Dimensions.kt                # Central spacing, padding, size, font constants.
│   │   └── Shapes.kt                    # RoundedCornerShape definitions (cards, buttons).
│   │
│   └── components/                      # Reusable UI Atoms & Molecules
│       ├── AllUIComponents.kt           # ControlDashboard, GestureTraining, Analytics, etc.
│       ├── AnimatedCheckbox.kt
│       ├── AnimatedSwitch.kt
│       ├── AnimatedToast.kt
│       ├── AnimatedCounter.kt
│       ├── AnimatedConnectionStatus.kt
│       ├── BatteryLevelIndicator.kt
│       ├── CircularProgressWithLabel.kt
│       ├── ConnectionStatusBadge.kt
│       ├── DataChart.kt                # Line & Donut charts.
│       ├── FloatingActionMenu.kt
│       ├── FloatingParticles.kt
│       ├── GestureWaveform.kt
│       ├── GlassCard.kt
│       ├── GradientBackground.kt
│       ├── GradientIconButton.kt
│       ├── HolographicText.kt
│       ├── InteractiveTutorialCard.kt
│       ├── NeonButton.kt
│       ├── NeumorphicCard.kt
│       ├── NotificationBadge.kt
│       ├── ParticleBackground.kt
│       ├── PullToRefresh.kt
│       ├── RadarAnimation.kt
│       ├── SensorVisualizer.kt          # 3D phone orientation cube.
│       ├── ShimmerEffect.kt
│       ├── SkeletonScreen.kt
│       ├── SlideUpPanel.kt
│       ├── TypewriterText.kt
│       └── VoiceWaveAnimation.kt
│
├── # =================== DOMAIN LAYER ===================
├── domain/
│   ├── model/                           # Pure Kotlin data classes.
│   │   ├── CalibrationModels.kt         # CalibrationStatus, Quality, Data.
│   │   ├── ConnectionModels.kt          # ConnectionConfig, Status, Quality.
│   │   ├── GestureModels.kt             # GestureType, Event, Template.
│   │   ├── MouseModels.kt               # MouseEvent, MovementProfile, Statistics.
│   │   ├── ProximityModels.kt           # ProximityState, Config.
│   │   ├── SensorModels.kt              # SensorData, OrientationData.
│   │   ├── StatisticsModels.kt          # StatisticsSummary, DailyStats.
│   │   ├── UpdateModels.kt              # UpdateResult, VersionInfo.
│   │   ├── VoiceCommandModels.kt        # VoiceCommand, Config, History.
│   │   ├── ProfileModels.kt             # UserProfile, ProfileSettings.
│   │   ├── PreferencesModels.kt         # AppPreferences, UserPreferences.
│   │   ├── BluetoothModels.kt           # BluetoothDeviceInfo, BLECharacteristic.
│   │   ├── ErrorModels.kt               # AppError, ErrorType.
│   │   └── ControlMode.kt               # ControlMode enum.
│   │
│   ├── repository/                       # Interfaces defining data operations.
│   │   ├── ICalibrationRepository.kt
│   │   ├── IConnectionRepository.kt
│   │   ├── IGestureRepository.kt
│   │   ├── IMouseRepository.kt
│   │   ├── IProfileRepository.kt
│   │   ├── IProximityRepository.kt
│   │   ├── ISensorRepository.kt
│   │   ├── ISettingsRepository.kt
│   │   ├── IStatisticsRepository.kt
│   │   ├── IUpdateRepository.kt
│   │   └── IVoiceCommandRepository.kt
│   │
│   ├── usecase/                         # Single responsibility business rules.
│   │   ├── CalibrationUseCase.kt
│   │   ├── ConnectToServerUseCase.kt
│   │   ├── SendMovementUseCase.kt
│   │   ├── DetectGestureUseCase.kt
│   │   ├── DiscoverServersUseCase.kt
│   │   ├── GetConnectionStatusUseCase.kt
│   │   ├── GetStatisticsUseCase.kt
│   │   ├── RecordStatisticsUseCase.kt
│   │   ├── ManageProfileUseCase.kt
│   │   ├── ManageGestureTemplatesUseCase.kt
│   │   ├── HandleVoiceCommandUseCase.kt
│   │   ├── GetProximityStateUseCase.kt
│   │   ├── UpdateProximityConfigUseCase.kt
│   │   ├── TestConnectionUseCase.kt
│   │   ├── CheckForUpdatesUseCase.kt
│   │   └── GetGestureStatisticsUseCase.kt
│   │
│   └── feature/                         # Feature orchestrators (bridging UI & UseCases).
│       ├── ConnectionFeature.kt
│       ├── MouseControlFeature.kt
│       ├── CalibrationFeature.kt
│       ├── GestureRecognitionFeature.kt
│       ├── ProximityFeature.kt
│       ├── StatisticsFeature.kt
│       ├── VoiceFeature.kt
│       ├── ProfileFeature.kt
│       ├── UpdateFeature.kt
│       └── SensorFeature.kt
│
├── # =================== DATA LAYER ===================
├── data/
│   ├── repository/                       # Implementations of Domain interfaces.
│   │   ├── CalibrationRepositoryImpl.kt
│   │   ├── ConnectionRepositoryImpl.kt
│   │   ├── GestureRepositoryImpl.kt
│   │   ├── MouseRepositoryImpl.kt
│   │   ├── ProfileRepositoryImpl.kt
│   │   ├── ProximityRepositoryImpl.kt
│   │   ├── SensorRepositoryImpl.kt
│   │   ├── SettingsRepositoryImpl.kt
│   │   ├── StatisticsRepositoryImpl.kt
│   │   ├── UpdateRepositoryImpl.kt
│   │   └── VoiceCommandRepositoryImpl.kt
│   │
│   ├── datasource/                      # Concrete data access.
│   │   ├── local/                       # Local storage (Room & Preferences).
│   │   │   ├── AppDatabase.kt           # Room database definition.
│   │   │   ├── Converters.kt            # Type converters for Room.
│   │   │   ├── entity/                  # Room Entities.
│   │   │   │   ├── CalibrationEntity.kt
│   │   │   │   ├── SettingsEntity.kt
│   │   │   │   ├── StatisticsEntity.kt
│   │   │   │   ├── GestureTemplateEntity.kt
│   │   │   │   ├── ProfileEntity.kt
│   │   │   │   ├── TrainingSampleEntity.kt
│   │   │   │   ├── DailyStatsEntity.kt
│   │   │   │   └── GestureStatsEntity.kt
│   │   │   ├── dao/                     # Room Data Access Objects.
│   │   │   │   ├── CalibrationDao.kt
│   │   │   │   ├── SettingsDao.kt
│   │   │   │   ├── StatisticsDao.kt
│   │   │   │   ├── GestureDao.kt
│   │   │   │   ├── ProfileDao.kt
│   │   │   │   ├── TrainingSampleDao.kt
│   │   │   │   ├── DailyStatsDao.kt
│   │   │   │   └── GestureStatsDao.kt
│   │   │   ├── CalibrationDataSourceImpl.kt
│   │   │   ├── GestureDataSourceImpl.kt
│   │   │   ├── ProfileDataSourceImpl.kt
│   │   │   ├── StatisticsDataSourceImpl.kt
│   │   │   ├── PreferencesDataSourceImpl.kt
│   │   │   ├── LocalDataSourceImpl.kt   # Unified wrapper over all DAOs.
│   │   │   └── interfaces/              # Interfaces for Data Sources.
│   │   │       ├── ICalibrationDataSource.kt
│   │   │       ├── IGestureDataSource.kt
│   │   │       ├── IProfileDataSource.kt
│   │   │       ├── IStatisticsDataSource.kt
│   │   │       ├── IPreferencesDataSource.kt
│   │   │       └── ILocalDataSource.kt
│   │   │
│   │   └── remote/                      # Remote data sources (Network/BT/USB).
│   │       ├── ConnectionDataSourceImpl.kt
│   │       ├── BluetoothDataSourceImpl.kt
│   │       ├── UsbDataSourceImpl.kt
│   │       ├── WebSocketDataSourceImpl.kt
│   │       └── interfaces/
│   │           ├── IConnectionDataSource.kt
│   │           ├── IBluetoothDataSource.kt
│   │           ├── IUsbDataSource.kt
│   │           └── IWebSocketDataSource.kt
│   │
│   ├── mapper/
│   │   ├── DomainToEntityMapper.kt      # Maps Domain → Room Entity.
│   │   └── EntityToDomainMapper.kt      # Maps Room Entity → Domain.
│   │
│   └── helpers/
│       ├── SensorRepository.kt          # Flow of fused sensor data (callbackFlow).
│       ├── PreferencesDataStore.kt      # AndroidX DataStore wrapper.
│       ├── CalibrationPrefsData.kt      # Helper data class.
│       └── GestureData.kt               # Helper data class.
│
├── # =================== INFRASTRUCTURE LAYER ===================
├── network/                              # Communication with PC Server.
│   ├── ConnectionManager.kt             # CORE – Unified WebSocket/TCP/UDP client.
│   ├── UdpDiscovery.kt                  # Server discovery via UDP broadcast.
│   ├── AutoReconnectManager.kt          # Exponential backoff reconnection logic.
│   ├── NetworkQualityMonitor.kt         # Wi-Fi/Cellular signal strength.
│   ├── MessageTypes.kt                  # Protocol constants (matching Go server).
│   ├── AirMouseProtocolMessages.kt      # JSON message builders.
│   ├── ConnectionHelper.kt              # Extension functions for sending commands.
│   ├── TcpClient.kt                     # DEPRECATED – Delete.
│   └── WebSocketManager.kt              # DEPRECATED – Delete.
│
├── sensors/                              # Hardware & Motion Processing.
│   ├── SensorService.kt                 # Registers sensors, runs Madgwick fusion.
│   ├── CalibrationHelper.kt             # Gyro bias, 6‑point accel, hard‑iron mag.
│   ├── EnhancedGestureDetector.kt       # Click, Double, Right, Scroll detection.
│   ├── MadgwickAHRS.kt                  # Quaternion-based sensor fusion.
│   ├── MotionAnalyzer.kt                # Jerk, acceleration, stability analysis.
│   ├── MotionDetector.kt                # Simple legacy detector.
│   ├── OrientationTracker.kt            # Tracks yaw/pitch/roll over time.
│   ├── SensorDataLogger.kt              # Logs raw sensor data to CSV.
│   ├── SensorDataProcessor.kt           # Filters (Low/High pass, Kalman).
│   ├── SensorFusion.kt                  # Static fusion utilities.
│   ├── SensorManagerHelper.kt           # Checks sensor availability.
│   └── GestureDetector.kt               # Legacy – Consider removing.
│
├── notifications/                       # System Alerts.
│   └── NotificationManager.kt           # Notification channels, badges, alerts.
│
├── files/                               # File Transfers.
│   └── FileTransferService.kt           # Handles sending/receiving files.
│
├── mirroring/                           # Screen Mirroring.
│   └── ScreenMirroringService.kt        # Captures screen and streams via WebSocket.
│
├── gaming/                              # Game Profiles.
│   └── GameProfilesManager.kt           # Detects foreground games, applies profiles.
│
├── macros/                              # Macro Recorder.
│   └── MacroRecorder.kt                 # Records/plays back mouse/keyboard macros.
│
├── sync/                                # Data Synchronization.
│   └── DataSyncManager.kt               # Syncs calibration/gestures/profiles to server.
│
├── utils/                               # Utility & Helper Classes.
│   ├── PreferencesManager.kt            # Interface for SharedPreferences/DataStore.
│   ├── LogManager.kt                    # ❌ MISSING
│   ├── PermissionHelper.kt              # ❌ MISSING
│   ├── VibrateUtils.kt                  # ❌ MISSING
│   ├── AudioUtils.kt                    # ❌ MISSING
│   ├── BluetoothUtils.kt                # ❌ MISSING
│   ├── BatterySaver.kt                  # ❌ MISSING
│   ├── ConnectedDeviceStore.kt          # ❌ MISSING
│   └── QRScanner.kt                     # ❌ MISSING
│
├── # =================== DEPENDENCY INJECTION ===================
├── di/
│   ├── AppContainer.kt                  # Manual DI container.
│   ├── AppModule.kt                     # Core dependencies (Context, Prefs, etc.).
│   ├── NetworkModule.kt                 # OkHttpClient, ConnectionManager.
│   ├── DatabaseModule.kt                # Room database, DAOs.
│   ├── SensorModule.kt                  # SensorManager, CalibrationHelper.
│   ├── ServiceModule.kt                 # SensorService, PresentationModeService.
│   ├── RepositoryModule.kt              # Binds Repository interfaces to impls.
│   ├── UseCaseModule.kt                 # Provides UseCase instances.
│   ├── FeatureModule.kt                 # Provides Feature instances.
│   ├── ViewModelModule.kt               # Binds ViewModels for Hilt.
│   ├── CalibrationModule.kt             # Calibration-specific bindings.
│   ├── CoroutineModule.kt               # Dispatchers (IO, Main, Default).
│   └── GestureRepositoryModule.kt       # Gesture repository bindings.
│
└── # =================== GO SERVER (Backend) ===================
└── go-server/ (External Package)
    ├── bspline.go                       # Cubic B‑spline smoothing.
    ├── humanizer.go                     # Human-like cursor movement.
    ├── tremor.go                        # Hand tremor simulation.
    ├── velocity.go                      # Log-normal velocity profiles.
    └── main.go / server.go              # ❌ MISSING (PC Server entry point).
```

---

## 3. Dependency Injection (Hilt Modules) – The Glue

Here is how Dagger/Hilt wires everything together:

| Module | Provides |
|--------|----------|
| **AppModule** | `Context`, `PreferencesManager`, `Vibrator`, `BluetoothAdapter`, `UsbManager`. |
| **NetworkModule** | `OkHttpClient`, `ConnectionManager`, `UdpDiscovery`. |
| **DatabaseModule** | `AppDatabase`, all DAOs (`CalibrationDao`, `ProfileDao`, etc.). |
| **SensorModule** | `SensorManager`, `CalibrationHelper`, `EnhancedGestureDetector`. |
| **ServiceModule** | `SensorService`, `PresentationModeService`. |
| **RepositoryModule** | Binds `ICalibrationRepository` → `CalibrationRepositoryImpl`, etc. |
| **UseCaseModule** | Provides `CalibrationUseCase`, `ConnectToServerUseCase`, etc. |
| **FeatureModule** | Provides `ConnectionFeature`, `MouseControlFeature`, etc. |
| **ViewModelModule** | Binds `HomeViewModel`, `SettingsViewModel`, etc., with `@ViewModelKey`. |
| **CoroutineModule** | Provides `@IoDispatcher`, `@MainDispatcher`, `@DefaultDispatcher`. |
| **CalibrationModule** | `ICalibrationDataSource` → `CalibrationDataSourceImpl`. |

### The Injection Flow
1. **Activity/Fragment** uses `@AndroidEntryPoint`.
2. **ViewModel** uses `@HiltViewModel` and `@Inject constructor`.
3. **ViewModel** injects `UseCase` or `Feature` dependencies.
4. **UseCase** injects `Repository` interfaces.
5. **RepositoryImpl** injects `DataSource` interfaces and `PreferencesManager`.
6. **DataSource** injects `Dao` (Room) or `ConnectionManager` (Network).

---

## 4. Data Flow – Complete Round Trip

Let's trace a **"Move Cursor"** action to see how all layers interact:

1. **User Gesture**: The user tilts the phone.
2. **SensorService** (Infrastructure) receives gyroscope data.
3. **SensorService** applies calibration (`CalibrationHelper`) and fusion (`MadgwickAHRS`).
4. **SensorService** invokes `onOrientationChanged` callback.
5. **HomeViewModel** (Presentation) receives the callback, calculates `dx` and `dy`.
6. **HomeViewModel** calls `connectionManager.sendMove(dx, dy)`.
7. **ConnectionManager** (Infrastructure) formats JSON and sends via WebSocket/TCP/UDP.
8. **Server** (Go) receives the message, applies smoothing (`bspline.go`), and moves the OS cursor.
9. **Server** sends back ACK or status updates.
10. **ConnectionManager** receives the response and updates `connectionQuality` StateFlow.
11. **HomeViewModel** collects the `connectionQuality` flow and updates the UI State.
12. **HomeScreen** recomposes, updating the signal strength indicator.

---

## 5. Duplicate Files to Delete

| File | Reason | Action |
|------|--------|--------|
| `TcpClient.kt` | Superseded by `ConnectionManager`. | ❌ **Delete** |
| `WebSocketManager.kt` | Superseded by `ConnectionManager`. | ❌ **Delete** |
| `TouchpadSettingsScreen.kt` | Settings are in `SettingsScreen` & `TouchpadScreen`. | ❌ **Delete** |
| `CalibrationProcessScreen.kt` | Duplicate of `CalibrationScreen`. | ❌ **Delete** |
| `GestureDetector.kt` (in `sensors/`) | Superseded by `EnhancedGestureDetector`. | ⚠️ Consider deleting/archiving. |

---

## 6. Missing Files to Implement

### A. Presentation (UI)
| File | Priority |
|------|----------|
| `StatisticsScreen.kt` | High |
| `AboutScreen.kt` | Medium |
| `SensorVisualizerScreen.kt` | High |
| `GestureStudioScreen.kt` | High |
| `EdgeGesturesScreen.kt` | Medium |
| `NetworkDiscoveryScreen.kt` | High |
| `BatteryScreen.kt` | Low |
| `FileTransferScreen.kt` | Medium |
| `OnboardingScreen.kt` (Compose) | Low (Activity exists) |

### B. Infrastructure (Utilities)
| File | Priority |
|------|----------|
| `LogManager.kt` | High |
| `PermissionHelper.kt` | High |
| `VibrateUtils.kt` | High |
| `AudioUtils.kt` | Medium |
| `BluetoothUtils.kt` | Medium |
| `BatterySaver.kt` | Medium |
| `ConnectedDeviceStore.kt` | Medium |
| `QRScanner.kt` | Medium |

### C. Backend (Go Server)
| File | Priority |
|------|----------|
| `main.go` | **Critical** |
| `server.go` | **Critical** |
| `handler.go` | **Critical** |

---

## 7. Gradle Module Structure (Recommended)

For large teams, consider modularising further:

```
app/ (Main application module)
  └── src/main/java/com/airmouse/
      ├── presentation/ (UI)
      ├── domain/ (Pure logic)
      ├── data/ (Implementation)
      └── di/ (Dagger)

core/ (Infrastructure shared across features)
  ├── network/
  ├── sensors/
  ├── utils/
  └── notifications/

feature/home/
feature/settings/
feature/calibration/
feature/touchpad/
feature/voice/
...
```

---

## ✅ Summary

The Air Mouse Android application is built on a **rock-solid Clean Architecture** with:
- **Strict layer separation** (Presentation ↔ Domain ↔ Data ↔ Infrastructure).
- **Unidirectional Data Flow (MVI)** for predictable UI state.
- **Dependency Injection (Hilt)** for loose coupling.
- **A rich, reusable component library** for consistent UI.
- **Comprehensive sensor and network handling** for real‑time control.

The architecture is **scalable, testable, and maintainable**. With the missing files and PC server implemented, it will be a fully production‑ready system.

---

*This architecture document is part of the Air Mouse Ultimate project – University of Tehran, Embedded Systems Exercise.*