chore: add Claude tooling and optimize token efficiency

- .claude/scripts/bump.sh: one-command version bump + commit + push
- .claude/scripts/new-feature.sh: branch creation helper
- .claude/session-context.md: session start context
- CLAUDE.md: reduced to dispatch table, no rule duplication
- docs/project-structure.md: restructured as dense module reference

Version: 0.2.1
This commit is contained in:
Faultier314
2026-04-05 22:32:58 +02:00
parent 80c73595d2
commit 6af5df32f6
8 changed files with 235 additions and 47 deletions

View File

@@ -1,47 +1,59 @@
# Projektstruktur
# Projektstruktur & Modulreferenz
> Dieses Dokument beschreibt die Verzeichnisstruktur und Architektur des Gartenmanagers.
> Bei strukturellen Änderungen bitte hier aktualisieren.
> **Token-Sparmaßnahme:** Dieses Dokument ist die erste Anlaufstelle.
> Vor dem Öffnen von Quellcode hier nachschlagen.
> Bei jeder Änderung an Funktionen, Modulen oder der Verzeichnisstruktur sofort aktualisieren.
---
## Verzeichnisübersicht
## Verzeichnisstruktur
```
gartenmanager/
├── CLAUDE.md # Guidance für Claude Code
├── .claude/ # Claude-Tooling (kein Projektcode)
│ ├── scripts/
│ │ ├── bump.sh # Version bumpen + commit + push
│ │ └── new-feature.sh # Feature-Branch erstellen
│ └── session-context.md # Sessionstart-Kontext
├── .gitea/
│ └── PULL_REQUEST_TEMPLATE.md
├── docs/
│ ├── development-standards.md # Allgemeine Entwicklungsstandards
── project-structure.md # Dieses Dokument
│ (weitere Verzeichnisse entstehen mit dem Projekt)
│ ├── branching-strategy.md
── development-standards.md
└── project-structure.md # dieses Dokument
├── .gitattributes
├── CHANGELOG.md
├── CLAUDE.md
├── README.md
└── VERSION
```
> Sobald der Techstack feststeht, wird diese Struktur hier dokumentiert.
> Sobald Quellcode-Verzeichnisse entstehen, hier ergänzen.
---
## Architektur
## Modulübersicht
> Noch festzulegen. Typische Optionen für dieses Projekt:
> Noch kein Anwendungscode vorhanden. Sobald Module/Komponenten entstehen:
>
> - **Monolith** (z. B. Full-Stack-Framework wie Laravel, Django, Rails)
> - **Frontend + Backend getrennt** (z. B. Vue/React + REST/GraphQL API)
> - **Mobile App** (z. B. Flutter, React Native)
> ```
> Modulname | Datei(en) | Zweck | Exportierte Funktionen
> ```
>
> **Format pro Funktion:**
> `funktionsname(param: Typ): Rückgabetyp` Ein-Satz-Beschreibung
---
## Domänenmodell (geplant)
## Domänenmodell
Die Kernkonzepte des Gartenmanagers:
| Konzept | Beschreibung |
|---|---|
| `Plant` / Pflanze | Eine Pflanzenart mit Eigenschaften (Aussaatzeit, Abstand, Wasserbedarf …) |
| `Bed` / Beet | Ein physischer Gartenbereich, dem Pflanzen zugeordnet werden |
| `SowingCalendar` / Aussaatkalender | Zeitplan für Aussaat und Pflanzung je Pflanze und Jahr |
| `Task` / Aufgabe | Eine zu erledigende Gartenarbeit mit Fälligkeitsdatum |
| `WateringSchedule` / Bewässerungsplan | Regelmäßige Bewässerungsintervalle je Beet oder Pflanze |
| Entität | Felder (geplant) | Beziehungen |
|---|---|---|
| `Plant` | name, sowingStart, sowingEnd, waterInterval, spacing | gehört zu Bed |
| `Bed` | name, width, length, location | enthält viele Plants |
| `SowingCalendar` | year, plantId, sowDate, plantDate | referenziert Plant |
| `Task` | title, dueDate, done, bedId? | optional zu Bed |
| `WateringSchedule` | bedId/plantId, intervalDays, lastWatered | referenziert Bed oder Plant |
---
@@ -51,6 +63,18 @@ Die Kernkonzepte des Gartenmanagers:
---
## Schnittstellen
## Schnittstellen / API
> Noch festzulegen.
> Noch festzulegen. Hier Endpunkte mit Kurzbeschreibung eintragen:
>
> ```
> GET /api/plants alle Pflanzen
> POST /api/plants neue Pflanze anlegen
> ...
> ```
---
## Konfiguration
> Relevante Umgebungsvariablen und Konfigurationsdateien hier auflisten.