# 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