PropertyExchangeFolder — die Ordnerstruktur #
Der zentrale Gedanke: Die Ordnerstruktur ist das Datenmodell. Kein System aus künstlichen Datenbank-IDs, sondern eine sprechende Hierarchie, in der der Ort einer Datei bereits sagt, worauf sie sich bezieht. Dokumente werden so hoch wie nötig, so genau wie möglich abgelegt.
Der Baum #
ROOT/
├── LIEGENSCHAFTEN/
│ └── <liegenschaft-slug>/ ANKER: Flurstück
│ ├── stammdaten.xml
│ ├── <dokumente>.pdf
│ └── GEBAEUDE/
│ └── <gebaeude-slug>/ ANKER: Koordinaten
│ ├── stammdaten.xml
│ ├── <dokumente>.pdf
│ └── EINHEITEN/
│ └── <einheit-slug>/ ANKER: Etage + Position
│ ├── stammdaten.xml
│ └── <dokumente>.pdf
├── PERSONEN/
│ └── <person-slug>/ ANKER: Name + Geburtsdatum
│ ├── stammdaten.xml
│ └── <dokumente>.pdf
└── FIRMEN/
└── <firma-slug>/ ANKER: Handelsregister
├── stammdaten.xml
└── <dokumente>.pdf
Ebenen und ihre Anker #
Jede Entität hat einen Anker — ein Merkmal, das sich nie ändert und die Identität stabil hält, auch wenn sich Namen, Eigentümer oder Nutzung wandeln.
| Ebene | Ordner | Anker (unveränderbar) | Slug-Beispiel |
|---|---|---|---|
| Liegenschaft | LIEGENSCHAFTEN/<slug>/ | Flurstück-Nummer | wehrheim-3-42-1 |
| Gebäude | GEBAEUDE/<slug>/ | GPS-Koordinaten | hauptstr-7 |
| Einheit | EINHEITEN/<slug>/ | Etage + Position | 3og-links |
| Person | PERSONEN/<slug>/ | Name + Geburtsdatum | mueller-max-1985 |
| Firma | FIRMEN/<slug>/ | Handelsregister | sanitaer-meier-hrb12345 |
Slug-Regeln #
Die Slugs sind bewusst streng, damit sie plattformübergreifend und maschinenlesbar bleiben:
- nur
[a-z0-9-]— Kleinbuchstaben, Ziffern, Bindestrich - keine Leerzeichen, keine Umlaute (ae/oe/ue/ss)
- Bindestrich als Trennzeichen
- so kurz wie eindeutig nötig
| Ebene | Muster | Beispiel |
|---|---|---|
| Liegenschaft | gemarkung-flur-flurstueck | wehrheim-3-42-1 |
| Gebäude | strasse-hausnummer | hauptstr-7 |
| Einheit | etage-position | 3og-links, eg-rechts, keller-3 |
| Person | nachname-vorname-geburtsjahr | mueller-max-1985 |
| Firma | kurzname-register | sanitaer-meier-hrb12345 |
Ablage-Regeln #
Dokumente gehören dorthin, worauf sie sich beziehen — und zwar auf die genaueste Ebene, die zutrifft. Eine Heizkostenabrechnung für eine einzelne Wohnung liegt bei der Einheit, ein Wärmeliefervertrag fürs ganze Haus beim Gebäude, ein Grundbuchauszug bei der Liegenschaft.
Warum sprechende Ordner statt IDs? Weil die Struktur damit ohne Spezialsoftware verständlich bleibt — im Dateimanager, im Backup, in zehn Jahren. Genau das ist Datenhoheit in der Praxis: Man versteht seine Daten auch dann noch, wenn das Programm längst vergessen ist.
Internationalisierung #
Für den internationalen Einsatz können die Ebenen zusätzlich eine
sprachunabhängige Nummer tragen (z. B. 2_1_LIEGENSCHAFTEN bzw.
2_1_PROPERTIES). Ein Parser findet den richtigen Ordner dann über die Nummer,
unabhängig vom sprachlichen Namen — maschinenlesbar und menschlich lesbar zugleich.