docs: add rd13 infrastructure conventions
Some checks failed
CI / Lint & self-test (push) Has been cancelled

This commit is contained in:
Conrad Schulz 2026-06-13 05:49:02 +00:00
parent 5dc89f01a7
commit e83c333d75
8 changed files with 96 additions and 1 deletions

View file

@ -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) - **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` - **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 ## Templates aktuell halten neuer Standard

View file

@ -17,6 +17,12 @@
## Deployment auf einem neuen System ## 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 ```bash
git clone <repo-url> ~/dotfiles/copilot-setup git clone <repo-url> ~/dotfiles/copilot-setup
cd ~/dotfiles/copilot-setup cd ~/dotfiles/copilot-setup

View file

@ -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 ## Dateistruktur

View file

@ -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.

View file

@ -8,7 +8,7 @@
## Aktueller Projektstatus ## Aktueller Projektstatus
**Letzte Aktualisierung:** 2026-06-10 Agent-History nach `docs/history/` verschoben (+ Auto-Migration für bestehende Repos); zuvor Portabilität (WP17,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 **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 Einstellungen, Dokumentations-Templates, Agent-History-Struktur und einem pre-commit
Quality Gate aus. 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 **Stack:** Shell (POSIX sh + fish), Markdown
**Deployment:** `bash scripts/deploy.sh` oder `fish scripts/deploy.fish` auf jedem neuen System **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 | | 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 | 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 | 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` | | 2026-06-10 | WP11 CI + selftest | `.github/workflows/ci.yml` (shellcheck+fish -n+selftest), `scripts/selftest.sh` | `deca872` |

View file

@ -76,6 +76,11 @@
- Key constraints: - Key constraints:
- ADR location: `docs/adr/` - 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 ## Project Structure Conventions
### Persistent Data (`/data/`) ### Persistent Data (`/data/`)

View file

@ -20,6 +20,12 @@
## Deployment ## 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 ### Erstes Aufsetzen
<!-- TODO: Schritt-für-Schritt Deployment --> <!-- TODO: Schritt-für-Schritt Deployment -->

View file

@ -9,6 +9,12 @@
<!-- TODO: Beschreibe die Architektur (C4, Hexagonal, Event-Driven, etc.) --> <!-- TODO: Beschreibe die Architektur (C4, Hexagonal, Event-Driven, etc.) -->
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) │ │ TODO: Architektur-Diagramm (ASCII oder Mermaid) │