GeoWalk v3.0.0 — Οδηγός Γρήγορης Εκκίνησης 🚀

Ξεκίνα σε 3 βήματα

1. Δώσε άδειες 🔐

• Άνοιξε την εφαρμογή και δώσε άδεια για Τοποθεσία (GPS) 📍
• Δώσε άδεια για Σωματική Δραστηριότητα / Βηματομετρητή 🚶
• Δώσε άδεια για Ειδοποιήσεις 🔔, ώστε να ακούς και να νιώθεις τους σταθμούς.

2. Φτιάξε το προφίλ σου 👤

• Γράψε το όνομά σου ή ένα ψευδώνυμο. ✍️
• Διάλεξε σωστά τον σωματότυπό σου, γιατί έτσι η εφαρμογή υπολογίζει καλύτερα το βήμα σου. 👣
• Το σύστημα δημιουργεί αυτόματα το δικό σου, μοναδικό 5ψήφιο Αναγνωριστικό Εξερευνητή για ασφαλή και ανώνυμη αποστολή στατιστικών. 🆔
• Αν ο/η εκπαιδευτικός έχει βάλει κλίμακα ή σύνδεσμο αξιολόγησης, απλώς ακολούθησε τις ρυθμίσεις της ομάδας σου. 🧭

3. Ξεκίνα το περπάτημα 🌍

• Πατώντας Έναρξη Αποστολής για πρώτη φορά, θα σου ζητηθεί να συμπληρώσεις το Ερωτηματολόγιο Εκκίνησης. Μπορείς να το κάνεις επιτόπου (ανοίγει ασφαλής σύνδεσμος) ή να επιβεβαιώσεις ότι το έχεις ήδη κάνει! 📝
• Παρακολούθησε το Cinematic Intro του Σταθμού 0. 🎬
• Περίμενε την αντίστροφη μέτρηση 3-2-1 και τότε ξεκινά επίσημα το ταξίδι. ⏱️
• Περπάτα σε ασφαλή διαδρομή, όχι με όχημα, όχι τρέχοντας για “κλέψιμο”. 🛣️

Όταν χτυπήσει το ραντάρ 📡

• Όταν πλησιάσεις σταθμό, το κινητό μπορεί να κάνει ήχο ή δόνηση. 📳
• Μόλις ανοίξει ο σταθμός, σταμάτα να περπατάς. 🛑
• Διάβασε το μόνιμο μήνυμα ασφαλείας. Αρχικά θα δεις μόνο την Ιστορία (Lore) του σταθμού. Πάρε τον χρόνο σου να τη διαβάσεις (έχει ειδικό φόντο για να διαβάζεται τέλεια ακόμα και κάτω από τον ήλιο!). ☀️
• Πάτησε ΣΥΝΕΧΕΙΑ για να αποκαλυφθεί η Ερώτηση και οι διαθέσιμες Βοήθειες (Hint / 50-50). 💡
• Το σύστημα σε κλειδώνει ακριβώς στον σταθμό, άρα δεν κερδίζεις έξτρα μέτρα αν συνεχίσεις να κινείσαι. 🧷

Αν σταματήσεις πολύ ώρα ⏸️

• Αν μείνεις ακίνητος/η περίπου 3 λεπτά, η εφαρμογή μπαίνει αυτόματα σε παύση (θα ακούσεις ένα χαρακτηριστικό “μπιπ”) για να κόψει το GPS drift και να εξοικονομήσει μπαταρία. 🔋
• Μπορείς επίσης να πατήσεις μόνος/η σου Παύση όταν κάνεις διάλειμμα.
• Προσοχή: Αν η εφαρμογή παραμείνει σε παύση συνεχόμενα για 15 λεπτά, θα κλείσει οριστικά μόνη της! Μην ανησυχείς όμως, όλη σου η πρόοδος και τα αντικείμενά σου αποθηκεύονται με απόλυτη ασφάλεια σε κάθε σου βήμα! 💾

Στο τέλος 🏁

• Θα δεις τα μετάλλια και τα αποτελέσματά σου. 🥇🥈🥉
• Αν υπάρχει σύνδεσμος αξιολόγησης, η εφαρμογή μπορεί να σε οδηγήσει εκεί με τα στοιχεία σου έτοιμα. 📝
• Αν δεν υπάρχει ίντερνετ, τα δεδομένα μπορούν να σταλούν αργότερα από τις Ρυθμίσεις (“Εκκρεμή Στατιστικά”), όταν βρεθεί σύνδεση. 📶

