# Στατιστικά επισκεψιμότητας αρχαιολογικών χώρων

## Πηγή και περίοδος
Πρωτογενής πηγή είναι η ΕΛΣΤΑΤ, «Έρευνα Κίνησης Μουσείων και Αρχαιολογικών Χώρων», πίνακας 04 «Επισκέπτες αρχαιολογικών χώρων κατά μήνα». Χρησιμοποιήθηκε το αρχείο χρονοσειράς Ιανουάριος 1998–Μάιος 2026 από τη δημοσίευση Μαΐου 2026: https://www.statistics.gr/en/statistics/-/publication/SCI21/2026-M05

Η έρευνα παράγει αποτελέσματα από το 1970, αλλά η διαθέσιμη αναλυτική χρονοσειρά ανά χώρο που αξιοποιήθηκε εδώ αρχίζει το 1998. Υπάρχουν ετήσια στοιχεία 1998–2025 και μερικό 2026 (Ιανουάριος–Μάιος). Η ΕΛΣΤΑΤ έχει δημοσιεύσει δελτίο για τον Ιούνιο 2026 με συνοπτικά αποτελέσματα, χωρίς τον αναλυτικό πίνακα ανά χώρο που απαιτείται για τα γεωγραφικά φίλτρα.

## Αρχεία
- elstat_archaeological_sites_1998_may2026.xlsx: αρχείο πηγής της ΕΛΣΤΑΤ.
- Συνοπτικό δελτίο Ιουνίου 2026: https://www.statistics.gr/documents/20181/418d9dc1-0e63-cf9e-ae47-515ba6483fdb
- archaeological_site_visits_by_site_1998_2026.csv: επεξεργασμένες ετήσιες καταγραφές ανά ενοποιημένο χώρο. Η στήλη `source_site_names` διατηρεί την ονομασία της πηγής για κάθε ετήσια εγγραφή.
- archaeological_site_name_crosswalk_1998_2026.csv: αντιστοιχίσεις αρχικών ονομασιών της ΕΛΣΤΑΤ προς τις ενοποιημένες ονομασίες, με έτη εμφάνισης και αριθμό αρχικών εγγραφών.
- archaeological_site_visits_by_source_unit_1998_2026.csv: ετήσια σύνολα ανά παλαιό νομό/ενότητα όπως αναφέρονται στην πηγή, μαζί με το άθροισμα των επιμέρους χώρων και τη διαφορά τους.
- ../archaeological-sites/index.html: διαδραστικό dashboard, λειτουργεί τοπικά χωρίς εξωτερικές βιβλιοθήκες.

