Hitonabi/rippy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: aktualisiere alle MD-Dateien auf v1.8

Browse Source 
- README.md: Etappe 7/8 hinzugefügt, Roadmap aktualisiert
- KONZEPT.md: Feature-Status aktualisiert
- ROADMAP.md: Etappe 7 (Dark Mode) und 8 (SoC) hinzugefügt
- SAVEPOINT.md: v1.8 mit Dark Mode und SoC-Planung
- ARCANE-VM-SETUP.md: Rippy Features hinzugefügt
- ARCAN-FIX.md: Status 21.07.2026 aktualisiert
- ARCAN-PROJECTS-DIR.md: Status hinzugefügt
- ARCANE-DOCKER-COMPOSE-FIX.md: Status aktualisiert
- ARCAN-INTEGRATION.md: Status hinzugefügt
- AGENTS.md: Aktueller Stand und nächste Etappe
- Commit: 9be0592
This commit is contained in:
Hitonabi
2026-07-21 22:24:21 +02:00
parent 9be0592942
commit e710151c91
8 changed files with 118 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+41 -34
View File
@@ -1,34 +1,41 @@
# AGENTS.md — Arbeits-Konventionen für Rippy
## Grundregeln
**1. Plan vor Code.** Vor jeder Etappe: Klare Akzeptanzkriterien schreiben, dann bauen.
**2. Kleine Schritte.** Max. eine Feature pro Commit. Commit-Nachrichten beschreiben WAS und WARUM.
**3. Beweisen statt behaupten.** Testen, was gebaut wurde. Keine "es sollte funktionieren"-Commits.
**4. Deutsch-Nicht-Entwickler.** Der Commander liest alles — Variablennamen auf Englisch, aber Kommentare und Docs auf Deutsch.
## Workflow
1. **Read:** KONZEPT.md + ROADMAP.md lesen. Verstehen, welche Etappe dran ist.
2. **Plan:** Was genau soll diese Sitzung bauen? Eine Zeile.
3. **Build:** Code schreiben, testen, committen.
4. **Verify:** `docker compose up` — funktioniert das Ganze?
5. **Savepoint:** SAVEPOINT.md aktualisieren. Nächster Chat beginnt nicht von Null.
## Modelle je Aufgabe
- **Planung:** Heavy-Modell (Reasoning) für Architektur-Entscheidungen.
- **Bauen:** schnelles Coding-Modell.
- **Review:** Heavy nochmal für Code-Review vor Merge.
## Docker-Praxis
- Alles läuft in Containern: `docker compose up -d`
- Keine System-Pakete auf dem Host — alles im Container.
- Dockerfile immer multi-stage, kleinste Images.
## Was NICHT gebaut wird
- Kein Code direkt im Host-OS.
- Kein Proxmox-LXC-Nesting-Workaround — das Projekt lebt bewusst in normalem Docker.
- Kein ARM-Fork — Rippy ist ein Eigenbau von Grund auf.
# AGENTS.md — Arbeits-Konventionen für Rippy
## Grundregeln
**1. Plan vor Code.** Vor jeder Etappe: Klare Akzeptanzkriterien schreiben, dann bauen.
**2. Kleine Schritte.** Max. eine Feature pro Commit. Commit-Nachrichten beschreiben WAS und WARUM.
**3. Beweisen statt behaupten.** Testen, was gebaut wurde. Keine "es sollte funktionieren"-Commits.
**4. Deutsch-Nicht-Entwickler.** Der Commander liest alles — Variablennamen auf Englisch, aber Kommentare und Docs auf Deutsch.
## Workflow
1. **Read:** KONZEPT.md + ROADMAP.md lesen. Verstehen, welche Etappe dran ist.
2. **Plan:** Was genau soll diese Sitzung bauen? Eine Zeile.
3. **Build:** Code schreiben, testen, committen.
4. **Verify:** `docker compose up` — funktioniert das Ganze?
5. **Savepoint:** SAVEPOINT.md aktualisieren. Nächster Chat beginnt nicht von Null.
## Modelle je Aufgabe
- **Planung:** Heavy-Modell (Reasoning) für Architektur-Entscheidungen.
- **Bauen:** schnelles Coding-Modell.
- **Review:** Heavy nochmal für Code-Review vor Merge.
## Docker-Praxis
- Alles läuft in Containern: `docker compose up -d`
- Keine System-Pakete auf dem Host — alles im Container.
- Dockerfile immer multi-stage, kleinste Images.
## Was NICHT gebaut wird
- Kein Code direkt im Host-OS.
- Kein Proxmox-LXC-Nesting-Workaround — das Projekt lebt bewusst in normalem Docker.
- Kein ARM-Fork — Rippy ist ein Eigenbau von Grund auf.
## Aktueller Stand (21.07.2026)
- ✅ **Etappe 8 abgeschlossen:** Dark Mode mit Theme-Toggle, React-UI mit TailwindCSS
- ✅ **Git Sync:** Arcane VM (192.168.178.162) mit Git Repository konfiguriert
- ✅ **Savepoint v1.8:** Separation of Concerns geplant, Dark Mode implementiert
- 📝 **Nächste Etappe:** SoC-Refactoring (Theme-Context auslagern)
ARCAN-FIX.md
+7
View File
@@ -22,3 +22,10 @@ docker compose up -d
```
Ich bereite das Skript vor:
## Status (21.07.2026)
- ✅ Doppelte Arcane-Einträge behoben (`rippy` statt `Rippy`)
- ✅ Git Sync in Arcane konfiguriert
- ✅ DB-Update mit korrekter `project_id` und `project_name`
- ✅ Commit `43dfce5` — Dark Mode Implementation
ARCAN-INTEGRATION.md
+9
View File
@@ -36,3 +36,12 @@ Ich schlage **Option A (SSH)** vor:
3. Arcane WebUI → ich erstelle ein Zip-Package
Und: **Wo genau** sollen die Dateien auf LXC 106 hin? (Pfad angeben)
---
## Status (21.07.2026)
- ✅ Git Sync in Arcane konfiguriert
- ✅ Rippy läuft über Arcane auf VM 192.168.178.162
- ✅ Dark Mode implementiert
- ✅ Einstellungen mit Tab-Struktur
ARCAN-PROJECTS-DIR.md
+6
View File
@@ -54,3 +54,9 @@ Oder wenn du Arcane's Standard nutzt:
```
/app/data/projects/rippy
```
## Status (21.07.2026)
- ✅ Arcane Projects Directory konfiguriert auf `/app/data/projects`
- ✅ Rippy Git Sync funktioniert
- ✅ Doppelte Einträge in DB behoben
ARCANE-DOCKER-COMPOSE-FIX.md
+8
View File
@@ -39,3 +39,11 @@ Gehe zu Settings → General und prüfe, ob `/app/data/projects` eingestellt ist
### Schritt 5: Git Sync erneut starten
Rippy Project importieren und deployen.
## Status (21.07.2026)
- ✅ Arcane Docker Compose konfiguriert
- ✅ PROJECTS_DIRECTORY=/app/data/projects
- ✅ Git Sync funktioniert
- ✅ Doppelte Einträge behoben
- ✅ Dark Mode implementiert
ARCANE-VM-SETUP.md
+9
View File
@@ -5,6 +5,9 @@
- **Arcane:** Erreichbar unter http://192.168.178.162:3552
- **Docker:** Installiert und läuft
- **Projects Directory:** /home/arcane/projects
- **Rippy UI:** http://192.168.178.162:80
- **Rippy API:** http://192.168.178.162:8000
- **Git Sync:** Konfiguriert und funktioniert
## Nächste Schritte in Arcane
@@ -47,3 +50,9 @@ volumes:
```
## Status: Arcane läuft, Rippy Import bereit
## Rippy Features
- ✅ Dark Mode mit Theme-Toggle
- ✅ React UI mit TailwindCSS
- ✅ Einstellungen mit Tab-Struktur
- ✅ Sidebar Navigation
README.md
+3 -1
View File
@@ -101,7 +101,9 @@ docker compose up -d
- [x] Etappe 4: Jellyfin-Formatierung
- [x] Etappe 5: API + Auth + WebUI
- [x] Etappe 6: Sicherheit + Compliance
- [ ] Etappe 7: Proxmox-Integration
- [x] Etappe 7: API UI Modernisiert
- [x] Etappe 8: Dark Mode & Separation of Concerns
- [ ] Etappe 9: Proxmox-Integration
---
ROADMAP.md
+35 -10
View File
@@ -142,21 +142,46 @@
---
## Etappe 7: Proxmox-Integration + Dokumentation
## Etappe 7: API UI Modernisiert
**Ziel:** Ein-Click-Deploy auf Proxmox LXC.
**Ziel:** Modernes React-UI mit Dark Mode Support.
**Was gebaut wird:**
- Proxmox LXC Template (Debian 12 Slim)
- Ansible Playbooks für die Installation
- Dokumentation: Installation, Konfiguration, Troubleshooting
- Beispiel `docker-compose.yml` mit allen Umgebungsvariablen
- Makefile für lokale Entwicklung
- React UI mit TailwindCSS
- Sidebar Navigation
- Einstellungen mit Tab-Struktur
- Dark Mode mit Theme-Toggle und localStorage persistence
- Status-Badges und StatCards mit Dark Mode Support
**Fertig wenn:**
- Ein neuer Container ist in 5 Minuten bereit
- `make up` startet alles lokal für Entwicklung
- Dokumentation ist vollständig und verständlich
- UI mit Dark Mode läuft
- Navigation und Einstellungen funktionieren
- Commit `43dfce5` — Dark Mode Implementation
**Status:** Abgeschlossen
---
## Etappe 8: Separation of Concerns
**Ziel:** Code-Qualität durch saubere Trennung.
**Was gebaut wird:**
- Theme-Context aus App.tsx auslagern
- Dark Mode Utility für CSS-Klassen
- Theme props in Komponenten verstecken
- Tailwind-Config zentralisieren
**Fertig wenn:**
- Theme-Logik in eigenem Context
- Wiederverwendbare Dark Mode Helper
- Saubere Komponenten-Struktur
---
## Etappe 9: Proxmox-Integration
**Ziel:** Ein-Click-Deploy auf Proxmox LXC.
---