Εγχειρίδιο Εκπαιδευτικού — GeoWalk v3.0.0

1. Παιδαγωγικός ρόλος της εφαρμογής

Το GeoWalk v3.0.0 είναι μια εκπαιδευτική εφαρμογή υπαίθρου που μετατρέπει τη φυσική μετακίνηση των μαθητών σε βιωματική πλοήγηση μέσα στη γεωλογική ιστορία της Γης. Ο σχεδιασμός της συνδυάζει μάθηση πεδίου, gamification, αναστοχασμό και έλεγχο φυσικής δραστηριότητας.

2. Ασφάλεια: η πρώτη προτεραιότητα

Η εφαρμογή σχεδιάστηκε για χρήση στον πραγματικό κόσμο, όχι σε εικονικό περιβάλλον. Για τον λόγο αυτό, η αλληλεπίδραση με τους σταθμούς συνοδεύεται από μόνιμο μήνυμα ασφαλείας στο quiz dialog: «🛑 Στάσου σε ασφαλές σημείο, διάβασε προσεκτικά, απάντησε και μετά συνέχισε!».

Επιπλέον, το station dialog δεν κλείνει κατά λάθος με back gesture, εμποδίζοντας την τυχαία έξοδο. Αυτό βοηθά ώστε οι μαθητές να σταματούν, να εστιάζουν και να μην κινούνται διαβάζοντας την ερώτηση.

Πρακτικά, για ασφαλή εφαρμογή στο πεδίο:

• οργανώστε την πορεία σε ευθύ και ασφαλές μονοπάτι,
• δώστε σαφή οδηγία ότι όταν χτυπήσει σταθμός όλοι σταματούν,
• χρησιμοποιήστε το Cinematic Intro ως οργανωμένη τελετή εκκίνησης.

3. Cinematic Intro ως εργαλείο οργάνωσης

Η έναρξη της εμπειρίας δεν γίνεται απότομα. Με το πάτημα της έναρξης εμφανίζεται ο Σταθμός 0, με αφηγηματικό κείμενο και αντίστροφη μέτρηση 3-2-1.

Αυτό μπορεί να αξιοποιηθεί διδακτικά ως εργαλείο συγχρονισμένης άφεσης:

• παρατάσσετε τις ομάδες στην αφετηρία,
• δίνετε σύντομο briefing,
• ζητάτε κοινή έναρξη,
• και το countdown λειτουργεί ως σαφές σήμα μετάβασης από τη θεωρία στη δράση.

4. Anti-Cheat: πώς το σύστημα διασφαλίζει ότι οι μαθητές όντως περπατούν

Η εφαρμογή δεν βασίζεται τυφλά στο GPS. Το GPS σε εξωτερικούς χώρους μπορεί να εμφανίζει drift, δηλαδή να “μετακινεί” το στίγμα ενός ακίνητου μαθητή χωρίς αυτός να έχει περπατήσει πραγματικά.

Για να το αντιμετωπίσει, η εφαρμογή χρησιμοποιεί έναν μηχανισμό Sanity Check. Με απλά λόγια, η απόσταση από το GPS δεν εγκρίνεται αμέσως· συγκεντρώνεται προσωρινά και εγκρίνεται μόνο αν υπάρχει και επαρκής ένδειξη βημάτων από τον βηματομετρητή.

Πιο συγκεκριμένα:

• η GPS απόσταση μπαίνει σε έναν προσωρινό “κουμπαρά”
• το σύστημα υπολογίζει πόσα βήματα θα αναμένονταν θεωρητικά με βάση το προφίλ βήματος του μαθητή (π.χ. Αγόρι, Κορίτσι, Ενήλικας)
• αν τα πραγματικά βήματα φτάνουν τουλάχιστον το 30% αυτής της θεωρητικής τιμής, η απόσταση εγκρίνεται
• αν όχι, απορρίπτεται ως drift

Αυτό σημαίνει στην πράξη ότι το GPS επαληθεύεται από τα βήματα. Άρα η πρόοδος αντανακλά πολύ περισσότερο το πραγματικό περπάτημα και πολύ λιγότερο τα σφάλματα του hardware.

