Specification
The spec is the single source of truth: when code and spec disagree, the spec wins. It is written in German; the type definitions in @real-life/data-interface are the precise English contract for all data shapes. Index: docs/spec/README.md.
| Document | Status | Content (German) |
|---|---|---|
| 00-architecture.md | Normativer Startpunkt | Schichtenmodell, Verantwortlichkeiten und Architekturregeln |
| 01-app-composition.md | Normativer Entwurf | App Shell, Current Space, Space Modules und Module Components |
| 02-data-interface.md | Normativer Entwurf | Read-only Core-Vertrag, Items, Observables und Filter |
| 03-capabilities.md | Normativer Entwurf | Optionale Connector-Fähigkeiten, Type Guards und FullConnector-Abgrenzung |
| 04-items-relations-groups-spaces.md | Normativer Entwurf | Items, Relations, Groups/Spaces und Projektionen für RLNP/Game |
| 05-confirmations-and-trust.md | Normativer Entwurf | Claims, Confirmations, Attestations und Trust-Level |
| 06-schema-composition.md | Normativer Entwurf | Schema-Komposition über `@context`, Standardvokabulare, `type`-Hint, Typ-Register |
| 07-tags.md | Normativer Entwurf | Tags als Kategorisierungs-Achse: einfache Strings + strukturierte URN-Tags |
| 08-relation-records.md | Normativer Entwurf | Relationen als eigenständige Items (`type: "relation"`), `RelationStoreCapable`, Trust-Bindung an Confirmations |
| 09-mirror-bridge.md | Normativer Entwurf (Implementierung ab Netzwerk-App P2) | Items in mehreren Spaces: Canonical Home, read-only Mirror-Snapshots, Brücken-Clients; Mitgliedschaftsbindung, Ablage/Registry, `MirrorCapable` |
| 10-activity-log.md | Normativer Entwurf | CRUD-Historie pro Space: Collection-Form, ID-/Merge-Ordnung, Retention, Atomarität |
| 11-runtime-config-und-branding.md | Normativer Entwurf | Ein Artefakt, viele Instanzen: Endpunkte und Identität zur Laufzeit statt zur Build-Zeit |
| 12-profile.md | Normativer Entwurf (erste Anwendung von 09) | Profil = person-Item im persönlichen Space, Mirror je freigegebenem Gruppen-Space; Freigabe, Widerruf, Ablage |
| glossary.md | Lebendes Dokument | Kurzdefinitionen der Spec-Begrifflichkeit mit Verweisen auf die normative Quelle |
| schemas/README.md | Konventionen, Komposition, Versionierung | |
| schemas/vocab/ | Pro Vokabular: `context.jsonld` (JSON-LD) + `schema.json` (JSON-Schema) + `examples/valid/` | |
| modules/ | Normative Detail-Specs im Aufbau | Verbindliche Space-Module-Spezifikationen auf Basis der Kern-Spec |
| code-and-storybook-mapping.md | Normativer Entwurf | Abbildung von App Shell, Space Modules, Module Components und Primitives in Code und Storybook |
| architektur2.md | Historische Referenz, nicht direkt normativ | bisher beste Gesamtbeschreibung; wird schrittweise in die neue Spec-Struktur überführt |
| reaktivitaet.md | Ergänzende Referenz | Bestehendes Detailverhalten für Reaktivität und Relations; wird später in passende Kern-Slices überführt |