Toteutus
Jokainen kuution käännös perustuu omaan järjestelmään: matemaattiseen malliin, 3D-moottoriin ja ratkaisijaan, joka huomioi oppitunnin tavoitteet. Android-sovellus käyttää Kotlin-kieltä ja Jetpack Compose -kirjastoa.
Projektin tilannekuva
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 ja Material 3 määrittävät käyttöliittymän komponentit ja teemat. Adaptive huolehtii asettelusta ikkunan koon mukaan ja Navigation 3 navigoinnista sekä näyttöjen palautuksesta. Tila välittyy Coroutines- ja Flow-tekniikoilla; Hilt yhdistää sovellusmoduulit.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileKäyttöliittymä, domain-sopimukset ja tiedot on jaettu eri moduuleihin; Hilt yhdistää toteutukset. Compose saa muuttumattoman tilan ja eksplisiittiset tapahtumat. Room tallentaa historian ja oppimisen edistymisen, DataStore asetukset ja Navigation 3 palauttaa osioiden pinot.
android-ux.md
Cubiq toteuttaa Googlen Apps Experience Program -ohjelmassa esiin nostamia ratkaisuja: Compose, mukautuva asettelu ja edge-to-edge.
engine.glsl
GLSL-varjostimet laskevat PBR-materiaalit, karheuden ja ympäristövalaistuksen. Malli ja animaatio toimivat yhdessä: askel taaksepäin tekee käänteisen siirron, ja kamera huomioi paneelien välisen vapaan tilan.
Tyypitetty merkintätapa muunnetaan siirroiksi ja yhtenäisiksi kuutiotiloiksi. Rendererin jono animoi kerrosten käännökset säilyttäen palojen ja faceletien identiteetit. Algoritmi toistetaan todellisena siirtosarjana toiston, tauon ja temponsäädön kanssa.
Askel eteenpäin animoi uuden siirron; askel taaksepäin käyttää käänteistä siirtoa. Paikkaan siirtyminen palauttaa pohjakohtauksen ja kohdesarjan. Peruutus lopettaa uusien siirtojen antamisen; aloitettu käännös päättyy. EGL-elinkaari hoitaa pause/release-toiminnot; ilman GL-tukea oppimispolku toimii edelleen ilman 3D-näkymää.
solver.kt
Oma ratkaisija rakentaa ratkaisun nykyisen oppitunnin algoritmeista ja apusiirroista. SolverRequest sisältää kuution tilan, kohdepalat, lukitut kohteet, sallitut algoritmit, tapaukset ja orientaation. Suunnittelija noudattaa oppimistavoitteiden järjestystä ja suojaa ratkaistut palat.
Vaihekohtainen suunnittelu käyttää rajattua BFS-hakua, keilahakua ja F2L-tapausten tunnistusta. Validointi tarkistaa palakoostumuksen, käännökset, kiertymät ja permutaatiopariteetin. Hakukäytäntö rajoittaa syvyyttä ja keilan leveyttä. Oppitunnin vaihto peruu haun ja estää vanhentuneen tuloksen.
Tulos on PracticePlan: askeleet, algoritmiviitteet, näyttöaikajana ja suoritusaikajana. Selitys säilyttää oppimisorientaation; moottori saa koko suoritussarjan. Tulokset: plan / solved / invalid input / no constrained path.
content.md
Teoria on 756 Markdown-dokumentissa ja harjoittelu on määritelty 336 lokalisoidussa skenaariossa. Gradle tarkistaa käännösten rakenteen ja viittaukset 316 omaan kuvitukseen. Grafiikka valmisteltiin Blender/Cycles-ohjelmistolla; Android-moottori käyttää erillistä proseduraalista geometriaa.
workflow.md
AGENTS.mdREADME.mdTietovarasto on järjestetty agenttien kanssa tehtävään kehitykseen: AGENTS.md-hierarkia määrää vastuut, arkkitehtuurirajoitteet ja validointiportit; README.md-tiedostot kuvaavat moduulisopimukset, KDoc API-rajapinnat ja invariantit.
Arkkitehtuuri-, design- ja lokalisointisopimuksia versioidaan koodin rinnalla. PLAN.md kirjaa laajuuden ja työn luovutuksen; sopimusmuutokset päivittävät omistavan tahon dokumentaation. Tarkistukset ja generointi kulkevat Gradle-työkalun kautta; CI kokoaa molemmat kauppaversiot.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTestit kattavat mahdottomat kuutiotilat, ratkaistujen kerrosten säilyttämisen, oppimissuunnitelmat, vanhentuneiden pyyntöjen perumisen, istuntojen palauttamisen ja tietojen tuonnin. CI kokoaa molemmat kauppaversiot; julkaisutarkistuksiin kuuluvat R8, APK/AAB, tarkistussummat ja natiivikirjastojen kohdistus 16 KB:n sivuille.
Kotlin-koodin määrä lasketaan fyysisinä riveinä, mukaan lukien kommentit, tyhjät rivit, buildSrc ja benchmark-koodi, ilman testihakemistoja. Testimäärä tarkoittaa 1 343 JVM-määrittelyä ja 281 Android-määrittelyä, ei suorituskertoja. Dokumentit sisältävät varatekstin; skenaarion olemassaolo ei tarkoita harjoitusta jokaisella oppitunnilla.
baselineprofile · @TestKokonaisteksti laskee fyysiset rivit versionhallinnan UTF-8-tiedostoista: lähteistä, testeistä, XML/JSON-resursseista, Markdown-sisällöstä, lokalisoinnista, dokumentaatiosta, koontityökaluista ja verkkolähteistä. Kommentit, tyhjät rivit ja kielikopiot sisältyvät. Media, generoidut ja koontitulokset, toimittajakoodi, palveluasetukset ja tilapäinen PLAN.md eivät sisälly. Tämä mittaa projektin tekstisyötteitä, ei suoritettavaa LOC-määrää.