initial commit. phase 1 complete

backend/tasks/discovery.py

@@ -0,0 +1,27 @@
+"""
+Discovery task stubs — Phase 1 scaffolding.
+
+Phase 2 implementations will:
+  scan_all_networks  — iterate Network queryset, run nmap per CIDR, upsert Nodes
+  poll_proxmox       — call Proxmox API, upsert VM/container Nodes via PROXMOX_URL/TOKEN env vars
+"""
+
+import logging
+
+from config.celery import app
+
+logger = logging.getLogger(__name__)
+
+
+@app.task(name="tasks.discovery.scan_all_networks", bind=True, max_retries=3)
+def scan_all_networks(self) -> dict:  # type: ignore[type-arg]
+    """Stub: scan all configured Network CIDRs for live hosts."""
+    logger.info("discovery.scan_all_networks: stub — Phase 2 not yet implemented")
+    return {"status": "stub", "message": "Phase 2 not yet implemented"}
+
+
+@app.task(name="tasks.discovery.poll_proxmox", bind=True, max_retries=3)
+def poll_proxmox(self) -> dict:  # type: ignore[type-arg]
+    """Stub: poll Proxmox API for VMs and containers."""
+    logger.info("discovery.poll_proxmox: stub — Phase 2 not yet implemented")
+    return {"status": "stub", "message": "Phase 2 not yet implemented"}