reset to setup module state
Remove Task Manager implementation to match `# Setup module` in module.md. Backend src/ reduced to Kernel.php + empty Entity/, all migrations deleted, database dropped and recreated. Frontend components/views/services/stores removed, App.vue/router/style.css reduced to skeletons. CLAUDE.md shortened to Setup-stand. Old backend/plan.md, plan2.md removed. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Marek Lenczewski
171
CLAUDE.md
171
CLAUDE.md
@@ -1,158 +1,50 @@
|
||||
# Haushalt — Aufgabenverwaltung
|
||||
# Haushalt
|
||||
|
||||
Basis-Software mit 3 geplanten Apps: Task Manager, Shopping List, Meal Planner.
|
||||
|
||||
Aktueller Stand: **Setup module** (siehe `module.md`) — minimales Symfony + Vue Gerüst, kein Feature-Code.
|
||||
|
||||
## Tech-Stack
|
||||
|
||||
| Schicht | Technologie |
|
||||
|---------|------------|
|
||||
| Backend | Symfony 7.4, PHP 8.2+, Doctrine ORM 3.6 |
|
||||
| Frontend Web | Vue 3 (Composition API), Vite 8, Pinia, Vue Router 4 |
|
||||
| Datenbank | MySQL/MariaDB (utf8mb4) |
|
||||
| Backend | Symfony 7.4, PHP 8.3, Doctrine ORM |
|
||||
| Frontend Web | Vue 3 (Composition API), Vite, Pinia, Vue Router 4 |
|
||||
| Frontend Mobile | Kotlin + Jetpack Compose (noch nicht aufgesetzt) |
|
||||
| Datenbank | MariaDB 10.11 (utf8mb4) |
|
||||
| CORS | Nelmio CORS Bundle |
|
||||
| Umgebung | DDEV |
|
||||
|
||||
## Domain-Modell
|
||||
|
||||
**Task** — Einzelne Aufgabe
|
||||
- Felder: id, name, status, date, schema (nullable FK), category (nullable FK), createdAt
|
||||
- TaskStatus: Active (`active`), Done (`done`)
|
||||
- Tasks mit schema=null sind standalone (z.B. aus Single-Schemas erstellt)
|
||||
- Tasks mit schema!=null gehören zu einem wiederkehrenden Schema
|
||||
|
||||
**TaskSchema** — Template für wiederkehrende Aufgaben
|
||||
- Felder: id, name, status, taskType, category, startDate, endDate, days, createdAt
|
||||
- TaskSchemaStatus: Active (`active`), Disabled (`disabled`)
|
||||
- TaskSchemaType: Single (`single`), Daily (`daily`), Custom (`custom`)
|
||||
- `days`: JSON-Feld mit optionalen Keys: `week` (1-7), `month` (1-31), `year` ([{month, day}])
|
||||
- Single: Erstellt Tasks via YearPicker, Tasks werden detached (schema=null), Schema löscht sich automatisch
|
||||
- Daily: Erstellt Tasks für jeden Tag im Zeitraum start–end
|
||||
- Custom: Erstellt Tasks basierend auf days-Konfiguration im Zeitraum start–end
|
||||
- Disabled: Generiert keine neuen Tasks, bestehende bleiben
|
||||
|
||||
**Category** — Farbkodierte Kategorie
|
||||
- Felder: id, name, color (Hex #RRGGBB)
|
||||
|
||||
Enum-Case-Namen und DB-Werte sind Englisch.
|
||||
|
||||
## Architektur (Backend)
|
||||
## Struktur
|
||||
|
||||
```
|
||||
Controller → Service (Manager) → Repository → Entity
|
||||
↓
|
||||
DTO (Request)
|
||||
backend/
|
||||
src/
|
||||
Kernel.php — Standard-Symfony-Kernel, keine App-Klassen
|
||||
config/ — Symfony-Config (nelmio_cors, doctrine, framework, ...)
|
||||
migrations/ — leer
|
||||
public/index.php — Symfony-Einstieg
|
||||
frontend/
|
||||
src/
|
||||
main.js — Vue-Init mit Pinia + Router
|
||||
App.vue — RouterView, kein Content
|
||||
router/index.js — Router mit leerem routes-Array
|
||||
style.css — leer
|
||||
index.html, vite.config.js
|
||||
```
|
||||
|
||||
**Prinzipien:**
|
||||
- Controller: nur Routing + Response, keine Geschäftslogik
|
||||
- Manager-Services: Geschäftslogik (CRUD, Validierung, Toggle)
|
||||
- DTOs: typisierter Input (Request)
|
||||
- Validierung: nur auf Request-DTOs (`#[Assert\...]`), nicht auf Entities
|
||||
- Entities: Doctrine-Mapping + Getter/Setter, Serializer-Groups für API-Output
|
||||
- Task-Generierung: Lazy beim Aufruf von GET /api/tasks (nicht per Cronjob)
|
||||
## Dokumentation
|
||||
|
||||
## Verzeichnisstruktur (Backend)
|
||||
|
||||
```
|
||||
backend/src/
|
||||
Controller/Api/
|
||||
CategoryController.php — Category CRUD
|
||||
TaskController.php — Task CRUD + index + toggle
|
||||
TaskSchemaController.php — Schema CRUD
|
||||
DTO/
|
||||
Request/ — CreateSchemaRequest, UpdateSchemaRequest, CreateTaskRequest,
|
||||
UpdateTaskRequest, CreateCategoryRequest, UpdateCategoryRequest,
|
||||
SchemaValidationTrait
|
||||
Entity/
|
||||
Category.php, Task.php, TaskSchema.php
|
||||
Enum/
|
||||
TaskStatus.php, TaskSchemaStatus.php, TaskSchemaType.php
|
||||
Repository/
|
||||
CategoryRepository.php, TaskRepository.php, TaskSchemaRepository.php
|
||||
Service/
|
||||
CategoryManager.php — Category CRUD-Logik
|
||||
TaskManager.php — Task Create/Update/Delete/Toggle
|
||||
TaskSchemaManager.php — Schema CRUD + Single-Flow + Sync-Auslösung
|
||||
TaskGenerator.php — Erzeugt Task-Instanzen für Zeiträume (lazy)
|
||||
TaskSynchronizer.php — Sync nach Schema-Update (löschen/erstellen/reset)
|
||||
DeadlineCalculator.php — Berechnet Fälligkeitsdaten für Daily/Custom-Schemas
|
||||
```
|
||||
|
||||
## API-Routen
|
||||
|
||||
### Tasks (`/api/tasks`)
|
||||
```
|
||||
GET / — Alle Tasks (triggert Task-Generierung)
|
||||
GET /{id} — Task-Details
|
||||
POST / — Task direkt erstellen (schema=null)
|
||||
PUT /{id} — Task aktualisieren
|
||||
DELETE /{id} — Task löschen
|
||||
PATCH /{id}/toggle — Status Active↔Done umschalten
|
||||
```
|
||||
|
||||
### Schemas (`/api/schemas`)
|
||||
```
|
||||
GET / — Alle Schemas
|
||||
GET /{id} — Einzelnes Schema
|
||||
POST / — Erstellen (Single: erstellt Tasks + löscht Schema)
|
||||
PUT /{id} — Aktualisieren (synchronisiert zukünftige Tasks)
|
||||
DELETE /{id} — Löschen (?deleteTasks=1 für Task-Löschung)
|
||||
```
|
||||
|
||||
### Categories (`/api/categories`)
|
||||
```
|
||||
GET / — Alle Kategorien
|
||||
GET /{id} — Einzelne Kategorie
|
||||
POST / — Erstellen
|
||||
PUT /{id} — Aktualisieren
|
||||
DELETE /{id} — Löschen
|
||||
```
|
||||
|
||||
## Verzeichnisstruktur (Frontend)
|
||||
|
||||
```
|
||||
frontend/src/
|
||||
views/
|
||||
HomeView.vue — Startseite, Wochenansicht (client-seitig berechnet)
|
||||
AllTasksView.vue — Übersicht aller Schemas/Tasks
|
||||
SchemaView.vue — Schema erstellen/bearbeiten (3 Typen)
|
||||
TaskDetailView.vue — Einzelne Aufgabe bearbeiten
|
||||
CategoriesView.vue — Kategorien verwalten
|
||||
components/
|
||||
TaskCard.vue — Aufgaben-Karte (klickbar zum Toggle)
|
||||
DayColumn.vue — Tages-Spalte in Wochenansicht
|
||||
CategoryBadge.vue — Kategorie-Badge mit Farbe
|
||||
Icon.vue — SVG-Icons (eyeOpen, eyeClosed, plus, arrowLeft, save, trash, edit, close)
|
||||
WeekdayPicker.vue — Wochentag-Auswahl (Mo-So)
|
||||
MonthdayPicker.vue — Monatstag-Auswahl (Kalender-Grid)
|
||||
YearPicker.vue — Jahreskalender-Auswahl
|
||||
router/index.js — Routen mit Breadcrumb-Meta
|
||||
services/api.js — REST-Client (fetch-basiert)
|
||||
stores/categories.js — Pinia Store für Kategorien
|
||||
style.css — Globale Styles, CSS-Variablen, Light/Dark Mode
|
||||
App.vue — Root-Layout mit Breadcrumb-Navigation
|
||||
main.js — Vue-App-Init (Pinia + Router)
|
||||
```
|
||||
|
||||
## Frontend-Routen
|
||||
|
||||
```
|
||||
/ → HomeView (Wochenansicht)
|
||||
/tasks/all → AllTasksView (Übersicht)
|
||||
/tasks/new → SchemaView (Schema erstellen)
|
||||
/tasks/:id → TaskDetailView (Aufgabe bearbeiten)
|
||||
/schemas/:id → SchemaView (Schema bearbeiten)
|
||||
/categories → CategoriesView
|
||||
```
|
||||
- **`base.md`** — Vision: was gebaut wird (3 Apps, Systeme, Datenbank-Skizze)
|
||||
- **`module.md`** — Implementierungs-Schritte als Feature-Module (Backend + Frontend end-to-end pro Modul)
|
||||
- **`CLAUDE.md`** (diese Datei) — Ist-Zustand des Codes
|
||||
|
||||
## Code-Konventionen
|
||||
|
||||
- **Sprache Code**: Englisch (Klassen, Methoden, Variablen, CSS-Klassen)
|
||||
- **Sprache UI**: Deutsch (Labels, Fehlermeldungen, Platzhalter)
|
||||
- **Enum-Werte**: Englisch in DB und Code (`active`, `done`, `single`, `daily`, `custom`, `disabled`)
|
||||
- **API-Serialisierung**: Symfony Serializer-Groups auf Entities (`schema:read`, `task:read`, `category:read`)
|
||||
- **Validierung**: Auf Request-DTOs, nicht auf Entities
|
||||
- **Error-Handling**: `HttpException` → Symfony built-in
|
||||
- **Frontend**: Vue 3 Composition API mit `<script setup>`, fetch-basierter API-Client
|
||||
- **Wochenansicht**: Frontend berechnet Mo-So client-seitig aus allen Tasks
|
||||
- **Sprache Code**: Englisch (Klassen, Methoden, Variablen)
|
||||
- **Sprache UI**: Deutsch
|
||||
- **Enum-Werte**: Englisch in DB und Code
|
||||
- **Frontend**: Vue 3 Composition API mit `<script setup>`
|
||||
|
||||
## Development
|
||||
|
||||
@@ -162,7 +54,6 @@ ddev start
|
||||
|
||||
# Backend
|
||||
ddev exec "cd backend && php bin/console cache:clear"
|
||||
ddev exec "cd backend && php bin/console doctrine:migrations:migrate --no-interaction"
|
||||
|
||||
# Frontend
|
||||
ddev exec "cd frontend && npm install"
|
||||
|
||||
Reference in New Issue
Block a user