Automate LLDP-based interface descriptions on Huawei VRP switches.

Automazione delle descrizioni interfacce basata su LLDP per switch Huawei VRP.

EN: LLDP Config Manager discovers LLDP neighbors on Huawei switches and automatically configures interface descriptions based on the discovered topology. It supports bulk operations across multiple switches, real-time progress monitoring via WebSocket, and integration with NeDi for device discovery.

IT: LLDP Config Manager scopre i neighbor LLDP sugli switch Huawei e configura automaticamente le descrizioni delle interfacce in base alla topologia scoperta. Supporta operazioni batch su piu' switch, monitoraggio in tempo reale via WebSocket e integrazione con NeDi per la discovery dei dispositivi.

• LLDP Discovery - Automatic neighbor detection via SSH (display lldp neighbor brief)
• Auto-Description - Generate and apply interface descriptions from LLDP data
• VRP Version Support - VRP 6.x, 7.x, 8.x with version-specific syntax
• Batch Operations - Process multiple switches with configurable concurrency
• Write + Verify - Write descriptions then verify readback (detects partial writes)
• SSH Session Management - Keepalive, heartbeat, auto-reconnect, TTL-based re-auth
• NeDi Integration - Import switches from NeDi network discovery database
• CSV/Excel Import - Bulk import switches and credentials from spreadsheets
• SNMP Discovery - Network-wide device discovery via SNMP
• Audit Logging - Full audit trail of all operations
• Kanban Board - Visual switch management workflow
• Real-time Updates - WebSocket-based progress monitoring
• Encrypted Credentials - Fernet encryption for stored passwords

lldp-config-manager/
  backend/           # FastAPI (Python) - Core API, SSH, LLDP logic
    services/        # SSH, LLDP, encryption, VRP syntax
    models/          # SQLAlchemy models
    routers/         # API endpoints
    tests/           # Pytest test suite
    src/             # Alternative API structure (v2)
    static/          # Standalone HTML frontend
  frontend/          # React + TypeScript + Vite + Tailwind CSS
    src/components/  # UI components (Kanban, ApplyModal, etc.)
    e2e/             # Playwright E2E tests
  server/            # Node.js Express - NeDi bridge, CSV import
    src/routes/      # API routes (nedi, csv, lldp, switches)

• Python 3.10+
• Node.js 18+
• Network access to Huawei switches via SSH

cd backend
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate   # Windows
pip install -r requirements.txt
cp ../.env.example .env   # Edit with your settings
uvicorn main:app --host 0.0.0.0 --port 8084

cd frontend
npm install
npm run dev

cd server
npm install
cp ../.env.example .env   # Edit with your NeDi credentials
node src/index.js

cp .env.example .env  # Edit with your settings
docker-compose up -d

Copy .env.example to .env and configure:

# Backend unit tests
cd backend
pytest

# Frontend E2E tests
cd frontend
npx playwright test

MIT License - see LICENSE

Marco Mereu