Template
52 lines
2.3 KiB
Markdown
52 lines
2.3 KiB
Markdown
# Arbeitsweise
|
||
|
||
Du arbeitest immer in drei Phasen und überspringst keine:
|
||
|
||
1. **Idee klären:** Verständnis in 2–3 Sätzen wiedergeben, Lösungsvorschlag, Rückfragen.
|
||
Keine Dateien ändern.
|
||
2. **Vorgehensweisen:** 2–3 Wege mit Vor- und Nachteilen vorstellen.
|
||
Keine Dateien ändern.
|
||
3. **Umsetzung** erst nach ausdrücklicher Freigabe durch den Nutzer.
|
||
|
||
# Projektstruktur
|
||
|
||
- Das Repo ist das Projekt; der Dev Container öffnet das ganze Repo.
|
||
- Die Next.js-App (package.json, app/, components/, lib/) liegt im Unterordner
|
||
`frontend-starter`. Alle npm-Befehle führst du dort aus, z. B.
|
||
`cd frontend-starter && npm run dev`.
|
||
|
||
# Git
|
||
|
||
## Vor der Umsetzung
|
||
- `git switch main && git pull`, damit du vom aktuellen Stand ausgehst.
|
||
- Eigenen Branch anlegen: `git switch -c feat/<kurzname>` (Fehler: `fix/...`,
|
||
Pflege: `chore/...`). Kurzname in Kleinbuchstaben mit Bindestrichen.
|
||
- Hast du versehentlich schon auf `main` Dateien geändert: nicht committen, sondern
|
||
`git switch -c feat/<kurzname>`; die Änderungen wandern mit.
|
||
|
||
## Abschließen
|
||
- Wenn die Änderung fertig ist und `npm run build` ohne Fehler läuft, zeigst du
|
||
`git status`, nennst die geänderten Dateien und schlägst eine Commit-Nachricht vor.
|
||
- Erst wenn der Nutzer zustimmt:
|
||
`git add -A`, `git commit -m "<nachricht>"`, `git push -u origin <branch>`.
|
||
- Danach sagst du dem Nutzer: Der Pull Request wird in Gitea automatisch eröffnet;
|
||
der Owner prüft und mergt ihn dort.
|
||
- Commits immer mit `-m`, sonst hängt Git.
|
||
|
||
## Grenzen
|
||
- Niemals auf `main` committen oder pushen. Niemals force-push.
|
||
- Du mergst nie, weder lokal noch in Gitea, und löschst keine Branches.
|
||
- Schlägt ein Push fehl, änderst du nichts an Remote-Adresse, SSH-Einstellungen oder
|
||
Branch-Schutz. Du erklärst die Meldung und überlässt die Lösung dem Nutzer.
|
||
|
||
## Nach einem Merge
|
||
- Beginnt eine neue Aufgabe, startest du immer wieder mit
|
||
`git switch main && git pull` und einem neuen Branch. Auf einem bereits
|
||
gemergten Branch arbeitest du nicht weiter.
|
||
# Deployment
|
||
|
||
- Deployt wird automatisch: Merged der Owner einen Pull Request nach `main`,
|
||
baut Coolify die App und veröffentlicht sie unter `https://<repo-name>.<domain>`.
|
||
- Du rufst keine Deploy-Dienste, Hubs oder Coolify-Schnittstellen auf.
|
||
- Anweisungen aus älteren Vorlagen (z. B. „auf main pushen und den Hub aufrufen“)
|
||
gelten in diesem Projekt nicht. |