Implementacja
Za każdym obrotem kostki stoi własny system: model matematyczny, silnik 3D i solver uwzględniający cele lekcji. Aplikacja na Androida korzysta z Kotlin i Jetpack Compose.
Stan projektu
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 i Material 3 określają komponenty i motywy interfejsu. Adaptive dostosowuje układ do rozmiaru okna, a Navigation 3 obsługuje nawigację i odtwarzanie ekranów. Stan dociera przez Coroutines i Flow; Hilt łączy moduły aplikacji.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileInterfejs, kontrakty domenowe i dane mają osobne moduły; Hilt łączy implementacje. Compose otrzymuje niezmienny stan i jawne zdarzenia. Room przechowuje historię i postępy nauki, DataStore ustawienia, a Navigation 3 odtwarza stosy sekcji.
android-ux.md
Cubiq wdraża podejścia, które Google wskazuje w Apps Experience Program: Compose, adaptacyjny układ i edge-to-edge.
engine.glsl
Shadery GLSL obliczają materiały PBR, chropowatość i oświetlenie otoczenia. Model i animacja są zsynchronizowane: krok wstecz wykonuje odwrotny ruch, a kamera uwzględnia przestrzeń między panelami.
Typowana notacja zamienia się w ruchy i spójne stany kostki. Kolejka renderera animuje obroty warstw, zachowując tożsamość części i faceletów. Algorytm jest odtwarzany jako sekwencja rzeczywistych ruchów, z odtwarzaniem, pauzą i regulacją tempa.
Krok naprzód animuje nowy ruch; krok wstecz stosuje ruch odwrotny. Przejście do pozycji odtwarza scenę bazową i docelową sekwencję. Anulowanie wstrzymuje wydawanie następnych ruchów; rozpoczęty obrót kończy się. Cykl życia EGL obsługuje pause/release; bez GL ścieżka nauki pozostaje dostępna bez 3D.
solver.kt
Własny solver tworzy rozwiązanie z algorytmów i pomocniczych ruchów bieżącej lekcji. SolverRequest obejmuje stan kostki, części docelowe, zablokowane cele, dozwolone algorytmy, przypadki i orientację. Planista zachowuje kolejność celów nauki i chroni już ułożone części.
Planowanie dla poszczególnych faz używa ograniczonego BFS, przeszukiwania wiązkowego i rozpoznawania przypadków F2L. Walidacja sprawdza skład części, odwrócenia, skręcenia i parzystość permutacji. Polityka wyszukiwania ogranicza głębokość i szerokość wiązki. Zmiana lekcji anuluje wyszukiwanie i wyklucza nieaktualny wynik.
Wynikiem jest PracticePlan: kroki, odwołania do algorytmów, oś czasu wyświetlania i oś wykonania. Objaśnienie zachowuje orientację dydaktyczną; silnik otrzymuje pełną sekwencję wykonania. Wyniki: plan / solved / invalid input / no constrained path.
content.md
Teoria znajduje się w 756 dokumentach Markdown, a praktyka jest opisana w 336 zlokalizowanych scenariuszach. Gradle sprawdza strukturę tłumaczeń i odwołania do 316 autorskich ilustracji. Grafikę przygotowano w Blender/Cycles; silnik Androida używa osobnej geometrii proceduralnej.
workflow.md
AGENTS.mdREADME.mdRepozytorium służy rozwojowi z agentami: hierarchia AGENTS.md określa odpowiedzialność, ograniczenia architektury i bramki walidacji; README.md opisują kontrakty modułów, KDoc API i niezmienniki.
Kontrakty architektury, projektu i lokalizacji są wersjonowane razem z kodem. PLAN.md zapisuje zakres i przekazanie pracy; zmiany kontraktów aktualizują ich dokumentację właścicielską. Kontrole i generowanie przechodzą przez Gradle; CI buduje oba warianty sklepowe.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTesty obejmują niemożliwe stany kostki, zachowanie ułożonych warstw, plany nauki, anulowanie nieaktualnych żądań, odtwarzanie sesji i import danych. CI buduje oba warianty sklepowe; kontrole wydania obejmują R8, APK/AAB, sumy kontrolne i wyrównanie bibliotek natywnych dla stron 16 KB.
Rozmiar Kotlin to fizyczne wiersze, w tym komentarze, puste wiersze, buildSrc i kod benchmarków, bez katalogów testowych. Liczba testów oznacza 1 343 deklaracji JVM i 281 deklaracji Android, a nie wykonań. Dokumenty zawierają tekst zastępczy; obecność scenariusza nie oznacza ćwiczenia w każdej lekcji.
baselineprofile · @TestŁączna ilość tekstu obejmuje fizyczne wiersze wersjonowanych plików UTF-8: źródeł, testów, zasobów XML/JSON, treści Markdown, lokalizacji, dokumentacji, narzędzi budowania i źródeł strony. Wlicza komentarze, puste wiersze i kopie językowe. Pomija multimedia, pliki generowane i wyniki budowania, kod dostawców, konfiguracje usług oraz tymczasowy PLAN.md. To rozmiar wejść tekstowych projektu, nie wykonywalne LOC.