V2-Dev-Stand: Skala 1-10, Benefits/Concerns, DEV-Isolation und Gitea-Doku.
Bündelt die Neuentwicklung in AssigmentMonitorV2 (eigene Ports/DB), die Umstellung auf numerische Bewertungen, Meeting-Checklisten, KI-Tagging und die geplante Feedback-Kaskade — als Basis für Versionsverwaltung in Gitea. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
782678a1cf
commit
234f87d408
71 files changed
+7567
-705
No files matched your search
+115
@@ -0,0 +1,115 @@
|
||||
# Gitea — Repository-Setup (Assignment Monitor V2)
|
||||
|
||||
Dieses Projekt ist lokal ein Git-Repo auf Branch `main`. Für Gitea fehlt nur noch der Remote und der erste Push.
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
- Gitea-Zugang (Benutzerkonto auf dem Server)
|
||||
- **HTTPS + Personal Access Token** (empfohhen unter Windows / Firmennetz) **oder** SSH-Key bei Gitea hinterlegt
|
||||
- Keine Secrets im Repo: `.env` und `server/data/` sind in `.gitignore`
|
||||
|
||||
## 1. Repository in Gitea anlegen
|
||||
|
||||
1. In Gitea einloggen
|
||||
2. **„+“ → New Repository** (oder Organisation wählen, dann „New Repository“)
|
||||
3. Einstellungen:
|
||||
- **Name:** `AssigmentMonitorV2` (oder gewünschter Name)
|
||||
- **Private** (empfohlen — personenbezogene Trainingsdaten im Backup-Format)
|
||||
- **Initialize repository:** alle Häkchen **aus** (kein README, keine .gitignore — existiert lokal schon)
|
||||
4. Erstellen
|
||||
|
||||
Gitea zeigt danach die Push-URLs an, z. B.:
|
||||
|
||||
- HTTPS: `https://gitea.example.com/lars/AssigmentMonitorV2.git`
|
||||
- SSH: `git@gitea.example.com:lars/AssigmentMonitorV2.git`
|
||||
|
||||
## 2. Remote hinzufügen (lokal)
|
||||
|
||||
HTTPS (empfohlen):
|
||||
|
||||
```powershell
|
||||
cd C:\dev\AssigmentMonitorV2
|
||||
git remote add origin https://gitea.example.com/<user>/AssigmentMonitorV2.git
|
||||
git remote -v
|
||||
```
|
||||
|
||||
SSH (Alternative):
|
||||
|
||||
```powershell
|
||||
git remote add origin git@gitea.example.com:<user>/AssigmentMonitorV2.git
|
||||
```
|
||||
|
||||
## 3. Authentifizierung
|
||||
|
||||
### HTTPS — Personal Access Token (empfohlen)
|
||||
|
||||
1. Gitea → **Settings → Applications → Generate New Token**
|
||||
2. Scopes: mindestens **`write:repository`** (bzw. „repo“ je nach Gitea-Version)
|
||||
3. Beim ersten `git push`:
|
||||
- **Username:** Gitea-Benutzername
|
||||
- **Password:** der Token (nicht das Login-Passwort)
|
||||
|
||||
Windows speichert Credentials oft über den Credential Manager (`credential.helper=manager`).
|
||||
|
||||
### SSH
|
||||
|
||||
1. Key erzeugen (falls noch keiner existiert):
|
||||
|
||||
```powershell
|
||||
ssh-keygen -t ed25519 -C "lars.stommer@capgemini.com"
|
||||
```
|
||||
|
||||
2. Öffentlichen Key (`~/.ssh/id_ed25519.pub`) in Gitea unter **Settings → SSH Keys** eintragen
|
||||
3. Verbindung testen:
|
||||
|
||||
```powershell
|
||||
ssh -T git@gitea.example.com
|
||||
```
|
||||
|
||||
## 4. Ersten Push ausführen
|
||||
|
||||
```powershell
|
||||
cd C:\dev\AssigmentMonitorV2
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
Falls Gitea standardmäßig `master` erwartet und leer ist, reicht obiger Befehl. Bei Konflikt mit vorgefertigtem Initial-Commit auf dem Server:
|
||||
|
||||
```powershell
|
||||
git pull origin main --rebase
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
## 5. Täglicher Workflow
|
||||
|
||||
```powershell
|
||||
git status
|
||||
git add -A
|
||||
git commit -m "kurze Beschreibung des Warums"
|
||||
git push
|
||||
```
|
||||
|
||||
Feature-Branches (optional):
|
||||
|
||||
```powershell
|
||||
git checkout -b feature/feedback-kaskade-stufe-a
|
||||
# … arbeiten …
|
||||
git push -u origin feature/feedback-kaskade-stufe-a
|
||||
```
|
||||
|
||||
In Gitea dann Pull Request / Merge Request erstellen.
|
||||
|
||||
## Datenschutz
|
||||
|
||||
- **Nicht committen:** `.env`, `server/data/*.sqlite3`, OpenRouter-API-Keys, Produktiv-Backups mit echten Personendaten
|
||||
- **Private Repo** auf Gitea verwenden
|
||||
- Backup-JSONs aus der App nur verschlüsselt/teambasiert teilen, nicht ins Repo legen
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
| Problem | Lösung |
|
||||
|---|---|
|
||||
| `403` / `Authentication failed` | Token statt Passwort; Token-Scopes prüfen |
|
||||
| `remote origin already exists` | `git remote set-url origin <neue-url>` |
|
||||
| Große Dateien abgelehnt | Keine DB/Backups committen; ggf. Gitea-LFS nur wenn wirklich nötig |
|
||||
| SSL-Zertifikat (interne CA) | Firmen-Root-Zertifikat in Windows/Git hinterlegen oder IT fragen |
|
||||
Reference in new issue
Block a user