# andervicario/netanalyzer architecture

> Architecture diagram of the GitHub repository andervicario/netanalyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andervicario/netanalyzer
- Repository: https://github.com/andervicario/netanalyzer

## Overview

NetAnalyzer is a root-free Android LAN auditing app. The user starts a scan from the home screen; a foreground service gathers network details and orchestrates discovery and port scanning, then publishes scan state for reactive device and home views. Discovery results are fused into device records and can be enriched with fingerprints or optional SSDP/AI analysis; scan history and configuration are persisted locally. The graph follows the README and shown source references; several discovery implementations and UI links are unsampled, so only documented or indexed relationships are connected.

Main entry points: [`app/src/main/java/com/av19/netanalyzer/service/ScanService.java`](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/service/ScanService.java) (Foreground scan service), [`app/src/main/java/com/av19/netanalyzer/utils/PreferencesManager.java`](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/PreferencesManager.java) (Preferences storage), [`app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java`](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java) (Home screen), [`app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java`](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java) (Network scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["User interface"]
  node_home["Home screen<br/>[HomeFragment.java]"]
  node_devices["Device results"]
  node_settings["Settings UI"]
end

subgraph group_orchestration["Scan orchestration"]
  node_service["Foreground scan service<br/>[ScanService.java]"]
  node_scanner["Network scanner"]
  node_ports["NIO port scan"]
end

subgraph group_discovery["Discovery and analysis"]
  node_discovery_methods["Discovery contract"]
  node_arp["ARP discovery<br/>[ARPDiscovery.java]"]
  node_icmp["ICMP discovery<br/>[ICMPDiscovery.java]"]
  node_tcp["TCP discovery<br/>[TCPDiscovery.java]"]
  node_mdns["mDNS discovery<br/>[MDNSDiscovery.java]"]
  node_ssdp["SSDP discovery<br/>[SSDPDiscovery.java]"]
  node_netbios["NetBIOS discovery"]
  node_fusion["Device fusion"]
  node_fingerprint["Device fingerprinting"]
  node_ai["OpenRouter enrichment"]
end

subgraph group_state["Scan state and history"]
  node_repository["Scan repository"]
  node_viewmodel["Scan ViewModel<br/>[ScanViewModel.java]"]
  node_scan_state["Scan state<br/>[ScanState.java]"]
  node_network_info["Network details<br/>[NetworkInfo.java]"]
  node_device_info["Device records<br/>[DeviceInfo.java]"]
  node_history["Scan history<br/>[ScanRecord.java]"]
end

subgraph group_configuration["Settings"]
  node_preferences[("Preferences storage")]
  node_method_config["Discovery configuration"]
  node_import_config["Config import/export"]
end

node_user(("Network auditor"))
node_openrouter{{"OpenRouter API"}}

node_user -->|"starts scan"| node_home
node_home -->|"starts service"| node_service
node_service -->|"configures scan"| node_scanner
node_scanner -->|"dispatches methods"| node_discovery_methods
node_scanner -->|"runs port scan"| node_ports
node_service -->|"registers method"| node_arp
node_service -->|"registers method"| node_icmp
node_service -->|"registers method"| node_mdns
node_service -->|"registers method"| node_ssdp
node_service -->|"registers method"| node_tcp
node_service -->|"registers method"| node_netbios
node_service -->|"collects devices"| node_fusion
node_service -->|"applies fingerprints"| node_fingerprint
node_ssdp -->|"enriches device"| node_ai
node_ai -->|"sends request"| node_openrouter
node_service -->|"publishes results"| node_repository
node_repository -->|"updates state"| node_scan_state
node_viewmodel -->|"observes state"| node_repository
node_home -->|"observes progress"| node_viewmodel
node_devices -->|"observes results"| node_viewmodel
node_service -->|"stores history"| node_preferences
node_preferences -->|"persists records"| node_history
node_home -->|"reads history"| node_preferences
node_settings -.->|"configures methods"| node_method_config
node_method_config -->|"saves settings"| node_preferences
node_import_config -->|"imports settings"| node_preferences

click node_home "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java"
click node_devices "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/devices/DevicesFragment.java"
click node_settings "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/settings/SettingsFragment.java"
click node_service "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/service/ScanService.java"
click node_scanner "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java"
click node_ports "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/scanner/NioPortScanner.java"
click node_discovery_methods "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/DiscoveryMethod.java"
click node_arp "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/ARPDiscovery.java"
click node_icmp "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/ICMPDiscovery.java"
click node_tcp "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/TCPDiscovery.java"
click node_mdns "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/MDNSDiscovery.java"
click node_ssdp "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/SSDPDiscovery.java"
click node_netbios "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/NetBIOSDiscovery.java"
click node_fusion "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/ListDeviceInfo.java"
click node_fingerprint "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/FingerprintManager.java"
click node_ai "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/OpenRouterApiClient.java"
click node_repository "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/repository/ScanRepository.java"
click node_viewmodel "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/viewmodel/ScanViewModel.java"
click node_scan_state "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/ScanState.java"
click node_network_info "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/NetworkInfo.java"
click node_device_info "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/DeviceInfo.java"
click node_history "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/ScanRecord.java"
click node_preferences "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/PreferencesManager.java"
click node_method_config "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/MethodConfigDialogFragment.java"
click node_import_config "https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/ImportConfigDialogFragment.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_devices,node_settings toneBlue
class node_service,node_scanner,node_ports toneAmber
class node_discovery_methods,node_arp,node_icmp,node_tcp,node_mdns,node_ssdp,node_netbios,node_fusion,node_fingerprint,node_ai,node_openrouter toneMint
class node_repository,node_viewmodel,node_scan_state,node_network_info,node_device_info,node_history toneRose
class node_preferences,node_method_config,node_import_config,node_user toneIndigo
```

## Components

### User interface

- [Home screen](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java): `app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java`
- [Device results](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/devices/DevicesFragment.java): `app/src/main/java/com/av19/netanalyzer/ui/devices/DevicesFragment.java`
- [Settings UI](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/settings/SettingsFragment.java): `app/src/main/java/com/av19/netanalyzer/ui/settings/SettingsFragment.java`

### Scan orchestration

- [Foreground scan service](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/service/ScanService.java): `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`
- [Network scanner](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java): `app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java`
- [NIO port scan](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/scanner/NioPortScanner.java): `app/src/main/java/com/av19/netanalyzer/scanner/NioPortScanner.java`

### Discovery and analysis

- [Discovery contract](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/DiscoveryMethod.java): `app/src/main/java/com/av19/netanalyzer/discovery/DiscoveryMethod.java`
- [ARP discovery](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/ARPDiscovery.java): `app/src/main/java/com/av19/netanalyzer/discovery/ARPDiscovery.java`
- [ICMP discovery](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/ICMPDiscovery.java): `app/src/main/java/com/av19/netanalyzer/discovery/ICMPDiscovery.java`
- [TCP discovery](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/TCPDiscovery.java): `app/src/main/java/com/av19/netanalyzer/discovery/TCPDiscovery.java`
- [mDNS discovery](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/MDNSDiscovery.java): `app/src/main/java/com/av19/netanalyzer/discovery/MDNSDiscovery.java`
- [SSDP discovery](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/SSDPDiscovery.java): `app/src/main/java/com/av19/netanalyzer/discovery/SSDPDiscovery.java`
- [NetBIOS discovery](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/discovery/NetBIOSDiscovery.java): `app/src/main/java/com/av19/netanalyzer/discovery/NetBIOSDiscovery.java`
- [Device fusion](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/ListDeviceInfo.java): `app/src/main/java/com/av19/netanalyzer/data/ListDeviceInfo.java`
- [Device fingerprinting](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/FingerprintManager.java): `app/src/main/java/com/av19/netanalyzer/utils/FingerprintManager.java`
- [OpenRouter enrichment](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/OpenRouterApiClient.java): `app/src/main/java/com/av19/netanalyzer/utils/OpenRouterApiClient.java`

### Scan state and history

- [Scan repository](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/repository/ScanRepository.java): `app/src/main/java/com/av19/netanalyzer/repository/ScanRepository.java`
- [Scan ViewModel](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/viewmodel/ScanViewModel.java): `app/src/main/java/com/av19/netanalyzer/viewmodel/ScanViewModel.java`
- [Scan state](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/ScanState.java): `app/src/main/java/com/av19/netanalyzer/data/ScanState.java`
- [Network details](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/NetworkInfo.java): `app/src/main/java/com/av19/netanalyzer/data/NetworkInfo.java`
- [Device records](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/DeviceInfo.java): `app/src/main/java/com/av19/netanalyzer/data/DeviceInfo.java`
- [Scan history](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/data/ScanRecord.java): `app/src/main/java/com/av19/netanalyzer/data/ScanRecord.java`

### Settings

- [Preferences storage](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/utils/PreferencesManager.java): `app/src/main/java/com/av19/netanalyzer/utils/PreferencesManager.java`
- [Discovery configuration](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/MethodConfigDialogFragment.java): `app/src/main/java/com/av19/netanalyzer/ui/home/MethodConfigDialogFragment.java`
- [Config import/export](https://github.com/andervicario/netanalyzer/blob/master/app/src/main/java/com/av19/netanalyzer/ui/home/ImportConfigDialogFragment.java): `app/src/main/java/com/av19/netanalyzer/ui/home/ImportConfigDialogFragment.java`

### Other components

- **Network auditor**
- **OpenRouter API**

## Connections

- Network auditor → Home screen: starts scan (evidence: `app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java`)
- Home screen → Foreground scan service: starts service (evidence: `app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java`)
- Foreground scan service → Network scanner: configures scan (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Network scanner → Discovery contract: dispatches methods (evidence: `app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java`)
- Network scanner → NIO port scan: runs port scan (evidence: `app/src/main/java/com/av19/netanalyzer/scanner/NetworkScanner.java`)
- Foreground scan service → ARP discovery: registers method (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → ICMP discovery: registers method (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → mDNS discovery: registers method (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → SSDP discovery: registers method (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → TCP discovery: registers method (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → NetBIOS discovery: registers method (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → Device fusion: collects devices (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Foreground scan service → Device fingerprinting: applies fingerprints (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- SSDP discovery → OpenRouter enrichment: enriches device (evidence: `app/src/main/java/com/av19/netanalyzer/discovery/SSDPDiscovery.java`)
- OpenRouter enrichment → OpenRouter API: sends request (evidence: `app/src/main/java/com/av19/netanalyzer/utils/OpenRouterApiClient.java`)
- Foreground scan service → Scan repository: publishes results (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Scan repository → Scan state: updates state (evidence: `app/src/main/java/com/av19/netanalyzer/repository/ScanRepository.java`)
- Scan ViewModel → Scan repository: observes state (evidence: `app/src/main/java/com/av19/netanalyzer/viewmodel/ScanViewModel.java`)
- Home screen → Scan ViewModel: observes progress (evidence: `app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java`)
- Device results → Scan ViewModel: observes results (evidence: `app/src/main/java/com/av19/netanalyzer/ui/devices/DevicesFragment.java`)
- Foreground scan service → Preferences storage: stores history (evidence: `app/src/main/java/com/av19/netanalyzer/service/ScanService.java`)
- Preferences storage → Scan history: persists records (evidence: `app/src/main/java/com/av19/netanalyzer/utils/PreferencesManager.java`)
- Home screen → Preferences storage: reads history (evidence: `app/src/main/java/com/av19/netanalyzer/ui/home/HomeFragment.java`)
- Settings UI → Discovery configuration: configures methods
- Discovery configuration → Preferences storage: saves settings (evidence: `app/src/main/java/com/av19/netanalyzer/ui/home/MethodConfigDialogFragment.java`)
- Config import/export → Preferences storage: imports settings (evidence: `app/src/main/java/com/av19/netanalyzer/ui/home/ImportConfigDialogFragment.java`)
