📋 ΔΕΔΔΗΕ Outages API - Τεκμηρίωση

Version: 2.1 | Base URL: http://localhost:5000

👨‍💻 Δημιουργός (Creator): Bairaktaris Emmanuel
📅 Ημερομηνία Δημιουργίας: 2026
© Copyright: All Rights Reserved

1. Documentation & Web Interface

Endpoint	Μέθοδος	Περιγραφή
`/` NEW	GET	HTML τεκμηρίωση (αυτή η σελίδα)
`/docs` NEW	GET	Ανακατεύθυνση στην τεκμηρίωση
`/documentation.css`	GET	Stylesheet της τεκμηρίωσης (αρχείο `documentation.css`)
`/api/municipalities`	GET	JSON νομών/δήμων (για τη φόρμα προβολής παρακάτω)
`/api/outages/preview`	GET	Άμεση προβολή διακοπών από ΔΕΔΔΗΕ (`?prefecture_id=&municipality_id=`) — χωρίς αποθήκευση

2. Προβολή διακοπών ανά νομό / δήμο (μόνο εμφάνιση)

Εδώ επιλέγετε οποιονδήποτε νομό και δήμο για να δείτε τι επιστρέφει η ιστοσελίδα της ΔΕΔΔΗΕ αυτή τη στιγμή. Τα αποτελέσματα εμφανίζονται ως πίνακας· δεν αποθηκεύονται στη βάση της εφαρμογής και δεν επηρεάζουν τις ειδοποιήσεις Telegram.

Η μόνιμη παρακολούθηση (scheduler, Telegram, SQLite) ορίζεται στο αρχείο app_config.json — όχι από αυτή τη φόρμα.

Αναζήτηση νομού Νομός

Αναζήτηση δήμου Δήμος

3. REST API Endpoints

ΒΑΣΙΚΑ ENDPOINTS

Endpoint	Μέθοδος	Περιγραφή
`/api/outages`	GET	Όλες οι ενεργές διακοπές (JSON)
`/api/outages/latest?limit=10`	GET	Οι τελευταίες Ν διακοπές
`/api/outages/check`	GET	Άμεσος έλεγχος για νέες διακοπές
`/api/outages/export/csv`	GET	CSV export (όλες)
`/api/outages/export/csv?days=30`	GET	CSV export (τελευταίες 30 ημέρες)
`/api/outages/stats`	GET	Στατιστικά
`/api/status`	GET	Status server

ΠΑΡΑΔΕΙΓΜΑΤΑ ΚΛΗΣΕΩΝ

GET / (Documentation)
curl http://localhost:5000/
Ανοίγει αυτή την HTML σελίδα

GET /api/outages
curl http://localhost:5000/api/outages

GET /api/outages/export/csv?days=30
curl http://localhost:5000/api/outages/export/csv?days=30 -o outages.csv

GET /api/status
curl http://localhost:5000/api/status

4. Λειτουργίες Telegram

✅ Νέα διακοπή → Άμεσο μήνυμα
✅ Ολοκλήρωση διακοπής → Μήνυμα όταν τελειώσει
✅ Μηνιαία αναφορά (κάθε 1η του μήνα, 10:00 π.μ.)
✅ Εκκαθάριση βάσης (ειδοποίηση όταν διαγράφονται παλιές διακοπές)
✅ Αποφυγή duplicate ειδοποιήσεων (δεν ξαναστέλνει για ίδια διακοπή)

5. Λειτουργίες CSV/Excel

✅ UTF-8 BOM encoding (σωστά Ελληνικά στο Excel)
✅ Φιλτράρισμα ανά ημέρες: ?days=30
✅ Αυτόματη εκκαθάριση παλιών δεδομένων (60 ημέρες)
✅ Καθαρισμός περίεργων χαρακτήρων (newlines, tabs)

6. Scheduler Tasks UPDATED

Χρονική στιγμή	Ενέργεια
Κάθε N λεπτά (ρύθμιση: `check_interval_minutes` στο `app_config.json`, προεπιλογή 60)	Έλεγχος για νέες διακοπές
Ίδιο διάστημα	Έλεγχος για ολοκληρωμένες διακοπές
Κάθε Κυριακή	Εκκαθάριση παλιών (>60 ημέρες)
1η κάθε μήνα, 10:00 π.μ.	Μηνιαία αναφορά

Το διάστημα αλλάζει από το app_config.json (προηγούμενη προεπιλογή: 60 λεπτά).

7. Database Structure

outages.db - SQLite database
Πίνακας outages: αποθηκεύει όλες τις διακοπές
Πίνακας notifications: ιστορικό ειδοποιήσεων (αποφυγή duplicates)
Πίνακας monthly_reports: μηνιαίες αναφορές
Διατήρηση δεδομένων: 60 ημέρες

8. Παράδειγμα Response

GET /api/outages
[
  {
    "id": 1,
    "from_date": "2026-04-10 08:00:00",
    "to_date": "2026-04-10 14:00:00",
    "municipality": "ΔΗΜΟΣ ΚΥΜΗΣ ΑΛΙΒΕΡΙΟΥ",
    "area": "Οδός Εθνικής Αντιστάσεως",
    "note_number": "2026-1234",
    "purpose": "Αναβάθμιση δικτύου",
    "detected_at": "2026-04-09T10:30:00"
  }
]

9. Εγκατάσταση & Εκτέλεση

# 1. Εγκατάσταση dependencies
pip install requests beautifulsoup4 flask flask-cors schedule

# 2. Εκτέλεση
python outages_api_clean.py

# 3. Έλεγχος λειτουργίας
# Άνοιξε browser: http://localhost:5000/

10. Ρύθμιση Windows Server (Startup)

# Μέθοδος 1: Task Scheduler
- Άνοιξε Task Scheduler
- Δημιούργησε νέα εργασία "DEDDIE Outages Monitor"
- Trigger: "When the computer starts"
- Action: python.exe με arguments outages_api_clean.py

# Μέθοδος 2: Windows Service (NSSM)
nssm install DEDDIEOutagesMonitor
nssm start DEDDIEOutagesMonitor

11. Troubleshooting

Ελληνικά εμφανίζονται ως "??" → Εκτέλεσε chcp 65001 πριν το script
Duplicate ειδοποιήσεις → Η βάση αποθηκεύει ήδη τις διακοπές, δεν ξαναστέλνει
CSV με μουτζούρες → Χρήση UTF-8 BOM, άνοιξε με Excel → Data → From Text/CSV
Telegram δεν στέλνει → Έλεγξε TOKEN και CHAT_ID

12. Άδεια Χρήσης (License)

Απαγορεύεται η αντιγραφή, διανομή ή τροποποίηση του λογισμικού χωρίς άδεια.
Το λογισμικό παρέχεται "ως έχει" χωρίς εγγυήσεις.
Για αναφορές σφαλμάτων ή γενικές προτάσεις: https://sonam.dev/contact
Αν επιθυμείτε να μοιραστώ μαζί σας τον κώδικα του backend (Python/Flask), επικοινωνήστε μέσω: https://sonam.dev/contact