5. Anti-Cheat απέναντι σε οχήματα και αφύσικες ταχύτητες

Η εφαρμογή είναι σχεδιασμένη για πεζοπορία και όχι για μετακίνηση με όχημα ή άλλο μέσο. Η Μηχανή (Fusion Engine) ελέγχει την υπολογιζόμενη ταχύτητα από τα GPS σημεία και, αν αυτή ξεπεράσει τα 3.5 m/s, το ύποπτο GPS increment δεν χρησιμοποιείται.

Πρακτικά, αυτό λειτουργεί ως anti-vehicle φίλτρο. Αν κάποιος μαθητής επιχειρήσει να “κερδίσει” μέτρα με μη φυσιολογική ταχύτητα, το σύστημα γίνεται συντηρητικό και δεν μεταφράζει ανεξέλεγκτα αυτήν την κίνηση σε πρόοδο.

6. Distance Snapping: δίκαιο και καθαρό progression

Ένα συνηθισμένο πρόβλημα σε outdoor apps είναι το overshoot. Ένας μαθητής μπορεί να “περάσει” έναν σταθμό λόγω στιγμιαίου GPS glitch και να πάρει άδικο πλεονέκτημα για τον επόμενο.

Το GeoWalk το λύνει με το Distance Snapping:

• όταν ο μαθητής φτάσει σε σταθμό, η απόσταση κλειδώνει ακριβώς στο σημείο του σταθμού
• το πιθανό πλεόνασμα δεν χαρίζεται, αλλά αποθηκεύεται σε μνήμη προσωρινής παύσης
• αυτό το πλεόνασμα αφαιρείται από τους επόμενους υπολογισμούς

Άρα κάθε σταθμός λειτουργεί ως πραγματικό checkpoint. Όλοι οι μαθητές υποχρεώνονται να καλύψουν την ίδια ουσιαστική διαδρομή, χωρίς “δωρεάν μέτρα”.

7. Auto-Pause (3 λεπτά) & Hard Kill (15 λεπτά): Εξοικονόμηση και Ασφάλεια Δεδομένων

Η νέα πολιτική διαχείρισης ενέργειας και αδράνειας λειτουργεί σε δύο επίπεδα:

1. Αυτόματη Παύση (3 λεπτά): Αν η ομάδα μείνει ακίνητη για 3 λεπτά, η εφαρμογή εκπέμπει ένα ηχητικό “μπιπ” και μπαίνει αυτόματα σε παύση. Αυτό αποτρέπει την καταγραφή ψεύτικων μέτρων (drift) κατά τη διάρκεια συζητήσεων.
2. Ολικό Κλείσιμο / Hard Kill (15 λεπτά): Αν η εφαρμογή μείνει σε παύση για 15 συνεχόμενα λεπτά (π.χ. αν ο μαθητής παρατήσει το κινητό στην τσέπη του στο διάλειμμα), το σύστημα την κλείνει οριστικά από τη μνήμη. Αυτό διασφαλίζει ότι δεν θα αδειάσει η μπαταρία του μαθητή (zombie app prevention). Όλη η πρόοδος, φυσικά, παραμένει απολύτως ασφαλής και αποθηκευμένη.

8. Σταθμοί: Σταδιακή Αποκάλυψη και Μαθησιακή Δυναμική

Ο κόμβος StationQuizDialog επανασχεδιάστηκε για να προσφέρει βέλτιστη αναγνωσιμότητα και να αποτρέψει τη “γνωστική υπερφόρτωση” (cognitive overload). Πλέον, η πληροφορία δίνεται σε δύο βήματα:

1. Η Ιστορία (Lore): Αρχικά, ο μαθητής βλέπει μόνο το αφηγηματικό κείμενο σε ένα ειδικό φωτεινό φόντο που εξασφαλίζει άριστη ανάγνωση ακόμα και κάτω από τον δυνατό ήλιο (High Contrast).
2. Ο Γρίφος: Μόνο αφού διαβάσει την ιστορία και πατήσει συνειδητά το κουμπί «ΣΥΝΕΧΕΙΑ», εμφανίζεται η ερώτηση, υπενθυμίσεις για τα διαθέσιμα εργαλεία (Hint / 50-50) και οι πιθανές απαντήσεις.

