gartenmanager/.claude/session-context.md

# Session-Kontext

> Claude liest diese Datei zu Beginn jeder Session.
> Claude aktualisiert sie am Ende jeder Session.

---

## Aktueller Stand

| Feld | Wert |
|---|---|
| **Version** | 0.2.3 |
| **Aktiver Branch** | feature/phase-1 |
| **Basis-Branch** | develop |
| **Zuletzt geändert** | 2026-04-05 |

## Offene Arbeit – nächste Session startet hier

Phase 1 implementieren. Reihenfolge:

1. **Backend** – teilweise bereits vorhanden (siehe unten), fehlende Teile ergänzen
2. **Frontend** (Agent-Tool) – alle Dateien unter `frontend/`
3. **Docker** – `docker-compose.yml`, `docker-compose.dev.yml`, `.env.example`
4. Docs aktualisieren, VERSION auf 1.0.0-alpha bumpen, commit + push

### Backend – bereits vorhanden (committet, Qualität noch nicht geprüft):
```
backend/Dockerfile, alembic.ini, requirements.txt
app/core/: config.py, security.py, deps.py
app/db/:   base.py, session.py
app/models/: user.py, tenant.py, plant.py, bed.py, planting.py
app/schemas/: auth.py, user.py, tenant.py
```
**Noch fehlend:** main.py, crud/, api/, seeds/, alembic/env.py + versions/001_initial.py, schemas/plant.py + bed.py + planting.py

**Zu Beginn:** vorhandene Dateien kurz prüfen (Konsistenz, async, UUID), dann fehlende ergänzen.

### Backend-Spec (Referenz):
- FastAPI + SQLAlchemy async + Alembic + PostgreSQL (asyncpg)
- Models: User, Tenant, UserTenant, PlantFamily, Plant, PlantCompatibility, Bed, BedPlanting
- Rollen: READ_ONLY / READ_WRITE / TENANT_ADMIN + Superadmin-Flag auf User
- JWT: Access 30min, Refresh 7 Tage
- Tenant-Kontext via Header `X-Tenant-ID`
- Seed-Daten: ~20 globale Pflanzen + Kompatibilitäten (fertig geplant, siehe Memory)
- Endpoints: /api/v1/auth/*, /api/v1/plants/*, /api/v1/plant-families, /api/v1/beds/*, /api/v1/beds/{id}/plantings, /api/v1/plantings/{id}

### Frontend-Spec:
- Vue 3 + Vite + PrimeVue + Pinia + Vue Router + Axios
- Views: Login, Beete (DataTable), Beet-Detail, Pflanzenbibliothek
- Sprache: Deutsch
- Static build → Nginx

## Git-Status
- `feature/grundstruktur` → in `develop` gemergt ✓
- `feature/phase-1` → erstellt und gepusht ✓
- Git-Auth: PAT im Credential Store hinterlegt ✓

## Wichtiger Hinweis für nächste Session
`.claude/settings.local.json` hat noch spezifische Permissions – bei git push ggf. Approval nötig.
Zu Beginn prüfen und ggf. auf breite Patterns updaten (Bash(git *), Bash(bash .claude/scripts/*)).

## Schnellreferenz

```bash
# Version bumpen
bash .claude/scripts/bump.sh patch "Was wurde geändert"

# Neuen Branch erstellen
bash .claude/scripts/new-feature.sh feature <name>

# Aktueller Branch
git branch --show-current
```