b372e2cf78
- Added CartItem, CartSummary, CartEmpty, CartSidebar, and CartSheet components for managing cart display and interactions. - Integrated useCart and useCartUI composables for cart state management and UI control. - Implemented API endpoints for cart operations, including fetching, adding, updating, and removing items. - Enhanced user experience with loading states and notifications using vue-sonner for cart actions. - Configured session management for guest and authenticated users, ensuring cart persistence across sessions. This commit completes the shopping cart feature, enabling users to add items, view their cart, and proceed to checkout. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
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! 🎉