formeleon/ARCHITEKTUR.md

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)

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.