pburkhalter/teko-s5-rubiks-cube-solver

Rubik's Cube Solver

A rubik's cube solver using Three.js and Rust.

Usage

• wasm-pack install
• wasm-pack build
• cd www
• npm install
• npm run start

Frontend

teko-s5-rubiks-cube-solver's Issues

Einrichten WebAssembly-Umgebung

• Aufsetzen der Entwicklungsumgebung für WebAssembly
• ev. build-pipeline ?

Verzögerte Würfelrotationen

Momentan rotiert sich ein Würfel sofort um 90 bzw. 180 Grad. Dies macht es schwer nachzuvollziehen, was für eine Rotation angewendet wurde.

• Eine Rotation soll ca. 0.5s dauern

Lösungsschritte visualisieren und navigieren

Mit #20 haben wir die Lösungsschritte erhalten. Nun sollen diese mittels vorhandenen Navigation "durchgestepped" werden oder abgespielt werden. Ebenfalls sollen die einzelnen Lösungsschritte als Text dargestellt werden.

Zusätzlich sollen alle Buttons in der Navigation ihre vorgesehene Funktionalität ausüben.

fixed group by bug / feature

Würfel anhand des Algorithmus lösen

• Würfelzustand vom frontend anfordern
• Würfelzustand überprüfen
  • User können den Würfel beliebig einfärben - auch unmögliche Kombinationen sind so möglich
  • bei fehlerhaftem Zustand dem frontend eine entsprechende Fehlermeldung zurückgeben
• Lösungsschritte ermitteln
• Lösungsschritte an frontend übermitteln

Würfelfaces mit "default" Farbe nicht ändern lassen

• die "unsichtbaren" Faces können momentan durch Klicken verändert werden
• dies soll gesperrt werden für eine bessere UX

Code refactor

refactor rust source

Dokumentation fertigstellen

Die Dokumentation wird auch schon während dem ganzen Entwicklungszyklus - wo passend - ergänzt.
Diese Story stellt den Abschluss der Dokumentation dar.

Würfelgaps entfernen

Die Würfelgaps machen den JS code nur schwieriger zu handeln und "echte" würfel haben auch (fast) keine gaps.

• die gaps entfernen
• einen schwarzen Rand um alle sub-cube faces machen

Frontend verschönern

• Titlebar hinzufügen
• (pop-up für Farbauswahl der faces ?)
• ..?

cargo test github action

Würfelfarben hinzufügen und den Status der einzelnen Felder ermitteln

• Würfel in gelöstem Zustand einfärben
• Funktion zum Ermitteln des Würfelzustands hinzufügen

validate input

Front- und Backend verbinden

• "Solve" button hinzufügen
• durch Klicken Würfelzustand ermitteln
• an Backend übergeben
  • falls ein invalider Zustand übergeben wurde, entsprechenden Fehler anzeigen
• Lösungsschritte des Backends zwischenspeichern

Die Anzeige und Navigation der Lösungsschritte wird dann mit #21 gemacht.

Verwendete(r) Lösungsalgorithmus ermitteln

Es gibt viele Algorithmen, um einen Rubik's Cube zu lösen.
Es soll ermittelt werden, welche(n) Algorithmus wir verwenden.

• Soll mehr als einer verwendet/angeboten werden?
• Welche(r)?

Anmerkung 30.12.: Vorerst nur einen implementieren.

Einen Würfel mit three.js implementieren

• Aufsetzen einer simplen Website
• Einbinden von three.js
• Implementation eines simplen 3D-Rubiks Würfel
  • nur visuell
  • drehbar

Würfel animieren

• Alle mögliche "Würfelmoves" animieren
  • Nach folgender Notation:
    
• Kontrollelemente entsprechend einbinden

OpenCV Einbindung abklären

Wie würden wir OpenCV in unserem Projekt einbinden?

• python?
• WebAssembly?
• kann es in das bestehende frontend eingebunden werden?

Abklären, wie es möglich wäre, die Eingabe mittels OpenCV umzusetzen und in unser Projekt einzubinden.

Linter hinzufügen

Für jede verwendete Sprache einen entsprechenden linter konfigurieren und via CI laufen lassen.

update crates dependencies

repo cleanup

Momentan hat es viele unnötige files, die wir nicht brauchen (e.g. various license files).
Diese gilt es aufzuräumen.

Frontend: Kontrollelemente hinzufügen

Kontrollelemente für die Lösungsschritte:

• vor
• zurück
• play
• Anfang
• Ende

Create graphic system overview