From 946a47f14ba2eac9285db405c4e3edcb3de95d61 Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 24 Mar 2025 10:16:15 +0100 Subject: [PATCH 01/28] upgrade --- README.md | 63 ++++++++-- Tree.md | 34 +++--- "n\303\244chste_Schritte/workflow_upgrade.md" | 111 ++++++++++++++++++ 3 files changed, 183 insertions(+), 25 deletions(-) create mode 100644 "n\303\244chste_Schritte/workflow_upgrade.md" diff --git a/README.md b/README.md index e8ece62..0552e3f 100644 --- a/README.md +++ b/README.md @@ -78,14 +78,61 @@ Eine **Progressive Web App (PWA)** zur **Verwaltung von Befehlen** (z. B. Docker ## 3. Goldanker CommandService (Beispiel in FastAPI) ### 3.1 Aufbau -``` -goldanker_commands/ - ├── Dockerfile - ├── requirements.txt - ├── main.py <-- FastAPI-Code - ├── befehle.json <-- Serverseitig gespeichert - └── ... -``` + +
+ befehlsbibliothek/ + +
+ .github/ +
workflows/ +
  • deploy.yml – GitHub Actions Workflow: automatisches Deployment auf GitHub Pages
+
+
+ +
+ public/ +
  • vite.svg – Platzhalter-/Standard-Icon für die App
+
+ +
+ src/ +
+ assets/ +
  • styles.css – Globale CSS-Stile
+
+
+ components/ +
  • CommandItem.vue – Kachel-Komponente
+
+
+ data/ +
  • befehle.json – JSON-Daten (Frontend)
+
+
    +
  • App.vue – Haupt-Komponente
    • +
  • main.js – Einstiegspunkt für Vue-App
    • +
+
+ +
+ goldanker_commands/ +
    +
  • Dockerfile – Build-Anleitung für Backend
    • +
  • requirements.txt – Python-Abhängigkeiten
    • +
  • main.py – FastAPI Backend
    • +
  • befehle.json – Serverseitige Daten
    • +
+
+ + +
+ ### 3.2 Dockerfile ```Dockerfile diff --git a/Tree.md b/Tree.md index 337aed2..c6002b9 100644 --- a/Tree.md +++ b/Tree.md @@ -1,26 +1,26 @@ befehlsbibliothek/ ├── .github/ │ └── workflows/ -│ └── deploy.yml # GitHub Actions Workflow für Deployment +│ └── deploy.yml # GitHub Actions Workflow: automatisches Deployment auf GitHub Pages ├── public/ -│ └── vite.svg +│ └── vite.svg # Platzhalter-/Standard-Icon für die App ├── src/ │ ├── assets/ -│ │ └── styles.css # Globale CSS-Datei +│ │ └── styles.css # Globale CSS-Stile inkl. Farbverläufe, Schriftarten, Kachel-Design │ ├── components/ -│ │ └── CommandItem.vue +│ │ └── CommandItem.vue # Einzelne Befehlskachel-Komponente (Darstellung + Interaktion) │ ├── data/ -│ │ └── befehle.json # Beispiel-Befehlsdaten -│ ├── App.vue -│ └── main.js +│ │ └── befehle.json # Alle Befehle als JSON (Frontend-Ansicht) +│ ├── App.vue # Haupt-Vue-Komponente mit Layout (Bibliothek & Arbeitsfläche) +│ └── main.js # Einstiegspunkt für Vue-App, Registrierung von Plugins (Tippy, PWA) ├── goldanker_commands/ -│ ├── Dockerfile -│ ├── requirements.txt -│ ├── main.py <-- FastAPI-Code -│ ├── befehle.json <-- Serverseitig gespeichert -│ └── ... -├── .gitignore -├── index.html -├── package.json -├── README.md -└── vite.config.js \ No newline at end of file +│ ├── Dockerfile # Build-Anleitung für den FastAPI-Microservice (Backend) +│ ├── requirements.txt # Python-Abhängigkeiten für FastAPI (Backend) +│ ├── main.py # FastAPI-Backend (CRUD-API für befehle.json) +│ ├── befehle.json # Serverseitig gespeicherte Befehle (wird von der API genutzt) +│ └── ... # Weitere Backend-Dateien (optional erweiterbar) +├── .gitignore # Git-Ignore-Regeln (z. B. node_modules, dist, etc.) +├── index.html # HTML-Startpunkt der App, lädt Vue & registriert PWA +├── package.json # Node.js-Projektkonfiguration: Abhängigkeiten, Scripts etc. +├── README.md # Projektbeschreibung, Setup-Anleitung und Funktionsübersicht +└── vite.config.js # Vite-Konfiguration (inkl. PWA-Plugin, Pfadoptionen) diff --git "a/n\303\244chste_Schritte/workflow_upgrade.md" "b/n\303\244chste_Schritte/workflow_upgrade.md" new file mode 100644 index 0000000..466ff1e --- /dev/null +++ "b/n\303\244chste_Schritte/workflow_upgrade.md" @@ -0,0 +1,111 @@ +Dein aktueller Workflow mit der **Befehlsbibliothek** ist schon richtig stark aufgestellt – du hast Vue, PWA, Drag & Drop, FastAPI als Backend (Goldanker CommandService) und sogar GitHub Actions für automatisiertes Deployment im Einsatz. Aber du kannst das Ganze noch **viel produktiver, modularer und zukunftssicherer** machen. + +--- + +## 🚀 **Wie du deinen Workflow verbessern kannst** + +### 🔁 1. **Befehle als lebendige Ressource** +Aktuell liegt deine `befehle.json` als Datei vor. Du könntest daraus eine **API-gesteuerte Datenquelle** machen: + +- Nutze den `Goldanker_CommandService`, um Befehle nicht nur anzuzeigen, sondern auch **hinzuzufügen, zu bearbeiten und zu löschen**. +- Dadurch wird deine Bibliothek zu einem echten Tool – wie ein **Command-CMS für Developer**. + +📌 *Vorteil:* Du musst die Datei nicht manuell bearbeiten, sondern kannst alles in der Oberfläche steuern – inklusive Git-Commit per Hook. + +--- + +### 💡 2. **Live-Interaktion mit deinem System** + +Statt nur Befehle darzustellen, könntest du optional auch: +- **Terminal-Output simulieren**, z. B. für `docker ps` oder `kubectl get pods`. +- **Befehle wirklich ausführen** (lokal im Container über einen `command-runner` Service – optional und sicher!) + +📌 *Vorteil:* Die Bibliothek wird interaktiv – ein Spielplatz und gleichzeitig Werkzeug. + +--- + +### 🧱 3. **Modularer Aufbau & Kategorien erweitern** +Mit der Kategorie-Struktur aus `Roadmap_v2.md` kannst du systematisch dein ganzes **Goldfruit-Ökosystem** abbilden: + +| Agent | Kategorie | Beispiel-Befehle | +|------------------|----------------------------|---------------------------------------| +| Goldstrom | Monitoring & Prometheus | `prometheus --config.file=...` | +| Goldfeder | Git & Docs | `git log`, `pandoc` | +| Goldanker | APIs, GitHub/GitLab | `gh`, `curl`, `gitlab-runner exec` | +| DashGold | Visualisierung | `grafana-cli plugins install` | +| TensorGold | Training, ML-Tools | `torchrun`, `optuna`, `ray` | +| GoldChain | IPFS, Ethereum, Wallet | `ipfs add`, `geth`, `clef` | + +📌 *Vorteil:* Du trainierst dich und deine Agenten direkt mit der Struktur, die später dein Backend bildet. + +--- + +### 🔄 4. **Synchronisiertes Git-Repo (Goldanker als Git-Committer)** + +Nach jedem `POST`, `PUT`, `DELETE` in deiner API kannst du automatisch: +- ein `git add`, `git commit` und `git push` triggern. +- so bleibt `befehle.json` **immer versioniert** und auf GitHub synchron. + +> 🎯 Mit `subprocess` oder GitHub API in FastAPI umsetzbar. + +--- + +### ☁️ 5. **Backend in Microservices aufteilen** +Jetzt hast du: +``` +goldanker_commands/ + └─ main.py (FastAPI) +``` + +Später könntest du das in Module wie `CommandService`, `UserService`, `SearchService` splitten und mit Kafka verbinden → perfekt für dein Triangle-Pattern im Goldfruit-System. + +--- + +### ⚡ 6. **Workspace teilen & exportieren** +Momentan ist dein Workspace `localStorage`-basiert. + +📌 *Zukunftsidee*: +- Button: „Workspace exportieren“ → JSON-Datei (oder QR-Code!) +- oder: "Workspace teilen" → Push an Goldanker & Link zurückbekommen. + +So kannst du deine Arbeitsfläche mit anderen teilen oder auf mehreren Geräten nutzen. + +--- + +## 🛠️ **Wie du das Tool weiterentwickeln könntest** + +### 🔮 **Nächste Ausbaustufen für die Befehlsbibliothek** + +| Funktion | Nutzen | +|------------------------------|----------------------------------------------------| +| **Benutzerverwaltung** | Verschiedene User mit Rechten, Rollen, Favoriten | +| **Versionierung pro Befehl** | Änderungen nachverfolgbar, wie bei GitHub Files | +| **Vorschau für Befehle** | Markdown-Preview oder Beispiel-Ausgabe anzeigen | +| **Markdown-Export** | Arbeitsfläche als Dev-Doku exportieren (PDF / MD) | +| **Mobile Optimierung** | Per Smartphone schnell einen Befehl nachsehen | +| **GPT-Integration** | Automatisch neue Befehle vorschlagen lassen | +| **CI/CD Integration** | Befehle gleich als GitLab/YAML-Jobs exportieren | + +--- + +## 🧭 Zusammenfassung: Optimierter Workflow + +1. **Frontend (PWA):** + - Kachel-Design, Drag & Drop, Kategorien, Tooltip-Infos + +2. **Backend (Goldanker):** + - REST-API mit FastAPI (CRUD für `befehle.json`) + - Optional: Command-Ausführung, Git-Autosync + +3. **CI/CD:** + - GitHub Actions oder GitLab zum automatischen Deployment + +4. **Ausbaustufen:** + - Teilen von Workspaces + - GPT-gestützte Befehlsvorschläge + - Microservice-Architektur + - Integration mit Goldfruit-Agenten + +--- + +Wenn du magst, kann ich dir den nächsten konkreten Schritt vorschlagen – z. B. `POST /commands`-Formular bauen, oder `vue-draggable-next` implementieren. Sag einfach, in welchem Bereich du loslegen willst. \ No newline at end of file From d413ff1bcc962f05add8fbc83fd5ae9fedc517ac Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 24 Mar 2025 10:42:39 +0100 Subject: [PATCH 02/28] add files --- Tree.md | 53 +++++------ docker-compose.yml | 12 +++ goldanker_commands/Dockerflile | 9 ++ goldanker_commands/main.py | 58 ++++++++++++ src/App.vue | 160 +++++++++++++++++++++++++++++---- 5 files changed, 248 insertions(+), 44 deletions(-) create mode 100644 docker-compose.yml create mode 100644 goldanker_commands/Dockerflile create mode 100644 goldanker_commands/main.py diff --git a/Tree.md b/Tree.md index c6002b9..43c63d2 100644 --- a/Tree.md +++ b/Tree.md @@ -1,26 +1,27 @@ -befehlsbibliothek/ -├── .github/ -│ └── workflows/ -│ └── deploy.yml # GitHub Actions Workflow: automatisches Deployment auf GitHub Pages -├── public/ -│ └── vite.svg # Platzhalter-/Standard-Icon für die App -├── src/ -│ ├── assets/ -│ │ └── styles.css # Globale CSS-Stile inkl. Farbverläufe, Schriftarten, Kachel-Design -│ ├── components/ -│ │ └── CommandItem.vue # Einzelne Befehlskachel-Komponente (Darstellung + Interaktion) -│ ├── data/ -│ │ └── befehle.json # Alle Befehle als JSON (Frontend-Ansicht) -│ ├── App.vue # Haupt-Vue-Komponente mit Layout (Bibliothek & Arbeitsfläche) -│ └── main.js # Einstiegspunkt für Vue-App, Registrierung von Plugins (Tippy, PWA) -├── goldanker_commands/ -│ ├── Dockerfile # Build-Anleitung für den FastAPI-Microservice (Backend) -│ ├── requirements.txt # Python-Abhängigkeiten für FastAPI (Backend) -│ ├── main.py # FastAPI-Backend (CRUD-API für befehle.json) -│ ├── befehle.json # Serverseitig gespeicherte Befehle (wird von der API genutzt) -│ └── ... # Weitere Backend-Dateien (optional erweiterbar) -├── .gitignore # Git-Ignore-Regeln (z. B. node_modules, dist, etc.) -├── index.html # HTML-Startpunkt der App, lädt Vue & registriert PWA -├── package.json # Node.js-Projektkonfiguration: Abhängigkeiten, Scripts etc. -├── README.md # Projektbeschreibung, Setup-Anleitung und Funktionsübersicht -└── vite.config.js # Vite-Konfiguration (inkl. PWA-Plugin, Pfadoptionen) +. +├── docker-compose.yml +├── .gitignore +├── goldanker_commands +│   ├── Dockerflile +│   └── main.py +├── index.html +├── nächste_Schritte +│   ├── Roadmap_v1.md +│   ├── Roadmap_v2.md +│   └── workflow_upgrade.md +├── package.json +├── package-lock.json +├── README.md +├── src +│   ├── App.vue +│   ├── assets +│   │   └── styles.css +│   ├── components +│   │   └── CommandItem.vue +│   ├── data +│   │   └── befehle.json +│   └── main.js +├── Tree.md +└── vite.config.js + +7 directories, 18 files diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..e926857 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,12 @@ +version: '3.8' +services: + goldanker_commands: + build: ./goldanker_commands + container_name: goldanker_commands + environment: + - COMMANDS_JSON_PATH=/app/befehle.json + volumes: + - ./goldanker_commands/befehle.json:/app/befehle.json + ports: + - "8000:8000" + # depends_on, networks, etc. \ No newline at end of file diff --git a/goldanker_commands/Dockerflile b/goldanker_commands/Dockerflile new file mode 100644 index 0000000..8c851c3 --- /dev/null +++ b/goldanker_commands/Dockerflile @@ -0,0 +1,9 @@ +FROM python:3.10-slim + +WORKDIR /app +COPY requirements.txt ./ +RUN pip install --no-cache-dir -r requirements.txt + +COPY . /app + +CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] \ No newline at end of file diff --git a/goldanker_commands/main.py b/goldanker_commands/main.py new file mode 100644 index 0000000..d9667ae --- /dev/null +++ b/goldanker_commands/main.py @@ -0,0 +1,58 @@ +from fastapi import FastAPI, HTTPException +from pydantic import BaseModel +from typing import List, Optional +import json +import os + +app = FastAPI() + +JSON_FILE = os.getenv("COMMANDS_JSON_PATH", "./befehle.json") + +class Command(BaseModel): + name: str + command: str + category: str + description: Optional[str] = None + info: Optional[str] = None + +def load_commands() -> List[Command]: + if not os.path.exists(JSON_FILE): + return [] + with open(JSON_FILE, "r", encoding="utf-8") as f: + data = json.load(f) + return [Command(**cmd) for cmd in data] + +def save_commands(commands: List[Command]): + with open(JSON_FILE, "w", encoding="utf-8") as f: + json.dump([cmd.dict() for cmd in commands], f, indent=2, ensure_ascii=False) + +@app.get("/commands", response_model=List[Command]) +def get_commands(): + return load_commands() + +@app.post("/commands", response_model=Command) +def create_command(new_cmd: Command): + commands = load_commands() + # Optional: check duplicates + commands.append(new_cmd) + save_commands(commands) + return new_cmd + +@app.put("/commands/{cmd_name}", response_model=Command) +def update_command(cmd_name: str, updated_cmd: Command): + commands = load_commands() + for i, c in enumerate(commands): + if c.name == cmd_name: + commands[i] = updated_cmd + save_commands(commands) + return updated_cmd + raise HTTPException(status_code=404, detail="Command not found") + +@app.delete("/commands/{cmd_name}") +def delete_command(cmd_name: str): + commands = load_commands() + filtered = [c for c in commands if c.name != cmd_name] + if len(filtered) == len(commands): + raise HTTPException(status_code=404, detail="Command not found") + save_commands(filtered) + return {"message": f"Befehl '{cmd_name}' gelöscht"} \ No newline at end of file diff --git a/src/App.vue b/src/App.vue index 8836b71..d550d79 100644 --- a/src/App.vue +++ b/src/App.vue @@ -1,29 +1,153 @@ - + \ No newline at end of file From 047681d41ee2ddf9a708cf6138dea46dc698501f Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 24 Mar 2025 10:45:44 +0100 Subject: [PATCH 03/28] add markdown-codeblock --- Tree.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Tree.md b/Tree.md index 43c63d2..995c54a 100644 --- a/Tree.md +++ b/Tree.md @@ -1,3 +1,4 @@ +```plaintext . ├── docker-compose.yml ├── .gitignore @@ -25,3 +26,4 @@ └── vite.config.js 7 directories, 18 files +``` From b078dd1b20d81c0bcf448f92710416dcbd077630 Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 24 Mar 2025 10:55:14 +0100 Subject: [PATCH 04/28] add tree.yml --- test | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 test diff --git a/test b/test new file mode 100644 index 0000000..e69de29 From 4963c382538b5b81161944cb1a7fb74f743d3b5c Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 24 Mar 2025 11:18:42 +0100 Subject: [PATCH 05/28] fix rename --- goldanker_commands/{Dockerflile => Dockerfile} | 2 +- {src/data => goldanker_commands}/befehle.json | 0 test | 0 3 files changed, 1 insertion(+), 1 deletion(-) rename goldanker_commands/{Dockerflile => Dockerfile} (73%) rename {src/data => goldanker_commands}/befehle.json (100%) delete mode 100644 test diff --git a/goldanker_commands/Dockerflile b/goldanker_commands/Dockerfile similarity index 73% rename from goldanker_commands/Dockerflile rename to goldanker_commands/Dockerfile index 8c851c3..2a2fb48 100644 --- a/goldanker_commands/Dockerflile +++ b/goldanker_commands/Dockerfile @@ -2,7 +2,7 @@ FROM python:3.10-slim WORKDIR /app COPY requirements.txt ./ -RUN pip install --no-cache-dir -r requirements.txt +RUN pip install fastapi uvicorn COPY . /app diff --git a/src/data/befehle.json b/goldanker_commands/befehle.json similarity index 100% rename from src/data/befehle.json rename to goldanker_commands/befehle.json diff --git a/test b/test deleted file mode 100644 index e69de29..0000000 From 350f71ef92f91e57d26423a515e68a31b7dc8efe Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 24 Mar 2025 11:44:01 +0100 Subject: [PATCH 06/28] fiy syntax --- Tree.md | 11 +++++------ goldanker_commands/Dockerfile | 20 +++++++++++++++----- goldanker_commands/requirements.txt | 13 +++++++++++++ 3 files changed, 33 insertions(+), 11 deletions(-) create mode 100644 goldanker_commands/requirements.txt diff --git a/Tree.md b/Tree.md index 995c54a..dbbe85b 100644 --- a/Tree.md +++ b/Tree.md @@ -1,10 +1,11 @@ -```plaintext . ├── docker-compose.yml ├── .gitignore ├── goldanker_commands -│   ├── Dockerflile -│   └── main.py +│   ├── befehle.json +│   ├── Dockerfile +│   ├── main.py +│   └── requirements.txt ├── index.html ├── nächste_Schritte │   ├── Roadmap_v1.md @@ -20,10 +21,8 @@ │   ├── components │   │   └── CommandItem.vue │   ├── data -│   │   └── befehle.json │   └── main.js ├── Tree.md └── vite.config.js -7 directories, 18 files -``` +7 directories, 19 files diff --git a/goldanker_commands/Dockerfile b/goldanker_commands/Dockerfile index 2a2fb48..e3baf69 100644 --- a/goldanker_commands/Dockerfile +++ b/goldanker_commands/Dockerfile @@ -1,9 +1,19 @@ -FROM python:3.10-slim +# Dockerfile für goldanker_commands +FROM python:3.11-slim + +# Arbeitsverzeichnis im Container WORKDIR /app -COPY requirements.txt ./ -RUN pip install fastapi uvicorn -COPY . /app +# requirements.txt kopieren und Abhängigkeiten installieren +COPY requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt + +# Projektdateien kopieren +COPY . . + +# Port angeben (optional) +EXPOSE 8000 -CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] \ No newline at end of file +# Startbefehl für Uvicorn (FastAPI Server) +CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] diff --git a/goldanker_commands/requirements.txt b/goldanker_commands/requirements.txt new file mode 100644 index 0000000..a4325a6 --- /dev/null +++ b/goldanker_commands/requirements.txt @@ -0,0 +1,13 @@ +from pathlib import Path + +# Inhalt der requirements.txt +requirements_content = """fastapi +uvicorn[standard] +pydantic +""" + +# Speicherort für requirements.txt +requirements_path = Path("/mnt/data/requirements.txt") +requirements_path.write_text(requirements_content) + +requirements_path.name From 42d2053a287f27da6f43b0d045fe9d5bf5804c5c Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 19:01:45 +0200 Subject: [PATCH 07/28] neuer Repo Name --- README.md | 690 +++++++++++------- Tree.md | 54 +- .../Contributing_guidelinie_GoldForge.md" | 141 ++++ "n\303\244chste_Schritte/Treebefehl.md" | 1 + 4 files changed, 595 insertions(+), 291 deletions(-) create mode 100644 "n\303\244chste_Schritte/Contributing_guidelinie_GoldForge.md" create mode 100644 "n\303\244chste_Schritte/Treebefehl.md" diff --git a/README.md b/README.md index 0552e3f..79a95dc 100644 --- a/README.md +++ b/README.md @@ -1,153 +1,347 @@ -# Befehlsbibliothek mit Goldanker-Backend – Komplette README +Hier folgt die finale, zusammengeführte Version der README.md, die sämtliche Inhalte aus deinen Dateien (Goldforge_new.md, GoldeForge.md, workflow_upgrade.md, Roadmap_v2.md und Roadmap_v1.md) integriert. Ich habe die einzelnen Themenbereiche strukturiert, sodass du einen durchgängigen Überblick über Architektur, Workflow, Implementierung, Kategorien, CI/CD und die zukünftigen Roadmap-Schritte erhältst. +--- + +```markdown +# GoldForge – Modular Semantic Command Center & Interaktive Befehlsbibliothek -Dieser Leitfaden vereint zwei Roadmaps (v1 und v2) zu einer umfassenden Dokumentation für deine Interaktive Befehlsbibliothek mit Anbindung an einen **Goldanker**-Microservice. +GoldForge bildet das zentrale, semantisch erweiterte Befehls- und Wissenszentrum im Goldfruit-Ökosystem. Es vereint ein modernes Vue.js‑Frontend mit einer interaktiven, kachelbasierten Befehlsbibliothek, ein robustes FastAPI‑Backend (Goldanker Command Service) sowie fortschrittliche Semantic Search & Retrieval-Augmented Generation (RAG) mit GPT-Modellen. Zusätzlich sorgt die Tampermonkey-Integration für die automatische Erfassung externer Inhalte. Alle Komponenten sind containerisiert und lassen sich mittels Docker Compose (oder Kubernetes) orchestrieren – mit CI/CD-Anbindung und einem zukunftsorientierten, modularen Aufbau. --- -## 1. Architektur & Idee +## Inhaltsverzeichnis + +- [Überblick](#überblick) +- [Gesamtarchitektur](#gesamtarchitektur) +- [Kernkomponenten](#kernkomponenten) + - [GoldForge UI (Frontend)](#goldforge-ui-frontend) + - [Goldanker Command Service (Backend)](#goldanker-command-service-backend) + - [API Gateway & Integrationen](#api-gateway--integrationen) + - [Semantic Search & RAG](#semantic-search--rag) + - [Tampermonkey Integration](#tampermonkey-integration) +- [Workflow-Optimierung & Erweiterungen](#workflow-optimierung--erweiterungen) +- [Interaktive Befehlsbibliothek & Kategorien](#interaktive-befehlsbibliothek--kategorien) +- [Docker-Setup & Beispielhafte Dockerfiles](#docker-setup--beispielhafte-dockerfiles) +- [Backend & Frontend – Code-Beispiele](#backend--frontend--code-beispiele) +- [CI/CD & Deployment](#cicd--deployment) +- [Roadmap & Zukunft](#roadmap--zukunft) +- [Optionale Features & Erweiterungen](#optionale-features--erweiterungen) +- [Lizenz](#lizenz) +- [Fazit & Nächste Schritte](#fazit--nächste-schritte) + +--- -### 1.1 Ziel -Eine **Progressive Web App (PWA)** zur **Verwaltung von Befehlen** (z. B. Docker-, Kubernetes-, Git-Befehle) mit -- **Zweiteiliger Oberfläche** (Bibliothek & Arbeitsfläche) -- **Drag & Drop**-Funktionalität -- **Kachel-Design** -- **Backend** (Goldanker CommandService, FastAPI oder Node.js) +## Überblick -### 1.2 Datenfluss -1. Frontend (Vue + Vite + PWA) -2. Backend (Goldanker_CommandService) -3. befehle.json (Serverseitige Ablage) -4. CI/CD (GitHub Actions / GitLab) +GoldForge dient als zentrales Command Center, das: +- **Befehle interaktiv verwaltet:** Über eine kachelbasierte Befehlsbibliothek, in der Befehle per Drag & Drop von einer übersichtlichen Liste in einen Arbeitsbereich gezogen werden. +- **Ein robustes Backend bereitstellt:** Der Goldanker Command Service (FastAPI) ermöglicht CRUD-Operationen auf einer JSON-Datenquelle, versioniert über automatische Git-Commits. +- **Semantische Such- und Antwortsysteme integriert:** Mittels modernen Embedding-Modellen (z. B. SentenceTransformers) und Vektor-Datenbanken (ChromaDB/Elasticsearch) werden kontextbasierte Antworten via Retrieval-Augmented Generation (RAG) generiert. +- **Externe Inhalte automatisiert erfasst:** Über flexible Tampermonkey-Userscripts. +- **Containerisiert betrieben wird:** Alle Services laufen in Docker-Containern und können bei Bedarf in Kubernetes skaliert werden. --- -## 2. Funktionale Übersicht - -### 2.1 Zweiteilige Oberfläche -- **Bibliothek (links):** - - Alle Befehle kategorisiert (Git, Docker, usw.) - - Suchfeld, um rasch Befehle zu finden -- **Arbeitsfläche (rechts):** - - Kachel-Design - - Drag & Drop: Befehle aus Bibliothek in Arbeitsfläche schieben - - X-Button zum Entfernen - -### 2.2 Kachel-Design -- Enthält: - - **Name**, **Beschreibung**, **Command** - - Optionale Infos, Tooltips -- Resizable (per CSS-Resize) & frei platzierbar - -### 2.3 Drag & Drop -- Nutzung von [vue-draggable-next](https://github.com/SortableJS/vue.draggable.next) - - `v-model`-Synchronisierung - - Optional: Reordering in Bibliothek oder Arbeitsfläche -- Alternativ: manuelles Drag & Drop (Events `dragstart`, `dragend`) - -### 2.4 Persistenz -- **Frontend**: localStorage - - Speichert Position und Größe der Kacheln -- **Backend**: befehle.json - - Speichert Befehle, Kategorien, Beschreibungen - -### 2.5 JSON-Struktur -- `name`, `command`, `category`, `description`, `info` - -```json -[ - { - "name": "Docker Build", - "command": "docker-compose up --build", - "category": "Docker", - "description": "Container neu bauen und starten", - "info": "Nach Änderungen oder Cache-Problemen." - }, - { - "name": "Kubernetes Pods anzeigen", - "command": "kubectl get pods", - "category": "Kubernetes", - "description": "Zeigt aktuell laufende Pods an", - "info": "Hilfreich für schnellen Überblick der Container." - } -] +## Gesamtarchitektur + +Die modulare Architektur von GoldForge ermöglicht den flexiblen Austausch einzelner Komponenten. Zentrale Steuerung übernimmt ein API Gateway, das sämtliche Anfragen (vom Frontend, CI/CD-Systemen, E-Mail-Diensten etc.) an die internen Services verteilt. + +### Systemdiagramm + +```mermaid +graph TD; + A[Developer/User] -->|UI/API Calls| B[GoldForge UI
(Vue.js/PWA)] + B -->|Sendet Anfragen| C[API Gateway] + C --> D[Goldanker Command Service
(FastAPI)] + D --> I[Command Database
(befehle.json/NoSQL)] + C --> E[Semantic Search Service
(ChromaDB/Elasticsearch)] + E --> J[Vector Database] + C --> F[GPT Service] + F --> G[Model API Gateway] + G --> H[Model Services] + A --> K[Tampermonkey Agent
(Web-Scraping)] + K -->|Sendet Daten| D ``` --- -## 3. Goldanker CommandService (Beispiel in FastAPI) - -### 3.1 Aufbau - -
- befehlsbibliothek/ - -
- .github/ -
workflows/ -
  • deploy.yml – GitHub Actions Workflow: automatisches Deployment auf GitHub Pages
-
-
- -
- public/ -
  • vite.svg – Platzhalter-/Standard-Icon für die App
-
- -
- src/ -
- assets/ -
  • styles.css – Globale CSS-Stile
-
-
- components/ -
  • CommandItem.vue – Kachel-Komponente
-
-
- data/ -
  • befehle.json – JSON-Daten (Frontend)
-
-
    -
  • App.vue – Haupt-Komponente
    • -
  • main.js – Einstiegspunkt für Vue-App
    • -
-
- -
- goldanker_commands/ -
    -
  • Dockerfile – Build-Anleitung für Backend
    • -
  • requirements.txt – Python-Abhängigkeiten
    • -
  • main.py – FastAPI Backend
    • -
  • befehle.json – Serverseitige Daten
    • -
-
- -
    -
  • .gitignore – Ignorierte Dateien
    • -
  • index.html – App Startpunkt
    • -
  • package.json – Node-Projektkonfiguration
    • -
  • README.md – Projektbeschreibung
    • -
  • vite.config.js – Vite-Konfiguration
    • -
-
- - -### 3.2 Dockerfile -```Dockerfile -FROM python:3.10-slim - -WORKDIR /app -COPY requirements.txt ./ -RUN pip install --no-cache-dir -r requirements.txt - -COPY . /app - -CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] +## Kernkomponenten + +### GoldForge UI (Frontend) +- **Technologien:** Vue.js 3, Vite, Progressive Web App (PWA) +- **Funktionen:** + - Zweigeteilte Oberfläche: Linke Spalte mit durchsuchbarer Befehlsbibliothek, rechte Spalte als Arbeitsfläche (Drag & Drop, resizable Kacheln). + - Lokale Persistenz (via localStorage) zur Speicherung des Workspace-Zustands. + +### Goldanker Command Service (Backend) +- **Technologien:** FastAPI, Python, Uvicorn +- **Funktionen:** + - Verwaltung von Befehlen via CRUD‑Endpunkten (GET, POST, PUT, DELETE). + - Speicherung der Befehle in einer JSON-Datei (befehle.json) und optionaler Git-Commit zur Versionierung. + - Integration externer Webhook-Events (z. B. von GitLab, Mailcow). + +### API Gateway & Integrationen +- **Funktion:** + - Zentraler Eingang für alle externen Anfragen, die an die jeweiligen internen Services weitergeleitet werden. + - Ermöglicht den Zugriff auf das Frontend, den Command Service, Semantic Search, GPT-Service und weitere Integrationen. + +### Semantic Search & RAG +- **Ziel:** + - Umwandlung von Textinhalten in semantische Vektoren (mittels Embedding-Modellen wie SentenceTransformers) und Speicherung in einer Vektor-Datenbank (ChromaDB oder Elasticsearch). + - Nutzung der abgerufenen, kontextrelevanten Dokumente als Basis für die Generierung präziser Antworten via GPT-Modellen (z. B. gpt‑4‑turbo). +- **Beispielcode:** + Siehe Abschnitt [Backend & Frontend – Code-Beispiele](#backend--frontend--code-beispiele). + +### Tampermonkey Integration +- **Technologien:** Tampermonkey Userscript (JavaScript) +- **Funktionen:** + - Automatisches bzw. manuelles Erfassen von Webseiteninhalten. + - Übertragung extrahierter Text-Snippets an den Goldanker Command Service, um neue Befehle zu generieren. + +--- + +## Workflow-Optimierung & Erweiterungen + +Aus der Datei *workflow_upgrade.md* lassen sich folgende Verbesserungspotenziale ableiten: +- **Befehle als lebendige Ressource:** + - Befehle werden nicht mehr statisch in einer Datei verwaltet, sondern über eine API hinzugefügt, bearbeitet und gelöscht. + - Automatische Git-Commits nach jedem Update gewährleisten Versionskontrolle. +- **Live-Interaktion:** + - Simulation von Terminal-Outputs (z. B. `docker ps`, `kubectl get pods`) und ggf. reale Ausführung über einen sicheren, containerbasierten `command-runner`. +- **Modularer Aufbau & erweiterbare Kategorien:** + - Eine flexible Kategoriestruktur (z. B. Git, Docker, Kubernetes) ermöglicht die systematische Organisation des gesamten Ökosystems. +- **Workspace-Sharing & Export:** + - Funktionen, um den aktuellen Arbeitsbereich (Workspace) als JSON oder QR-Code zu exportieren und zu teilen. + +--- + +## Interaktive Befehlsbibliothek & Kategorien + +Die Befehlsbibliothek bildet das Herzstück des Systems. Sie besteht aus zwei Bereichen: +- **Bibliothek (links):** + - Enthält alle Befehle, sortiert und filterbar nach Kategorien (z. B. Git, Docker, Kubernetes, CI/CD etc.). + - Suche und Filterung ermöglichen eine schnelle Übersicht. +- **Arbeitsfläche (rechts):** + - Befehle können per Drag & Drop als Kacheln platziert, verschoben und resized werden. + - Der Zustand wird in localStorage gespeichert, sodass die Anordnung geräteübergreifend bestehen bleibt. + +### Beispielhafte Kategorien (siehe Roadmap_v2.md) +```yaml +Befehlsbibliothek: + - Git + - Docker + - npm & Node.js + - Ubuntu & Linux + - Kubernetes & Container-Orchestrierung + - Kafka & Datenverarbeitung + - Istio & Service Mesh + - Helm & Paketmanagement + - Prometheus & Monitoring + - Grafana & Visualisierung + - CI/CD & GitLab + - Python-Umgebung + - Sicherheit & VPN + - IPFS & dezentrale Speicherung +``` + +Zusätzlich empfiehlt sich folgende Tabelle für das Goldfruit-Ökosystem: + +| Kategorie | Beispiel-Befehle | +|-----------------------------|-------------------------------------------------------| +| **Kubernetes & Helm** | `kubectl apply`, `kubectl get pods`, `helm upgrade` | +| **Docker & Container** | `docker-compose build`, `docker-compose up -d` | +| **Git & Versionskontrolle** | `git pull`, `git merge`, `git rebase`, `git clone` | +| **CI/CD & GitLab** | `gitlab-runner exec`, YAML-Jobs für Deployment | +| **Monitoring & Prometheus** | `promtool check config`, PromQL Queries | +| **Visualisierung (Grafana)**| Starten von Dashboards | +| **Kafka & Event Streams** | `kafka-topics.sh`, `kafka-console-consumer.sh` | +| **Service Mesh & Istio** | `istioctl install`, `istioctl analyze` | +| **VPN & Sicherheit** | ProtonVPN CLI, SSH-Tunnel | +| **IPFS & Storage** | `ipfs add`, `ipfs pin`, `ipfs daemon` | +| **Python-Umgebung** | `pipenv`, `poetry`, `python -m venv` | + +--- + +## Docker-Setup & Beispielhafte Dockerfiles + +### Docker Compose Beispiel + +```yaml +version: '3.8' +services: + goldforge_ui: + build: ./goldforge_ui + container_name: goldforge_ui + ports: + - "3000:80" + networks: + - goldforge_net + + tampermonkey_api: + build: ./tampermonkey_api + container_name: tampermonkey_api + ports: + - "3001:3001" + networks: + - goldforge_net + + goldanker_commands: + build: ./goldanker_commands + container_name: goldanker_commands + environment: + - COMMANDS_JSON_PATH=/app/befehle.json + volumes: + - ./goldanker_commands/befehle.json:/app/befehle.json + ports: + - "8000:8000" + networks: + - goldforge_net + + api_gateway: + build: ./api_gateway + container_name: api_gateway + ports: + - "8080:8080" + networks: + - goldforge_net + + semantic_search: + image: chromadb/chromadb:latest + container_name: semantic_search + ports: + - "9200:9200" + networks: + - goldforge_net + + gpt_service: + build: ./gpt_service + container_name: gpt_service + ports: + - "8500:8500" + networks: + - goldforge_net + + model_api_gateway: + build: ./model_api_gateway + container_name: model_api_gateway + ports: + - "8600:8600" + networks: + - goldforge_net + + gitlab_runner: + image: gitlab/gitlab-runner:latest + container_name: gitlab_runner + volumes: + - /var/run/docker.sock:/var/run/docker.sock + - ./gitlab-runner/config:/etc/gitlab-runner + networks: + - goldforge_net + + mailcow: + image: mailcow/mailcow-dockerized:latest + container_name: mailcow + ports: + - "8081:80" + - "8443:443" + networks: + - goldforge_net + + monitoring: + image: prom/prometheus:latest + container_name: prometheus + ports: + - "9090:9090" + networks: + - goldforge_net + + message_broker: + image: wurstmeister/kafka:latest + container_name: kafka + ports: + - "9092:9092" + networks: + - goldforge_net + +networks: + goldforge_net: + driver: bridge ``` -### 3.3 main.py (CRUD-Endpunkte) +### Beispielhafte Dockerfiles + +1. **GoldForge UI (Frontend – Vue.js & Nginx)** + + ```dockerfile + # Stage 1: Build mit Node.js + FROM node:16-alpine AS builder + WORKDIR /app + COPY package*.json ./ + RUN npm install + COPY . . + RUN npm run build + + # Stage 2: Auslieferung mit Nginx + FROM nginx:alpine + COPY --from=builder /app/dist /usr/share/nginx/html + EXPOSE 80 + CMD ["nginx", "-g", "daemon off;"] + ``` + +2. **Goldanker Command Service (FastAPI Backend)** + + ```dockerfile + FROM python:3.9-slim + WORKDIR /app + COPY requirements.txt . + RUN pip install --no-cache-dir -r requirements.txt + COPY . . + EXPOSE 8000 + CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] + ``` + +3. **Tampermonkey API (Node.js Service)** + + ```dockerfile + FROM node:16-alpine + WORKDIR /app + COPY package*.json ./ + RUN npm install --production + COPY . . + EXPOSE 3001 + CMD ["node", "server.js"] + ``` + +4. **GPT Service & Model API Gateway (Python, Uvicorn)** + + ```dockerfile + FROM python:3.9-slim + WORKDIR /app + COPY requirements.txt . + RUN pip install --no-cache-dir -r requirements.txt + COPY . . + EXPOSE 8500 + CMD ["uvicorn", "gpt_gateway:app", "--host", "0.0.0.0", "--port", "8500"] + ``` + +5. **Optional: VS Code im Container (code‑server)** + + ```dockerfile + FROM linuxserver/code-server:latest + ENV PUID=1000 + ENV PGID=1000 + ENV TZ=Europe/Berlin + ENV PASSWORD=deinPasswort + EXPOSE 8443 + CMD ["/init"] + ``` + +--- + +## Backend & Frontend – Code-Beispiele + +### Backend: FastAPI Beispiel (siehe Roadmap_v1.md) + ```python from fastapi import FastAPI, HTTPException from pydantic import BaseModel @@ -156,7 +350,6 @@ import json import os app = FastAPI() - JSON_FILE = os.getenv("COMMANDS_JSON_PATH", "./befehle.json") class Command(BaseModel): @@ -184,7 +377,6 @@ def get_commands(): @app.post("/commands", response_model=Command) def create_command(new_cmd: Command): commands = load_commands() - # Optional: check duplicates commands.append(new_cmd) save_commands(commands) return new_cmd @@ -209,145 +401,91 @@ def delete_command(cmd_name: str): return {"message": f"Befehl '{cmd_name}' gelöscht"} ``` -### 3.4 Docker-Compose Integration -```yaml -version: '3.8' -services: - goldanker_commands: - build: ./goldanker_commands - container_name: goldanker_commands - environment: - - COMMANDS_JSON_PATH=/app/befehle.json - volumes: - - ./goldanker_commands/befehle.json:/app/befehle.json - ports: - - "8000:8000" - # depends_on, networks, etc. -``` - ---- +### Frontend: Vue.js Beispiel (siehe Roadmap_v1.md) -## 4. Vue-Frontend (Befehlsbibliothek) - -### 4.1 Struktur -``` -befehlsbibliothek/ - ├── src/ - │ ├── App.vue - │ ├── main.js - │ └── assets/ - │ └── styles.css - ├── public/ - ├── vite.config.js - ├── package.json - └── ... -``` - -### 4.2 App.vue (Beispiel mit vue-draggable-next) ```html @@ -379,76 +518,93 @@ export default { position: relative; background: #f5f5f5; overflow: hidden; - padding: 1rem; -} -.workspace { - min-height: 400px; - background: #e0e0e0; - padding: 1rem; - border: 2px dashed #ccc; } .command-box { + width: 200px; background: white; border: 2px solid #ccc; + cursor: move; padding: 1rem; - margin-bottom: 1rem; - transition: transform 0.2s ease; -} -.command-box:hover { - transform: translateY(-4px); } ``` --- -## 5. Kategorien & Struktur +## CI/CD & Deployment -Hier einige sinnvolle Kategorien (erweiterbar): +- **Backend:** + - Docker-Build des Goldanker Command Service (FastAPI) und automatisierte Git-Commits bei Änderungen der `befehle.json`. + - CI/CD-Pipelines (GitHub Actions oder GitLab CI) bauen und deployen den Service automatisch. +- **Frontend:** + - Vue-App wird mittels `npm run build` erstellt und über Nginx oder GitHub Pages ausgeliefert. +- **Orchestrierung:** + - Alle Services laufen in Docker-Containern (via Docker Compose oder Kubernetes). -```yaml -- Git -- Docker -- npm & Node.js -- Ubuntu & Linux -- Kubernetes & Helm -- Kafka -- Istio -- Helm -- Prometheus -- Grafana -- CI/CD (GitLab) -- Python -- Sicherheit & VPN -- IPFS -``` +--- + +## Roadmap & Zukunft + +Die weitere Entwicklung gliedert sich in folgende Phasen: + +### **Phase 1 – Konzept & Vorbereitung** +- Konzept finalisieren und JSON-Befehlsdatei erstellen. +- Grundstruktur (Frontend & Backend) aufsetzen. + +### **Phase 2 – Frontend-Entwicklung** +- Aufbau des zweigeteilten Layouts (Bibliothek links, Arbeitsfläche rechts). +- Implementierung von Drag & Drop, Resize und Suchfunktionen. + +### **Phase 3 – Backend-Optimierung** +- CRUD-Operationen via FastAPI und automatische Git-Commit-Integration. +- Erweiterung in Microservices (z. B. separate Module für User-, Search- und Command-Service). + +### **Phase 4 – Semantic Search & RAG** +- Integration von ChromaDB/Elasticsearch und Embedding-Modellen. +- Entwicklung eines RAG-Workflows zur Generierung kontextbasierter Antworten. + +### **Phase 5 – Workflow-Optimierung** +- Live-Interaktion (Terminal-Simulation, echter Command-Runner). +- Workspace-Export und Sharing-Funktionalität. + +### **Phase 6 – Deployment & Skalierung** +- Vollständiges Testen und Deployment via CI/CD. +- Skalierung in Kubernetes inklusive Monitoring (Prometheus, Grafana, Jaeger). --- -## 6. CI/CD und Deployment +## Optionale Features & Erweiterungen -1. **Backend**: Docker build/push -2. **Frontend**: `npm run build`, deploy nach GitHub Pages oder Docker-Container + Nginx -3. **Docker-Compose**: orchestriert Services (goldanker_commands + befehlsbibliothek) -4. **GitHub Actions / GitLab-CI**: automatisiertes Bauen und Ausrollen +- **Befehlseingabemaske im Frontend:** Formular für das Erstellen neuer Befehle (POST `/commands`). +- **Edit- und Vorschaufunktionen:** Markdown-Preview, Versionierung einzelner Befehle. +- **Benutzer- und Rollenverwaltung:** Absicherung der API. +- **Live-Ausführung von Befehlen:** Simulation oder tatsächliche Ausführung in einem sicheren Container. +- **Slack- oder E-Mail-Benachrichtigungen** bei Änderungen. +- **Erweiterung des Workspace-Konzepts:** Export als JSON oder QR-Code, um die Anordnung zu teilen. --- -## 7. Erweiterungsideen +## Lizenz -- **Command-Eingabemaske** (POST /commands) -- **Edit-Funktion** (PUT /commands/{cmd_name}) -- **Git-Commit-Hook** nach Speichern -- **Nutzer-/Rollenverwaltung** -- **Tooltip**-Infos mit Tippy.js -- **Responsive** für Mobile/Tablet +Dieses Projekt ist unter der MIT‑Lizenz lizenziert – siehe [LICENSE](LICENSE) für Details. --- -## 8. Fazit +## Fazit & Nächste Schritte + +GoldForge bietet ein umfassendes, modulares und zukunftssicheres System, das die Entwicklung, Verwaltung und Ausführung von Befehlen in deinem Goldfruit-Ökosystem revolutioniert. Die Integration von Semantic Search, RAG und interaktiver Befehlsverwaltung, gekoppelt mit modernem Deployment via Docker und CI/CD, ermöglicht es dir, Arbeitsabläufe effizient und dynamisch zu gestalten. + +**Nächste Schritte:** +- Feedback zur JSON-Datenstruktur und Kategoriestruktur einholen. +- Konkrete Implementierung einzelner Module (z. B. das POST /commands-Formular) starten. +- Praktische Hands-on-Übungen durchführen, um den Workflow (z. B. Drag & Drop, Git-Commit-Hooks) zu validieren. +- Weitere Erweiterungen (z. B. Live-Interaktion, Workspace-Export) schrittweise implementieren. + +--- + +*Diese README.md fasst sämtliche Konzepte, Code-Beispiele und strategischen Roadmap-Schritte zusammen. Feedback und Anpassungswünsche sind jederzeit willkommen!* +``` + +--- -Mit dieser kombinierten README hast du: -1. Eine **Architektur-Beschreibung** (Backend/Frontend) -2. **Konkrete Codebeispiele** (FastAPI + Vue) -3. **Einen klaren Projektplan** (Phasen, Tools, Docker-Setup) -4. **Optionale Features** (Git-Commit-Hooks, CI/CD, etc.)befehlsbibliothek/ \ No newline at end of file +Ist diese Zusammenführung so in deinem Sinne? Möchtest du an einzelnen Abschnitten noch weitere Details oder spezifische Anpassungen vornehmen? \ No newline at end of file diff --git a/Tree.md b/Tree.md index dbbe85b..3e63964 100644 --- a/Tree.md +++ b/Tree.md @@ -1,28 +1,34 @@ -. -├── docker-compose.yml +~/Goldfruit/befehlsbibliothek +├── .github/ +│ └── workflows/ +│ └── deploy.yml ├── .gitignore -├── goldanker_commands -│   ├── befehle.json -│   ├── Dockerfile -│   ├── main.py -│   └── requirements.txt +├── docker-compose.yml ├── index.html -├── nächste_Schritte -│   ├── Roadmap_v1.md -│   ├── Roadmap_v2.md -│   └── workflow_upgrade.md ├── package.json -├── package-lock.json +├── vite.config.js ├── README.md -├── src -│   ├── App.vue -│   ├── assets -│   │   └── styles.css -│   ├── components -│   │   └── CommandItem.vue -│   ├── data -│   └── main.js -├── Tree.md -└── vite.config.js - -7 directories, 19 files +├── src/ +│ ├── App.vue +│ ├── assets/ +│ │ └── styles.css +│ ├── components/ +│ │ └── CommandItem.vue +│ ├── data/ +│ └── main.js +├── goldanker_commands/ +│ ├── Dockerfile +│ ├── befehle.json +│ ├── main.py +│ └── requirements.txt +├── docs/ +│ ├── CONTRIBUTING.md +│ └── Tree.md +├── nächste_Schritte/ +│ ├── GoldForge_aktuel_v1.md +│ ├── GoldeForge.md +│ ├── Goldforge_new.md +│ ├── Roadmap_v1.md +│ ├── Roadmap_v2.md +│ └── workflow_upgrade.md +└── LICENSE diff --git "a/n\303\244chste_Schritte/Contributing_guidelinie_GoldForge.md" "b/n\303\244chste_Schritte/Contributing_guidelinie_GoldForge.md" new file mode 100644 index 0000000..d34242b --- /dev/null +++ "b/n\303\244chste_Schritte/Contributing_guidelinie_GoldForge.md" @@ -0,0 +1,141 @@ +Hier ist ein Beispiel für eine ansprechende und umfassende CONTRIBUTING.md, die du direkt in dein Projekt integrieren kannst: + +--- + +# CONTRIBUTING Guidelines for GoldForge_aktuel_v1 + +Vielen Dank, dass du zur Weiterentwicklung von GoldForge_aktuel_v1 beitragen möchtest! Diese Richtlinien helfen uns, einen strukturierten und effizienten Workflow sicherzustellen – egal ob du ein neues Feature einführst, Bugs behebst oder die Dokumentation erweiterst. + +--- + +## Inhaltsverzeichnis + +- [CONTRIBUTING Guidelines for GoldForge\_aktuel\_v1](#contributing-guidelines-for-goldforge_aktuel_v1) + - [Inhaltsverzeichnis](#inhaltsverzeichnis) + - [Code of Conduct](#code-of-conduct) + - [Branch-Konvention](#branch-konvention) + - [Workflow \& Pull Request-Prozess](#workflow--pull-request-prozess) + - [Commit-Richtlinien](#commit-richtlinien) + - [Testen und CI/CD](#testen-und-cicd) + - [Feedback und Kommunikation](#feedback-und-kommunikation) + - [Weitere Hinweise](#weitere-hinweise) + +--- + +## Code of Conduct + +Bitte verhalte dich respektvoll und konstruktiv. Wir schätzen freundliche, sachliche Kommunikation. Bei Konflikten hilft uns eine offene und lösungsorientierte Diskussion. + +--- + +## Branch-Konvention + +Unsere Branches folgen einem klaren Namensschema, um Übersicht und Automatisierung zu erleichtern. Die Branch-Namen bestehen aus zwei Teilen: + +``` +/- +``` + +**Bereiche:** +- **`frontend/`** – Für alle Änderungen an der GoldForge UI (Vue.js, PWA, etc.) +- **`backend/`** – Für den Goldanker Command Service (FastAPI) +- **`infra/`** – Für Docker, Kubernetes, CI/CD und Infrastruktur-Anpassungen +- **`docs/`** – Für Dokumentationsupdates, Setup-Guides oder Tutorials +- **`ci/`** – Für Änderungen an unseren CI/CD-Pipelines +- **`misc/`** – Für sonstige Anpassungen, die keiner der o.g. Kategorien eindeutig zugeordnet werden können + +**Typen:** +- **`feature/`** – Neue Funktionen oder Erweiterungen +- **`fix/`** – Bugfixes und Korrekturen +- **`refactor/`** – Umstrukturierungen und Optimierungen im Code +- **`hotfix/`** – Kritische Fehlerbehebungen im Produktionssystem +- **`test/`** – Temporäre oder experimentelle Änderungen + +**Beispiele:** +- `frontend/feature-login-ui` +- `backend/fix-authentication` +- `infra/refactor-docker-compose` +- `docs/update-setup-guide` + +--- + +## Workflow & Pull Request-Prozess + +1. **Fork & Branch erstellen:** + Erstelle zunächst einen Fork des Projekts (falls du nicht direkt im Repository arbeitest) und dann einen neuen Branch, der auf dem aktuellen Stand von `main` basiert: + ```bash + git checkout main + git pull + git checkout -b /- + ``` + +2. **Entwicklung:** + Arbeite an deinem Feature oder Fix. Committe regelmäßig und benutze aussagekräftige Commit-Messages. + +3. **Tests & Lokale Überprüfung:** + Stelle sicher, dass dein Code lokal alle Tests besteht und den vorgegebenen Code-Standards entspricht. + +4. **Pull Request (PR) erstellen:** + Eröffne einen Pull Request, in dem du deine Änderungen beschreibst. Bitte um Review und Feedback. Bei größeren Änderungen oder Unsicherheiten nutze gerne unseren Discord- oder Slack-Kanal, um vorab Rücksprache zu halten. + +5. **Code Review & Merge:** + Ein Teammitglied wird deinen PR überprüfen. Sobald alle Tests erfolgreich sind und das Feedback berücksichtigt wurde, erfolgt der Merge in den `dev`-Branch (oder direkt in `main`, falls es sich um einen Hotfix handelt). + +--- + +## Commit-Richtlinien + +- **Klar und prägnant:** + Schreibe Commit-Messages, die klar den Zweck der Änderung beschreiben. + _Beispiel:_ `frontend/feature-login-ui: Implementiere Login-Oberfläche und Validierung` + +- **Konsistente Formatierung:** + Nutze das Format `/: Kurze Beschreibung` für die erste Zeile deiner Commit-Messages. + Weitere Details können in den nächsten Zeilen folgen. + +- **Squash Commits:** + Falls möglich, fasse mehrere kleine Commits zusammen, bevor du deinen Branch in den Integrationszweig mergst. + +--- + +## Testen und CI/CD + +- **Automatisierte Tests:** + Stelle sicher, dass alle automatisierten Tests lokal und in der CI/CD-Pipeline erfolgreich laufen, bevor du einen PR eröffnest. + +- **Pre-Commit Hooks:** + Wir empfehlen die Nutzung von Git-Hooks (z. B. pre-commit) zur Code-Formatierung und Linting, um die Code-Qualität zu sichern. + +- **Branch-spezifische Builds:** + Unsere CI/CD-Pipeline führt Builds und Tests für alle Branches durch. Achte darauf, dass deine Änderungen branchübergreifend kompatibel sind. + +--- + +## Feedback und Kommunikation + +- **Offene Diskussion:** + Wenn du Fragen oder Verbesserungsvorschläge hast, eröffne bitte ein Issue oder sprich uns direkt an. + +- **Review-Prozess:** + Wir schätzen konstruktives Feedback – sei offen für Änderungsvorschläge und versuche, bei Diskussionen stets sachlich zu bleiben. + +--- + +## Weitere Hinweise + +- **Dokumentation:** + Ergänze die README.md oder andere Dokumentationsdateien, wenn deine Änderungen neue Features oder Anpassungen betreffen. + +- **Automatisierung:** + Falls du Skripte oder Automatisierungstools entwickelst, die den Workflow verbessern (z. B. automatische Branch-Erstellung oder Versionierung), dokumentiere diese bitte ebenfalls. + +- **Branch Protection:** + Um versehentliche Änderungen an `main` zu vermeiden, sind direkte Pushes in diesen Branch deaktiviert. Änderungen müssen immer über einen PR erfolgen. + +--- + +Vielen Dank für deinen Beitrag und dein Engagement! Gemeinsam machen wir GoldForge_aktuel_v1 noch besser und zukunftssicher. + +--- + +Hast du Fragen zu einem der Punkte oder weitere Anregungen? Dann melde dich gerne – wir sind stets offen für Verbesserungen! \ No newline at end of file diff --git "a/n\303\244chste_Schritte/Treebefehl.md" "b/n\303\244chste_Schritte/Treebefehl.md" new file mode 100644 index 0000000..65e0bc5 --- /dev/null +++ "b/n\303\244chste_Schritte/Treebefehl.md" @@ -0,0 +1 @@ +tree -a -I 'node_modules|.git|dist|__pycache__' > Tree.md From bea100894c98134c0ee25ddbdbda301c01634cfb Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 19:55:48 +0200 Subject: [PATCH 08/28] fix: set correct base path for GitHub Pages --- vite.config.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/vite.config.js b/vite.config.js index 1f139d1..696847f 100644 --- a/vite.config.js +++ b/vite.config.js @@ -29,5 +29,6 @@ export default defineConfig({ } }) ], - base: "./", // Wichtig für relative Pfade, gerade wenn du GitHub Pages nutzen willst + base: "/GoldForge/" + }); From 734377b2722f1cc6da7761342e8743f6238cdea0 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 20:11:16 +0200 Subject: [PATCH 09/28] ci: add deploy workflow & install vuedraggable dependency --- package-lock.json | 16 +++++++++++++++- package.json | 3 ++- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index eacf5d0..93d81d7 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10,7 +10,8 @@ "dependencies": { "tippy.js": "^6.3.7", "vue": "^3.2.47", - "vue-tippy": "^6.7.0" + "vue-tippy": "^6.7.0", + "vuedraggable": "^2.24.3" }, "devDependencies": { "@vitejs/plugin-vue": "^4.0.0", @@ -3842,6 +3843,11 @@ "dev": true, "license": "MIT" }, + "node_modules/sortablejs": { + "version": "1.10.2", + "resolved": "https://registry.npmjs.org/sortablejs/-/sortablejs-1.10.2.tgz", + "integrity": "sha512-YkPGufevysvfwn5rfdlGyrGjt7/CRHwvRPogD/lC+TnvcN29jDpCifKP+rBqf+LRldfXSTh+0CGLcSg0VIxq3A==" + }, "node_modules/source-map": { "version": "0.8.0-beta.0", "dev": true, @@ -4371,6 +4377,14 @@ "vue": "^3.2.0" } }, + "node_modules/vuedraggable": { + "version": "2.24.3", + "resolved": "https://registry.npmjs.org/vuedraggable/-/vuedraggable-2.24.3.tgz", + "integrity": "sha512-6/HDXi92GzB+Hcs9fC6PAAozK1RLt1ewPTLjK0anTYguXLAeySDmcnqE8IC0xa7shvSzRjQXq3/+dsZ7ETGF3g==", + "dependencies": { + "sortablejs": "1.10.2" + } + }, "node_modules/webidl-conversions": { "version": "4.0.2", "dev": true, diff --git a/package.json b/package.json index e6371ce..333ac0d 100644 --- a/package.json +++ b/package.json @@ -9,7 +9,8 @@ "dependencies": { "tippy.js": "^6.3.7", "vue": "^3.2.47", - "vue-tippy": "^6.7.0" + "vue-tippy": "^6.7.0", + "vuedraggable": "^2.24.3" }, "devDependencies": { "@vitejs/plugin-vue": "^4.0.0", From cec82fc1f698ad69dcc896a9803be1c51c1f3820 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 20:32:19 +0200 Subject: [PATCH 10/28] ci: move tree.yml to correct GitHub workflows folder --- .github/workflows/update-tree.yml | 40 +++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 .github/workflows/update-tree.yml diff --git a/.github/workflows/update-tree.yml b/.github/workflows/update-tree.yml new file mode 100644 index 0000000..f38fc0e --- /dev/null +++ b/.github/workflows/update-tree.yml @@ -0,0 +1,40 @@ +# .github/workflows/update-tree.yml + +name: Update Tree.md + +on: + push: + branches: [ "main" ] + +jobs: + update-tree: + runs-on: ubuntu-latest + + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Install tree + run: sudo apt-get install tree + + - name: Generate Tree.md + run: | + echo '```plaintext' > Tree.md + tree -a -I "node_modules|dist|target|.git" >> Tree.md + echo '```' >> Tree.md + + - name: Configure git + run: | + git config user.name "github-actions" + git config user.email "github-actions@github.com" + + - name: Commit changes + run: | + if git diff --exit-code Tree.md; then + echo "No changes in Tree.md. Abbruch." + exit 0 + fi + + git add Tree.md + git commit -m "Update Tree.md [skip ci]" + git push From 665382e94436eaedce928926c6fbd1a3c9f811c4 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 20:38:31 +0200 Subject: [PATCH 11/28] ci: move deploy workflow to correct GitHub Actions folder --- .github/workflows/deploy.yml | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 .github/workflows/deploy.yml diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml new file mode 100644 index 0000000..d710467 --- /dev/null +++ b/.github/workflows/deploy.yml @@ -0,0 +1,31 @@ +name: Deploy Vue App + +on: + push: + branches: + - main + +jobs: + build-and-deploy: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v3 + + - name: Setup Node.js + uses: actions/setup-node@v3 + with: + node-version: '18' + + - name: Install dependencies + run: npm install + + - name: Build project + run: npm run build + + - name: Deploy to GitHub Pages + uses: JamesIves/github-pages-deploy-action@v4 + with: + branch: gh-pages # Zielbranch für GitHub Pages + folder: dist # Build-Ausgabeordner (Vue + Vite) From 29c10d6026a6a0a4d91fa4cb8155b1acfca3e188 Mon Sep 17 00:00:00 2001 From: Goldfruit Date: Sun, 30 Mar 2025 20:41:41 +0200 Subject: [PATCH 12/28] Update update-tree.yml mian to dev --- .github/workflows/update-tree.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/update-tree.yml b/.github/workflows/update-tree.yml index f38fc0e..50db313 100644 --- a/.github/workflows/update-tree.yml +++ b/.github/workflows/update-tree.yml @@ -4,7 +4,7 @@ name: Update Tree.md on: push: - branches: [ "main" ] + branches: [ "dev" ] jobs: update-tree: From 50e3711a6e6ee51a8effca6e31fe71380db74764 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 20:59:43 +0200 Subject: [PATCH 13/28] trigger tree.yml From cd420472344e6ef93017f043d856bb024335f9a4 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 21:00:06 +0200 Subject: [PATCH 14/28] schreibfehler --- .github/{workflows => workflow}/deploy.yml | 0 .github/{workflows => workflow}/update-tree.yml | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename .github/{workflows => workflow}/deploy.yml (100%) rename .github/{workflows => workflow}/update-tree.yml (100%) diff --git a/.github/workflows/deploy.yml b/.github/workflow/deploy.yml similarity index 100% rename from .github/workflows/deploy.yml rename to .github/workflow/deploy.yml diff --git a/.github/workflows/update-tree.yml b/.github/workflow/update-tree.yml similarity index 100% rename from .github/workflows/update-tree.yml rename to .github/workflow/update-tree.yml From 049b1475435ad11733f8e3bd0624de8e333ad074 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 21:20:59 +0200 Subject: [PATCH 15/28] update-tree.yml --- .github/workflow/update-tree.yml | 46 ++++++++++++-------------------- 1 file changed, 17 insertions(+), 29 deletions(-) diff --git a/.github/workflow/update-tree.yml b/.github/workflow/update-tree.yml index 50db313..35c938f 100644 --- a/.github/workflow/update-tree.yml +++ b/.github/workflow/update-tree.yml @@ -1,5 +1,3 @@ -# .github/workflows/update-tree.yml - name: Update Tree.md on: @@ -11,30 +9,20 @@ jobs: runs-on: ubuntu-latest steps: - - name: Check out repository - uses: actions/checkout@v3 - - - name: Install tree - run: sudo apt-get install tree - - - name: Generate Tree.md - run: | - echo '```plaintext' > Tree.md - tree -a -I "node_modules|dist|target|.git" >> Tree.md - echo '```' >> Tree.md - - - name: Configure git - run: | - git config user.name "github-actions" - git config user.email "github-actions@github.com" - - - name: Commit changes - run: | - if git diff --exit-code Tree.md; then - echo "No changes in Tree.md. Abbruch." - exit 0 - fi - - git add Tree.md - git commit -m "Update Tree.md [skip ci]" - git push + - name: Checkout repository + uses: actions/checkout@v3 + + - name: Generate tree structure + run: | + echo '```' > Tree.md + tree -I 'node_modules|.git|dist' -a >> Tree.md + echo '```' >> Tree.md + + - name: Commit & push Tree.md + run: | + git config --global user.name "GoldForge Bot" + git config --global user.email "github-actions[bot]@users.noreply.github.com" + git remote set-url origin https://x-access-token:${{ secrets.GH_TOKEN }}@github.com/Goldfruit/GoldForge.git + git add Tree.md + git commit -m "ci: update Tree.md [skip ci]" || echo "nothing to commit" + git push origin dev From b7fa036a237faede0a992ea4d55c3e3f9ad2044c Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 21:26:11 +0200 Subject: [PATCH 16/28] tree.yml --- .github/workflow/{update-tree.yml => tree.yml} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename .github/workflow/{update-tree.yml => tree.yml} (100%) diff --git a/.github/workflow/update-tree.yml b/.github/workflow/tree.yml similarity index 100% rename from .github/workflow/update-tree.yml rename to .github/workflow/tree.yml From e5ac6179479658ba1ccbbbc0fbe368c2c21d594e Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 22:14:30 +0200 Subject: [PATCH 17/28] test.md --- .github/workflow/deploy.yml | 1 + test.md | 1 + 2 files changed, 2 insertions(+) create mode 100644 test.md diff --git a/.github/workflow/deploy.yml b/.github/workflow/deploy.yml index d710467..1727c34 100644 --- a/.github/workflow/deploy.yml +++ b/.github/workflow/deploy.yml @@ -4,6 +4,7 @@ on: push: branches: - main + - dev jobs: build-and-deploy: diff --git a/test.md b/test.md new file mode 100644 index 0000000..95d09f2 --- /dev/null +++ b/test.md @@ -0,0 +1 @@ +hello world \ No newline at end of file From 644635d4f94706f104466597b573a3ae3812cf69 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 22:41:17 +0200 Subject: [PATCH 18/28] refactor-yml --- .github/workflow/deploy.yml | 2 ++ .github/workflow/tree.yml | 35 ++++++++++++++++++++--------------- 2 files changed, 22 insertions(+), 15 deletions(-) diff --git a/.github/workflow/deploy.yml b/.github/workflow/deploy.yml index 1727c34..17276c8 100644 --- a/.github/workflow/deploy.yml +++ b/.github/workflow/deploy.yml @@ -13,6 +13,8 @@ jobs: steps: - name: Checkout repository uses: actions/checkout@v3 + with: + fetch-depth: 0 - name: Setup Node.js uses: actions/setup-node@v3 diff --git a/.github/workflow/tree.yml b/.github/workflow/tree.yml index 35c938f..28c620d 100644 --- a/.github/workflow/tree.yml +++ b/.github/workflow/tree.yml @@ -4,25 +4,30 @@ on: push: branches: [ "dev" ] +permissions: + contents: write + jobs: update-tree: runs-on: ubuntu-latest steps: - - name: Checkout repository - uses: actions/checkout@v3 + - name: Checkout repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 - - name: Generate tree structure - run: | - echo '```' > Tree.md - tree -I 'node_modules|.git|dist' -a >> Tree.md - echo '```' >> Tree.md + - name: Generate tree structure + run: | + echo '```' > Tree.md + tree -I 'node_modules|.git|dist' -a >> Tree.md + echo '```' >> Tree.md - - name: Commit & push Tree.md - run: | - git config --global user.name "GoldForge Bot" - git config --global user.email "github-actions[bot]@users.noreply.github.com" - git remote set-url origin https://x-access-token:${{ secrets.GH_TOKEN }}@github.com/Goldfruit/GoldForge.git - git add Tree.md - git commit -m "ci: update Tree.md [skip ci]" || echo "nothing to commit" - git push origin dev + - name: Commit & push Tree.md + run: | + git config --global user.name "GoldForge Bot" + git config --global user.email "github-actions[bot]@users.noreply.github.com" + git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/Goldfruit/GoldForge.git + git add Tree.md + git commit -m "ci: update Tree.md [skip ci]" || echo "nothing to commit" + git push origin dev From 75fed80922c9572500ac496c6aee3f77f07aaba8 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 22:42:36 +0200 Subject: [PATCH 19/28] delet --- test.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 test.md diff --git a/test.md b/test.md deleted file mode 100644 index 95d09f2..0000000 --- a/test.md +++ /dev/null @@ -1 +0,0 @@ -hello world \ No newline at end of file From 0cf793e93ff0a1607689e0042cdaaf6def919f3f Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 22:54:42 +0200 Subject: [PATCH 20/28] delet skip ci --- .github/workflow/tree.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflow/tree.yml b/.github/workflow/tree.yml index 28c620d..d8ae4d3 100644 --- a/.github/workflow/tree.yml +++ b/.github/workflow/tree.yml @@ -29,5 +29,5 @@ jobs: git config --global user.email "github-actions[bot]@users.noreply.github.com" git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/Goldfruit/GoldForge.git git add Tree.md - git commit -m "ci: update Tree.md [skip ci]" || echo "nothing to commit" + git commit -m "ci: update Tree.md" || echo "nothing to commit" git push origin dev From 887e413c348567bfbf19ab19494c0f7b62b62015 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 23:05:53 +0200 Subject: [PATCH 21/28] README.md bereinigt --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 79a95dc..38bed6a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -Hier folgt die finale, zusammengeführte Version der README.md, die sämtliche Inhalte aus deinen Dateien (Goldforge_new.md, GoldeForge.md, workflow_upgrade.md, Roadmap_v2.md und Roadmap_v1.md) integriert. Ich habe die einzelnen Themenbereiche strukturiert, sodass du einen durchgängigen Überblick über Architektur, Workflow, Implementierung, Kategorien, CI/CD und die zukünftigen Roadmap-Schritte erhältst. + --- From 603bfcf530695464a3fa62be262c4c5bb0d4c463 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 23:20:46 +0200 Subject: [PATCH 22/28] =?UTF-8?q?kleiner=20ab=C3=A4nderung?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Tree.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tree.md b/Tree.md index 3e63964..9573101 100644 --- a/Tree.md +++ b/Tree.md @@ -31,4 +31,4 @@ │ ├── Roadmap_v1.md │ ├── Roadmap_v2.md │ └── workflow_upgrade.md -└── LICENSE +└── LICENS \ No newline at end of file From b225ac5c195505ee710579ef3809ddd334415fcb Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 23:36:06 +0200 Subject: [PATCH 23/28] fix: rename folder to .github/workflows --- .github/workflows/deploy.yml | 34 ++++++++++++++++++++++++++++++++++ .github/workflows/tree.yml | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 .github/workflows/deploy.yml create mode 100644 .github/workflows/tree.yml diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml new file mode 100644 index 0000000..17276c8 --- /dev/null +++ b/.github/workflows/deploy.yml @@ -0,0 +1,34 @@ +name: Deploy Vue App + +on: + push: + branches: + - main + - dev + +jobs: + build-and-deploy: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Setup Node.js + uses: actions/setup-node@v3 + with: + node-version: '18' + + - name: Install dependencies + run: npm install + + - name: Build project + run: npm run build + + - name: Deploy to GitHub Pages + uses: JamesIves/github-pages-deploy-action@v4 + with: + branch: gh-pages # Zielbranch für GitHub Pages + folder: dist # Build-Ausgabeordner (Vue + Vite) diff --git a/.github/workflows/tree.yml b/.github/workflows/tree.yml new file mode 100644 index 0000000..d8ae4d3 --- /dev/null +++ b/.github/workflows/tree.yml @@ -0,0 +1,33 @@ +name: Update Tree.md + +on: + push: + branches: [ "dev" ] + +permissions: + contents: write + +jobs: + update-tree: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Generate tree structure + run: | + echo '```' > Tree.md + tree -I 'node_modules|.git|dist' -a >> Tree.md + echo '```' >> Tree.md + + - name: Commit & push Tree.md + run: | + git config --global user.name "GoldForge Bot" + git config --global user.email "github-actions[bot]@users.noreply.github.com" + git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/Goldfruit/GoldForge.git + git add Tree.md + git commit -m "ci: update Tree.md" || echo "nothing to commit" + git push origin dev From d2e8be25d8c03df2f3176b8c9a1d5139fe20a713 Mon Sep 17 00:00:00 2001 From: GoldForge Bot Date: Sun, 30 Mar 2025 21:36:15 +0000 Subject: [PATCH 24/28] ci: update Tree.md --- Tree.md | 64 ++++++++++++++++++++++++++++++--------------------------- 1 file changed, 34 insertions(+), 30 deletions(-) diff --git a/Tree.md b/Tree.md index 9573101..0209289 100644 --- a/Tree.md +++ b/Tree.md @@ -1,34 +1,38 @@ -~/Goldfruit/befehlsbibliothek -├── .github/ -│ └── workflows/ -│ └── deploy.yml +``` +. +├── .github +│   ├── workflow +│   │   ├── deploy.yml +│   │   └── tree.yml +│   └── workflows +│   ├── deploy.yml +│   └── tree.yml ├── .gitignore +├── README.md +├── Tree.md ├── docker-compose.yml +├── goldanker_commands +│   ├── Dockerfile +│   ├── befehle.json +│   ├── main.py +│   └── requirements.txt ├── index.html +├── nächste_Schritte +│   ├── Contributing_guidelinie_GoldForge.md +│   ├── Roadmap_v1.md +│   ├── Roadmap_v2.md +│   ├── Treebefehl.md +│   └── workflow_upgrade.md +├── package-lock.json ├── package.json -├── vite.config.js -├── README.md -├── src/ -│ ├── App.vue -│ ├── assets/ -│ │ └── styles.css -│ ├── components/ -│ │ └── CommandItem.vue -│ ├── data/ -│ └── main.js -├── goldanker_commands/ -│ ├── Dockerfile -│ ├── befehle.json -│ ├── main.py -│ └── requirements.txt -├── docs/ -│ ├── CONTRIBUTING.md -│ └── Tree.md -├── nächste_Schritte/ -│ ├── GoldForge_aktuel_v1.md -│ ├── GoldeForge.md -│ ├── Goldforge_new.md -│ ├── Roadmap_v1.md -│ ├── Roadmap_v2.md -│ └── workflow_upgrade.md -└── LICENS \ No newline at end of file +├── src +│   ├── App.vue +│   ├── assets +│   │   └── styles.css +│   ├── components +│   │   └── CommandItem.vue +│   └── main.js +└── vite.config.js + +9 directories, 25 files +``` From 78ca2e04115d139541f8255aa37a2d1f519dd349 Mon Sep 17 00:00:00 2001 From: Philippe Date: Sun, 30 Mar 2025 23:36:47 +0200 Subject: [PATCH 25/28] rename workflow --- .github/workflow/deploy.yml | 34 ---------------------------------- .github/workflow/tree.yml | 33 --------------------------------- 2 files changed, 67 deletions(-) delete mode 100644 .github/workflow/deploy.yml delete mode 100644 .github/workflow/tree.yml diff --git a/.github/workflow/deploy.yml b/.github/workflow/deploy.yml deleted file mode 100644 index 17276c8..0000000 --- a/.github/workflow/deploy.yml +++ /dev/null @@ -1,34 +0,0 @@ -name: Deploy Vue App - -on: - push: - branches: - - main - - dev - -jobs: - build-and-deploy: - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v3 - with: - fetch-depth: 0 - - - name: Setup Node.js - uses: actions/setup-node@v3 - with: - node-version: '18' - - - name: Install dependencies - run: npm install - - - name: Build project - run: npm run build - - - name: Deploy to GitHub Pages - uses: JamesIves/github-pages-deploy-action@v4 - with: - branch: gh-pages # Zielbranch für GitHub Pages - folder: dist # Build-Ausgabeordner (Vue + Vite) diff --git a/.github/workflow/tree.yml b/.github/workflow/tree.yml deleted file mode 100644 index d8ae4d3..0000000 --- a/.github/workflow/tree.yml +++ /dev/null @@ -1,33 +0,0 @@ -name: Update Tree.md - -on: - push: - branches: [ "dev" ] - -permissions: - contents: write - -jobs: - update-tree: - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v3 - with: - fetch-depth: 0 - - - name: Generate tree structure - run: | - echo '```' > Tree.md - tree -I 'node_modules|.git|dist' -a >> Tree.md - echo '```' >> Tree.md - - - name: Commit & push Tree.md - run: | - git config --global user.name "GoldForge Bot" - git config --global user.email "github-actions[bot]@users.noreply.github.com" - git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/Goldfruit/GoldForge.git - git add Tree.md - git commit -m "ci: update Tree.md" || echo "nothing to commit" - git push origin dev From 503f8539552a629fea981bf75de3514ce8a40331 Mon Sep 17 00:00:00 2001 From: GoldForge Bot Date: Sun, 30 Mar 2025 21:42:04 +0000 Subject: [PATCH 26/28] ci: update Tree.md --- Tree.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/Tree.md b/Tree.md index 0209289..1a118cd 100644 --- a/Tree.md +++ b/Tree.md @@ -1,9 +1,6 @@ ``` . ├── .github -│   ├── workflow -│   │   ├── deploy.yml -│   │   └── tree.yml │   └── workflows │   ├── deploy.yml │   └── tree.yml @@ -34,5 +31,5 @@ │   └── main.js └── vite.config.js -9 directories, 25 files +8 directories, 23 files ``` From ca232d35aae4c27cd3c051e1ef8b971cbe1130b2 Mon Sep 17 00:00:00 2001 From: Philippe Date: Mon, 31 Mar 2025 22:11:35 +0200 Subject: [PATCH 27/28] add.md --- ATTRIBUTIONS.md | 1 + AUTHORS.md | 1 + CHANGELOG.md | 1 + CODE_OF_CONDUCT.md | 1 + ISSUE_TEMPLATE.md | 1 + LICENSE.md | 1 + PULL_REQUEST_TEMPLATE.md | 1 + SECURITY.md | 1 + 8 files changed, 8 insertions(+) create mode 100644 ATTRIBUTIONS.md create mode 100644 AUTHORS.md create mode 100644 CHANGELOG.md create mode 100644 CODE_OF_CONDUCT.md create mode 100644 ISSUE_TEMPLATE.md create mode 100644 LICENSE.md create mode 100644 PULL_REQUEST_TEMPLATE.md create mode 100644 SECURITY.md diff --git a/ATTRIBUTIONS.md b/ATTRIBUTIONS.md new file mode 100644 index 0000000..faa545c --- /dev/null +++ b/ATTRIBUTIONS.md @@ -0,0 +1 @@ +Diese Dateien dienen dazu, die Mitwirkenden oder externe Ressourcen/Tools zu würdigen und aufzuzählen. \ No newline at end of file diff --git a/AUTHORS.md b/AUTHORS.md new file mode 100644 index 0000000..faa545c --- /dev/null +++ b/AUTHORS.md @@ -0,0 +1 @@ +Diese Dateien dienen dazu, die Mitwirkenden oder externe Ressourcen/Tools zu würdigen und aufzuzählen. \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..357293a --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1 @@ +Dokumentiert die Änderungen und Verbesserungen in den verschiedenen Versionen des Projekts. \ No newline at end of file diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..9a89eef --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1 @@ +Enthält einen Verhaltenskodex, der klarstellt, wie sich Mitwirkende verhalten sollten, um ein respektvolles Miteinander zu gewährleisten. \ No newline at end of file diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md new file mode 100644 index 0000000..828c9a9 --- /dev/null +++ b/ISSUE_TEMPLATE.md @@ -0,0 +1 @@ +Diese Vorlagen helfen dabei, bei der Erstellung von Issues und Pull Requests konsistente Informationen zu liefern und so den Review-Prozess zu vereinfachen. \ No newline at end of file diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..cd8f72e --- /dev/null +++ b/LICENSE.md @@ -0,0 +1 @@ +Legt die Lizenzbedingungen für das Projekt fest, sodass Nutzer und Contributor wissen, unter welchen Bedingungen der Code verwendet werden darf. \ No newline at end of file diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..828c9a9 --- /dev/null +++ b/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1 @@ +Diese Vorlagen helfen dabei, bei der Erstellung von Issues und Pull Requests konsistente Informationen zu liefern und so den Review-Prozess zu vereinfachen. \ No newline at end of file diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..4d146aa --- /dev/null +++ b/SECURITY.md @@ -0,0 +1 @@ +Beschreibt, wie Sicherheitslücken gemeldet werden können und welche Maßnahmen im Falle eines Sicherheitsproblems zu ergreifen sind. \ No newline at end of file From 3b571342e09845bac44a4e071ff2e12e93b72a9a Mon Sep 17 00:00:00 2001 From: GoldForge Bot Date: Mon, 31 Mar 2025 20:32:02 +0000 Subject: [PATCH 28/28] ci: update Tree.md --- Tree.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Tree.md b/Tree.md index 1a118cd..2351760 100644 --- a/Tree.md +++ b/Tree.md @@ -5,7 +5,15 @@ │   ├── deploy.yml │   └── tree.yml ├── .gitignore +├── ATTRIBUTIONS.md +├── AUTHORS.md +├── CHANGELOG.md +├── CODE_OF_CONDUCT.md +├── ISSUE_TEMPLATE.md +├── LICENSE.md +├── PULL_REQUEST_TEMPLATE.md ├── README.md +├── SECURITY.md ├── Tree.md ├── docker-compose.yml ├── goldanker_commands @@ -31,5 +39,5 @@ │   └── main.js └── vite.config.js -8 directories, 23 files +8 directories, 31 files ```