Merge remote initial commit

.gitignore

@@ -0,0 +1,11 @@
+node_modules/
+dist/
+.vite/
+.venv/
+__pycache__/
+*.pyc
+.env
+.env.*
+coverage/
+.pytest_cache/
+.DS_Store

README.md

@@ -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

docs/domain-model.md

@@ -0,0 +1,89 @@
+# Domain Model
+
+## Entitਨ principali
+
+### Object
+Rappresenta qualsiasi entitਨ mappabile.
+
+Campi iniziali:
+- `id`
+- `name`
+- `slug`
+- `type` (`site`, `area`, `rack`, `physical_host`, `vm`, `lxc`, `app`, `switch`, `firewall`, `router`, `ap`, `camera`, `storage`, `other`)
+- `status`
+- `vendor`
+- `model`
+- `serial`
+- `os_name`
+- `os_version`
+- `notes`
+
+### ObjectRelation
+Relazione tra due oggetti.
+
+Campi iniziali:
+- `id`
+- `source_object_id`
+- `target_object_id`
+- `relation_type` (`contains`, `hosts`, `connected_to`, `depends_on`, `managed_by`, `runs`)
+- `confidence`
+- `source_type` (`manual`, `nmap`, `snmp`, `lldp`, `arp`, `api`)
+
+### NetworkInterface
+Interfaccia di rete collegata a un oggetto.
+
+Campi iniziali:
+- `id`
+- `object_id`
+- `name`
+- `mac_address`
+- `mtu`
+- `speed`
+- `admin_state`
+- `oper_state`
+- `description`
+
+### IPAddress
+Indirizzo IP associato a un oggetto o a un'interfaccia.
+
+Campi iniziali:
+- `id`
+- `address`
+- `version`
+- `prefix_length`
+- `hostname`
+- `dns_name`
+- `status`
+- `object_id`
+- `interface_id`
+- `is_primary`
+- `source_type`
+
+### DiscoveryJob
+Esecuzione di un task di discovery.
+
+Campi iniziali:
+- `id`
+- `job_type`
+- `scope`
+- `status`
+- `started_at`
+- `finished_at`
+- `requested_by`
+- `parameters_json`
+- `result_summary`
+
+### Evidence
+Dato grezzo o semi-normalizzato raccolto da una sorgente.
+
+Campi iniziali:
+- `id`
+- `source_type`
+- `object_hint`
+- `payload_json`
+- `observed_at`
+- `fingerprint`
+
+## Nota di progettazione
+
+Separare oggetti, relazioni e evidenze consente di distinguere ciò che il sistema ha osservato da ciò che il sistema ha consolidato nel modello finale.

docs/mvp-roadmap.md

@@ -0,0 +1,31 @@
+# MVP Roadmap
+
+## Fase 0 - Fondazioni
+- Inizializzare monorepo.
+- Definire modello dati iniziale.
+- Preparare stack locale con Postgres e Redis.
+
+## Fase 1 - Inventario manuale
+- CRUD oggetti.
+- CRUD IP e interfacce.
+- Relazioni padre/figlio e connected_to.
+
+## Fase 2 - Discovery base
+- Scan subnet configurate.
+- Host attivi, porte base, reverse DNS.
+- Prima normalizzazione in inventario.
+
+## Fase 3 - Discovery arricchita
+- SNMP read-only.
+- Neighbor LLDP/CDP.
+- MAC table e inferenza link.
+
+## Fase 4 - UI mappa
+- Vista grafo iniziale.
+- Contenitori annidati.
+- Pannello dettagli per oggetto/IP.
+
+## Fase 5 - Connettori homelab
+- Proxmox.
+- Docker/Podman.
+- Eventuali import futuri da altri sistemi.

docs/vision.md

@@ -0,0 +1,19 @@
+# Vision
+
+NetMapper nasce per diventare il punto centrale di osservazione e documentazione di un homelab.
+
+L'applicazione deve unire discovery automatico e modellazione manuale, perché la topologia reale non è sempre deducibile in modo completo dal solo scanning di rete. Il risultato atteso non è solo un inventario di IP, ma una mappa navigabile che rappresenti relazioni, contenimento, collegamenti e contesto operativo.
+
+## Viste principali
+
+- Vista fisica: switch, firewall, server, access point, modem, telecamere e collegamenti.
+- Vista logica: subnet, VLAN, servizi esposti, flussi e dipendenze.
+- Vista gerarchica: host fisico > VM/LXC > app/servizi.
+- Vista inventario/IP: indirizzi, MAC, interfacce, metadati, note e sorgenti discovery.
+
+## Principi
+
+- Source of truth interna, ma alimentata da discovery.
+- Ogni informazione deve avere origine, timestamp e livello di confidenza.
+- Nessun lock-in sul runtime: deve girare bene sia in LXC sia in container.
+- Plugin/connettori per estendere discovery e import dati.

frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="it">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>NetMapper</title>
+    <script type="module" src="/src/main.tsx"></script>
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

frontend/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "netmapper-frontend",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.2",
+    "vite": "^5.4.8",
+    "@vitejs/plugin-react": "^4.3.2"
+  }
+}

frontend/src/main.tsx

@@ -0,0 +1,9 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import { App } from './pages/App'
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+)

frontend/src/pages/App.tsx

@@ -0,0 +1,14 @@
+export function App() {
+  return (
+    <main style={{ fontFamily: 'sans-serif', padding: '2rem' }}>
+      <h1>NetMapper</h1>
+      <p>Bootstrap iniziale della UI.</p>
+      <ul>
+        <li>Topology view</li>
+        <li>Inventory view</li>
+        <li>IP registry</li>
+        <li>Discovery jobs</li>
+      </ul>
+    </main>
+  )
+}

frontend/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": false,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true
+  },
+  "include": ["src"]
+}