ca0c4dddf4
- Updated last modified date and overall progress in the project documentation. - Enhanced cart UI by fixing the Warenkorb button hover bug, improving CartItem layout, and refining the quantity selector for better user experience. - Improved styling of the Warenkorb button for better visual consistency. - Created a new Educator Products page to showcase educator annual passes with optimized content. These changes aim to enhance the shopping cart functionality and user experience for educators.
Task Management System
my.experimenta.science MVP Implementation
Dieses Verzeichnis enthält die feingranulare Task-Planung für die Implementierung des MVP.
📁 Ordnerstruktur
tasks/
├── README.md # Diese Datei - Übersicht & Anleitung
├── 00-PROGRESS.md # Zentrale Fortschrittsverfolgung
├── 01-foundation.md # Phase 1: Foundation (Nuxt Setup)
├── 02-database.md # Phase 2: Database Schema & Migrations
├── 03-authentication.md # Phase 3: Cidaas OAuth2 Integration
├── 04-products.md # Phase 4: Product Display
├── 05-cart.md # Phase 5: Shopping Cart
├── 06-checkout.md # Phase 6: Checkout Flow
├── 07-payment.md # Phase 7: PayPal Integration
├── 08-order-processing.md # Phase 8: Order Processing (BullMQ + X-API)
├── 09-erp-integration.md # Phase 9: NAV ERP Product Sync
├── 10-i18n.md # Phase 10: Internationalization
└── 11-testing-deployment.md # Phase 11: Testing & Deployment
🎯 Zweck
Dieses System ermöglicht:
✅ Strukturierte Entwicklung: Klare Aufteilung in logische Phasen ✅ Progress Tracking: Nachvollziehbarer Fortschritt pro Phase ✅ Agent-freundlich: Claude Code Agents können Tasks autonom abarbeiten ✅ Resume-fähig: Einfaches Fortsetzen nach Unterbrechung ✅ Transparenz: Blockers & Decisions werden dokumentiert ✅ Dependencies: Klare Abhängigkeiten zwischen Phasen
📊 Status-Definitionen
| Status | Symbol | Bedeutung |
|---|---|---|
| Todo | ⏳ | Noch nicht begonnen |
| In Progress | 🔄 | Aktuell in Arbeit |
| Done | ✅ | Abgeschlossen & getestet |
| Blocked | 🚫 | Blockiert, wartet auf externes Input |
| Skipped | ⏭️ | Übersprungen (optional/nicht relevant) |
🔄 Workflow für Agents
1. Start einer Arbeitssession
1. Öffne `00-PROGRESS.md`
2. Identifiziere nächste Phase mit Status "⏳ Todo" oder "🔄 In Progress"
3. Öffne die entsprechende Phase-Datei (z.B. `03-authentication.md`)
2. Während der Implementierung
1. Arbeite Tasks sequenziell ab (von oben nach unten)
2. Markiere Tasks als erledigt: `- [ ]` → `- [x]`
3. Dokumentiere wichtige Entscheidungen im Notes-Bereich
4. Bei Blocker: Status auf 🚫, Grund dokumentieren
3. Fortschritt aktualisieren
1. Nach jedem abgeschlossenen Task:
- Aktualisiere Progress in Phase-Datei: "3/15 tasks (20%)"
2. Nach Abschluss einer Phase:
- Status auf ✅ Done setzen
- `00-PROGRESS.md` aktualisieren
- Nächste Phase identifizieren
4. Bei Unterbrechung
1. Aktuellen Task-Status in Phase-Datei speichern
2. In `00-PROGRESS.md` unter "Current Work" dokumentieren:
- Welche Phase
- Welcher Task
- Was als nächstes zu tun ist
📝 Phase-Datei Format
Jede Phase-Datei folgt diesem Template:
# Phase X: [Name]
**Status:** ⏳ Todo | 🔄 In Progress | ✅ Done | 🚫 Blocked
**Progress:** 0/15 tasks (0%)
**Started:** -
**Completed:** -
**Assigned to:** -
---
## Overview
[Beschreibung was in dieser Phase erreicht werden soll]
---
## Dependencies
- ✅ Phase Y: [Name] must be completed first
- ⏳ Phase Z: [Name] (optional, can run parallel)
---
## Tasks
### Setup
- [ ] Task 1
- [ ] Task 2
### Implementation
- [ ] Task 3
- [ ] Task 4
### Testing
- [ ] Task 5
- [ ] Task 6
---
## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
---
## Notes
- Important decision: ...
- Issue encountered: ...
- Resource link: ...
---
## Blockers
- None currently
---
## Related Documentation
- [PRD Section X](../docs/PRD.md#section)
- [Architecture Section Y](../docs/ARCHITECTURE.md#section)
🎓 Best Practices
Für Agents
- Lies zuerst die Phase-Übersicht: Verstehe das Ziel, bevor du startest
- Prüfe Dependencies: Sind alle abhängigen Phasen abgeschlossen?
- Arbeite sequenziell: Tasks sind nach Abhängigkeit sortiert
- Teste nach jedem Task: Nicht alle Tasks am Ende testen
- Dokumentiere Blocker: Wenn stuck, dokumentiere warum
- Update Progress häufig: Nach jedem Task, nicht nur am Ende
Für Entwickler
- Review 00-PROGRESS.md täglich: Übersicht behalten
- Nutze Git Commits pro Task: Ermöglicht einfaches Rollback
- Dokumentiere Abweichungen: Wenn von Plan abgewichen wird
- Update Acceptance Criteria: Falls sich Requirements ändern
📦 Phase-Übersicht
| # | Phase | Schwerpunkt | Geschätzte Tasks |
|---|---|---|---|
| 01 | Foundation | Nuxt 4 Setup, shadcn-nuxt, Tailwind | ~10 |
| 02 | Database | Drizzle Schema, Migrations | ~12 |
| 03 | Authentication | Cidaas OAuth2/OIDC | ~18 |
| 04 | Products | Product Display & List | ~10 |
| 05 | Cart | Shopping Cart Logic | ~12 |
| 06 | Checkout | Checkout Flow & Forms | ~15 |
| 07 | Payment | PayPal Integration | ~12 |
| 08 | Order Processing | BullMQ + X-API Submission | ~15 |
| 09 | ERP Integration | NAV ERP Product Sync API | ~10 |
| 10 | i18n | Internationalization DE/EN | ~8 |
| 11 | Testing & Deployment | E2E Tests, Docker Production | ~15 |
Total: ~137 granulare Tasks
🚀 Getting Started
# 1. Lies die zentrale Progress-Datei
cat tasks/00-PROGRESS.md
# 2. Identifiziere nächste Phase
# z.B. Phase 1: Foundation
# 3. Öffne Phase-Datei
cat tasks/01-foundation.md
# 4. Starte Implementierung
# Arbeite Tasks von oben nach unten ab
# 5. Update Progress nach jedem Task
# Markiere Task als done, update Progress-Zeile
📞 Bei Fragen
- Schaue in die relevante Dokumentation:
docs/PRD.md,docs/ARCHITECTURE.md,docs/TECH_STACK.md - Prüfe
CLAUDE.mdfür Code-Patterns - Bei Blocker: Dokumentiere in Phase-Datei +
00-PROGRESS.md
Happy Coding! 🎉