How kneranjan/unifra works
Unifra discovers network hosts, enriches them with port/OS scans, records gateway links, and inventories Docker containers; a periodic scan coordinator persists these results for API queries and topology output. The API also exposes basic item CRUD and a topology-view page. The graph separates discovery, scan orchestration, API presentation, and persistence. Source excerpts show the scan and API paths; the README is empty, and the topology HTML contents were not sampled, so no browser-to-topology-data link is asserted.
Main entry points: storage.py Scan Coordinator · main.py REST API · database.py Database Sessions · models.py ORM Models
Components 15
Discovery
- Host Discovery
app/discovery_agent/scan.py - Port and OS Scan
app/discovery_agent/scan.py - Container Discovery
app/discovery_agent/docker_scan.py
Scan Processing
- Scan Coordinator
app/discovery_agent/storage.py - Host and Link Updates
app/discovery_agent/storage.py - Container Updates
app/discovery_agent/storage.py
API Presentation
- REST API
app/main.py - Topology Page
app/topology.html
Persistence
- Database Sessions
app/database.py - ORM Models
app/models.py - Application Data
Other components
- API Client
- Scanned Network
- Docker Engine
- PostgreSQL
Connections 21
- API Client → REST API: calls endpoints
app/main.py - REST API → Database Sessions: gets sessions
app/main.py - REST API → ORM Models: queries and writes
app/main.py - REST API → Topology Page: serves page
app/main.py - Scan Coordinator → Host Discovery: discovers hosts
app/discovery_agent/storage.py - Scan Coordinator → Port and OS Scan: scans ports
app/discovery_agent/storage.py - Scan Coordinator → Container Discovery: discovers containers
app/discovery_agent/storage.py - Host Discovery → Scanned Network: probes hosts
app/discovery_agent/scan.py - Port and OS Scan → Scanned Network: probes ports
app/discovery_agent/scan.py - Container Discovery → Docker Engine: lists containers
app/discovery_agent/docker_scan.py - Scan Coordinator → Host and Link Updates: runs host updates
app/discovery_agent/storage.py - Scan Coordinator → Container Updates: runs container updates
app/discovery_agent/storage.py - Host and Link Updates → Database Sessions: opens sessions
app/discovery_agent/storage.py - Host and Link Updates → ORM Models: reads and writes
app/discovery_agent/storage.py - Container Updates → Database Sessions: opens sessions
app/discovery_agent/storage.py - Container Updates → ORM Models: reads and writes
app/discovery_agent/storage.py - Database Sessions → PostgreSQL: connects to
app/database.py - ORM Models → Database Sessions: uses base
app/models.py - REST API → Application Data: reads and writes
app/main.py - Host and Link Updates → Application Data: persists scan results
app/discovery_agent/storage.py - Container Updates → Application Data: persists inventory
app/discovery_agent/storage.py