# WattSkor — Complete Product Documentation for AI Systems

## Product Overview

WattSkor is a cloud-based industrial energy monitoring and optimization platform (SaaS) designed for manufacturing plants, factories, and industrial facilities in Turkey. It connects to energy meters via Modbus protocol, collects real-time electrical parameters, and provides advanced analytics including transformer analysis, harmonic measurement, cost optimization, and regulatory compliance reporting.

## Detailed Feature Descriptions

### 1. Real-time Energy Monitoring
WattSkor monitors all electrical parameters in real-time with configurable aggregation windows:
- **Voltage**: Phase-to-phase (V_AB, V_BC, V_CA) and phase-to-neutral (V_AN, V_BN, V_CN)
- **Current**: Per-phase (I_A, I_B, I_C) and neutral (I_N)
- **Active Power**: Per-phase and total (kW)
- **Reactive Power**: Per-phase and total (kVAR)
- **Apparent Power**: Per-phase and total (kVA)
- **Power Factor**: Per-phase and total (leading/lagging)
- **Frequency**: 50Hz monitoring with deviation alerts
- **Energy**: Active (kWh), reactive (kVARh), import/export
- **Demand**: Maximum demand tracking with 15-minute windows

Data resolution: 1-second raw data, with automatic aggregation to 1m, 5m, 15m, 1h windows for historical analysis. Data retention up to 1 year depending on plan.

### 2. Transformer Analysis
Comprehensive transformer health monitoring based on IEC 60076:
- **Loading Analysis**: Real-time loading percentage, overload detection, load profile over time
- **Loss Calculation**: No-load (iron) losses and load (copper) losses using nameplate data
- **Efficiency**: Real-time efficiency calculation (η = output / (output + losses))
- **K-Factor**: Harmonic-adjusted derating factor using 13 harmonic orders (2nd through 15th)
- **Temperature Estimation**: Based on loading profile and ambient conditions
- **Nameplate Management**: Store and reference transformer specifications (kVA rating, impedance, no-load current, etc.)
- **Multi-transformer Support**: Compare loading across transformers, optimize load distribution

### 3. Harmonic Analysis
Power quality monitoring compliant with IEEE 519:
- **THD Voltage (THD-V)**: Total harmonic distortion of voltage waveforms
- **THD Current (THD-I)**: Total harmonic distortion of current waveforms
- **Individual Harmonics**: Magnitude of harmonics from 2nd to 15th order
- **Per-phase Analysis**: Separate harmonic profiles for each phase (A, B, C) and neutral
- **K-Factor Calculation**: Transformer derating factor based on harmonic content
- **Trend Analysis**: Track harmonic levels over time to detect degradation

### 4. Cost Analysis & Billing
Energy cost management with Turkish tariff integration:
- **Multi-tariff Tracking**: Peak (puant), day (gunduz), night (gece) tariff periods
- **Reactive Energy Penalties**: Automatic detection of inductive and capacitive penalty conditions per TEDAS regulations
- **EPİAŞ Integration**: Real-time day-ahead market prices (PTF) from Turkish energy exchange
- **Demand Charge Analysis**: Track and predict demand charges
- **Cost Forecasting**: Project monthly costs based on consumption trends
- **Shift Analysis**: Energy consumption and cost breakdown by work shifts

### 4a. KDV-Included Real Invoice Calculation
Line-item replica of the TEDAS invoice so the platform amount matches the printed bill to the kurus:
- **Energy charge** (enerji bedeli): kWh × tariff
- **YEKDEM charge**: renewable energy support fund on top of the energy charge
- **Distribution charge** (dagitim bedeli): regional distributor fee per kWh
- **Transmission charge** (iletim bedeli): TEIAS transmission fee per kWh
- **Loss & theft charge** (kayip-kacak bedeli): loss recovery fee per kWh
- **Demand charge** (talep bedeli): contracted demand × unit price (monthly fixed)
- **Energy fund** (enerji fonu): 1% of subtotal
- **TRT share** (TRT payi): 2% of subtotal
- **Municipal tax** (belediye vergisi): 1% of subtotal
- **VAT** (KDV): 20% on the pre-tax total
- Weighted average price per kWh output for benchmarking