## Ορισμοί και περιορισμοί
- Από το 2002 η ΕΛΣΤΑΤ περιλαμβάνει επισκέπτες με εισιτήριο και δωρεάν είσοδο. Για το 1998–2001 η σειρά καταγράφει εισιτήρια και δεν είναι πλήρως συγκρίσιμη με τα επόμενα έτη.
- Κενή τιμή στο πεδίο `visitors` σημαίνει ότι η ΕΛΣΤΑΤ δεν δημοσίευσε ετήσιο αριθμό για τη συγκεκριμένη εγγραφή. Δεν μετατρέπεται σε μηδέν. Ρητή τιμή `0` στην πηγή διατηρείται ως μηδενική επισκεψιμότητα.
- Το 2026 είναι μερικό έτος. Μην το συγκρίνεις ως πλήρες έτος με τα προηγούμενα.
- Η πηγή ομαδοποιεί τα δεδομένα ανά παλαιό νομό. Οι νομοί αντιστοιχίστηκαν στις 13 σημερινές περιφέρειες. Όπου ένας παλαιός νομός έχει διαιρεθεί σε περισσότερες σημερινές περιφερειακές ενότητες, τα δεδομένα δεν επιμερίζονται περαιτέρω.
- Η κάλυψη μεταβάλλεται ανά έτος. Στη Θεσσαλία τα στοιχεία καλύπτουν μόνο τη Μαγνησία έως το 2011· προστίθενται τα Τρίκαλα το 2012, η Λάρισα το 2013 και η Καρδίτσα το 2017. Συνεπώς, τα παλαιότερα χαμηλά σύνολα Θεσσαλίας δεν αντιπροσωπεύουν ολόκληρη τη σημερινή περιφέρεια. Το dashboard εμφανίζει σχετική προειδοποίηση.
- Οι αρχικές ετικέτες «Μυκήνες», «Θησαυρός Ατρέα» και «Μυκήνες & Θησαυρός Ατρέα» ενοποιούνται ανά έτος σε μία σειρά «Μυκήνες & Θησαυρός Ατρέα». Όταν υπάρχουν δύο χωριστές εγγραφές, οι επισκέψεις αθροίζονται· όταν η πηγή δίνει ήδη κοινό σύνολο, το ποσό διατηρείται χωρίς περαιτέρω διαχωρισμό. Οι αρχικές ετικέτες παραμένουν στη στήλη `source_site_names` και στο αρχείο αντιστοιχίσεων.
- Για τη μικτή αυτή σειρά, το `monument_type` είναι «Αρχαιολογικό σύμπλεγμα», λειτουργική κατηγορία του dashboard και όχι επίσημη κατηγορία της ΕΛΣΤΑΤ.
- Το συνοδευτικό πρωτογενές XLSX δεν εμφανίζει χωριστές γραμμές «Μυκήνες» σε όλα τα έτη στα οποία εμφανίζονται στο επεξεργασμένο CSV. Η ενοποιημένη σειρά διατηρεί τα ήδη επεξεργασμένα ποσά και ελέγχθηκε έναντι των δημοσιευμένων συγκεντρωτικών τιμών της ΕΛΣΤΑΤ όπου αυτές είναι διαθέσιμες: [2000–2002](https://www.statistics.gr/documents/20181/8dfebbf8-a500-416c-ac1b-3b3114036648), [2022–2024](https://www.statistics.gr/documents/20181/3877b305-6278-8a70-c495-8f684643ebaf), [2024–2025](https://www.statistics.gr/documents/20181/c5c0844d-7d7a-0f18-6605-a437b33e9116) και [2024–Μάιος 2026](https://www.statistics.gr/documents/20181/7a21ace2-4ea5-ee4c-e9db-4c506a8a5760).
- Το είδος χώρου εκτιμάται από την ονομασία της πηγής. Δεν είναι επίσημη κατηγορία της ΕΛΣΤΑΤ.
- Πριν από την εξαγωγή, οι παραλλαγές ονομασιών ελέγχθηκαν σε όλα τα ετήσια φύλλα και αντιστοιχίστηκαν χειροκίνητα ανά ενότητα πηγής. Ενοποιήθηκαν ορθογραφικές και τυπογραφικές διαφορές, πτώσεις, συντομογραφίες και σημάνσεις υποσημειώσεων μόνο όταν ταυτοποιούσαν καθαρά τον ίδιο χώρο. Ονόματα χώρων που παραμένουν αμφίσημα ή αφορούν διαφορετικούς χώρους δεν συγχωνεύτηκαν. Οι αρχικές ετικέτες διατηρούνται στο `source_site_names` και στο αρχείο αντιστοιχίσεων.
- Επεξηγηματικές υποσημειώσεις των πινάκων που δεν αποτελούν εγγραφές χώρου και δεν έχουν μηνιαίες τιμές εξαιρούνται από το CSV χώρων.
- Στις ετήσιες συγκεντρώσεις χώρων έχουν εξαιρεθεί γραμμές που δηλώνουν συνολικά δωρεάν εισιτήρια, ώστε να μη διπλομετρώνται με τις επιμέρους καταγραφές.
- Για το 2026 διαπιστώνεται ασυμφωνία μεταξύ του αναφερόμενου συνόλου νομού και του αθροίσματος των χώρων στη Λακωνία και τη Μεσσηνία. Το αρχείο ανά νομό διατηρεί το ποσό της πηγής στη στήλη «visitors» και δείχνει χωριστά το άθροισμα χώρων και τη διαφορά.
- Από τον Μάιο 2017, τα εισιτήρια του Θεάτρου Διονύσου περιλαμβάνονται στην Ακρόπολη Αθηνών.
- Τα στοιχεία μετρούν επισκέψεις/εισιτήρια και όχι μοναδικά άτομα.

## Επανέλεγχος ποιότητας δεδομένων
- Αφαιρέθηκαν 13 γραμμές με την επικεφαλίδα «ΑΠΟ ΤΟΥΣ ΕΠΙΣΚΕΠΤΕΣ» (2013–2025) που είχαν εισαχθεί ως χώρος. Στο XLSX είναι επικεφαλίδα του πίνακα ελεύθερης εισόδου και όχι αρχαιολογικός χώρος.
- Αποκαταστάθηκαν έξι κενές ετήσιες τιμές που είχαν μετατραπεί σε μηδενικά: Κάστρο Υπάτης (2018–2019) και Σπήλαιο Θεόπετρας (2020–2023). Η τιμή του Σπηλαίου Θεόπετρας δεν δηλώνεται για τα έτη αυτά· το μηδενικό σύνολο των Τρικάλων στην πηγή δεν αποτελεί τιμή του ίδιου του χώρου.
- Το ετήσιο σύνολο της Ξάνθης για το 2018 είναι κενό και παραμένει κενό στο αρχείο ενοτήτων. Το άθροισμα επιμέρους χώρων είναι 0, ενώ η διαφορά δεν υπολογίζεται επειδή λείπει το επίσημο σύνολο.
- Στη Δυτική Μακεδονία δεν υπάρχουν εγγραφές πηγής για το 1998–2001. Η Κοζάνη εμφανίζεται από το 2002, η Καστοριά από το 2012 και η Φλώρινα από το 2013. Τα μηδενικά της Κοζάνης το 2009–2010 είναι ρητές τιμές του XLSX, αλλά δεν αποτελούν μηδενικό σύνολο όλης της Δυτικής Μακεδονίας, καθώς δεν αναφέρονται τότε οι άλλες δύο ενότητες.
- Η πτώση της Κοζάνης από 6.424 επισκέψεις το 2012 σε 389 το 2013 συμφωνεί με την πηγή. Το 2012 η Αιανή καταγράφεται ως 6.081 και η Βασιλική Νεκρόπολη ως 343· το 2013 η ενότητα δίνει 118 για την αρχαία πόλη και 271 για τη Βασιλική Νεκρόπολη. Δεν προκύπτει διπλοεγγραφή ή σφάλμα αθροίσματος.
- Στη Θεσσαλία, τα χαμηλά σύνολα 1998–2011 αφορούν μόνο τη Μαγνησία. Οι απότομες μεταβολές της Μαγνησίας/Διμηνίου (2003–2006) συμφωνούν με το XLSX. Τα ετήσια αθροίσματα χώρων της Θεσσαλίας και της Δυτικής Μακεδονίας συμφωνούν με τα αντίστοιχα σύνολα ενότητας για τα έτη που αναφέρει η πηγή.
- Ελέγχθηκαν επίσης οι μεταβολές των Δελφών (2023–2025) και των Τρικάλων. Οι τιμές συμφωνούν με το πρωτογενές XLSX και διατηρούνται· δεν διορθώθηκαν με υπόθεση. Η μεγάλη πτώση του 2020 εμφανίζεται σε όλες τις περιφέρειες και συμπίπτει με την αναστολή λειτουργίας λόγω πανδημίας.
- Παραμένει η γνωστή απόκλιση του 2026 ανάμεσα στα σύνολα πηγής και στα αθροίσματα χώρων για Λακωνία και Μεσσηνία· διατηρούνται χωριστά οι δύο τιμές και η διαφορά.

## Καταγραφή επεξεργασίας
Η έκδοση αυτή περιλαμβάνει 3,210 ετήσιες εγγραφές χώρων από τα φύλλα 1998–2026, από τις οποίες έξι δεν έχουν δημοσιευμένη ετήσια τιμή. Μετά την ενοποίηση ονομασιών, οι σειρές αντιστοιχούν σε 181 συνδυασμούς χώρου και ενότητας πηγής. Το αρχείο αντιστοιχίσεων καταγράφει 133 αρχικές ονομασίες προς ενοποιημένες ονομασίες, μεταξύ των οποίων και τις τρεις αρχικές ετικέτες για τις Μυκήνες και τον Θησαυρό Ατρέα. Εξαιρέθηκαν επίσης 16 επεξηγηματικές γραμμές υποσημειώσεων που δεν αποτελούν εγγραφές επισκεψιμότητας. Το πρωτογενές αρχείο ΕΛΣΤΑΤ παραμένει διαθέσιμο αυτούσιο.

# Στατιστικά τουριστικής δραστηριότητας

Τα αρχεία τροφοδοτούν το dashboard `../tourism-activity/index.html`. Δημιουργούνται με `python3 scripts/fetch_tourism_data.py` (απαιτεί `openpyxl`) και ενσωματώνονται στη σελίδα με `python3 scripts/build_tourism_data.py`.

- tourism_elstat_2025_regions.csv: αφίξεις, διανυκτερεύσεις και κλίνες ανά περιφέρεια και περιφερειακή ενότητα, ανά είδος καταλύματος (ξενοδοχειακά, σύντομης διαμονής, κάμπινγκ), 2025. Πηγή: ΕΛΣΤΑΤ, πίνακες 3 και 4.
- tourism_elstat_2025_monthly.csv: αφίξεις και διανυκτερεύσεις ανά μήνα, είδος καταλύματος και ιδιότητα (ημεδαποί/αλλοδαποί), σύνολο χώρας. Πηγή: ΕΛΣΤΑΤ, πίνακες 8 και 9.
- tourism_elstat_2025_occupancy.csv: πληρότητα κλινών ανά μήνα (ξενοδοχεία και ομοειδή). Πηγή: ΕΛΣΤΑΤ, πίνακας 7.
- tourism_elstat_2025_origin.csv: αφίξεις και διανυκτερεύσεις ανά περιφέρεια προορισμού και χώρα προέλευσης. Η στήλη `indent` δείχνει την ιεραρχία (0 = σύνολα και ομάδες). Πηγή: ΕΛΣΤΑΤ, πίνακας 14.
- tourism_eurostat_nights_annual.csv: ετήσιες διανυκτερεύσεις ανά περιφέρεια NUTS 2 και ιδιότητα, από το 1994. Πηγή: Eurostat, tour_occ_nin2.
- tourism_eurostat_nights_monthly.csv: μηνιαίες διανυκτερεύσεις ανά περιφέρεια NUTS 2 και ιδιότητα, 2020–2025. Πηγή: Eurostat, tour_occ_nin2m.
- elstat_tourism_2025/: τα πρωτογενή αρχεία xlsx της ΕΛΣΤΑΤ.

Παρατηρήσεις: Για το 2025 το σύνολο διανυκτερεύσεων της Eurostat (156.347.283) ταυτίζεται με το σύνολο της ΕΛΣΤΑΤ. Τα στοιχεία κάμπινγκ του Βορείου Αιγαίου περιλαμβάνονται στο Νότιο Αιγαίο. Η Δυτική Μακεδονία έχει κενά στη χρονοσειρά της Eurostat. Οι ονομασίες περιφερειακών ενοτήτων και χωρών διατηρούνται όπως τις δημοσιεύει η ΕΛΣΤΑΤ.

# Δημογραφικά στοιχεία

Τα αρχεία τροφοδοτούν το dashboard `../demographics/index.html`. Δημιουργούνται με `python3 scripts/fetch_demographics_data.py` και ενσωματώνονται στη σελίδα με `python3 scripts/build_demographics_data.py`.

- demographics_eurostat_regional_balance.csv: πληθυσμός την 1η Ιανουαρίου, γεννήσεις, θάνατοι, φυσική μεταβολή, καθαρή μετανάστευση (με στατιστική προσαρμογή), συνολική μεταβολή και ρυθμοί ανά 1.000 κατοίκους, ανά περιφέρεια NUTS 2 και για το σύνολο της χώρας, από το 2000. Πηγή: Eurostat, demo_r_gind3.
- demographics_eurostat_population_age_sex.csv: πληθυσμός ανά πενταετή ηλικιακή ομάδα (0-4 έως 85+) και φύλο, από το 1990. Πηγή: Eurostat, demo_r_d2jan. Το σύνολο χώρας είναι το άθροισμα των περιφερειών.

Παρατηρήσεις: Οι γεννήσεις και οι θάνατοι ανά περιφέρεια είναι διαθέσιμοι έως το 2024 και για το σύνολο της χώρας έως το 2025. Περιφέρειες και έτη με ελλιπή ηλικιακή ανάλυση (1990 και 2011) παραλείπονται από το αρχείο ηλικίας και φύλου. Η φυσική μεταβολή ισούται με τις γεννήσεις μείον τους θανάτους.

# Περιφερειακή οικονομία

Τα αρχεία τροφοδοτούν το dashboard `../regional-economy/index.html`. Δημιουργούνται με `python3 scripts/fetch_economy_data.py` και ενσωματώνονται στη σελίδα με `python3 scripts/build_economy_data.py`.

- economy_eurostat_gdp.csv: ΑΕΠ σε τρέχουσες τιμές (εκατ. €), ΑΕΠ ανά κάτοικο (€ και ΜΑΔ), ΑΕΠ ανά κάτοικο ως ποσοστό του μέσου όρου της ΕΕ27 (σε € και σε ΜΑΔ) και πραγματική ετήσια μεταβολή του ΑΕΠ (%), ανά περιφέρεια NUTS 2, για το σύνολο της χώρας και για την ΕΕ27, 2000–2024. Πηγές: Eurostat, nama_10r_2gdp και nama_10r_2gvagr.
- economy_eurostat_gva_by_sector.csv: ακαθάριστη προστιθέμενη αξία σε βασικές τιμές (εκατ. €, τρέχουσες τιμές) ανά περιφέρεια και ομάδα τομέων NACE Rev. 2 (A, B-E, F, G-J, K-N, O-U) και συνολικά, 2000–2024. Πηγή: Eurostat, nama_10r_3gva.

Παρατηρήσεις: Το άθροισμα των περιφερειακών ΑΕΠ ισούται με το ΑΕΠ της χώρας και το άθροισμα των τομέων με τη συνολική προστιθέμενη αξία (ελέγχεται από το `build_economy_data.py`). Η προστιθέμενη αξία δεν περιλαμβάνει τους φόρους μείον τις επιδοτήσεις προϊόντων και γι' αυτό υπολείπεται του ΑΕΠ.

# Απογραφή Πληθυσμού-Κατοικιών 2021

Τα αρχεία τροφοδοτούν το dashboard `../demographics/census-2021/index.html`. Δημιουργούνται με `python3 scripts/fetch_census_data.py` (απαιτεί `openpyxl`) και ενσωματώνονται στη σελίδα με `python3 scripts/build_census_data.py`.

- census_2021_population_by_area.csv: μόνιμος πληθυσμός ανά φύλο και δεκαετή ηλικιακή ομάδα (0-9 έως 80+) για τη χώρα, τις 13 περιφέρειες (με αντιστοίχιση σε NUTS 2), τις 75 περιφερειακές ενότητες και τους 333 δήμους. Πηγή: ΕΛΣΤΑΤ, πίνακας Β01.
- census_2021_education_by_age.csv: μόνιμος πληθυσμός ανά ομάδα ηλικιών (0-14, 15-29, 30-44, 45-59, 60-74, 75+ και σύνολο `ALL`) και υψηλότερο επίπεδο εκπαίδευσης, για τις ίδιες περιοχές. Στήλες εκπαίδευσης: `tertiary` (ανώτατη: διδακτορικό, μεταπτυχιακό, ΑΕΙ, ΑΤΕΙ), `post_secondary` (ΙΕΚ, κολέγια), `upper_secondary` (λύκειο), `lower_secondary` (επαγγελματική σχολή, γυμνάσιο), `primary` (δημοτικό), `below_primary` (δεν ολοκλήρωσε το δημοτικό) και `unclassified` (γεννήθηκαν μετά την 1/1/2016). Πηγή: ΕΛΣΤΑΤ, πίνακας Β02.
- census_2021/: τα πρωτογενή αρχεία xlsx της ΕΛΣΤΑΤ.

Παρατηρήσεις: Η ΕΛΣΤΑΤ εφαρμόζει στατιστική εμπιστευτικότητα στους πίνακες της Απογραφής, γι' αυτό τα επιμέρους μεγέθη μιας περιοχής μπορεί να διαφέρουν από το δημοσιευμένο σύνολό της κατά λίγες δεκάδες άτομα το πολύ. Το `build_census_data.py` δέχεται απόκλιση έως 25 άτομα και αποτυγχάνει σε μεγαλύτερες. Οι ονομασίες περιοχών διατηρούνται όπως τις δημοσιεύει η ΕΛΣΤΑΤ (κεφαλαία, χωρίς τόνους), εκτός από τις περιφέρειες που έχουν τις ονομασίες της Eurostat.

# Αγροδιατροφή και παραγωγικό δυναμικό

Τα αρχεία βρίσκονται στο `data/agriculture/` και τροφοδοτούν τα dashboards `../agrifood/plant-production/`, `holdings/`, `livestock/`, `employment/`, `economy/` και `prices/` του φακέλου `../agrifood/`. Αναλυτική τεκμηρίωση (σχήμα πινάκων, κανόνες εισαγωγής, γνωστές ανωμαλίες της πηγής, σχέδιο φάσεων): [`agriculture/README.md`](agriculture/README.md).

- agriculture/spg06/, spg32/, spk12/, spg12/, spk33/, sel61/, spa06/, dkt33/, dkt30/: τα πρωτογενή αρχεία XLS(X) της ΕΛΣΤΑΤ (SPG06 Ετήσια Γεωργική Έρευνα 2011–2024· SPG32 και SPK12 Έρευνα Διάρθρωσης 2016, 2023· SPG12 Έρευνα Διάρθρωσης, απασχόληση 2016, 2023· SPK33 Ετήσια έρευνα κτηνοτροφίας 2011–2024· SEL61 Οικονομικοί Λογαριασμοί Γεωργίας 1995–2023· SPA06 Έρευνα Υδατοκαλλιεργειών 2002–2024· DKT33 και DKT30 δείκτες τιμών, τελευταία έκδοση), αυτούσια, και `manifest.csv` με το έγγραφο, το άθροισμα ελέγχου, το στάδιο (οριστικά/προσωρινά) και την ημερομηνία δημοσίευσης.
- agriculture/agri_observations.csv: μία γραμμή ανά στατιστικό μέγεθος (έτος αναφοράς, περιοχή, προϊόν, μέγεθος, τιμή, μονάδα, κατάσταση, πηγή, ημερομηνία ενημέρωσης).
- agriculture/agri_geo.csv, agri_products.csv, agri_variables.csv, agri_datasets.csv, agri_publications.csv: πίνακες διαστάσεων (γεωγραφία, ταξινόμηση προϊόντων, μεγέθη, πηγές, δημοσιευμένοι πίνακες).
- agriculture/agri_observation_revisions.csv, agri_import_log.csv, agri_import_issues.csv: ιστορικό αναθεωρήσεων, αναφορά εισαγωγών και σφάλματα/παρατηρήσεις ανά αρχείο.
- agriculture/geo/greece_units.json: γεωμετρίες περιφερειών, γεωγραφικών ζωνών, περιφερειακών ενοτήτων και νομών για τον χάρτη.

Δημιουργούνται με `python3 scripts/fetch_agriculture_data.py` (λήψη), `python3 scripts/import_agriculture_data.py` (εισαγωγή, απαιτεί `openpyxl` και `xlrd`) και ενσωματώνονται στη σελίδα με `python3 scripts/build_agriculture_data.py`. Οι έλεγχοι τρέχουν με `python3 scripts/verify_agriculture_data.py [--reparse]`.

# Χρηματοδοτήσεις και δημόσιες επενδύσεις

Τα αρχεία βρίσκονται στο `funding/` (`data/funding/`) και τροφοδοτούν τα dashboards `../funding/progress/` και `../funding/interreg/`. Επειδή η πλατφόρμα είναι στατικός ιστότοπος, οι «πίνακες βάσης» είναι κανονικοποιημένα CSV και οι importers είναι scripts Python.

## Εισαγωγή

- `python3 scripts/fetch_cohesion_data.py` εισάγει τα στοιχεία της Ευρωπαϊκής Επιτροπής (Cohesion Open Data, άδεια CC0). Τα URL των γραφημάτων «Financial implementation by intervention field» (9b7m-ewym) και «21-27 Interreg EU allocations» (upqa-iza8) δείχνουν σε οπτικοποιήσεις και όχι σε πίνακες. Οι πραγματικοί πίνακες είναι τα `3git-md5z` και `9qee-iv7c`, και οι στήλες ελέγχονται έναντι των μεταδεδομένων του συνόλου πριν από κάθε εισαγωγή.
- `python3 scripts/build_funding_data.py` ενσωματώνει τα CSV στα dashboards, και με `--check` ελέγχει ότι συμφωνούν.
- Οι κοινές ρουτίνες βρίσκονται στο `scripts/funding_lib.py`: κανονικοποίηση ποσών (ελληνική και αγγλική μορφή) και ημερομηνιών, σταθερά κλειδιά γραμμών (`row_key`), upsert χωρίς διπλοεγγραφές και καταγραφή εισαγωγών. Μια νέα εισαγωγή του ίδιου αρχείου δεν αλλάζει τίποτα, οι αναθεωρημένες γραμμές ενημερώνονται και οι γραμμές που λείπουν από την πηγή διατηρούνται (στήλες `first_seen`, `last_seen`, `last_changed`).
- `scripts/inspect_xlsx.py` εμφανίζει τη δομή ενός αρχείου XLSX σε streaming, για να οριστούν οι στήλες ενός νέου importer από το πραγματικό αρχείο. Τα αρχεία που δεν μπορούν να ληφθούν αυτόματα τοποθετούνται στο `data/funding/raw/`.

## Αρχεία

- sync_log.csv: μία γραμμή ανά εισαγωγή, με το σύνολο δεδομένων, την πηγή, τις ημερομηνίες δημοσίευσης και τροποποίησης της πηγής, την ώρα εισαγωγής, τον αριθμό γραμμών και το αποτέλεσμα (νέες, ενημερωμένες, αμετάβλητες, διατηρημένες γραμμές).
- cohesion_financial_implementation_el.csv: χρηματοδοτική υλοποίηση 2021–2027 των ελληνικών προγραμμάτων (σύνολο 3git-md5z). Μία γραμμή ανά κύκλο αναφοράς, πρόγραμμα, ταμείο, προτεραιότητα, ειδικό στόχο και πεδίο παρέμβασης. Προγραμματισμένοι πόροι (`planned_*`), πόροι επιλεγμένων πράξεων (`decided_*`) και δηλωθείσες δαπάνες (`spent_*`) σε ευρώ, σε συνολικό κόστος. **Τα μεγέθη κάθε κύκλου είναι σωρευτικά και δεν αθροίζονται μεταξύ κύκλων.** Οι στήλες `*_notional` είναι εκτιμήσεις της Κομισιόν με βάση τον μέσο ρυθμό συγχρηματοδότησης.
- programmes_el.csv: οι επίσημες ελληνικές ονομασίες των εθνικών προγραμμάτων (σύνολο 92d9-xqvh).
- interreg_allocations.csv: προγραμματισμένες ετήσιες δεσμεύσεις της ΕΕ των διακρατικών προγραμμάτων (σύνολο 9qee-iv7c), ανά πρόγραμμα, ταμείο και κατηγορία κατανομής. Αφορούν ολόκληρα τα προγράμματα και όχι το μερίδιο της Ελλάδας, και δεν είναι δαπάνες.
- interreg_greek_territories.csv: τα ελληνικά εδάφη (NUTS) που καλύπτει κάθε πρόγραμμα. Από αυτό προκύπτει ποια προγράμματα Interreg έχουν ελληνική συμμετοχή.
- taxonomy_themes.csv και taxonomy_intervention_fields.csv: οι 11 αναπτυξιακές θεματικές, με δύο επιπλέον ομάδες εκτός θεματικών (τεχνική βοήθεια και μετανάστευση-σύνορα-ασφάλεια), και η αντιστοίχιση κάθε επίσημου κωδικού πεδίου παρέμβασης (Παράρτημα I του Κανονισμού ΕΕ 2021/1060) σε μία θεματική, με τεκμηρίωση ανά κωδικό. Το `build_funding_data.py` αποτυγχάνει αν υπάρξει κωδικός χωρίς αντιστοίχιση.

## Κατάλογος Πράξεων ΕΣΠΑ

Δεν έχει εισαχθεί ακόμα: το `www.espa.gr` δεν ήταν προσβάσιμο από το περιβάλλον όπου ετοιμάστηκαν τα δεδομένα, και ο importer απαιτεί τις πραγματικές στήλες του αρχείου.