neonova-insight

NeoNova Subscriber Dashboard & Reports

A powerful Tampermonkey userscript suite for NeoNova admins (admin.neonova.net).

Real-time customer monitoring + professional stability reports with live polling, two-click customer addition, dual stability scores, rolling 7-day charts, and exports.

Built for admins, field techs, and small ISPs who need better visibility into modem flaps, uptime, and reconnect behavior.

(Live dashboard with polling controls, status table, and Add Customer modal – connected modems now sorted by shortest connection duration first)

Sample Interactive Report

Here’s a real generated report from an 11 month (max length) monitoring period (interactive version with live charts, tooltips, and export buttons):

Open Interactive Sample Report →

Or view the raw HTML directly:
View raw sample report

✨ Current Features

Live Dashboard

• Real-time customer status polling (configurable interval)
• Pause/Resume + manual Refresh
• One-click Add Customer modal (no more inline form clutter)
• Connected modems automatically sorted by connection duration (shortest first) – new in March 2026
• Remove & Report buttons per customer
• Clean, consistent UI with Tailwind styling

Professional Reports

• Dual stability scores (mean + median session-based)
• Uptime %, session/reconnect stats, peak analysis
• Hourly, daily, and rolling 7-day disconnect charts (Chart.js)
• Long disconnect table + export (HTML / CSV / PDF)
• Handles 140k+ row reports without breaking
• Total results counted + duplicates ignored note restored

Under the Hood

• Fully modular MVC architecture (src/{controllers, models, views, core, scripts}/)
• NeonovaAnalyzer refactored into clean private helpers with heavy comments
• Stress-tested on massive accounts with over 100k results in one report
• Zero console errors on normal use
• Full test suite (Vitest) + architecture overview in docs/architecture.md

Security & Data Handling

This is a client-side Tampermonkey userscript designed to make life easier for NeoNova administrators. It runs entirely inside your browser on admin.neonova.net and does nothing unless you are actively logged in.

Why it can process large datasets quickly (and why that’s not scary)

The script can generate reports that pull and analyze hundreds of thousands of RADIUS log entries in hours rather than days simply because it automates the exact same actions you already perform manually in the admin portal.

• It uses the exact same pagination endpoints the official web UI already exposes.
• Everything (fetching, cleaning, and calculating metrics) happens locally in your browser using standard JavaScript.
• It does not bypass any rate limits, does not use hidden APIs, and does not create any extra load on the server beyond what a human clicking through pages would generate.
  In short: it just saves you from having to sit there clicking “Next” for 45 minutes.

Authentication & Access

• The script cannot function at all without an active, 2FA-verified session on the NeoNova admin portal.
• It never stores, transmits, or interacts with passwords, 2FA tokens, or any credentials.
• It performs only actions that the currently logged-in user is already authorized to do through the normal web interface.

Data Access

• The script only reads and processes data that is already visible or exportable in the standard NeoNova admin UI while you are logged in.
• No additional privileges are requested or used.

Persistent Storage (Encrypted)

• The only data saved between sessions is your personal list of monitored customers (usernames, friendly names, and latest status).
• This data is stored in the browser’s localStorage and is fully AES-256-GCM encrypted on disk using the Web Crypto API.
• On first use you set a passphrase (the dashboard cannot be used without a passphrase). The key is remembered securely on your device for zero-prompt future visits.
• To force a re-prompt or wipe the key at any time: run localStorage.removeItem('novaDashboardMasterKey') in the console.

No Persistent Logs or Reports

Historical RADIUS data and generated reports exist only in memory while the dashboard or report modal is open. They are never automatically saved to disk — you must explicitly export them (HTML/CSV/PDF) if needed.

The script does not run in the background, does not contact any external servers, and does not perform any actions outside of an active authenticated session.

If you have any security, compliance, or operational questions, feel free to reach out — we’re happy to walk through anything.

Installation

1. Install Tampermonkey (Chrome / Firefox / Edge).

2. Click this raw link — Tampermonkey will prompt to install:

   • NeoNova Dashboard ← Main script
     (All supporting modules in src/ are auto-@required)
3. Visit https://admin.neonova.net → log in → the dashboard panel appears automatically.

Usage

• Dashboard: Monitor multiple customers live. Use “Add Customer”, Refresh, or let it poll.
• Reports: Click any “Report” button → generates beautiful HTML with charts and stats.
• Export: HTML, CSV, or PDF from any report.

Recent Major Updates (2026)

• Mar 17–18: Merged PR #23 – connected modems now sorted by duration (shortest first) + reporting fixes
• Live dashboard with polling controls and Add Customer modal
• Complete modular refactor (src/{controllers, models, views, scripts, core}/ structure – fully testable & documented)
• Rolling 7-day chart fixed and scaled properly
• Total results counted / ignored duplicates restored
• Button styling unified across the entire UI
• 140k-row stress testing passed

Tech Stack

• Tampermonkey userscript
• Pure JavaScript + Chart.js
• Tailwind CSS (via CDN for dev speed)
• jsPDF + html2canvas for PDF export

Contributing

PRs welcome! Especially interested in:

• More chart types
• Configurable scoring weights
• Dark/light theme toggle
• CLI version for bulk reports

License

MIT

This site is open source. Improve this page.