2026-08-03 21:40:48 +00:00
|
|
|
# NetMapper2026
|
|
|
|
|
|
|
|
|
|
NetMapper è una web app self-hosted per la mappatura dinamica di un homelab su più livelli: fisico, logico, gerarchico e inventario/IP.
|
|
|
|
|
|
|
|
|
|
## Obiettivi iniziali
|
|
|
|
|
|
|
|
|
|
- Discovery di rete multi-livello con granularitਨ.
|
|
|
|
|
- Modellazione gerarchica di host fisici, VM, container, app e dispositivi di rete.
|
|
|
|
|
- Associazione IP/MAC/interfacce agli oggetti mappati.
|
|
|
|
|
- Vista fisica e logica editabile, con arricchimento manuale.
|
|
|
|
|
- Deploy semplice in LXC Proxmox con base portabile verso Docker/Podman.
|
|
|
|
|
|
|
|
|
|
## Monorepo layout
|
|
|
|
|
|
|
|
|
|
- `docs/` - visione, modello dati, roadmap e scelte architetturali.
|
|
|
|
|
- `frontend/` - UI web dell'applicazione.
|
|
|
|
|
- `backend/` - API, logica dominio e persistenza.
|
|
|
|
|
- `worker/` - motore di discovery e job asincroni.
|
|
|
|
|
- `deploy/` - file di deploy, compose e containerizzazione.
|
|
|
|
|
|
|
|
|
|
## MVP
|
|
|
|
|
|
|
|
|
|
1. CRUD oggetti, IP, interfacce e relazioni.
|
|
|
|
|
2. Discovery base subnet/host/porte.
|
|
|
|
|
3. Discovery SNMP/LLDP per topologia iniziale.
|
|
|
|
|
4. Mappa visuale con nodi annidati e pannello dettagli.
|
|
|
|
|
|
|
|
|
|
## Stack proposto
|
|
|
|
|
|
|
|
|
|
- Frontend: React + TypeScript + Vite
|
|
|
|
|
- Backend: FastAPI
|
|
|
|
|
- Worker discovery: Python
|
|
|
|
|
- Database: PostgreSQL
|
|
|
|
|
- Cache/queue: Redis
|
|
|
|
|
- Deploy: Docker Compose
|
2026-08-03 22:13:46 +00:00
|
|
|
|
|
|
|
|
### Agent
|
|
|
|
|
|
|
|
|
|
- `agent/` - control agent per gestire i servizi systemd (start/stop/status).
|
