# Subframe UI Standards

Status: Entwurf
Datum: 2026-06-02

Dieses Standards-Projekt dokumentiert dauerhafte Subframe-, Komponenten- und Layout-Standards fuer HiveGrid.

Seit 2026-06-29 liegt es als eigenes Standards-Projekt im HiveGrid-Wireframe-Repo.
Die HiveGrid-Einordnung und der Aenderungsschutz stehen in [[00_HiveGrid-Einordnung]].

Es dokumentiert Standards, die nicht direkt in einzelnen Screens oder in Subframe selbst geloest werden:

- Benennung
- State-Namen
- Varianten-Namen
- Size-Namen
- Defaults
- globale Component-API-Regeln
- komponenteninterne Abstaende
- Gruppenregeln
- Komponenten-Links und Notizen

Es soll wachsen, wenn echte, validierte Standards entstehen.

## Struktur

| Datei | Zweck |
| --- | --- |
| [[00_HiveGrid-Einordnung]] | Einordnung im HiveGrid-Repo, Zweck, Abgrenzung und Aenderungsschutz |
| [[01_Brainstorming]] | Rohe Ideen und offene Gedanken |
| [[02_Entscheidungen]] | Entscheidungen, die nachvollziehbar bleiben sollen |
| [[03_Benennung]] | Globale Regeln fuer Namen und Begriffe |
| [[04_Gruppenregeln]] | Regeln fuer Komponenten-Gruppen |
| [[05_Komponenten-Index]] | Link- und Statusuebersicht mit Fertig-Checkbox |
| [[06_Backlog]] | Themen fuer spaeter |
| [[07_Global-Rules]] | Globale Component-API- und Arbeitsregeln |
| [[08_Todo]] | Eigenstaendige Aufgabenliste fuer Komponenten-Pruefpunkte und Nacharbeiten |
| `Layout/` | Validierte Layout-, Spacing-, Dialog-, Table- und Composition-Regeln |
| [[AI/07_AI-References]] | Arbeitskontext und Ablauf fuer AI-Aenderungen |
| [[AI/08_AI-Change-History]] | AI-Verlauf nur fuer Aenderungen am Subframe UI Standards / Component Library Regelwerk |
| `Components/` | Einzelne Komponenten-Notizen mit Subframe-Link, Bereich und Regel-Referenzen |

## Grundmodell

Standards werden so hoch wie moeglich und so spezifisch wie noetig dokumentiert.

1. Globale Benennungen stehen in [[03_Benennung]].
2. Globale Component-API-Regeln stehen in [[07_Global-Rules]].
3. Gruppenregeln stehen in [[04_Gruppenregeln]].
4. Der Komponenten-Index ist nur eine Link- und Statusuebersicht.
5. Einzelne Komponenten-Notizen stehen unter `Components/`.
6. Dauerhafte Layout-Regeln stehen unter `Layout/`, sobald sie validiert sind.
7. Laufende Aufgaben und Pruefpunkte der Subframe UI Standards stehen in [[08_Todo]].
8. AI-Aenderungen am Subframe UI Standards / Component Library Regelwerk werden in [[AI/08_AI-Change-History]] protokolliert; fuer repo-weite Aenderungen ist Git der Verlauf.

Bei Arbeit mit AI zuerst [[AI/07_AI-References]] lesen.

Wenn die Arbeit aus dem HiveGrid-Wireframe-Kontext kommt, zuerst [[00_HiveGrid-Einordnung]] lesen.

Beispiel:

- `disabled` wird global geklaert.
- Field-Anatomy-Abstaende fuer Form Inputs stehen in [[04_Gruppenregeln]].
- Text-Input-spezifische Notizen stehen in [[Components/Text Input]].