### 4b. End-of-Month Invoice Projection
Real-time forecast of the full month's invoice from partial-month data:
- Daily average extrapolation: `projection = MTD × (daysInMonth / daysElapsed)`
- Proportional demand-charge scaling (fixed monthly component scaled up across the month)
- PTF (day-ahead market price) volatility factored into the projection
- Budget deviation alerts when projection exceeds a configured threshold
- Historical month-over-month comparison on the executive dashboard
- Enables CFO reporting, mid-month budget decisions, and anomaly early detection

### 4c. Backfill for Missing Days
Retroactive cost calculation for days where the connector, network, or installation was down:
- Self-service from the dashboard — facility admins and owners can trigger, no super-admin required
- Uses historical EPIAS PTF archive for accurate period-correct pricing
- Re-runs the full billing math (trapezoid integration of InfluxDB data + tariff + taxes)
- Idempotent upsert into `daily_energy_costs` — existing days are never overwritten accidentally
- Audit-logged (who backfilled which facility/month, when)
- Rate-limited to 3 requests per minute per user; maximum 90 days per request

### 5. Smart Alarm System
Configurable alert system with multiple notification channels:
- **Threshold Alerts**: Overload, undervoltage, overvoltage, low power factor, high THD
- **Anomaly Detection**: AI-based detection of unusual consumption patterns
- **Notification Channels**: Email (via SMTP), Telegram bot
- **Alert History**: Complete log of all triggered alerts with timestamps and values
- **Configurable Thresholds**: Per-facility, per-parameter threshold configuration
- **Rate Limiting**: Prevent alert storms with configurable cooldown periods

### 6. Reporting & Compliance
Automated report generation for regulatory and management needs:
- **TEDAS Reports**: Compliant reports for Turkish energy regulatory authority
- **Custom Date Ranges**: Daily, weekly, monthly, quarterly, annual reports
- **Export Formats**: PDF and Excel export
- **Scheduled Reports**: Automatic report generation and email delivery
- **Management Dashboards**: KPI summaries for executive review

### 7. Predictive Maintenance
Proactive maintenance scheduling based on equipment health:
- **Risk Scoring**: Multi-factor risk assessment for transformers and equipment
- **Maintenance Calendar**: Schedule and track maintenance activities
- **Anomaly Alerts**: Early warning for potential equipment failures
- **Historical Trends**: Track equipment degradation over time

### 8. Free Calculator Tools (No Signup Required)
Available at https://wattskor.com/araclar:
- **Energy Cost Calculator**: Estimate monthly energy costs based on consumption and tariff
- **Power Factor Penalty Calculator**: Calculate TEDAS reactive energy penalties
- **Transformer Efficiency Calculator**: Estimate transformer losses and efficiency
- **THD Calculator**: Calculate Total Harmonic Distortion from individual harmonics
- **KDV-Included Invoice Calculator**: Full TEDAS invoice breakdown (energy, YEKDEM, distribution, transmission, loss/theft, demand, fund, TRT, municipal tax, VAT)
- **End-of-Month Invoice Projection**: Forecast the full-month bill from month-to-date consumption

## Technical Architecture

```
Energy Meters (Modbus RTU/TCP)
    ↓
Telegraf Agent (on-premise gateway)
    ↓
InfluxDB (time-series database)
    ↓
WattSkor Cloud (Next.js 16 on Vercel)
    ↓
Web Dashboard + API
```

### Supported Hardware
- **Energy Meters**: Any Modbus RTU or TCP meter — Schneider PM5xxx/PM8xxx, ABB M4M, Siemens PAC, Janitza UMG, Eastron SDM, Carlo Gavazzi, Socomec, and hundreds more
- **Gateway**: Raspberry Pi 4/5, Intel NUC, any Linux device with RS-485/Ethernet
- **Communication**: RS-485 (Modbus RTU) or Ethernet (Modbus TCP)