Οι κύριοι σταθμοί δίνουν μεταλλιακές βαθμίδες (gold, silver, bronze), ενώ τα τυχαία ευρήματα (Loot Events) δίνουν εργαλεία.

9. Offline λογική και αξιολόγηση

Η εφαρμογή έχει offline-first φιλοσοφία και αποθηκεύει την τοπική πρόοδο εσωτερικά στη συσκευή, κάτι που είναι ιδιαίτερα σημαντικό για περιοχές χωρίς σταθερή συνδεσιμότητα (π.χ. βουνό, εξοχή).

Αν ο εκπαιδευτικός έχει ορίσει ψηφιακή αξιολόγηση (μέσω Tally.so ή Google Forms), η εφαρμογή αναλαμβάνει να περάσει αυτόματα το 5ψήφιο ID και τα στατιστικά. Αν δεν υπάρχει δίκτυο την ώρα του τερματισμού, αυτά τα δεδομένα κρατούνται ασφαλή στα «Εκκρεμή Στατιστικά» (Inbox) των ρυθμίσεων και μπορούν να σταλούν αργότερα.

10. Οδηγίες εφαρμογής στην τάξη ή στο πεδίο

Πριν από τη δράση:

• Ελέγξτε ότι οι μαθητές έδωσαν άδειες για GPS, φυσική δραστηριότητα και ειδοποιήσεις.
• Το Έξυπνο Pop-up (Pre-Test): Δεν χρειάζεται πια να υπενθυμίζετε το αρχικό ερωτηματολόγιο! Μόλις οι μαθητές πατήσουν “Έναρξη Αποστολής”, το παιχνίδι θα τους “μπλοκάρει” έξυπνα, ζητώντας τους να ολοκληρώσουν πρώτα το Ερωτηματολόγιο Εκκίνησης.
• Οργανώστε ομάδες και ασφαλή κατεύθυνση πορείας.

Κατά τη δράση:

• Παρακολουθήστε ότι οι μαθητές δεν κινούνται διαβάζοντας.
• Αξιοποιήστε τις παύσεις για σύντομες συζητήσεις (η εφαρμογή θα μπει μόνη της σε παύση αν χρειαστεί).
• Ενθαρρύνετε τη στρατηγική χρήση των εργαλείων (Hint / 50-50) που κερδίζουν στην πορεία.

Μετά τη δράση:

• Συζητήστε τα μετάλλια και τα λάθη όχι ως “βαθμούς”, αλλά ως αφορμές αναστοχασμού.
• Ολοκληρώστε την online φόρμα λήξης (από τα «Εκκρεμή Στατιστικά» αν δεν υπήρχε ίντερνετ στο πεδίο).

11. Τελική αποτίμηση

Το GeoWalk v3.0.0 είναι το απόλυτο εργαλείο για υπαίθρια εκπαιδευτική χρήση επειδή ενσωματώνει Ασφάλεια, Anti-Cheat και Εξοικονόμηση Μπαταρίας ως κεντρικές αρχές σχεδιασμού.

Η επιβεβαίωση των βημάτων (Sanity Check), το κόψιμο του drift (Distance Snapping), ο “έξυπνος” θάνατος αδράνειας στα 15 λεπτά (Hard Kill) και η σταδιακή αποκάλυψη της γνώσης στους σταθμούς, διασφαλίζουν μια ομαλή, παιδαγωγικά άρτια και τεχνολογικά αλεξίσφαιρη εμπειρία για μαθητές και εκπαιδευτικούς.

Εγχειρίδιο Μαθητή — GeoWalk v3.0.0

1. Καλωσόρισες στο GeoWalk!

Το GeoWalk δεν είναι ένα απλό παιχνίδι στο κινητό. Είναι ένα ταξίδι στην ιστορία της Γης, όπου κάθε βήμα που κάνεις σε πηγαίνει μπροστά στον γεωλογικό χρόνο και σε φέρνει πιο κοντά σε μεγάλες ανακαλύψεις.

Στην αρχή της αποστολής δεν ξεκινάς αμέσως να “γράφεις” μέτρα. Πρώτα βλέπεις τον Σταθμό 0, ένα μικρό cinematic intro που σε βάζει στο κλίμα του ταξιδιού, και μετά ξεκινά η αντίστροφη μέτρηση 3-2-1!

2. Πριν ξεκινήσεις

