docs: add rd13 infrastructure conventions
Some checks failed
CI / Lint & self-test (push) Has been cancelled
Some checks failed
CI / Lint & self-test (push) Has been cancelled
This commit is contained in:
parent
5dc89f01a7
commit
e83c333d75
8 changed files with 96 additions and 1 deletions
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
@ -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 (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
|
**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` |
|
||||||
|
|
|
||||||
|
|
@ -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/`)
|
||||||
|
|
|
||||||
|
|
@ -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 -->
|
||||||
|
|
|
||||||
|
|
@ -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) │
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue