gandalf/secubox-openwrt
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
078e2dc01e
secubox-openwrt/package/secubox/secubox-app-device-intel/HISTORY.md
CyberMind-FR 57db9cfb40 feat: Add device-intel and dns-provider packages 
Add 4 new packages implementing unified device intelligence and
DNS provider API management:

- secubox-app-dns-provider: dnsctl CLI with OVH, Gandi, Cloudflare
  adapters for DNS record CRUD, HAProxy vhost sync, propagation
  verification, and ACME DNS-01 wildcard certificate issuance
- luci-app-dns-provider: RPCD handler + LuCI views for provider
  settings and DNS record management
- secubox-app-device-intel: Aggregation layer merging mac-guardian,
  client-guardian, DHCP, P2P mesh, and exposure data with heuristic
  classification engine and USB/MQTT/Zigbee emulator modules
- luci-app-device-intel: RPCD handler + 5 LuCI views (dashboard,
  devices, emulators, mesh, settings) with shared API and CSS

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 15:47:20 +01:00

2.5 KiB
Raw Blame History

secubox-app-device-intel — History

v1.0.0 — 2026-02-04

Initial Release

  • Created secubox-app-device-intel package

    • UCI config: main settings, display preferences, 3 emulator modules (USB/MQTT/Zigbee), 10 device type rules, per-device override template
    • device-intelctl CLI: list, show, classify, set-type, set-label, summary, emulators, mesh-list, export, refresh, status
    • Core aggregation library (functions.sh): 6 data source collectors + emulator dispatcher + merge-on-MAC + caching
    • Classification engine (classify.sh): 7-level priority chain (user > emulator > mesh > port > vendor > hostname > fallback)
    • USB emulator: walks /sys/bus/usb/devices, classifies by bDeviceClass, detects storage mount points
    • MQTT emulator: queries mosquitto broker via $SYS topics, logs, or mosquitto_ctrl
    • Zigbee emulator: queries zigbee2mqtt HTTP API or deCONZ REST API, parses paired devices

  • Created luci-app-device-intel package

    • RPCD handler: get_devices, get_device, get_summary, get_mesh_devices, get_emulators, get_device_types, classify_device, set_device_meta, refresh
    • Shared API module (api.js): 9 RPC method wrappers
    • Dashboard view: stat cards, source chips, type distribution grid, zone bar, recent devices
    • Devices view: filter bar, full device table, edit modal, detail modal
    • Emulators view: USB/MQTT/Zigbee status cards with mini device tables
    • Mesh view: peer cards, remote device table
    • Settings view: form.Map for all UCI sections (main, display, USB, MQTT, Zigbee)
    • Custom CSS (common.css): stat cards, type grid, source chips, device table, emulator cards
    • Menu under admin/secubox/device-intel (5 tabs)
    • ACL with cross-subsystem read access (mac-guardian, client-guardian, P2P, exposure)

Design Decisions

  • Pure aggregation: No data duplication — all data fetched at query time from existing subsystems
  • MAC as primary key: All sources merged on MAC address; synthetic IDs (synth-usb-, synth-mqtt-, synth-zigbee-*) for non-MAC devices
  • File-based caching: /tmp/device-intel/cache-devices.json with configurable TTL avoids repeated collection
  • Emulator modularity: Each emulator is a standalone .sh file exporting emulate_<type>(), loaded only when enabled in UCI
  • Pipe-delimited intermediate format: Collectors output source|mac|field1|field2... lines to temp files, merged by the aggregator
  • Classification decoupled from collection: classify.sh is a separate library that can run independently or batch