NetMapper2026/README.md

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

Agent

• agent/ - control agent per gestire i servizi systemd (start/stop/status).