diff --git a/README.md b/README.md index 0caf72c..20f2d50 100644 --- a/README.md +++ b/README.md @@ -3,9 +3,9 @@ --- -## 1. Grundanforderungen (25 Punkte) +## 1. Grundanforderungen (insg. 30 Punkte) -### Projektgrundlagen (15 Punkte) +### Projektgrundlagen (15/30 Punkte) - **Funktionsfähige Anwendung** (8 Punkte) - Webapp oder Backend-Anwendung läuft fehlerfrei - Kernfunktionalitäten sind in der Projektdokumentation beschrieben und testbar @@ -17,7 +17,7 @@ - README.md mit Installation, Verwendung und Technologie-Stack - Kurze Erklärung der Hauptfunktionen am Anfang relevanter Dateien -### Präsentation (20 Punkte) +### Präsentation (15/30 Punkte) - **Elevator Pitch** (5 Punkte) - Maximal 1 Minute - Welches Problem wird gelöst und warum wurde es vorher noch nicht gelöst? @@ -37,9 +37,9 @@ --- -## 2. Clean Code Prinzipien (35 Punkte) +## 2. Clean Code Prinzipien (insg. 30 Punkte) -### Projektstruktur (10 Punkte) +### Projektstruktur (10/30 Punkte) - **Ordnerstruktur** (5 Punkte) ``` projekt/ @@ -64,9 +64,9 @@ - Ein Konzept pro Datei (Single Responsibility) - Konsistente Namenskonventionen: `kebab-case` für Dateien, `camelCase` für Variablen, `PascalCase` für Komponenten/Klassen -### Code-Qualität (15 Punkte) +### Code-Qualität (10/30 Punkte) -#### KISS Prinzip (5 Punkte) +#### KISS Prinzip (2 Punkte) **❌ Nicht so einfach:** ```javascript @@ -101,7 +101,7 @@ function findActiveUser(users, userId) { } ``` -#### Beschreibende Namen (5 Punkte) +#### Beschreibende Namen (2 Punkte) **❌ Schlecht:** ```javascript @@ -163,7 +163,7 @@ function sendWelcomeEmail(email) { } ``` -### Kommentierung & Dokumentation (5 Punkte) +### Kommentierung & Dokumentation (5/30 Punkte) **JSDoc ist optional und der beste Code muss nicht kommentiert werden.** **❌ Über-/Unterkommentiert:** @@ -217,17 +217,16 @@ function calculateShippingCost(weight, distance, priority) { } ``` -### Live-Demo (10 Punkte) -- **Fehlerfreie Demonstration** (10 Punkte) +### Live-Demo (5/30 Punkte) - Anwendung läuft während der Präsentation stabil - Alle Kernfunktionen werden erfolgreich vorgeführt - Ungefähr 5 Minuten Demo-Zeit --- -## 3. Accessibility & UX (25 Punkte) +## 3. Accessibility & UX (25 Punkte insg.) -### Web Accessibility (15 Punkte) +### Web Accessibility (15/25 Punkte) #### Semantisches HTML (5 Punkte) @@ -308,7 +307,7 @@ div.clickable:focus {
🍔
``` -### Responsive Design (10 Punkte) +### Responsive Design (10/25 Punkte) #### Mobile First Approach (5 Punkte - mindestens 1 Breakpoint) ```css @@ -359,9 +358,9 @@ div.clickable:focus { --- -## 4. Erweiterte Technologien & Innovation (15 Punkte) +## 4. Erweiterte Technologien & Innovation (15 Punkte insg.) -### Plattformunabhängigkeit (5 Punkte) +### Plattformunabhängigkeit (5/15 Punkte) - Funktioniert auf macOS, Windows, GNU/Linux - Browser-Kompatibilität (Chrome, Firefox, Safari, Edge) @@ -392,7 +391,7 @@ function copyToClipboard(text) { } ``` -### Entwicklungs-Tools (10 Punkte) +### Entwicklungs-Tools (10/15 Punkte) #### Package Management (4 Punkte) @@ -443,7 +442,7 @@ import { debounce } from 'lodash'; // Debug-Code entfernt in Production ``` -### Zusätzliche Features (Bonus: bis zu 10 Punkte) +### Zusätzliche Features (Bonus: bis maximal 10 Punkte zusätzlich) **Wähle mindestens 2 Bereiche:** #### API Integration (5 Punkte)