diff --git a/README.md b/README.md index cacd8a4..13d40d1 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,12 @@ Dieses Repo enthält alle Konfigurationsdateien die nötig sind um GitHub Copilo - **Bootstrap-Skript** – bestehende und geclonte Repos in Sekunden ausstatten (POSIX sh, läuft überall) - **Update-Mechanismus** – Templates und Prompts in allen Repos mit einem Befehl aktuell halten: `git copilot-update` +Für Repos mit einem Namen beginnend mit `rd13_` gilt als allgemeine Infrastruktur-Annahme: + +- Der Runner läuft in Docker. +- Alle Services laufen hinter Caddy als Proxy. +- Die zentrale Proxy-Implementierung liegt im Repo `rd13_system_proxy`. + --- ## Templates aktuell halten – neuer Standard diff --git a/docs/ADMIN.md b/docs/ADMIN.md index 73c1698..6d54434 100644 --- a/docs/ADMIN.md +++ b/docs/ADMIN.md @@ -17,6 +17,12 @@ ## Deployment auf einem neuen System +Für Repos mit einem Namen beginnend mit `rd13_` gilt als Standard-Topologie: + +- Der Runner muss in Docker laufen. +- Alle Services werden über Caddy als Reverse Proxy ausgeliefert. +- Die Proxy-Schicht wird zentral im Repo `rd13_system_proxy` gepflegt. + ```bash git clone ~/dotfiles/copilot-setup cd ~/dotfiles/copilot-setup diff --git a/docs/MAINTAINER.md b/docs/MAINTAINER.md index 11ce9ca..c05fa24 100644 --- a/docs/MAINTAINER.md +++ b/docs/MAINTAINER.md @@ -25,6 +25,12 @@ Dieses Dokument beschreibt Architektur, Designentscheidungen und wie das Projekt └─────────────────────────────────────────────────────────┘ ``` +Für Repos mit einem Namen beginnend mit `rd13_` gilt als Grundannahme: + +- Der Runner läuft in Docker. +- Alle Services werden über Caddy als Proxy bereitgestellt. +- Die zentrale Proxy-Infrastruktur liegt im Repo `rd13_system_proxy`. + --- ## Dateistruktur diff --git a/docs/history/prompts/2026-06-13_rd13-infrastruktur-konvention_session.md b/docs/history/prompts/2026-06-13_rd13-infrastruktur-konvention_session.md new file mode 100644 index 0000000..fa25591 --- /dev/null +++ b/docs/history/prompts/2026-06-13_rd13-infrastruktur-konvention_session.md @@ -0,0 +1,55 @@ +# Session History + +### Prompt 1 +füge als allgemeine information hinzu das in rd13_ beginnenden repos der runner bei forgeji docker sein muss und das alle services über einen caddy als proxy laufen und das repo rd13_system_proxy heißt. + +### Antwort 1 +Ich habe die rd13_-Konvention in den allgemeinen Dokumentations- und Template-Dateien ergänzt, damit neue Repos und die bestehende Doku dieselbe Infrastruktur-Annahme tragen. Ausgeführt wurden diese Schritte: + +```text +read_file /mnt/services-data/rd13_copilot_setup/docs/history/summary/PROJECT_CONTEXT.md +read_file /mnt/services-data/rd13_copilot_setup/docs/MAINTAINER.md +read_file /mnt/services-data/rd13_copilot_setup/docs/ADMIN.md +read_file /mnt/services-data/rd13_copilot_setup/README.md +read_file /mnt/services-data/rd13_copilot_setup/git-templates/.github/copilot-instructions.md +read_file /mnt/services-data/rd13_copilot_setup/git-templates/docs/MAINTAINER.md +read_file /mnt/services-data/rd13_copilot_setup/git-templates/docs/ADMIN.md +apply_patch +read_file /mnt/services-data/rd13_copilot_setup/git-templates/.github/copilot-instructions.md +read_file /mnt/services-data/rd13_copilot_setup/git-templates/docs/MAINTAINER.md +read_file /mnt/services-data/rd13_copilot_setup/git-templates/docs/ADMIN.md +read_file /mnt/services-data/rd13_copilot_setup/docs/MAINTAINER.md +read_file /mnt/services-data/rd13_copilot_setup/docs/ADMIN.md +read_file /mnt/services-data/rd13_copilot_setup/README.md +read_file /mnt/services-data/rd13_copilot_setup/docs/history/summary/PROJECT_CONTEXT.md +apply_patch +run_in_terminal: git -C /mnt/services-data/rd13_copilot_setup diff --check +run_in_terminal: git -C /mnt/services-data/rd13_copilot_setup status --short +``` + +Der Validierungs-Check `git diff --check` war sauber, und die geänderten Dateien waren: + +```text + M README.md + M docs/ADMIN.md + M docs/MAINTAINER.md + M docs/history/summary/PROJECT_CONTEXT.md + M git-templates/.github/copilot-instructions.md + M git-templates/docs/ADMIN.md + M git-templates/docs/MAINTAINER.md +``` + +### Prompt 2 +das können wir commiten und puschen und dann die lokale systemschicht updaten. + +### Antwort 2 +Ich habe die rd13_-Konvention noch einmal präzisiert und das Session-Log plus den Projektkontext vorbereitet, damit der Commit die Pflicht-History enthält. Ausgeführt wurden diese Schritte: + +```text +file_search /mnt/services-data/rd13_copilot_setup/docs/history/prompts/2026-06-13*_session.md +read_file /mnt/services-data/rd13_copilot_setup/docs/history/summary/PROJECT_CONTEXT.md +read_file /mnt/services-data/rd13_copilot_setup/git-templates/.github/copilot-instructions.md +apply_patch +``` + +Der nächste Schritt ist der Commit, danach Push und das lokale Setup-Update. \ No newline at end of file diff --git a/docs/history/summary/PROJECT_CONTEXT.md b/docs/history/summary/PROJECT_CONTEXT.md index 8651137..e49a5c8 100644 --- a/docs/history/summary/PROJECT_CONTEXT.md +++ b/docs/history/summary/PROJECT_CONTEXT.md @@ -8,7 +8,7 @@ ## Aktueller Projektstatus -**Letzte Aktualisierung:** 2026-06-10 – Agent-History nach `docs/history/` verschoben (+ Auto-Migration für bestehende Repos); zuvor Portabilität (WP1–7,11,12) +**Letzte Aktualisierung:** 2026-06-13 – rd13_-Grundkonvention ergänzt: Runner heißt Docker, Services hinter Caddy, zentrales Proxy-Repo `rd13_system_proxy` **Phase:** Produktion / stabil – wird bei Bedarf erweitert --- @@ -20,6 +20,10 @@ jedes neue oder bestehende Git-Repo automatisch mit Copilot-Instruktionen, VS Co Einstellungen, Dokumentations-Templates, Agent-History-Struktur und einem pre-commit Quality Gate aus. +Für Repos mit einem Namen beginnend mit `rd13_` gilt als allgemeine Infrastruktur-Annahme: +Der Runner läuft in Docker, alle Services werden über Caddy als Proxy bereitgestellt und +die zentrale Proxy-Schicht liegt im Repo `rd13_system_proxy`. + **Stack:** Shell (POSIX sh + fish), Markdown **Deployment:** `bash scripts/deploy.sh` oder `fish scripts/deploy.fish` auf jedem neuen System @@ -29,6 +33,7 @@ Quality Gate aus. | Datum | Aufgabe | Ergebnis | Entscheidungen | |---|---|---|---| +| 2026-06-13 | rd13_-Infrastrukturkonvention | Runner in Docker; alle Services hinter Caddy; zentrales Proxy-Repo `rd13_system_proxy` | this session | | 2026-06-10 | Agent-History → `docs/history/` + Auto-Migration | pre-commit Cutover, alle Skripte, settings/prompt/instructions/docs; `git mv` dieses Repos | `2b20a98` + Dogfood | | 2026-06-10 | WP12 Doku-Portabilität | README/USER/ADMIN/MAINTAINER: env/config, init-copilot, offline; tote IP raus | `afd5b38` | | 2026-06-10 | WP11 CI + selftest | `.github/workflows/ci.yml` (shellcheck+fish -n+selftest), `scripts/selftest.sh` | `deca872` | diff --git a/git-templates/.github/copilot-instructions.md b/git-templates/.github/copilot-instructions.md index 10f96df..4b9e377 100644 --- a/git-templates/.github/copilot-instructions.md +++ b/git-templates/.github/copilot-instructions.md @@ -76,6 +76,11 @@ - Key constraints: - ADR location: `docs/adr/` +### rd13_-Konventionen +- In Repos, deren Name mit `rd13_` beginnt, muss der Runner in Docker laufen. +- Alle Services laufen hinter einem Caddy als Reverse Proxy. +- Das zentrale Proxy-Repo heißt `rd13_system_proxy`. + ## Project Structure Conventions ### Persistent Data (`/data/`) diff --git a/git-templates/docs/ADMIN.md b/git-templates/docs/ADMIN.md index 23f6b0d..4bd6839 100644 --- a/git-templates/docs/ADMIN.md +++ b/git-templates/docs/ADMIN.md @@ -20,6 +20,12 @@ ## Deployment +Für Repos mit einem Namen beginnend mit `rd13_` gilt als Standard-Topologie: + +- Der Runner muss in Docker laufen. +- Alle Services werden über Caddy als Reverse Proxy ausgeliefert. +- Die Proxy-Schicht wird zentral im Repo `rd13_system_proxy` gepflegt. + ### Erstes Aufsetzen diff --git a/git-templates/docs/MAINTAINER.md b/git-templates/docs/MAINTAINER.md index 0a2da63..7a77bd9 100644 --- a/git-templates/docs/MAINTAINER.md +++ b/git-templates/docs/MAINTAINER.md @@ -9,6 +9,12 @@ +Für Repos mit einem Namen beginnend mit `rd13_` gilt als Grundannahme: + +- Der Runner läuft in Docker. +- Alle Services werden über Caddy als Proxy bereitgestellt. +- Die zentrale Proxy-Infrastruktur liegt im Repo `rd13_system_proxy`. + ``` ┌──────────────────────────────────────────────────────────┐ │ TODO: Architektur-Diagramm (ASCII oder Mermaid) │