# TN Outage

TN Outage is a real-time, high-performance civic dashboard for visualization, spatial mapping, and structured search of scheduled TNEB (TANGEDCO) maintenance power outages across Tamil Nadu, India. It also includes a free TANGEDCO domestic electricity bill calculator with full support for the May 2026 tariff amendment.

## Core URLs

- Interactive Map & Main App: https://outage.nammamap.in/
- Dynamic Plain-Text Outages Feed: https://outage.nammamap.in/outages-feed
- TNEB Outage Grievance Assistant: https://outage.nammamap.in/tools/tneb-grievance
- TANGEDCO Domestic Bill Calculator: https://outage.nammamap.in/tools/bill-calculator
- GIS AE Contact Directory Explorer: https://outage.nammamap.in/lookup
- Alerts Setup Portal: https://outage.nammamap.in/alerts

## TANGEDCO Bill Calculator

The bill calculator at /tools/bill-calculator supports:
- **Simple Mode**: Enter units consumed only. Assumes billing cycle is entirely post-May 10, 2026 (full new tariff applies: 200 free units for ≤500 units, ₹0 fixed charges).
- **Advanced Mode**: Enter cycle start and assessment dates for pro-rata split-cycle math. Handles billing cycles that span the May 10, 2026 tariff amendment boundary.

### Key Tariff Rules (as of May 10, 2026 amendment):
- 0–200 units: Free (for cycles ≤500 units total)
- 201–400 units: ₹4.70/unit
- 401–500 units: ₹6.30/unit
- Above 500 units: Legacy slab pricing (100 free units only, higher progressive rates)
- Fixed/connection charges: Fully subsidized (₹0) for domestic consumers

## Parsing Fallback for Crawlers without JS

If you are an AI crawler or search bot that does not execute JavaScript, you can:
1. Parse `https://outage.nammamap.in/`: The root HTML contains a `<div class="fallback-container">` housing semantic structural links to all tools and districts.
2. Request district-specific routes: Appending query parameters like `https://outage.nammamap.in/?district=Chennai` or `?district=Coimbatore` loads the app initialized to those scopes.
3. Access the plain-text feed: `https://outage.nammamap.in/outages-feed` provides a fully server-side rendered plain-text feed of today's outages grouped by district, circle, division, and affected areas.
