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)
|
||||
- **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
|
||||
|
|
|
|||
|
|
@ -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 <repo-url> ~/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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
**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` |
|
||||
|
|
|
|||
|
|
@ -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/`)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
<!-- TODO: Schritt-für-Schritt Deployment -->
|
||||
|
|
|
|||
|
|
@ -9,6 +9,12 @@
|
|||
|
||||
<!-- 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) │
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue