ostrelle
Menü

OSTRELLE · LERNEN · MIT ÜBUNGEN

1. Den richtigen Vertrag finden

Du ordnest eine Änderung der bestehenden Domäne und ihrer echten Implementierung zu. Mit konkreten Schritten, eigener Übung, Musterlösung und Erfolgskontrolle.

Ostrelle für Entwickler · Lektion 1 von 4 · Quellstand 3. November 2026

Das lernst du

Du ordnest eine Änderung der bestehenden Domäne und ihrer echten Implementierung zu.

Ostrelle ist ein Rust-CMS mit mehreren Workspacecrates. Gemeinsame Typen und Store-/Journalverträge tragen die Domänen; der Server verdrahtet sie. Die Verwaltungs-API prüft Authentifizierung, Origin, CSRF und Fähigkeiten. Ein Cratename oder eine Spezifikation allein belegt keinen ausgelieferten Klickpfad.

Die Architektur verlangt serverseitiges HTML und eine klare Trennung zwischen Besucher- und Editorcode. Erlaubte Admininseln ändern nicht das Ziel, Informationsseiten ohne JavaScript auszuliefern. Führe für eine Dokumentationsseite keinen separaten React-/Vue-Renderer ein.

Schritt für Schritt

  1. Lies docs/PLAN-PHASE1.md, docs/ARCHITEKTUR.md und die passende Spezifikation. Für Blöcke ist SPEC-13, Rendering SPEC-14 und Verwaltung SPEC-20 maßgeblich.
  2. Lies Cargo.toml und die betroffenen Crates. Verfolge einen bestehenden Seitenabruf von wpnext-server zu wpnext-render und dem Runtime-Theme.
  3. Öffne website/build-content.mjs, das erzeugte Manifest und crates/wpnext-server/examples/product_site.rs. Bestimme, welches Werkzeug Quellinhalt baut und welches wirklich persistiert.
  4. Prüfe den verwendeten Commit und git status. Arbeite auf einem eigenen Branch und fasse keine fremden Änderungen an.
  5. Baue oder teste nur die für deine Änderung erforderlichen Ziele. In diesem gemeinsamen Workspace gelten ein globaler Buildlock, Jobs2 und ein eigenes Target je Worktree.
git status --short
git rev-parse HEAD
node website/build-content.mjs --check
cargo check --locked -p wpnext-server

Deine Übung

Ordne eine neue Infoseite, einen neuen APIhandler und eine geänderte Datenbankregel der passenden Schicht zu. Welche Arbeit darf eine Themeänderung nicht übernehmen?

Musterlösung und Erklärung

Die Infoseite besteht aus kanonischen Blöcken und dem vorhandenen Theme. Ein APIhandler gehört zur vorhandenen API-/Serververdrahtung und nutzt Domänenverträge. Eine Datenbankregel wird im verantwortlichen Store-/Domänenvertrag mit Migration und Test umgesetzt.

Ein Theme darf weder eine zweite fachliche Datenquelle noch einen eigenen Auth-/Buchungs-/Shopzustand erzeugen. Node ist ein Buildwerkzeug; der Besucherbetrieb benötigt keinen zusätzlichen Node-Webserver.

So prüfst du dein Ergebnis

  • Du kannst Quelle, Manifest, Operator und Renderer unterscheiden.
  • Die Spezifikation wurde mit tatsächlichem Code abgeglichen.
  • Eigener Branch und eigener Buildpfad sind erkennbar.

Kursübersicht · Nächste Lektion →