# AI.md — Strukturvorgaben für neue Applikation

**Autoren:** Björn Runden <br@chamaeleoncloud.de>, Gerd Goldberg <Gerd.Goldberg@outlook.com>, Bruno Runden <mail@bruno.zone>
**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/