init

ai-context/AI-operative_Vorgaben.md

@@ -0,0 +1,41 @@
+# AI.md — Strukturvorgaben für neue Applikation
+
+**Autoren:** Björn Runden, Gerd Goldberg  
+**Zweck dieses Dokuments:** Verbindliche strukturelle, betriebliche und infrastrukturelle Vorgaben für eine neue Python-Applikation. Applikationslogik, Routing und Frontend sind bewusst nicht Teil dieses Dokuments.
+
+---
+
+## 1. Technologie-Stack
+
+| Schicht | Technologie |
+|---|---|
+| Backend-Framework | Python Flask 2.x |
+| OIDC-Authentifizierung | Authlib (gegen Zitadel als externen IdP) |
+| Datenbank / ORM | SQLite + SQLAlchemy |
+| Konfiguration | 12-Factor-App via `.env`-Datei |
+| Produktions-Server | Gunicorn |
+| Container | Docker (`python:3.11-slim`), orchestriert via `docker-compose.yml` |
+
+---
+
+## 2. Verzeichnisstruktur
+
+```text
+.
+├── .gitignore
+├── .env
+├── .env.example
+├── requirements.txt
+├── docker-compose.yml
+├── Dockerfile
+├── wsgi.py
+├── data/                  ← Datenbankverzeichnis (persistente SQLite-Datei, nicht im Image)
+└── app/
+    ├── __init__.py
+    ├── config.py
+    ├── database.py
+    ├── models.py
+    ├── auth.py
+    ├── routes.py
+    ├── templates/
+    └── static/