Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

+7
View File
@@ -1,2 +1,9 @@
# Lokaler Obsidian UI-/Tab-Zustand.
.obsidian/workspace.json
# Temporaere lokale Preview-Labs fuer Brainstorming. Nach Abschluss loeschen.
99 Temp/
# Lokale System-/Dependency-Dateien nicht ins Wireframe-Repo uebernehmen.
.DS_Store
node_modules/
+3 -1
View File
@@ -15,7 +15,9 @@ Ziel: Alle Wireframe-Regeln, Pakete, Screen-Notizen, Banner, Toasts, Zustaende u
| [[02 Wireframes/Screen Paket Tracker]] | Zentrale Kontrolltabelle fuer alle Flows, Screens, Canvas- und Subframe-Links. |
| [[02 Wireframes/_Templates/Wireframe Paket Template]] | Vorlage fuer ein neues Wireframe-Paket. |
| [[02 Wireframes/_Templates/Screen Template]] | Vorlage fuer eine einzelne Screen-Datei. |
| [[03 Quellen und Repo/Repo Notizen]] | Wo das Gitea-Repo liegt und wie du die Planning-Dateien aktualisierst. |
| [[03 Quellen und Referenzen/README]] | Quellen, Referenz-Repos und Repo-Hinweise. |
| [[04 Standards/README]] | UI-, Layout- und Subframe-Standards. |
| [[Tickets/README]] | Fertige Ticket-Handoffs und Ticket-Index. |
---
+12 -2
View File
@@ -18,8 +18,11 @@ Dieser Vault ist der Arbeitsbereich fuer Screens, Wireframes und Handoffs.
| `01 Regeln` | dauerhafte Regeln und Arbeitsweisen |
| `02 Wireframes` | alle Wireframe-Pakete, Screen-Dateien und Canvas-Dateien |
| `02 Wireframes/_Templates` | Vorlagen fuer neue Pakete und Screens |
| `03 Quellen und Repo` | Hinweise zum Gitea-Repo und lokalen Planning-Dateien |
| `hivegrid-cloud` | technisches Repo mit Planning-Quellen |
| `03 Quellen und Referenzen` | Quellen, Referenz-Repos und Repo-Hinweise |
| `03 Quellen und Referenzen/hivegrid-cloud` | mitgepushte HiveGrid-Cloud-Referenz mit Planning-Quellen |
| `04 Standards/Subframe UI Standards` | eigenes Standards-Projekt fuer dauerhafte Subframe-, Komponenten- und Layout-Standards |
| `Tickets` | Ticket-Handoff-Index |
| `Tickets/Fertige Tickets` | fertige oder handofffaehige Ticket-Zusammenfassungen |
---
@@ -152,6 +155,13 @@ Sync-Regel:
Subframe wird nicht automatisch aus dem Tracker heraus bearbeitet.
Die Subframe UI Standards unter `04 Standards/Subframe UI Standards/` sind ebenfalls geschuetzt:
- Sie sind ein eigenes Standards-Projekt innerhalb dieses Repos.
- Sie werden als Referenz fuer Layout-, Komponenten- und Subframe-Konventionen genutzt.
- Sie duerfen nicht durch normale Screen-/Flow-Arbeit automatisch umgeschrieben werden.
- Aenderungen brauchen eine explizite Aufgabe oder eine vorher validierte systemweite Entscheidung.
Regel:
- Bestehende Subframe-Screens bleiben unberuehrt, auch wenn sie gleich heissen.
+5 -3
View File
@@ -22,6 +22,7 @@ This file is the operative checklist. `Screen Agent Workflow - Brainstorming.md`
- MUST check for similar existing flows, screens, reusable patterns and naming conflicts before creating a new flow or screen.
- MUST use internal Planning as the default source of truth.
- MUST use external research only as decision support, and validate relevant research-derived ideas with David before they enter planning.
- MUST use `04 Standards/Subframe UI Standards/` as reference for already validated Subframe, component and layout standards when relevant.
- MUST give an assumption and recommendation before asking David a decision question.
- MUST have David validate every product, UX, screen, state, backlog, scope and research-derived decision.
- MUST keep one small flow or screen package in focus at a time.
@@ -40,6 +41,7 @@ This file is the operative checklist. `Screen Agent Workflow - Brainstorming.md`
- NEVER finalize unvalidated decisions.
- NEVER silently create, delete, rename or split screens.
- NEVER build or edit Subframe without explicit OK for the concrete screen or flow.
- NEVER edit `04 Standards/Subframe UI Standards/` during normal screen work unless David explicitly asks for standards work or validates a systemwide rule that belongs there.
- NEVER overwrite or revert David's manual changes in Obsidian or Subframe.
- NEVER let external examples override internal Planning without making the conflict visible and asking David.
- NEVER create Canvas nodes for normal Toasts, Banners, Inline States, field validation or pure documentation states.
@@ -155,9 +157,9 @@ Then check:
When a ticket is finished, ready for external ticket-system handoff, or David asks for a ticket summary:
- Create or update one Markdown file in `Tickets/`.
- Use the same structure as `Tickets/D-P2 Auth Wireframes.md`.
- Name it clearly after the ticket and area, for example `Tickets/D-P2 Auth Wireframes.md`.
- Create or update one Markdown file in `Tickets/Fertige Tickets/`.
- Use the same structure as `Tickets/Fertige Tickets/D-P2 Auth Wireframes.md`.
- Name it clearly after the ticket and area, for example `Tickets/Fertige Tickets/D-P2 Auth Wireframes.md`.
- Include ticket id, area, status, repo link, central tracker link and working area.
- Summarize what was done, what David validated and what remains Backlog/Open.
- Link every relevant flow package MD, Canvas and Subframe flow.
@@ -0,0 +1,157 @@
---
kind: brainstorming
ticket: D-D0b
area: Layout Standards
status: In Planung
---
# D-D0b Layout Brainstorming
## Ziel
D-D0b wird fuer diese Runde als Layout- und Composition-Standard geplant, nicht als Komponenten-Katalog.
Fokus:
- Layout-Raster und Page Padding
- Textabstaende und vertikale Rhythmik
- Breiten fuer kleine, normale und grosse Dialoge
- Form-, Tabellen-, Listen- und Settings-Composition
- Zustandsflaechen wie Empty, Loading, Error, No Permission
Nicht Fokus:
- konkrete Subframe-Komponenten
- App-Shell-Definition
- fachliche Feature-Flows
- Backend-/Datenmodell-Logik
## Temporaeres Preview-Lab
Lokales Preview-Lab:
`99 Temp/D-D0b Layout Preview/index.html`
Dieses Lab dient nur dazu, Layoutgroessen und Abstaende visuell zu entscheiden. Es ist kein Source of Truth und darf nicht als finaler Screen oder Komponentenbibliothek behandelt werden.
Wichtig:
- Der Ordner `99 Temp/` ist per `.gitignore` ausgeschlossen.
- Nach Abschluss der D-D0b-Brainstorming- und Validierungsrunde muss `99 Temp/D-D0b Layout Preview/` geloescht werden.
- Validierte Entscheidungen werden danach in diese D-D0b-Dokumentation uebertragen.
- Nicht validierte Varianten bleiben nicht als finale Regel stehen.
## Preview-Visualisierung
Im lokalen Preview-Lab werden Abstaende visuell markiert:
- Lila = `Padding` / Innenabstand.
- Tuerkis = `Gap` / Abstand zwischen getrennten Elementen.
- Weiss = eigentlicher Inhalt / Content.
Begriffe:
- `Padding`: Innenabstand innerhalb eines Containers. Beispiel: Abstand zwischen Kartenrand und Karteninhalt, zwischen Dialogrand und Dialoginhalt, zwischen Tabellenzellenrand und Zelltext oder zwischen Buttonrand und Buttonlabel.
- `Gap`: Abstand zwischen mehreren Elementen innerhalb eines Layouts. Beispiel: Abstand zwischen Formularfeldern, Karten, Buttons oder Layout-Spalten.
- `Margin`: Aussenabstand eines einzelnen Elements zu anderen Bereichen. In den HiveGrid-Layout-Regeln soll bevorzugt mit Auto Layout/Flex/Grid-Gaps gearbeitet werden, weil das konsistenter steuerbar ist.
Regel fuer das Preview:
- Die Preview-Seite muss sich selbst an die Regeln halten, die sie gerade testet. Keine zusaetzlichen Zufallsabstaende nur fuer die Demo.
- Nur der jeweils relevante Abstand soll visuell markiert werden.
- Wenn es um Card Padding geht, wird die Card-Innenflaeche markiert.
- Wenn es um Dialog Padding geht, wird Header/Body/Footer-Innenabstand markiert.
- Wenn es um Tabellen geht, wird Cell Padding markiert.
- Wenn es um Formularabstaende geht, muss klar unterschieden werden zwischen Input-Padding und Field-Gap.
## Carbon-Referenzen
- 2x Grid: https://carbondesignsystem.com/elements/2x-grid/overview/
- Spacing: https://carbondesignsystem.com/elements/spacing/overview/
- Modal Usage: https://carbondesignsystem.com/components/modal/usage/
- Forms Pattern: https://carbondesignsystem.com/patterns/forms-pattern/
## Subframe UI Standards als zentrale Shell
Die Subframe UI Standards liegen als eigenes Standards-Projekt im Repo:
- [00_HiveGrid-Einordnung](<../../../04 Standards/Subframe UI Standards/00_HiveGrid-Einordnung.md>)
- [Subframe UI Standards Start](<../../../04 Standards/Subframe UI Standards/00_Start.md>)
- [Layout-Regeln](<../../../04 Standards/Subframe UI Standards/Layout/README.md>)
Zweck:
- D-D0b bleibt der Arbeits- und Validierungsort fuer Layout-Entscheidungen.
- Die Subframe UI Standards sind die dauerhafte Zielstruktur fuer systemweite Subframe-, Komponenten- und Layout-Standards.
- Nach Davids Validierung koennen D-D0b-Entscheidungen in den Layout-Bereich der Subframe UI Standards uebertragen werden.
Abgrenzung:
- Keine Regel in den Subframe UI Standards wird durch diese D-D0b-Datei automatisch geaendert.
- Keine unvalidierten D-D0b-Werte werden als finale Subframe-Regel gespeichert.
- Wenn eine Layout-Regel uebertragen wird, muss klar sein, ob sie allgemein gilt oder nur fuer bestimmte Layout-Archetypen.
## Erste Entscheidungsbereiche
Die Entscheidungen werden einzeln validiert. David muss nicht die komplette Seite auf einmal abnehmen.
Validierungsreihenfolge:
| ID | Entscheidung | Worum es geht |
|---|---|---|
| D01 | Grundraster / Spacing Scale | Welche Abstandswerte sind erlaubt? |
| D02 | Page & Card Padding | Wie viel Innenabstand bekommen Seiten, Karten, Dialogbereiche, Tabellenzellen und Buttons? |
| D03 | Text-Rhythmus | Wie nah stehen Titel, Beschreibung und erster Inhalt zusammen? |
| D04 | Buttons | Welche Button-Hoehen und horizontalen Innenabstaende wirken richtig? |
| D05 | Formulare | Wie dicht stehen Formularfelder, Labels und Help/Error-Texte? |
| D06 | Tabellen | Welche Row Height und welches Cell Padding gelten fuer Admin-Tabellen? |
| D07 | Dialoge | Welche Breiten gelten fuer kleine, normale und grosse Dialoge? |
| D08 | States | Wie gross sind Empty, Error und No-Permission-Bereiche? |
Arbeitsregel:
- Der Agent fuehrt David immer nur durch die naechste offene Entscheidung.
- Jede Entscheidung wird erst dokumentiert, wenn David sie explizit validiert hat.
- Wenn eine Entscheidung spaeter geaendert wird, muss ein Impact-Check auf die anderen Layout-Regeln erfolgen.
### 1. Grundraster
Zu klaeren:
- Ist ein 8px-Rhythmus als Hauptstandard passend?
- Welche Zwischenwerte sind erlaubt: 4px, 12px, 20px?
- Welche Abstaende gelten fuer eng verwandte Elemente, Feldgruppen und grosse Sections?
### 2. Page Padding
Zu klaeren:
- Standard Desktop Page Padding
- kompakter Admin-/Settings-Padding-Standard
- Umgang mit Tabellen: full width vs. constrained
### 3. Text-Rhythmik
Zu klaeren:
- Abstand Page Title zu Subtitle
- Abstand Subtitle zu erstem Content
- Abstand Section Title zu Beschreibung
- Abstand Beschreibung zu Inhalt
### 4. Formulare
Zu klaeren:
- Label/Input-Abstand
- Input/Help/Error-Abstand
- Abstand zwischen Feldern
- Abstand zwischen Form-Sections
### 5. Dialogbreiten
Zu klaeren:
- kleine Confirm-Dialoge
- normale Formular-Dialoge
- grosse Editor-Dialoge
- maximale Breite relativ zum Viewport
### 6. Listen und Tabellen
Zu klaeren:
- Toolbar zu Tabelle
- Row Height
- Zell-Padding
- Empty/Loading/Error-Bereich
+18
View File
@@ -0,0 +1,18 @@
# Quellen und Referenzen
Dieser Bereich sammelt Quellen, Referenz-Repos und Repo-Hinweise.
Hier liegt Kontext, der fuer Wireframe- und UX-Planung gelesen werden kann, aber nicht selbst der aktive Screen-Arbeitsbereich ist.
## Inhalt
| Pfad | Zweck |
|---|---|
| `hivegrid-cloud/` | mitgepushte HiveGrid-Cloud-Referenz inklusive Planning, Ticket-Docs und Code-Kontext |
| [[Repo Notizen]] | Hinweise zum Aktualisieren und Nutzen der HiveGrid-Cloud-Referenz |
## Regel
Quellen duerfen fuer Planung und Research genutzt werden.
Produkt- oder UX-Entscheidungen werden trotzdem erst in den Wireframe-Paketen dokumentiert, nachdem David sie validiert hat.
+28
View File
@@ -0,0 +1,28 @@
# Repo Notizen
Die mitgepushte HiveGrid-Cloud-Referenz liegt hier:
```text
03 Quellen und Referenzen/hivegrid-cloud
```
Wichtige Planning-Dateien aus dem Repo:
- `03 Quellen und Referenzen/hivegrid-cloud/.planning/SCREEN-MAP.md`
- `03 Quellen und Referenzen/hivegrid-cloud/.planning/DESIGNER-FIRST-PLAYBOOK.md`
- `03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/`
Repo aktualisieren:
```bash
cd "/Users/davidbertram/Desktop/Subframe/HiveGrid-Screen-Project/03 Quellen und Referenzen/hivegrid-cloud"
git pull --ff-only
```
Hinweis: Diese Referenz ist fuer die Wireframe-Arbeit vor allem auf Lesen/Pullen ausgelegt. Relevante Planning-Aenderungen werden im Hauptrepo mitgepusht.
Alter lokaler Backup-Ordner:
```text
/Users/davidbertram/Desktop/HiveGrid-Backups/
```
File renamed without changes.
File renamed without changes.
File renamed without changes.
Loaded 100 of 5885 files, more files were not shown because too many files have changed in this diff. Show more