Για να δουλέψει σωστά η εφαρμογή, πρέπει να επιτρέψεις:

• Τοποθεσία GPS,
• Βηματομετρητή / Σωματική δραστηριότητα,
• Ειδοποιήσεις.

Δώσε επίσης προσοχή στα εξής:

• Φρόντισε να έχεις μπαταρία.
• Το σύστημα θα δημιουργήσει αυτόματα για σένα ένα μοναδικό 5ψήφιο Αναγνωριστικό Εξερευνητή. Δεν χρειάζεται να θυμάσαι κωδικούς!
• Περπάτα σε ασφαλές μέρος.
• Μη χρησιμοποιείς ποδήλατο, πατίνι ή όχημα, γιατί το παιχνίδι είναι φτιαγμένο μόνο για περπάτημα.

3. Πώς ξεκινά το ταξίδι

Μόλις πατήσεις Έναρξη Αποστολής, το παιχνίδι θα ελέγξει αν έχεις συμπληρώσει το Ερωτηματολόγιο Εκκίνησης. Αν όχι, θα σου εμφανίσει ένα παράθυρο για να το κάνεις επιτόπου!

Μόλις το ολοκληρώσεις (ή επιβεβαιώσεις ότι το έχεις ήδη κάνει), εμφανίζεται ο Σταθμός 0. Εκεί διαβάζεις το αρχικό μήνυμα για τη γέννηση της Γης και το μεγάλο ταξίδι που ξεκινάς.

Έπειτα πατάς το κουμπί έναρξης και βλέπεις στην οθόνη την αντίστροφη μέτρηση. Όταν μηδενίσει, η Μηχανή του Χρόνου ενεργοποιείται και η καταγραφή ξεκινά επίσημα!

4. Πώς παίζεις

Καθώς περπατάς, το GeoWalk μετρά την πορεία σου και τη μετατρέπει σε ταξίδι μέσα στον χρόνο. Στην οθόνη βλέπεις πόσο μακριά είσαι από τον επόμενο σταθμό και σε ποια γεωλογική εποχή βρίσκεσαι.

Υπάρχουν δύο είδη συναντήσεων:

• Κύριοι Σταθμοί, όπου κερδίζεις μετάλλια αν απαντήσεις σωστά.
• Τυχαία Ευρήματα, όπου μπορεί να κερδίσεις εργαλεία όπως σφυρί ή φακό.

Τα εργαλεία αυτά μπορούν να σε βοηθήσουν στους επόμενους γρίφους:

• το σφυρί ενεργοποιεί 50/50,
• ο φακός δίνει hint στη σωστή κατεύθυνση.

5. Όταν φτάσεις σε σταθμό

Όταν το ραντάρ μηδενίσει, το κινητό μπορεί να κάνει ήχο και δόνηση. Τότε ανοίγει το παράθυρο του σταθμού και ξεκινά η δοκιμασία σου.

Προσοχή στις 2 σελίδες: Αρχικά θα δεις μόνο την ιστορία του σταθμού (σε ένα ειδικό φωτεινό φόντο για να διαβάζεται τέλεια ακόμα και κάτω από τον ήλιο). Διάβασέ τη με την ησυχία σου και πάτα ΣΥΝΕΧΕΙΑ για να αποκαλυφθεί ο γρίφος και οι βοήθειές σου!

Εδώ υπάρχει ένας πολύ σημαντικός κανόνας: σταματάς και διαβάζεις με ασφάλεια. Στην κορυφή του παραθύρου υπάρχει πάντα το μήνυμα: «🛑 Στάσου σε ασφαλές σημείο, διάβασε προσεκτικά, απάντησε και μετά συνέχισε!»

Αυτό υπάρχει γιατί το παιχνίδι παίζεται στον πραγματικό κόσμο. Πρώτα ασφάλεια, μετά αποστολή. (Μικρό μυστικό: Στα τελευταία μέτρα του ταξιδιού, να έχεις τον νου σου! Κάποια σπουδαία γεγονότα μπορεί να εμφανιστούν ξαφνικά, χωρίς να προλάβει να σε προειδοποιήσει το ραντάρ!)

6. Τι σημαίνει ότι ο σταθμός “κλειδώνει”

Όταν φτάσεις σε έναν σταθμό, το παιχνίδι σε σταματά ακριβώς εκεί. Δεν μπορείς να “κλέψεις” μέτρα συνεχίζοντας να περπατάς ή τρέχοντας ενώ το παράθυρο είναι ανοιχτό.

