prompt_template/docs/ARCHITECTURE.md

# Architecture

Systemarchitektur und Komponenten.

## Komponenten

- **`web/serve.py`** – Minimaler Python-HTTP-Server (Port 8081). Liefert die SPA und routet `/templates.json` → `web/templates.json` sowie `/templates/**` → `<ROOT>/templates/**`.
- **`web/index.html`** – Single-Page-Frontend. Lädt den Katalog `/templates.json` und rendert System- und User-Templates.
- **`templates/system/`** – Strukturierte System-Templates (JSON).
- **`templates/user/`** – Benutzer-Templates (Markdown).
- **`scripts/validate.py`** – Validierung der Template-Struktur.

## Datenfluss

1. Browser ruft `/` auf → `web/index.html`.
2. Frontend lädt `/templates.json` (Katalog).
3. Für jeden Eintrag lädt das Frontend die referenzierte Datei aus `/templates/system/*` oder `/templates/user/*`.
4. Bearbeitung erfolgt via `PUT /templates/...` zurück an den Server.

> Stub — noch auszuarbeiten.
-												fix: /templates.json-Bug, AGENTS.md neu strukturiert, fehlende Stubs angelegt

- serve.py: /templates.json mappt nun auf web/templates.json (GET + PUT).
  Zuvor lieferte der Endpoint 404, weil der Handler nach ROOT/templates.json
  suchte, die Datei aber in web/ liegt.
- AGENTS.md als Verhaltensregeln fuer Agenten umgebaut (statt defensive
  Selbstbehauptung in Projektdoku). Erfundene/nicht existente Artefakte
  aus der Doku entfernt, Commit-Tabelle aktualisiert, Tippfehler und
  nicht gerenderter date-Ausdruck korrigiert.
- docs/{GETTING_STARTED,ARCHITECTURE,API_REFERENCE,DEPLOYMENT,DEBUGGING,
  SECURITY}.md als Stubs angelegt (waren in docs/INDEX.md verlinkt, aber
  inexistent).
- history/CHANGELOG.md als Stub angelegt.
- scripts/cleanup_server.sh angelegt (war in AGENTS.md als 'integriert'
  beschrieben, fehlte aber).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

											
										
										
											2026-04-24 13:01:07 +02:00
+								# Architecture
 								Systemarchitektur und Komponenten.
 								## Komponenten
 								- **`web/serve.py`** – Minimaler Python-HTTP-Server (Port 8081). Liefert die SPA und routet `/templates.json` → `web/templates.json` sowie `/templates/**` → `<ROOT>/templates/**`.
 								- **`web/index.html`** – Single-Page-Frontend. Lädt den Katalog `/templates.json` und rendert System- und User-Templates.
 								- **`templates/system/`** – Strukturierte System-Templates (JSON).
 								- **`templates/user/`** – Benutzer-Templates (Markdown).
 								- **`scripts/validate.py`** – Validierung der Template-Struktur.
 								## Datenfluss
 . Browser ruft `/` auf → `web/index.html`.
 . Frontend lädt `/templates.json` (Katalog).
 . Für jeden Eintrag lädt das Frontend die referenzierte Datei aus `/templates/system/*` oder `/templates/user/*`.
 . Bearbeitung erfolgt via `PUT /templates/...` zurück an den Server.
 								> Stub — noch auszuarbeiten.