42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# AI.md — Strukturvorgaben für neue Applikation
|
|
|
|
**Autoren:** Björn Runden <br@chamaeleoncloud.de>, Gerd Goldberg <Gerd.Goldberg@outlook.com>, Bruno Runden <acc@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/
|