Με απλά λόγια:

• έφτασες στον σταθμό,
• η απόσταση κλειδώνει,
• λύνεις τον γρίφο,
• και μετά συνεχίζεις.

Άρα: Δεν μπορείς να κλέψεις μέτρα τρέχοντας. Το GeoWalk σε σταματάει ακριβώς στον σταθμό και κρατά τη διαδρομή δίκαιη για όλους.

7. Τι γίνεται αν σταματήσεις

Αν σταθείς για αρκετή ώρα, το παιχνίδι δεν θέλει να σε “προδώσει” με ψεύτικα μέτρα από το GPS. Γι’ αυτό, μετά από περίπου 3 λεπτά ακινησίας (θα ακούσεις ένα χαρακτηριστικό “μπιπ”), μπαίνει μόνο του σε παύση.

Αυτό δεν είναι τιμωρία. Είναι προστασία, για να μετράει μόνο το πραγματικό περπάτημα και όχι τα λάθη του σήματος.

Προσοχή όμως! Αν η εφαρμογή μείνει σε παύση για 15 συνεχόμενα λεπτά (π.χ. αν ξεχάσεις το κινητό στην τσέπη σου σε κάποιο διάλειμμα), θα κλείσει οριστικά μόνη της! Το κάνει αυτό για να μην σου αδειάσει την μπαταρία. Μην ανησυχείς, όλη σου η πρόοδος και τα αντικείμενα είναι απολύτως ασφαλή και αποθηκευμένα!

8. Πώς το παιχνίδι καταλαβαίνει ότι περπατάς αληθινά

Η εφαρμογή δεν κοιτάζει μόνο το GPS. Ελέγχει και τα βήματά σου, ώστε να καταλαβαίνει αν πραγματικά περπατάς ή αν το στίγμα απλώς “χορεύει” χωρίς λόγο.

Με απλά λόγια, το GPS πρέπει να συμφωνεί έστω σε έναν βασικό βαθμό με τα βήματά σου. Έτσι, αν είσαι σχεδόν ακίνητος/η και το GPS δείξει ψεύτικη μετακίνηση, η εφαρμογή μπορεί να την αγνοήσει.

9. Μετάλλια, σακίδιο και πρόοδος

Στους κύριους σταθμούς μπορείς να κερδίσεις:

• Χρυσό,
• Ασημένιο,
• Χάλκινο μετάλλιο.

Στο σακίδιό σου αποθηκεύονται:

• τα εργαλεία που βρήκες,
• τα μετάλλια που κέρδισες,
• και οι ιστορίες που έχεις ήδη ξεκλειδώσει.

Έτσι, το παιχνίδι γίνεται και ένα προσωπικό ημερολόγιο ανακαλύψεων.

10. Στο τέλος της αποστολής

Όταν φτάσεις στο τέλος, θα δεις τα αποτελέσματά σου και όσα κατάφερες στη διαδρομή. Αν ο/η εκπαιδευτικός έχει ενεργοποιήσει φόρμα αξιολόγησης, η εφαρμογή μπορεί να ανοίξει αυτόματα τον σύνδεσμο για να ολοκληρώσεις την τελική δραστηριότητα.

Κι αν δεν υπάρχει ίντερνετ εκείνη τη στιγμή, δεν πειράζει. Η λογική της εφαρμογής υποστηρίζει offline χρήση. Τα στατιστικά σου θα μπουν στα “Εκκρεμή Στατιστικά” των Ρυθμίσεων, και η αποστολή των δεδομένων μπορεί να ολοκληρωθεί αργότερα.

11. Τρία μυστικά για να τα πας τέλεια

• Περπάτα σταθερά, όχι βιαστικά.
• Μόλις ανοίξει σταθμός, σταμάτα και συγκεντρώσου.
• Χρησιμοποίησε έξυπνα τα εργαλεία σου, όχι αμέσως.

Το GeoWalk δεν κερδίζεται με βιασύνη. Κερδίζεται με παρατήρηση, συνεργασία και περιέργεια!

Technical Architecture Manual — GeoWalk v3.0.0

1. Σκοπός και Αρχιτεκτονική Προσέγγιση

