154 lines
3.8 KiB
Markdown
154 lines
3.8 KiB
Markdown
---
|
|
kind: rule
|
|
project: HiveGrid Screen Project
|
|
area: Obsidian
|
|
status: active
|
|
---
|
|
|
|
# Obsidian Struktur
|
|
|
|
Dieser Vault ist der Arbeitsbereich fuer Screens, Wireframes und Handoffs.
|
|
|
|
---
|
|
|
|
## Ordner
|
|
|
|
| Ordner | Zweck |
|
|
|---|---|
|
|
| `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 |
|
|
|
|
---
|
|
|
|
## Dateiarten
|
|
|
|
| Dateiart | Beispiel | Zweck |
|
|
|---|---|---|
|
|
| Paket-Datei | `WF-[Ticket] [Flow Name].md` | sammelt Scope, Brainstorming, Screen-Liste und Handoff |
|
|
| Screen-Datei | `S01 Profil auswaehlen.md` | beschreibt genau einen Screen |
|
|
| State-Datei | `ST01 Keine Suchergebnisse.md` | beschreibt einen Zustand, der nicht als eigener Frame gebaut wird |
|
|
| Canvas-Datei | `WF-[Ticket] [Flow Name].canvas` | visueller Flow-Tree in Obsidian Canvas |
|
|
| Tracker | `Screen Paket Tracker.md` | Uebersicht ueber Pakete und Status |
|
|
|
|
---
|
|
|
|
## Flow-Typen
|
|
|
|
| Typ | Bedeutung |
|
|
|---|---|
|
|
| Normaler Flow | eigener Nutzerweg mit Start, Entscheidung und Ziel |
|
|
| Zubringerflow | klaert Vorbedingungen und fuehrt in einen anderen Flow |
|
|
| Auth-Core-Flow | zentraler Sicherheitsflow, der von mehreren Zubringerflows genutzt wird |
|
|
|
|
Aktuelle Auth-Core-Entscheidung:
|
|
|
|
- `WF-P2 Set Password` ist ein zentraler Auth-Core-Flow.
|
|
- Passwort Reset, Einladung/initialer Mitarbeiterzugang, Passwort aendern, Admin-Reset und Security-Incident koennen dorthin fuehren.
|
|
- Neukunden-Signup ist die Ausnahme und setzt das Passwort direkt im Signup-Flow.
|
|
|
|
---
|
|
|
|
## Benennung
|
|
|
|
Pakete:
|
|
|
|
```text
|
|
WF-[Ticket] [Name].md
|
|
```
|
|
|
|
Screens:
|
|
|
|
```text
|
|
S01 [Screen Name].md
|
|
S02 [Screen Name].md
|
|
B01 [Branch Name].md
|
|
ST01 [State Name].md
|
|
```
|
|
|
|
IDs:
|
|
|
|
- `S01`, `S02`, `S03` = Hauptflow
|
|
- `B01`, `B02`, `B03` = Branch/Variante
|
|
- `M01`, `M02` = Modal/Overlay
|
|
- `ST01`, `ST02` = Zustand
|
|
|
|
---
|
|
|
|
## Link-Anzeige in Tabellen
|
|
|
|
In Tabellen werden lange Links mit normalen Markdown-Links gekuerzt.
|
|
|
|
Warum: Obsidian-Wiki-Aliase nutzen `|`, und dieses Zeichen kann Markdown-Tabellen kaputt machen.
|
|
|
|
Beispiel:
|
|
|
|
```md
|
|
[MD](<P2 Auth/WF-P2 Login und 2FA/Screens/S01 Login.md>)
|
|
[Canvas](<P2 Auth/WF-P2 Login und 2FA/WF-P2 Login und 2FA.canvas>)
|
|
```
|
|
|
|
Regel:
|
|
|
|
- In Tracker-Tabellen kurze Labels verwenden: `MD`, `Canvas`, `Subframe`.
|
|
- In Tabellen keine `[[Pfad|Alias]]`-Links verwenden.
|
|
- Lange Pfade nur in der Datei selbst oder im Frontmatter ausschreiben.
|
|
- Der sichtbare Tabelleninhalt soll scanbar bleiben.
|
|
|
|
---
|
|
|
|
## Frontmatter
|
|
|
|
Jede Paket- und Screen-Datei bekommt oben Metadaten. Dadurch kann Obsidian spaeter Tabellen daraus bauen.
|
|
|
|
Beispiel Screen:
|
|
|
|
```yaml
|
|
---
|
|
kind: screen
|
|
ticket: P2
|
|
package: WF-[Ticket] [Flow Name]
|
|
id: S01
|
|
screen: Profil auswaehlen
|
|
umsetzung: Bauen
|
|
status: Validiert
|
|
subframe: ""
|
|
---
|
|
```
|
|
|
|
---
|
|
|
|
## Obsidian Canvas
|
|
|
|
Canvas-Dateien liegen direkt im jeweiligen Paketordner.
|
|
|
|
Grid-Regel:
|
|
|
|
- Hauptflow nach rechts
|
|
- Varianten nach unten
|
|
- Varianten laufen danach wieder nach rechts weiter
|
|
- wenn es unuebersichtlich wird, entsteht ein neues Paket
|
|
|
|
Qualitaetsregel:
|
|
|
|
- keine ueberlappenden Nodes
|
|
- keine verdeckten Labels
|
|
- keine Kante durch andere Karten
|
|
- kurze Kantenlabels mit genug Abstand
|
|
- Canvas nach dem Erstellen mit JSON-Check pruefen
|
|
|
|
---
|
|
|
|
## Subframe-Schutz
|
|
|
|
Subframe wird nicht automatisch aus dem Tracker heraus bearbeitet.
|
|
|
|
Regel:
|
|
|
|
- Bestehende Subframe-Screens bleiben unberuehrt, auch wenn sie gleich heissen.
|
|
- Der Assistant darf Subframe nur nach expliziter Freigabe fuer einen konkreten Flow nutzen.
|
|
- Ohne Freigabe werden nur Obsidian-Dateien vorbereitet: Paket, Screens, Canvas, Tracker.
|
|
- David kann bestehende oder gleichnamige Subframe-Screens spaeter selbst pruefen, ersetzen oder loeschen.
|