From 6af5df32f6527809bf5d857db80ad4292a26b49e Mon Sep 17 00:00:00 2001 From: Faultier314 <114798763+Faultier314@users.noreply.github.com> Date: Sun, 5 Apr 2026 22:32:58 +0200 Subject: [PATCH] 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 --- .claude/scripts/bump.sh | 62 +++++++++++++++++++++++++++ .claude/scripts/new-feature.sh | 41 ++++++++++++++++++ .claude/session-context.md | 42 ++++++++++++++++++ .claude/settings.local.json | 12 ++++++ CHANGELOG.md | 13 ++++++ CLAUDE.md | 32 ++++++-------- VERSION | 2 +- docs/project-structure.md | 78 ++++++++++++++++++++++------------ 8 files changed, 235 insertions(+), 47 deletions(-) create mode 100644 .claude/scripts/bump.sh create mode 100644 .claude/scripts/new-feature.sh create mode 100644 .claude/session-context.md create mode 100644 .claude/settings.local.json diff --git a/.claude/scripts/bump.sh b/.claude/scripts/bump.sh new file mode 100644 index 0000000..8720079 --- /dev/null +++ b/.claude/scripts/bump.sh @@ -0,0 +1,62 @@ +#!/usr/bin/env bash +# bump.sh – Version erhöhen, CHANGELOG aktualisieren, committen und pushen +# +# Verwendung: +# bash .claude/scripts/bump.sh patch "Beschreibung der Änderung" +# bash .claude/scripts/bump.sh minor "Beschreibung der Änderung" +# bash .claude/scripts/bump.sh major "Beschreibung der Änderung" + +set -euo pipefail + +BUMP_TYPE="${1:-patch}" +MESSAGE="${2:-}" + +if [[ -z "$MESSAGE" ]]; then + echo "Fehler: Beschreibung fehlt." + echo "Verwendung: bash .claude/scripts/bump.sh [patch|minor|major] \"Beschreibung\"" + exit 1 +fi + +ROOT="$(git rev-parse --show-toplevel)" +VERSION_FILE="$ROOT/VERSION" +CHANGELOG_FILE="$ROOT/CHANGELOG.md" + +# Aktuelle Version lesen +CURRENT=$(cat "$VERSION_FILE" | tr -d '[:space:]') +IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT" + +# Version erhöhen +case "$BUMP_TYPE" in + major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;; + minor) MINOR=$((MINOR + 1)); PATCH=0 ;; + patch) PATCH=$((PATCH + 1)) ;; + *) + echo "Fehler: Ungültiger Typ '$BUMP_TYPE'. Erlaubt: patch, minor, major" + exit 1 + ;; +esac + +NEW_VERSION="$MAJOR.$MINOR.$PATCH" +DATE=$(date +%Y-%m-%d) + +echo "Bump: $CURRENT → $NEW_VERSION ($BUMP_TYPE)" + +# VERSION aktualisieren +echo "$NEW_VERSION" > "$VERSION_FILE" + +# CHANGELOG-Eintrag einfügen (nach der ersten ---) +ENTRY="## [$NEW_VERSION] - $DATE\n\n### Changed\n- $MESSAGE\n\n---\n" +# Füge nach der ersten '---' Zeile ein +awk -v entry="$ENTRY" '/^---$/ && !inserted { print; printf "%s", entry; inserted=1; next } { print }' \ + "$CHANGELOG_FILE" > "$CHANGELOG_FILE.tmp" && mv "$CHANGELOG_FILE.tmp" "$CHANGELOG_FILE" + +# Commit und Push +git -C "$ROOT" add "$VERSION_FILE" "$CHANGELOG_FILE" +git -C "$ROOT" commit -m "chore: bump version to $NEW_VERSION + +$MESSAGE + +Version: $NEW_VERSION" +git -C "$ROOT" push + +echo "Fertig: Version $NEW_VERSION committed und gepusht." diff --git a/.claude/scripts/new-feature.sh b/.claude/scripts/new-feature.sh new file mode 100644 index 0000000..e82b388 --- /dev/null +++ b/.claude/scripts/new-feature.sh @@ -0,0 +1,41 @@ +#!/usr/bin/env bash +# new-feature.sh – Feature- oder Fix-Branch aus develop erstellen und pushen +# +# Verwendung: +# bash .claude/scripts/new-feature.sh feature +# bash .claude/scripts/new-feature.sh fix +# bash .claude/scripts/new-feature.sh debug + +set -euo pipefail + +TYPE="${1:-}" +NAME="${2:-}" + +if [[ -z "$TYPE" || -z "$NAME" ]]; then + echo "Verwendung: bash .claude/scripts/new-feature.sh [feature|fix|debug] " + exit 1 +fi + +case "$TYPE" in + feature|fix|debug) ;; + *) + echo "Fehler: Ungültiger Typ '$TYPE'. Erlaubt: feature, fix, debug" + exit 1 + ;; +esac + +BRANCH="$TYPE/$NAME" +ROOT="$(git rev-parse --show-toplevel)" + +# Sicherstellen dass develop aktuell ist +echo "Wechsle zu develop und aktualisiere..." +git -C "$ROOT" checkout develop +git -C "$ROOT" pull origin develop + +# Branch erstellen und pushen +echo "Erstelle Branch: $BRANCH" +git -C "$ROOT" checkout -b "$BRANCH" +git -C "$ROOT" push -u origin "$BRANCH" + +echo "Fertig: Branch '$BRANCH' erstellt und gepusht." +echo "Aktiver Branch: $(git -C "$ROOT" branch --show-current)" diff --git a/.claude/session-context.md b/.claude/session-context.md new file mode 100644 index 0000000..3b9d684 --- /dev/null +++ b/.claude/session-context.md @@ -0,0 +1,42 @@ +# Session-Kontext + +> Claude liest diese Datei zu Beginn jeder Session. +> Claude aktualisiert sie am Ende jeder Session (Version, Branch, offene Arbeit). + +--- + +## Aktueller Stand + +| Feld | Wert | +|---|---| +| **Version** | 0.2.1 | +| **Aktiver Branch** | feature/grundstruktur | +| **Basis-Branch** | develop | +| **Zuletzt geändert** | 2026-04-05 | + +## Offene Arbeit + +- [ ] Techstack festlegen +- [ ] feature/grundstruktur → develop mergen (wenn Techstack entschieden) + +## Zuletzt abgeschlossen + +- Repo-Infrastruktur aufgebaut (CLAUDE.md, Standards, Branching, README, PR-Template) +- .gitattributes, bump.sh, new-feature.sh, session-context.md eingeführt +- Branch Protection + Squash-Merge serverseitig konfiguriert + +## Schnellreferenz + +```bash +# Version bumpen +bash .claude/scripts/bump.sh patch "Was wurde geändert" + +# Neuen Branch erstellen +bash .claude/scripts/new-feature.sh feature + +# Aktueller Branch +git branch --show-current + +# Status +git status +``` diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 0000000..43a7844 --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,12 @@ +{ + "permissions": { + "allow": [ + "Bash(curl -s -o /dev/null -w \"%{http_code}\" https://tea.jr-family.de/api/v1/repos/Admin/gartenmanager)", + "Bash(git -C c:/Projekte/Home/gartenmanager config --get credential.helper)", + "Bash(git credential:*)", + "Bash(python3 -m json.tool)", + "Bash(git -C c:/Projekte/Home/gartenmanager credential fill)", + "Bash(python3 -c \"import sys,json; r=json.load\\(sys.stdin\\); print\\('allow_squash_merge:', r.get\\('allow_squash_merge'\\), '| default_merge_style:', r.get\\('default_merge_style'\\)\\)\")" + ] + } +} diff --git a/CHANGELOG.md b/CHANGELOG.md index 629f026..f10fe01 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,19 @@ Format: `[MAJOR.MINOR.PATCH] - YYYY-MM-DD` --- +## [0.2.1] - 2026-04-05 + +### Changed +- `CLAUDE.md` auf reine Dispatch-Tabelle reduziert (keine Regelwiederholungen) +- `docs/project-structure.md` als dichte Modulreferenz-Vorlage strukturiert + +### Added +- `.claude/scripts/bump.sh` – Version + CHANGELOG + commit + push in einem Befehl +- `.claude/scripts/new-feature.sh` – Feature/Fix/Debug-Branch aus develop erstellen +- `.claude/session-context.md` – Sessionstart-Kontext (Version, Branch, offene Arbeit) + +--- + ## [0.2.0] - 2026-04-05 ### Added diff --git a/CLAUDE.md b/CLAUDE.md index 894c290..cb6cf16 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,17 +4,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## Projekt -**Gartenmanager** – eine Anwendung zur Verwaltung und Planung von Gartenaktivitäten (Pflanzen, Aussaatkalender, Aufgaben, Bewässerung etc.). +**Gartenmanager** – Anwendung zur Verwaltung von Gartenaktivitäten (Pflanzen, Beete, Aussaatkalender, Aufgaben, Bewässerung). -## Weiterführende Dokumente +## Dokumente – wo was steht | Dokument | Inhalt | |---|---| -| [docs/development-standards.md](docs/development-standards.md) | Entwicklungsstandards, Branching-Regeln, Versionierung, Workflow | -| [docs/project-structure.md](docs/project-structure.md) | Projektstruktur, Module, Funktionsübersicht | -| [docs/branching-strategy.md](docs/branching-strategy.md) | Branching-Diagramm | +| [docs/development-standards.md](docs/development-standards.md) | **Alle Regeln:** Branching, Versionierung, Workflow, Coding, Testing | +| [docs/project-structure.md](docs/project-structure.md) | **Alle Module & Funktionen** – hier zuerst lesen, bevor Quellcode geöffnet wird | +| [docs/branching-strategy.md](docs/branching-strategy.md) | Branch-Diagramm | | [CHANGELOG.md](CHANGELOG.md) | Versionshistorie | | [VERSION](VERSION) | Aktuelle Versionsnummer | +| [.claude/session-context.md](.claude/session-context.md) | **Sessionstart hier lesen:** aktiver Branch, Version, offene Arbeit | +| [.claude/scripts/](.claude/scripts/) | Automatisierungsscripts (bump, new-feature) | ## Techstack @@ -42,18 +44,10 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co # Build für Produktion # + +# Version bumpen + commit + push (patch/minor/major) +bash .claude/scripts/bump.sh patch "Beschreibung der Änderung" + +# Neuen Feature-Branch erstellen +bash .claude/scripts/new-feature.sh ``` - -## Pflichtregeln (immer befolgen) - -1. **Nie direkt nach `main` pushen/mergen** – ausschließlich per Pull-Request, und nur auf explizite Anweisung. -2. **Branching:** Jede Arbeit in einem `feature/` oder `fix/` Branch unter `develop`. Erst nach dev mergen, wenn alles fertig und alle Tests grün sind. -3. **Nach jeder Änderung:** Versionsnummer erhöhen (`VERSION` + `CHANGELOG.md`), committen und pushen. -4. **Vor Merge nach dev / PR nach main:** README.md, CHANGELOG.md und docs/ prüfen und aktualisieren. -5. **Projektstruktur-Doku** (`docs/project-structure.md`) bei jeder Funktions-/Moduländerung synchron halten. -6. **Versionierung:** `MAJOR.MINOR.PATCH` – MAJOR nur auf Anweisung, MINOR bei Features, PATCH bei Fixes/Kleinänderungen. - -## Wichtige Konventionen - -- Sprache: Deutsch für Domänenkonzepte (Pflanzen, Beet, Aussaat …), Englisch für Code-Bezeichner und Commit-Messages -- Alle Dateipfade in den `docs/`-Dokumenten aktuell halten, wenn sich die Struktur ändert diff --git a/VERSION b/VERSION index 0ea3a94..0c62199 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.2.0 +0.2.1 diff --git a/docs/project-structure.md b/docs/project-structure.md index 81f27fb..de88c16 100644 --- a/docs/project-structure.md +++ b/docs/project-structure.md @@ -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.