Erste Version

bottlesort/SPEC.md

@@ -0,0 +1,57 @@
+# Flaschen-Sortier-Spiel - Produktspezifikation
+
+## 1. Ziel des Spiels
+Der Spieler lernt, leere Flaschen nach Sorte korrekt in passende Kisten zu sortieren, zum Beispiel:
+- Bierflaschen in die Bierkiste
+- Wasserflaschen in die Wasserkiste
+
+Die Unterscheidung der Flaschensorten erfolgt visuell über:
+- Farbe
+- Form
+
+## 2. Spielprinzip
+- Das Spiel läuft im Browser.
+- Perspektive: Top-Down-Ansicht auf einen Level, der eine Küche darstellt.
+- Im Level stehen leere Flaschen an verschiedenen Positionen.
+- Der Spieler steuert ein Männchen, das Flaschen einsammelt.
+- Das Männchen kann immer nur **eine** Flasche gleichzeitig tragen.
+- Getragene Flaschen werden zu den passenden Kisten gebracht und dort abgelegt.
+
+## 3. Level-Struktur und Progression
+Es gibt insgesamt **4 Level**.
+
+### Level 1
+- Flaschensorten: 2
+- Leere Flaschen gesamt: 10
+
+### Skalierung pro weiterem Level
+In jedem folgenden Level verdoppeln sich:
+- Anzahl der Flaschensorten
+- Anzahl der Flaschen
+
+Daraus ergibt sich:
+- Level 2: 4 Sorten, 20 Flaschen
+- Level 3: 8 Sorten, 40 Flaschen
+- Level 4: 16 Sorten, 80 Flaschen
+
+## 4. Erfolg, Fehler und Spielende
+- Ein Level ist abgeschlossen, wenn alle Flaschen korrekt einsortiert wurden.
+- Wird eine Flasche in die falsche Kiste einsortiert, startet der Spieler **im aktuellen Level von vorn**.
+- Nach erfolgreichem Abschluss von Level 4 ist das Spiel beendet.
+
+## 5. Nicht-funktionale Vorgaben
+- Die visuelle Stilvorgabe ist ausgelagert in [STYLE_GUIDE.md](./STYLE_GUIDE.md), damit derselbe Stil auch für ähnliche Spiele wiederverwendet werden kann.
+
+## 6. Implementierungsrahmen (final festgelegt)
+- Plattform: Desktop-Browser (aktuelles Chrome/Firefox/Edge)
+- Steuerung: Tastatur (Pfeiltasten oder WASD), Aktionstaste zum Aufnehmen/Ablegen
+- Kollisionslogik: Kollision mit Waenden/Moebeln und Kisten aktiv
+- Levelziel: Alle 4 Level muessen erfolgreich abgeschlossen werden
+- Fehlerfall: Bei falscher Einsortierung sofortiger Neustart des aktuellen Levels
+- Zeitlimit/Punkte: Kein Zeitlimit, kein Punktesystem
+- Hindernisse: Ja, Waende und weitere Hindernisse im Level
+- Sortenunterscheidung: Ausschliesslich ueber Farbe und Form
+- Tutorial: Kein separates Tutorial
+- Sprache: Deutsch
+- Audio: 8-Bit-Hintergrundmusik sowie Soundeffekte (mindestens Aufnehmen/Ablegen; weitere Effekte erlaubt)
+- Speicherstand: Kein Persistenzspeicher, Neustart bei Seiten-Reload