How netwatchteam/netwatch works
Netwatch is a Flask-based network scanner and monitoring service. Its main workflow accepts scan targets over HTTP, discovers hosts and services, then enriches each machine with availability, TCP, TLS, and optional SSH system metrics before returning a snapshot. A separate endpoint checks configured TCP targets without running discovery. The graph reflects the documented composition root and sampled calls; unsampled API and presentation behavior is included only where the README or source index supports it.
Main entry points: main.py Application wiring · machine_use_case.py Machine scan · main_controller.py Main controller · check_tcp_service.py TCP service check
Components 30
HTTP interface
- Flask API
scanner/src/api/api_resource.py - Main controller
scanner/src/controllers/main_controller.py
Scan orchestration
- Application wiring
scanner/src/main.py - Machine scan
scanner/src/usecases/machine_use_case.py - Network discovery
scanner/src/usecases/scan_network.py - Expected TCP checks
scanner/src/usecases/check_expected_services.py
Network probes
- Availability check
scanner/src/usecases/check_availability.py - TCP service check
scanner/src/usecases/check_tcp_service.py - TLS certificate check
scanner/src/usecases/check_tls_use_case.py - System metrics
scanner/src/usecases/collect_system_metrics.py - Scanner interface
scanner/src/usecases/ports/network_scanner.py - ICMP interface
scanner/src/usecases/ports/icmp.py - TCP interface
scanner/src/usecases/ports/tcp.py - TLS interface
scanner/src/usecases/ports/tls.py - SSH metrics interface
scanner/src/usecases/ports/ssh.py - Nmap adapter
scanner/src/adapters/nmap_adapter.py - ICMP adapter
scanner/src/adapters/icmp_adapter.py - TCP adapter
scanner/src/adapters/tcp_adapter.py - TLS adapter
scanner/src/adapters/tls_adapter.py - SSH metrics adapter
scanner/src/adapters/ssh_adapter.py
Domain and presentation
- Machine model
scanner/src/entities/machine.py - Service model
scanner/src/entities/service.py - Certificate model
scanner/src/entities/certificate.py - Metrics models
scanner/src/entities/system_metrics.py - TCP result model
scanner/src/entities/tcp_check.py - Snapshot presenter
scanner/src/presenters/snapshot_presenter.py - Scan presenter
scanner/src/presenters/scan_presenter.py - Machine presenter
scanner/src/presenters/machine_presenter.py - Scan response
scanner/src/usecases/responses/scan_response.py
Other components
- API client
Connections 38
- API client → Flask API: sends requests
scanner/src/api/api_resource.py - Flask API → Main controller: delegates scans
scanner/src/api/api_resource.py - Main controller → Machine scan: runs scan
scanner/src/controllers/main_controller.py - Main controller → Expected TCP checks: runs checks
scanner/src/controllers/main_controller.py - Main controller → Snapshot presenter: formats snapshot
scanner/src/controllers/main_controller.py - Application wiring → Flask API: creates app
scanner/src/main.py - Application wiring → Main controller: builds controller
scanner/src/main.py - Application wiring → Machine scan: injects dependencies
scanner/src/main.py - Application wiring → Network discovery: injects scanner
scanner/src/main.py - Application wiring → Expected TCP checks: injects checker
scanner/src/main.py - Application wiring → Nmap adapter: constructs adapter
scanner/src/main.py - Application wiring → ICMP adapter: constructs adapter
scanner/src/main.py - Application wiring → TCP adapter: constructs adapter
scanner/src/main.py - Application wiring → TLS adapter: constructs adapter
scanner/src/main.py - Application wiring → SSH metrics adapter: constructs adapter
scanner/src/main.py - Machine scan → Network discovery: discovers hosts
scanner/src/usecases/machine_use_case.py - Machine scan → Availability check: checks availability
scanner/src/usecases/machine_use_case.py - Machine scan → TCP service check: checks ports
scanner/src/usecases/machine_use_case.py - Machine scan → TLS certificate check: reads certificates
scanner/src/usecases/machine_use_case.py - Machine scan → System metrics: collects metrics
scanner/src/usecases/machine_use_case.py - Expected TCP checks → TCP service check: checks targets
scanner/src/usecases/check_expected_services.py - Network discovery → Scanner interface: scans hosts
scanner/src/usecases/scan_network.py - Nmap adapter → Scanner interface: implements
scanner/src/adapters/nmap_adapter.py - ICMP adapter → ICMP interface: implements
scanner/src/adapters/icmp_adapter.py - TCP adapter → TCP interface: implements
scanner/src/adapters/tcp_adapter.py - TLS adapter → TLS interface: implements
scanner/src/adapters/tls_adapter.py - SSH metrics adapter → SSH metrics interface: implements
scanner/src/adapters/ssh_adapter.py - Availability check → ICMP interface: probes through
scanner/src/usecases/check_availability.py - TCP service check → TCP interface: probes through
scanner/src/usecases/check_tcp_service.py - TCP service check → TCP result model: creates result
scanner/src/usecases/check_tcp_service.py - TLS certificate check → TLS interface: reads through
scanner/src/usecases/check_tls_use_case.py - System metrics → SSH metrics interface: fetches metrics
scanner/src/usecases/collect_system_metrics.py - System metrics → Metrics models: builds metrics
scanner/src/usecases/collect_system_metrics.py - Machine model → Certificate model: contains certificates
scanner/src/entities/machine.py - Machine model → Service model: contains services
scanner/src/entities/machine.py - Service model → Certificate model: none
- Scan presenter → Machine presenter: uses
scanner/src/presenters/scan_presenter.py - Scan presenter → Scan response: formats response
scanner/src/presenters/scan_presenter.py