docs: aktualisiere alle MD-Dateien auf v1.8

- 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
+41 -34
View File
@@ -1,34 +1,41 @@
# AGENTS.md — Arbeits-Konventionen für Rippy # AGENTS.md — Arbeits-Konventionen für Rippy
## Grundregeln ## Grundregeln
**1. Plan vor Code.** Vor jeder Etappe: Klare Akzeptanzkriterien schreiben, dann bauen. **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. **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. **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. **4. Deutsch-Nicht-Entwickler.** Der Commander liest alles — Variablennamen auf Englisch, aber Kommentare und Docs auf Deutsch.
## Workflow ## Workflow
1. **Read:** KONZEPT.md + ROADMAP.md lesen. Verstehen, welche Etappe dran ist. 1. **Read:** KONZEPT.md + ROADMAP.md lesen. Verstehen, welche Etappe dran ist.
2. **Plan:** Was genau soll diese Sitzung bauen? Eine Zeile. 2. **Plan:** Was genau soll diese Sitzung bauen? Eine Zeile.
3. **Build:** Code schreiben, testen, committen. 3. **Build:** Code schreiben, testen, committen.
4. **Verify:** `docker compose up` — funktioniert das Ganze? 4. **Verify:** `docker compose up` — funktioniert das Ganze?
5. **Savepoint:** SAVEPOINT.md aktualisieren. Nächster Chat beginnt nicht von Null. 5. **Savepoint:** SAVEPOINT.md aktualisieren. Nächster Chat beginnt nicht von Null.
## Modelle je Aufgabe ## Modelle je Aufgabe
- **Planung:** Heavy-Modell (Reasoning) für Architektur-Entscheidungen. - **Planung:** Heavy-Modell (Reasoning) für Architektur-Entscheidungen.
- **Bauen:** schnelles Coding-Modell. - **Bauen:** schnelles Coding-Modell.
- **Review:** Heavy nochmal für Code-Review vor Merge. - **Review:** Heavy nochmal für Code-Review vor Merge.
## Docker-Praxis ## Docker-Praxis
- Alles läuft in Containern: `docker compose up -d` - Alles läuft in Containern: `docker compose up -d`
- Keine System-Pakete auf dem Host — alles im Container. - Keine System-Pakete auf dem Host — alles im Container.
- Dockerfile immer multi-stage, kleinste Images. - Dockerfile immer multi-stage, kleinste Images.
## Was NICHT gebaut wird ## Was NICHT gebaut wird
- Kein Code direkt im Host-OS. - Kein Code direkt im Host-OS.
- Kein Proxmox-LXC-Nesting-Workaround — das Projekt lebt bewusst in normalem Docker. - Kein Proxmox-LXC-Nesting-Workaround — das Projekt lebt bewusst in normalem Docker.
- Kein ARM-Fork — Rippy ist ein Eigenbau von Grund auf. - 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)
+7
View File
@@ -22,3 +22,10 @@ docker compose up -d
``` ```
Ich bereite das Skript vor: 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
+9
View File
@@ -36,3 +36,12 @@ Ich schlage **Option A (SSH)** vor:
3. Arcane WebUI → ich erstelle ein Zip-Package 3. Arcane WebUI → ich erstelle ein Zip-Package
Und: **Wo genau** sollen die Dateien auf LXC 106 hin? (Pfad angeben) 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
+6
View File
@@ -54,3 +54,9 @@ Oder wenn du Arcane's Standard nutzt:
``` ```
/app/data/projects/rippy /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
+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 ### Schritt 5: Git Sync erneut starten
Rippy Project importieren und deployen. 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
+9
View File
@@ -5,6 +5,9 @@
- **Arcane:** Erreichbar unter http://192.168.178.162:3552 - **Arcane:** Erreichbar unter http://192.168.178.162:3552
- **Docker:** Installiert und läuft - **Docker:** Installiert und läuft
- **Projects Directory:** /home/arcane/projects - **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 ## Nächste Schritte in Arcane
@@ -47,3 +50,9 @@ volumes:
``` ```
## Status: Arcane läuft, Rippy Import bereit ## Status: Arcane läuft, Rippy Import bereit
## Rippy Features
- ✅ Dark Mode mit Theme-Toggle
- ✅ React UI mit TailwindCSS
- ✅ Einstellungen mit Tab-Struktur
- ✅ Sidebar Navigation
+3 -1
View File
@@ -101,7 +101,9 @@ docker compose up -d
- [x] Etappe 4: Jellyfin-Formatierung - [x] Etappe 4: Jellyfin-Formatierung
- [x] Etappe 5: API + Auth + WebUI - [x] Etappe 5: API + Auth + WebUI
- [x] Etappe 6: Sicherheit + Compliance - [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
--- ---
+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:** **Was gebaut wird:**
- Proxmox LXC Template (Debian 12 Slim) - React UI mit TailwindCSS
- Ansible Playbooks für die Installation - Sidebar Navigation
- Dokumentation: Installation, Konfiguration, Troubleshooting - Einstellungen mit Tab-Struktur
- Beispiel `docker-compose.yml` mit allen Umgebungsvariablen - Dark Mode mit Theme-Toggle und localStorage persistence
- Makefile für lokale Entwicklung - Status-Badges und StatCards mit Dark Mode Support
**Fertig wenn:** **Fertig wenn:**
- Ein neuer Container ist in 5 Minuten bereit - UI mit Dark Mode läuft
- `make up` startet alles lokal für Entwicklung - Navigation und Einstellungen funktionieren
- Dokumentation ist vollständig und verständlich - 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.
--- ---