initiales Projektsetup als skeleton für fresh flask + architecture

ARCHITEKTUR.md

@@ -0,0 +1,50 @@
+# ARCHITEKTUR.md – Systemarchitektur & Datenkonzept
+
+## 1. Übersicht
+
+Formeleon folgt einer entkoppelten Architektur:
+* **Public Form API (`/api/v1`):** Nimmt Formular-Submissions von externen Mandanten-Webseiten entgegen.
+* **Admin Dashboard (`/admin`):** Verwaltung von Mandanten, Formular-Layouts und Submissions.
+* **Form Embed Snippet:** Ein leichtes JS-Script, das dynamisch Formulare rendert und Sicherheits-Tokens verarbeitet.
+
+---
+
+## 2. Ordnerstruktur (Blueprint-Muster)
+
+```text
+formeleon/
+├── AGENTS.md
+├── ARCHITEKTUR.md
+├── README.md
+├── README.EN.md
+├── docker-compose.yml
+├── Dockerfile
+├── requirements.txt
+├── app.py                  # Anwendungs-Initialisierung & Blueprint-Registration
+├── models.py               # SQLAlchemy Datenmodelle
+├── routes/
+│   ├── api.py              # Blueprint: Public Submissions & Handshake (@api_bp)
+│   ├── admin.py            # Blueprint: Admin Panel & Config (@admin_bp)
+│   └── auth.py             # Blueprint: OIDC / Zitadel Handler (@auth_bp)
+├── services/
+│   ├── recaptcha.py        # reCAPTCHA Validation & Mocking
+│   ├── exporter.py         # Stream-Export Logik (CSV/JSON/YAML)
+│   └── mailer.py           # E-Mail Versand (SMTP Relay)
+├── static/
+│   ├── js/                 # Snippets & Mithril.js Admin UI
+│   └── css/                # Bootstrap / Custom Styles
+└── docs/
+    ├── coding-standards.md # Header & PyDoc Spezifikation
+    ├── deployment.md
+    └── dev-guide.md
+```
+
+---
+
+## 3. Datenmodell (SQLAlchemy)
+
+Das Datenmodell nutzt ein flexibles JSON-Payload-Feld für die dynamischen Formulareingaben, um Schema-Änderungen pro Mandant ohne Tabellen-Umbau zu ermöglichen.
+
+* **Tenant:** ID, Name, Public Key, Allowed Origins.
+* **FormConfig:** ID, Tenant_ID, Name, Form-Structure (JSON).
+* **Submission:** ID, FormConfig_ID, Payload (JSON), IP_Hash, Created_At.