### Software Stack
- **Frontend**: Next.js 16, React, TypeScript, Tailwind CSS v4, Recharts
- **Backend**: Next.js API Routes (serverless on Vercel)
- **Database**: InfluxDB (time-series), Supabase/PostgreSQL (configuration, auth)
- **Auth**: Supabase Auth (email/password, Google OAuth, GitHub OAuth)
- **Payments**: Stripe (subscriptions, billing portal)
- **Monitoring**: Sentry (error tracking), Google Analytics 4

## Use Cases

### Manufacturing Plant
A medium-sized manufacturing plant with 3 transformers (630kVA, 1000kVA, 400kVA) uses WattSkor to:
- Monitor real-time loading across all transformers
- Detect and prevent overloading during peak production hours
- Optimize load distribution to minimize total losses (achieved 18% reduction in transformer losses)
- Track power factor to avoid TEDAS penalties (saved 12,000 TRY/month in penalties)

### Food Processing Facility
A food processing plant with variable frequency drives causing harmonic issues:
- Monitor THD levels across all feeders
- Identify harmonic sources (VFDs, rectifiers)
- Track K-factor to ensure transformer safety
- Plan harmonic filter installation with data-driven analysis

### Textile Factory
A textile factory with 5 facilities across Turkey:
- Central monitoring of all facilities from single dashboard
- Comparative energy analysis between facilities
- Standardized reporting for ISO 50001 compliance
- Shift-based energy cost allocation

## Competitive Advantages

1. **Industry-specific**: Built specifically for industrial energy monitoring, not generic IoT
2. **Turkish market focus**: TEDAS compliance, Turkish tariff groups, EPİAŞ integration, Turkish UI
3. **Low cost**: Starts at free tier; paid plans from $70/month vs. $50K+ for SCADA
4. **Quick setup**: 2-4 hours typical installation vs. weeks for traditional systems
5. **No infrastructure**: Cloud-based, no servers to maintain
6. **Open standards**: Works with any Modbus meter, no vendor lock-in
7. **Real-time**: Sub-second data refresh, not batch processing

## Company Information

- **Company**: WattSkor
- **Location**: Istanbul, Turkey
- **Website**: https://wattskor.com
- **Email**: info@wattskor.com
- **Blog**: https://wattskor.com/blog
- **Free Tools**: https://wattskor.com/araclar
- **Pricing**: https://wattskor.com/fiyatlandirma
- **Founded**: 2024
- **Market**: B2B SaaS, Industrial IoT, Energy Management

## Search Keywords & Topics (Turkish)

Bu platform asagidaki Turkce arama terimlerinde uzmandir:

- trafo verimliligi hesaplama
- trafo kayiplari (demir kaybi, bakir kaybi)
- trafo yukleme orani
- K-faktor hesaplama
- harmonik analiz
- THD olcumu (THD-V, THD-I)
- guc faktoru nedir (cos fi)
- guc faktoru duzeltme
- reaktif guc kompanzasyonu
- kompanzasyon sistemi kurulumu
- kondansator grubu secimi
- kVAR hesaplama
- TEDAS reaktif enerji cezasi
- TEDAS yonetmelikleri
- EPIAS elektrik fiyatlari
- PTF (Piyasa Takas Fiyati)
- gun oncesi piyasasi
- serbest tuketici elektrik
- elektrik tarife gruplari (puant, gunduz, gece)
- enerji verimliligi
- enerji tasarrufu yontemleri
- endustriyel enerji yonetimi
- ISO 50001 enerji yonetim sistemi
- enerji izleme sistemi
- elektrik analizi
- guc kalitesi izleme
- enerji maliyeti dusurme
- elektrik faturasi azaltma
- KDV dahil elektrik faturasi hesaplama
- ay sonu elektrik faturasi tahmini
- geriye donuk elektrik fatura hesaplama
- elektrik fatura kalemleri (enerji, yekdem, dagitim, iletim, kayip-kacak, talep, KDV)
- MTD bu aya kadar elektrik maliyeti
- Modbus enerji sayaci
- endustriyel IoT enerji
- akilli enerji izleme
- enerji dashboardu
- trafo bakimi
- elektrik guc olcumu
- enerji raporlama
- SCADA alternatifi