kbcrm/ai-context/AI-operative_Vorgaben.md

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

.
├── .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/