Το παρόν έγγραφο αναλύει την εσωτερική τεχνική αρχιτεκτονική της τελικής έκδοσης GeoWalk v3.0.0. Σε αυτή την έκδοση, ο πυρήνας της Μηχανής Σύντηξης (fusion_engine.dart) και το Gameplay Orchestration Layer (dashboard_screen.dart / welcome_screen.dart) έχουν αναβαθμιστεί ριζικά. Στόχος είναι η εξάλειψη του GPS drift, η αποτροπή του over-progression, η ενίσχυση της ασφάλειας (UI-driven safety limits), η επιθετική διαχείριση μνήμης (Hard Kill) και η αυτοματοποιημένη συλλογή ερευνητικών δεδομένων.

2. Sensor Fusion & Loose Sanity Check (fusion_engine.dart)

Το μεγαλύτερο πρόβλημα των outdoor location-based εφαρμογών είναι τα “ψεύτικα” άλματα του GPS (drift) όταν ο χρήστης παραμένει ακίνητος. Το GeoWalk λύνει αυτό το πρόβλημα μέσω του Loose Sanity Check.

2.1 Ο Μηχανισμός του Κουμπαρά (_gpsAccumulator)

Το GPS δεν προσθέτει πλέον μέτρα απευθείας στη μεταβλητή της κεντρικής προόδου (fusedDistance). Όταν η συσκευή είναι θεωρητικά ακίνητη, τα GPS increments (συνήθως “θόρυβος” του αισθητήρα) προστίθενται προσωρινά σε έναν accumulator (_gpsAccumulator).

2.2 Ο Έλεγχος Βημάτων (Το όριο του 30%)

Όταν τα σωρευμένα μέτρα στον _gpsAccumulator φτάσουν το όριο ανοχής (Tolerance Threshold), η Μηχανή απαιτεί επιβεβαίωση από τον Hardware Βηματομετρητή (Pedometer).

1. Υπολογίζει τα αναμενόμενα βήματα: Expected Steps = _gpsAccumulator / _baseProfileStride.
2. Ελέγχει αν τα πραγματικά βήματα (pending steps) ξεπερνούν το 30% των Expected Steps.
   • Αν ΝΑΙ, το drift θεωρείται πραγματική κίνηση, το _gpsAccumulator προστίθεται στο fusedDistance και μηδενίζεται.
   • Αν ΟΧΙ, το σύστημα αντιλαμβάνεται ότι ο χρήστης είναι ακίνητος και το GPS “χορεύει”. Το _gpsAccumulator μηδενίζεται χωρίς να πιστώσει μέτρα, διαγράφοντας το drift!

2.3 Η Αποφυγή Κυκλικής Αναφοράς (Circular Dependency)

Γιατί χρησιμοποιείται το σταθερό _baseProfileStride (0.60, 0.65, 0.75) και όχι το δυναμικό currentStride; Αν χρησιμοποιούσαμε το currentStride, το οποίο προσαρμόζεται από τα δεδομένα του GPS, το GPS θα αξιολογούσε έμμεσα τον εαυτό του. Χρησιμοποιώντας το _baseProfileStride (τη hardcoded ανατομική σταθερά), κρατάμε τον Sanity Validator απολύτως ανεξάρτητο από τη στιγμιαία παραμόρφωση του GPS.

3. Distance Snapping & Progression Locking (dashboard_screen.dart)

Ένα συχνό φαινόμενο ήταν οι παίκτες να ξεπερνούν την απόσταση ενός σταθμού λόγω ενός απότομου άλματος του GPS (Overshoot). Η λύση υλοποιήθηκε μέσω του Distance Snapping με χρήση της μεταβλητής _pausedOffset.

1. Όταν η νέα υπολογισμένη απόσταση (newDist) ξεπεράσει την απόσταση του επόμενου σταθμού (nextStation.distanceRequired), ο αλγόριθμος “παρεμβαίνει” και καρφώνει (snaps) το newDist ακριβώς πάνω στον σταθμό.
2. Το “περίσσευμα” του GPS δεν αγνοείται σιωπηλά, αλλά εξισορροπείται μαθηματικά: _pausedOffset = currentEngineDistance - exactEffectiveNeeded.
3. Το πλεόνασμα αποθηκεύεται στο offset, αφαιρώντας διαρκώς το over-estimation από τα επόμενα ticks. Ο χρήστης αναγκάζεται να περπατήσει ξανά την πραγματική απόσταση για τον επόμενο σταθμό.

