Υλοποίηση
Κάθε περιστροφή του κύβου βασίζεται σε ένα δικό του σύστημα: ένα μαθηματικό μοντέλο, μια μηχανή 3D και έναν επιλυτή που λαμβάνει υπόψη τους στόχους του μαθήματος. Η εφαρμογή Android χρησιμοποιεί Kotlin και Jetpack Compose.
Στιγμιότυπο έργου
test* / androidTest* · @Teststack.kt
| Kotlin | 2.4.21 |
|---|---|
| Compose BOM | 2026.09.00 |
| Material 3 | 1.5.0-beta01 |
| Adaptive | 1.3.0 |
| Navigation 3 | 1.2.0 |
| AGP | 9.4.1 |
| KSP | 2.3.12 |
| Gradle | 9.7.0 |
Τα Jetpack Compose και Material 3 καθορίζουν τα στοιχεία και τα θέματα της διεπαφής. Το Adaptive χειρίζεται τη διάταξη ανάλογα με το μέγεθος του παραθύρου, ενώ το Navigation 3 την πλοήγηση και την επαναφορά οθονών. Η κατάσταση φτάνει μέσω Coroutines και Flow· το Hilt συνδέει τις ενότητες της εφαρμογής.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileΗ διεπαφή, τα συμβόλαια τομέα και τα δεδομένα βρίσκονται σε χωριστές ενότητες· το Hilt συνδέει τις υλοποιήσεις. Το Compose λαμβάνει αμετάβλητη κατάσταση και ρητά συμβάντα. Το Room αποθηκεύει ιστορικό και πρόοδο μάθησης, το DataStore ρυθμίσεις και το Navigation 3 επαναφέρει τις στοίβες των ενοτήτων.
android-ux.md
Το Cubiq υλοποιεί προσεγγίσεις που η Google επισημαίνει στο Apps Experience Program: Compose, προσαρμοστική διάταξη και edge-to-edge.
engine.glsl
Οι shaders GLSL υπολογίζουν υλικά PBR, τραχύτητα και φωτισμό περιβάλλοντος. Μοντέλο και κίνηση είναι συγχρονισμένα: ένα βήμα πίσω εφαρμόζει την αντίστροφη κίνηση και η κάμερα λαμβάνει υπόψη τον χώρο ανάμεσα στα πάνελ.
Η σημειογραφία με τύπους μετατρέπεται σε κινήσεις και συνεπείς καταστάσεις κύβου. Η ουρά του renderer κινεί τις περιστροφές στρωμάτων, διατηρώντας την ταυτότητα κομματιών και facelet. Ο τύπος αναπαράγεται ως ακολουθία πραγματικών κινήσεων, με αναπαραγωγή, παύση και ρύθμιση ρυθμού.
Ένα βήμα μπροστά κινεί μια νέα κίνηση· ένα βήμα πίσω εφαρμόζει την αντίστροφη. Η μετάβαση σε θέση επαναφέρει τη βασική σκηνή και την ακολουθία στόχου. Η ακύρωση σταματά την έκδοση επόμενων κινήσεων· μια περιστροφή που άρχισε ολοκληρώνεται. Ο κύκλος ζωής EGL χειρίζεται pause/release· χωρίς GL παραμένει διαθέσιμη η μαθησιακή διαδρομή χωρίς 3D.
solver.kt
Ο δικός του επιλυτής δημιουργεί λύση από τύπους και βοηθητικές κινήσεις του τρέχοντος μαθήματος. Το SolverRequest περιλαμβάνει κατάσταση κύβου, κομμάτια στόχου, κλειδωμένους στόχους, επιτρεπόμενους τύπους, περιπτώσεις και προσανατολισμό. Ο σχεδιαστής τηρεί τη σειρά των μαθησιακών στόχων και προστατεύει τα λυμένα κομμάτια.
Ο σχεδιασμός ανά φάση χρησιμοποιεί περιορισμένο BFS, αναζήτηση δέσμης και αναγνώριση περιπτώσεων F2L. Η επικύρωση ελέγχει τη σύνθεση κομματιών, αναστροφές, συστροφές και ισοτιμία μεταθέσεων. Η πολιτική αναζήτησης περιορίζει βάθος και εύρος δέσμης. Η αλλαγή μαθήματος ακυρώνει την αναζήτηση και αποκλείει παρωχημένο αποτέλεσμα.
Το αποτέλεσμα είναι PracticePlan: βήματα, αναφορές τύπων, χρονογραμμή προβολής και χρονογραμμή εκτέλεσης. Η εξήγηση διατηρεί τον εκπαιδευτικό προσανατολισμό· η μηχανή λαμβάνει την πλήρη ακολουθία εκτέλεσης. Αποτελέσματα: plan / solved / invalid input / no constrained path.
content.md
Η θεωρία βρίσκεται σε 756 έγγραφα Markdown και η πρακτική ορίζεται σε 336 τοπικοποιημένα σενάρια. Το Gradle ελέγχει τη δομή των μεταφράσεων και τις αναφορές σε 316 πρωτότυπες εικονογραφήσεις. Τα γραφικά προετοιμάστηκαν στο Blender/Cycles· η μηχανή Android χρησιμοποιεί ξεχωριστή διαδικαστική γεωμετρία.
workflow.md
AGENTS.mdREADME.mdΤο αποθετήριο οργανώνεται για ανάπτυξη με agents: η ιεραρχία AGENTS.md ορίζει ευθύνες, αρχιτεκτονικούς περιορισμούς και ελέγχους επικύρωσης· τα README.md περιγράφουν συμβόλαια ενοτήτων, το KDoc API και αναλλοίωτες συνθήκες.
Τα συμβόλαια αρχιτεκτονικής, σχεδίασης και τοπικοποίησης αποθηκεύονται με έλεγχο εκδόσεων μαζί με τον κώδικα. Το PLAN.md καταγράφει πεδίο εργασίας και παράδοση· οι αλλαγές συμβολαίων ενημερώνουν την αρμόδια τεκμηρίωση. Έλεγχοι και παραγωγή περνούν από Gradle· το CI δημιουργεί και τις δύο παραλλαγές καταστημάτων.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationΟι δοκιμές καλύπτουν αδύνατες καταστάσεις κύβου, διατήρηση λυμένων στρωμάτων, σχέδια μάθησης, ακύρωση παρωχημένων αιτημάτων, επαναφορά συνεδριών και εισαγωγή δεδομένων. Το CI δημιουργεί και τις δύο παραλλαγές καταστημάτων· οι έλεγχοι έκδοσης περιλαμβάνουν R8, APK/AAB, αθροίσματα ελέγχου και ευθυγράμμιση native βιβλιοθηκών για σελίδες 16 KB.
Ο όγκος Kotlin μετρά φυσικές γραμμές, μαζί με σχόλια, κενές γραμμές, buildSrc και κώδικα benchmark, χωρίς καταλόγους δοκιμών. Ο αριθμός δοκιμών σημαίνει 1 343 δηλώσεις JVM και 281 δηλώσεις Android, όχι εκτελέσεις. Τα έγγραφα περιλαμβάνουν εφεδρικό κείμενο· η παρουσία σεναρίου δεν σημαίνει πρακτική σε κάθε μάθημα.
baselineprofile · @TestΤο συνολικό κείμενο μετρά φυσικές γραμμές σε αρχεία UTF-8 υπό παρακολούθηση: πηγές, δοκιμές, πόρους XML/JSON, περιεχόμενο Markdown, τοπικοποίηση, τεκμηρίωση, εργαλεία build και πηγές web. Περιλαμβάνει σχόλια, κενές γραμμές και γλωσσικά αντίγραφα. Εξαιρεί μέσα, παραγόμενα και build αποτελέσματα, κώδικα τρίτων, ρυθμίσεις υπηρεσιών και το προσωρινό PLAN.md. Μετρά τις εισόδους κειμένου του έργου, όχι εκτελέσιμες LOC.