Harry-kp/uppcl-pro

GitHub: Harry-kp/uppcl-pro

Stars: 1 | Forks: 0

# UPPCL Pro **Your prepaid meter, finally making sense.** Analytics dashboard for UPPCL SMART prepaid electricity meters.
Live balance, runway forecast, anomaly detection, complaint tracking.
[**Try it**](https://uppcl-pro.vercel.app) · [Screenshots](#screenshots) · [Self-host](#self-host) · [How it works](#how-it-works)
Live Privacy MIT

UPPCL Pro dashboard ## What you get | | | |---|---| | **Balance & Runway** | Live balance with fallback chain. Days-until-empty gauge. Recharge recommendation. | | **Anomaly Detection** | Flags days >1.5 standard deviations above your 30-day average. | | **Usage Analytics** | Calendar heatmap, day-of-week patterns, annual consumption profile. | | **Cost Breakdown** | Effective rate/unit, charge composition, tariff slab usage, subsidy tracking. | | **Recharge Planner** | Sweet-spot recommender with lifespan analytics for past recharges. | | **Meter Health** | Data reliability, peak-vs-sanctioned load, power factor trend, 365-day gap calendar. | | **1912 Complaints** | Full complaint history, JE/AE/XEN officer chain with phone numbers. |
## Screenshots
Usage analytics Usage analytics
Bills & cost Bills & cost
Recharges & runway Recharges
Meter health Meter health
1912 complaints Complaints

## Self-host git clone https://github.com/Harry-kp/uppcl-pro.git cd uppcl-pro bun install bun run dev Open [localhost:3000](http://localhost:3000) and sign in with your UPPCL SMART credentials. Requires Node 20+ or Bun 1.1+.
## Privacy Your credentials pass through the server over HTTPS to reach UPPCL's API. **They are never stored, logged, or shared.** The server is a stateless CORS proxy with no database, no tracking, and no analytics. For complete privacy, [self-host](#self-host) -- your credentials never leave your machine. The entire codebase is open-source. [Read the proxy route](src/app/api/uppcl/%5B...path%5D/route.ts) yourself.
## How it works You This app UPPCL | | | |── credentials (HTTPS) ───>|── forwards to UPPCL ──────>| | | (never stores anything) | |<── dashboard data ────────|<── returns response ────────| | | | JWT stored in your browser Server forgets immediately The server has two routes: - `/api/uppcl/*` -- CORS proxy to `uppcl.sem.jio.com` (your data passes through, never stored) - `/api/complaints` -- queries the public 1912 complaint portal (no credentials involved)
## Supported DISCOMs | DISCOM | Region | Status | |--------|--------|--------| | **PVVNL** | West UP | Tested | | MVVNL | Central UP | Same API, unverified | | PuVVNL | East UP | Same API, unverified | | DVVNL | South UP | Same API, unverified | | KESCo | Kanpur | Same API, unverified | Using a non-PVVNL DISCOM? [Let us know](https://github.com/Harry-kp/uppcl-pro/issues) if it works.
## License [MIT](LICENSE). Not affiliated with UPPCL, any DISCOM, or Reliance Jio.
标签：自动化攻击