Feature Modülleri

Backend 30 feature modülünden oluşur. Her modül bağımsız bir iş alanını kapsar.

Kimlik Doğrulama ve Kullanıcı Yönetimi

Modül	Endpoint Prefix	Açıklama
auth	/api/auth	JWT login, refresh, me. Access token 30dk, refresh 7 gün
users	/api/users	Kullanıcı CRUD (tenant-scoped)
roles	/api/roles	RBAC rolleri ve izin yönetimi. 56 izin, 3 ön tanımlı rol
memberships	/api/memberships	Kullanıcı-cihaz eşleştirme (OWNER/VIEWER)

Coğrafi Yapı

Modül	Endpoint Prefix	Açıklama
regions	/api/regions	Bölge CRUD. tariff_type: ticarethane, sanayi, mesken, aydınlatma, tarımsal
subregions	/api/subregions	Alt bölge CRUD. lat/lng, area_m2, floor, building

Cihaz Yönetimi

Modül	Endpoint Prefix	Açıklama
gateways	/api/gateways	Gateway CRUD + rawconfig sync + MQTT push. ip_based veya mqtt_based
devices	/api/devices	Cihaz CRUD + hierarchy + consumption. Device templates ve register map
attached_devices	/api/attached-devices	Gateway'e fiziksel bağlı Modbus RTU cihazları
gateway_config	—	Desired/reported config sync, rawconfig push
provisioning	/api/provisioning	Gateway claiming ve onboarding akışı
templates	/api/templates	Cihaz ve gateway yapılandırma şablonları
templates (v1)	/api/v1/templates	Templates V1 API (ayrı router)

Ölçüm ve Analiz

Modül	Endpoint Prefix	Açıklama
measurements	/api/measurements	Map data, aggregated (hourly/daily/weekly/monthly), reactive ratio, export
telemetry	/api/internal/telemetry	İç telemetri endpoint'leri

Alarm Sistemi

Modül	Endpoint Prefix	Açıklama
alarms	/api/alarms	Policy CRUD + incident yönetimi (ack/snooze/close) + events audit trail. 63+ alarm tipi, severity: critical/high/medium/low
contacts	/api/contacts	Bildirim alıcıları (email, SMS, WhatsApp)

Firmware ve OTA

Modül	Endpoint Prefix	Açıklama
firmware	/api/firmware	Binary upload, ECDSA P-256 imzalama, versiyonlama, download token
ota	/api/ota	Tekil ve batch OTA orkestrasyonu. Progress/cancel/retry desteği

Görselleştirme ve Raporlama

Modül	Endpoint Prefix	Açıklama
sld	/api/sld	Tek Hat Şeması (Single Line Diagram) oluşturma/düzenleme
widgets	/api/widgets	Dashboard widget CRUD. 11 widget tipi: device_read_rate, consumption_chart, consumption_numeric, cost_chart, cost_numeric, reactive_gauge, reactive_numeric, realtime_value, realtime_gauge, realtime_3phase, realtime_power
reports	/api/reports	Rapor oluşturma ve export (CSV, Excel, PDF)

Diğer Modüller

Modül	Endpoint Prefix	Açıklama
zigbee	/api/v1/zigbee	Zigbee2MQTT entegrasyonu. Claim code, EMQX webhooks, gateway/device CRUD
loto	/api/loto	Lock-Out Tag-Out. Points, sessions (onay akışı), steps, locks
tariffs	/api/tariffs	Elektrik tarife yönetimi. SINGLE/TOU, AG/OG/EBY
assets	/api/assets	Fiziksel varlık yönetimi (SLD ve LOTO için)
bms_identity	/api/v1	Sofar inverter BMS batarya kimlik takibi
modbus	—	Modbus profil yönetimi
payments	/api/payments	Ödeme entegrasyonu (placeholder)
internal	/api/internal	EMQX webhooks (gateway connected/disconnected)

Alarm Tipleri

Zeus 63+ alarm tipi destekler.

🟢 Genel (7)

• voltage_high
• voltage_low
• current_high
• power_factor_low
• frequency_deviation
• device_offline
• communication_error

🔵 Analizor (10)

• voltage_imbalance
• current_imbalance
• neutral_current_high
• power_demand_high
• reactive_inductive_high
• reactive_capacitive_high
• energy_consumption_limit
• energy_daily_budget
• thd_voltage_high
• thd_current_high

🔴 MCCB Trip (11)

• breaker_trip_overload
• breaker_trip_short_circuit_delay
• breaker_trip_short_circuit_instant
• breaker_trip_overvoltage
• breaker_trip_undervoltage
• breaker_trip_phase_loss
• breaker_trip_neutral_loss
• breaker_trip_overtemperature
• breaker_trip_residual_current
• breaker_trip_manual
• breaker_trip_remote

🟠 MCCB Durum (4)

• breaker_open_unexpected
• terminal_overtemperature
• residual_current_high
• power_failure

🟣 Batarya (10)

• battery_soc_low
• battery_soc_critical
• battery_soc_overcharge
• battery_temperature_high
• battery_temperature_low
• battery_soh_low
• battery_soh_rapid_decline
• battery_voltage_high
• battery_voltage_low
• battery_discharge_rate_high

🟡 PV / Solar (4)

• pv_production_zero
• pv_string_imbalance
• pv_string_offline
• pv_daily_production_low

🔴 Invertor Fault (5)

• inverter_fault_grid
• inverter_fault_dc
• inverter_fault_system
• inverter_fault_battery
• inverter_fault_comm

🟠 Invertor Sistem (4)

• inverter_temperature_high
• inverter_efficiency_low
• inverter_isolation_low
• inverter_status_fault

🟡 Grid Protection Warning (5)

• inverter_grid_voltage_high_warning
• inverter_grid_voltage_low_warning
• inverter_grid_frequency_high_warning
• inverter_grid_frequency_low_warning
• inverter_isolation_low_warning

⚪ Diger (3)

• reverse_power
• island_detected
• battery_cycle_count_high

Sofar Spesifik Moduller

• sofar_fault_map.py — Sofar invertor hata kodlari haritasi (grid, DC, system, battery, comm kategorileri)
• sofar_grid_protection.py — Grid koruma erken uyari sistemi (5 kontrol tipi)