139 lines
6.5 KiB
Markdown
139 lines
6.5 KiB
Markdown
# Haushalt
|
|
|
|
Basis-Software mit 3 geplanten Apps: Task Manager, Shopping List, Meal Planner.
|
|
|
|
Aktueller Stand: **Task module** implementiert (siehe `module.md`) — Backend + Vue + Kotlin App jeweils end-to-end mit Task-CRUD, Status-Handling und Datum.
|
|
|
|
## Tech-Stack
|
|
|
|
| Schicht | Technologie |
|
|
|---------|------------|
|
|
| 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 (Material 3), Retrofit + kotlinx.serialization |
|
|
| Datenbank | MariaDB 10.11 (utf8mb4) |
|
|
| CORS | Nelmio CORS Bundle |
|
|
| Umgebung | DDEV |
|
|
|
|
## Struktur
|
|
|
|
```
|
|
backend/
|
|
src/
|
|
Collection/TaskCollection.php — IteratorAggregate, filterInactive/sortByDueDate*
|
|
Controller/Api/TaskController.php — REST-Routen unter /api/tasks
|
|
DTO/TaskRequest.php — readonly promoted constructor, Validator + Context(!Y-m-d)
|
|
Entity/Task.php — Doctrine entity, getStatus() derived-past
|
|
Enum/TaskStatus.php — active, done, inactive, past (past nicht user-selectable)
|
|
Repository/TaskRepository.php — currentTasks(), allTasks() → TaskCollection
|
|
Service/TaskManager.php — create/update/delete/toggle Business-Logik
|
|
Kernel.php
|
|
config/ — nelmio_cors, doctrine, framework, ...
|
|
migrations/Version20260411141650.php — tasks table
|
|
public/index.php
|
|
frontend/
|
|
src/
|
|
components/Icon.vue — zentrales Icon-Component
|
|
router/index.js — /, /tasks, /tasks/all, /tasks/create, /tasks/:id mit breadcrumb meta
|
|
services/api.js — fetch wrapper, tasks() + statuses() Endpoints
|
|
stores/tasks.js — Pinia store: fetchCurrent, fetchAll, get, create, update, remove, toggle, fetchStatuses
|
|
views/
|
|
Startpage.vue — Nav-Kacheln
|
|
Task.vue — /tasks (aktuelle Tasks), Card-pro-Datum mit Legend-Titel
|
|
TaskAll.vue — /tasks/all (alle Tasks, flache Liste mit Edit/Delete)
|
|
TaskCreate.vue — /tasks/create
|
|
TaskEdit.vue — /tasks/:id
|
|
App.vue — Breadcrumb-Layout + RouterView
|
|
main.js — Vue-Init (Pinia + Router)
|
|
app/app/src/main/java/de/haushalt/app/
|
|
MainActivity.kt — Compose entry
|
|
MainScreen.kt — NavHost (start, tasks, tasks/all, tasks/create, tasks/{id})
|
|
StartScreen.kt — Nav-Kacheln
|
|
data/
|
|
ApiClient.kt — Retrofit + kotlinx.serialization Setup
|
|
TaskApi.kt — Retrofit interface (list, get, create, update, delete, toggle, statuses)
|
|
Task.kt — Task + TaskStatus enum
|
|
ui/task/
|
|
TaskScreen.kt — /tasks, gleiches Card-Gruppierungs-Muster wie Vue
|
|
TaskAllScreen.kt — /tasks/all flache Liste, Edit/Delete
|
|
TaskCreateScreen.kt / TaskCreateViewModel.kt
|
|
TaskEditScreen.kt / TaskEditViewModel.kt
|
|
TaskListViewModel.kt — visibleTasks, groupedTasks, showDone, refresh, toggle
|
|
TaskAllViewModel.kt
|
|
DatePickerField.kt — Material 3 DatePickerDialog Wrapper
|
|
StatusDropdown.kt — ExposedDropdownMenuBox, Status-Labels vom Backend
|
|
DateFormat.kt — formatDate() mit dd.MM.yyyy
|
|
```
|
|
|
|
## Domänenmodell
|
|
|
|
**Task**
|
|
- `id`, `name`, `date` (nullable, ISO), `status`
|
|
- Status-Enum (`TaskStatus`): `active`, `done`, `inactive`, `past`
|
|
- `past` ist **derived** — wenn `date < today`, liefert `Task::getStatus()` automatisch `past`; der rohe gespeicherte Wert bleibt erhalten (`getRawStatus()`)
|
|
- `past` ist **nicht user-selectable** (siehe `TaskStatus::userSelectableValues()`)
|
|
- Filter `/api/tasks?filter=current` → Tasks ohne `inactive`, sortiert nach `date` aufsteigend (null-first)
|
|
- Default (`/api/tasks`) → alle Tasks, sortiert nach `date` absteigend
|
|
|
|
## REST-API
|
|
|
|
| Methode | Route | Zweck |
|
|
|---|---|---|
|
|
| GET | `/api/tasks?filter=current` | aktuelle Tasks (für `/tasks`) |
|
|
| GET | `/api/tasks` | alle Tasks (für `/tasks/all`) |
|
|
| GET | `/api/tasks/statuses` | user-selectable Statuswerte als `string[]` |
|
|
| GET | `/api/tasks/{id}` | einzelner Task |
|
|
| POST | `/api/tasks` | Task anlegen |
|
|
| PUT | `/api/tasks/{id}` | Task aktualisieren |
|
|
| DELETE | `/api/tasks/{id}` | Task löschen |
|
|
| PATCH | `/api/tasks/{id}/toggle` | Status zwischen `active`/`done` togglen |
|
|
|
|
Request-DTO: `TaskRequest` (name, date `!Y-m-d`, status). Deserialisiert + validiert via `#[MapRequestPayload]`.
|
|
Response-Serialisierung: Symfony Serializer mit `groups: ['task:read']`, Datum als ISO `Y-m-d` String.
|
|
|
|
## UI-Muster
|
|
|
|
- **`/tasks`** (Vue + Kotlin): Tasks nach Datum gruppiert in Cards. Datum sitzt als Pill auf dem Top-Border der Card (fieldset/legend-Look). No-Date-Tasks oben in titelloser Card. `showDone` default `false`.
|
|
- **`/tasks/all`** (Vue + Kotlin): Flache Liste mit Edit- und Delete-Icons. `past`-Tasks mit Opacity 0.5, `inactive` kursiv, `done` durchgestrichen.
|
|
- **Icon-Reihenfolge `/tasks` Header**: plus, list, eye, refresh.
|
|
- Kotlin-Screens refreshen auf `Lifecycle.Event.ON_RESUME` via `DisposableEffect` (gegen stale Daten nach Navigation).
|
|
- Status-Labels in Create/Edit kommen aus dem Backend (`/api/tasks/statuses`) — nicht clientseitig hardcoded.
|
|
|
|
## Dokumentation
|
|
|
|
- **`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)
|
|
- **Sprache UI**: Deutsch
|
|
- **Enum-Werte**: Englisch in DB und Code
|
|
- **Datum im Backend**: ISO `Y-m-d` (als DTO-Input und in Response-JSON)
|
|
- **Datum im UI**: `dd.MM.yyyy` — Formatierung in Vue (`formatDate` in `Task.vue`) und Kotlin (`DateFormat.kt`)
|
|
- **Frontend**: Vue 3 Composition API mit `<script setup>`
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# DDEV starten
|
|
ddev start
|
|
|
|
# Backend
|
|
ddev exec "cd backend && php bin/console cache:clear"
|
|
ddev exec "cd backend && php bin/console doctrine:migrations:migrate"
|
|
|
|
# Frontend
|
|
ddev exec "cd frontend && npm install"
|
|
ddev exec "cd frontend && npm run dev -- --host 0.0.0.0"
|
|
ddev exec "cd frontend && npm run build"
|
|
|
|
# Android App (Java 17 für Gradle)
|
|
cd app && JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 ./gradlew :app:installDebug
|
|
|
|
# URLs
|
|
Frontend: https://haushalt.ddev.site:5173
|
|
API: https://haushalt.ddev.site/api
|
|
```
|