# 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.