Initial commit: bootstrap monorepo NetMapper

2026-08-03 21:40:48 +00:00
commit 96130a11f4
10 changed files with 257 additions and 0 deletions
@@ -0,0 +1,35 @@
+# 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