4. Power Management & Idle Policies (Zombie App Prevention)

Στην έκδοση 3.0.0, η πολιτική αδράνειας γίνεται διβαθμιδική για μέγιστη προστασία της μπαταρίας:

• Soft Pause (στα 3 λεπτά): Στο fusion_engine.dart, η μεταβλητή _idleTimeoutMinutes έχει οριστεί στα 3 λεπτά. Αν περάσουν χωρίς έγκυρο step/GPS event, ο κινητήρας μπαίνει δυναμικά σε TrackerState.still και εκτελεί pause του background tracking.
• Hard Kill (στα 15 λεπτά): Μια νέα ρουτίνα Timers (_manageShutdownTimer) στο dashboard_screen.dart αναλαμβάνει την οριστική εκκαθάριση. Όταν το παιχνίδι μπει σε παύση, ξεκινά ένας χρονοδιακόπτης. 10 δευτερόλεπτα πριν τη λήξη ακούγεται συναγερμός (beep05.mp3). Στα 15 λεπτά ακριβώς, καλείται η εντολή SystemNavigator.pop(), η οποία τερματίζει βίαια την εφαρμογή σε επίπεδο OS, απελευθερώνοντας τη RAM. Όλα τα states είναι ήδη persisted.

5. UI Orchestration, Pacing & Gating

Η έκδοση 3.0.0 εισάγει εξελιγμένα patterns αλληλεπίδρασης και ελέγχου:

• Pre-Test Gating (welcome_screen.dart): Η Έναρξη Αποστολής (αν το Save State είναι άδειο) μπλοκάρεται από ένα έξυπνο Pop-up. Αυτό αναγκάζει τον χρήστη είτε να εκτελέσει το Ερωτηματολόγιο Εκκίνησης (ανοίγοντας το URL με injected arguments) είτε να επιβεβαιώσει ρητά την ολοκλήρωσή του.
• Σταδιακή Αποκάλυψη Σταθμών (2-Page Flow): Στο station_quiz_dialog.dart, για να αποφευχθεί το Cognitive Overload, το UI ξεκινάει δείχνοντας μόνο το Lore του σταθμού σε High Contrast φόντο. Μόνο αφού ο χρήστης πατήσει «ΣΥΝΕΧΕΙΑ» (scroll-to-top event), αποκαλύπτεται ο γρίφος.
• Dynamic Radar & Jump Scares: Στο next_station_panel.dart, το glow και ο ήχος του ραντάρ δεν ελέγχονται πια από μια hardcoded τιμή (20μ), αλλά διαβάζουν το νέο πεδίο radarRange του Station model. Αυτό επιτρέπει τη δημιουργία Jump Scares στο τέλος (Σταθμοί 19 & 20) όπου το radarRange είναι 0.
• Cinematic Intro & Safety Messages: Το Station 0 (CinematicIntroDialog) μπλοκάρει με PopScope(canPop: false) την έξοδο, ενώ κάθε Σταθμός έχει μόνιμο πορτοκαλί Warning Banner («Στάσου σε ασφαλές σημείο…») όσο είναι σε Unresolved state.

6. Research Data & Offline Fallback (Inbox System)

Για την υποστήριξη της ακαδημαϊκής έρευνας χωρίς να απαιτείται Login System:

Offline Inbox System (settings_screen.dart): Στο τέλος της αποστολής, τα δεδομένα (medals, loots, timestamps) γίνονται URL-encoded. Αν η συσκευή είναι offline, το URI string αποθηκεύεται στη λίστα prefPendingEvalUrlsList (Local Inbox) και μπορεί να ανακληθεί από τον χρήστη μέσω των Ρυθμίσεων όταν αποκατασταθεί η σύνδεση.λεία υπαίθρου που είναι διαθέσιμα για τα σημερινά σχολεία.

Persistent Student ID: Το WelcomeScreen παράγει ένα τυχαίο 5ψήφιο ID (10000-99999) κατά το first launch, το οποίο αποθηκεύεται μόνιμα και αποτελεί το key του μαθητή στα analytics.

Dynamic Route ID: Παράγεται ένα νέο Session ID (π.χ. R-45091) σε κάθε “Νέα Αποστολή”.