EAOS

Zentraler Leitfaden

EAOS Praxisguide

Vom ersten Öffnen bis zum gesicherten Architekturstand: die Workbench als zusammenhängender Arbeitsprozess.

Workspace öffnenStudio öffnenArchitecture as Code

1. Schnellstart

  1. ZIP vollständig entpacken.
  2. lernweg.html öffnen.
  3. Diesen Praxisguide auswählen.
  4. index.html als fokussierten Workspace öffnen.
  5. Rolle auswählen.
  6. Demo-Projekt verwenden oder eigenen Workspace importieren.

2. Sechs Haupteinstiege

Platform

Projekte, Governance, Policies, Knowledge Graph und zentrale Dienste.

Studio

Domänen, C4, APIs, Events, Deployment, Betrieb und Reviews.

Architecture as Code

Modellvalidierung und Ableitung technischer Artefakte.

Ecosystem

Marketplace, Blueprints, Playbooks, Patterns und Entscheidungen.

Academy

Lernpfade, Labs, Challenges, Katas und Certification.

Administration

Runtime Validation, Hardening, Acceptance und Prüfberichte.

3. Rollen

RolleSchwerpunkt
Enterprise ArchitectPortfolio, Governance, Policies, Roadmaps
Solution ArchitectSystemkontext, C4, ADRs, APIs, Risiken
DeveloperModule, Code, Architecture as Code, Quality Gates
ReviewerReviews, Findings, Evidence, Freigaben
ExecutiveKPIs, Kosten, Reifegrad, Risiken

4. Empfohlener Arbeitsablauf

  1. Projekt öffnen: Demo, neues Projekt oder JSON-Import.
  2. Domäne modellieren: Subdomänen, Bounded Contexts, Verantwortung, Datenhoheit.
  3. Architektur modellieren: Systeme, Container, Komponenten, Module und Beziehungen.
  4. Schnittstellen beschreiben: APIs, Events, Schemas, Versionierung und Security.
  5. Entscheidungen dokumentieren: Optionen, Konsequenzen, Risiken und Status.
  6. Prüfen: Policies, Fitness Functions, Drift, Impact und Evidence.
  7. Generieren: Maven, Java, OpenAPI, AsyncAPI, Docker, Kubernetes, CI/CD und Dokumentation.
  8. Review: Findings, Reviewer, Freigaben und Vier-Augen-Regel.
  9. Sichern: JSON exportieren, Snapshot erzeugen und in Git ablegen.

5. Einheitliche Objektansicht

Systeme, Module, APIs, Events und Bounded Contexts folgen demselben Muster:

ÜbersichtBeziehungenEntscheidungenRisikenPoliciesEvidenceHistorie

6. Command Center

Mit Ctrl + K beziehungsweise Cmd + K die Command Palette öffnen. Damit lassen sich Bereiche aufrufen, Projekte wechseln, Modelle validieren, ADRs erstellen und Drift-Prüfungen starten.

7. Offline-Modus und Sicherung

8. Team- und Serverbetrieb

Mehrbenutzerbetrieb benötigt die vorbereitete Spring-Boot-, PostgreSQL-, OIDC-, Evidence- und optionale Messaging-Infrastruktur.

mvn clean verify
docker compose up --build

Diese Nachweise müssen in einer realen Entwicklungs- oder CI-Umgebung ausgeführt werden.

9. Öffnungsreihenfolge

  1. lernweg.html
  2. docs/user-guide/EAOS_PRAXISGUIDE.html
  3. index.html
  4. studio/index.html
  5. architecture-as-code/index.html
  6. focused-workspace/object-detail.html
  7. WAS_WURDE_GEMACHT.html

10. Sauberer Abschluss eines Arbeitsstands

Weiterführende Hilfen

Workbench GuideErstes ProjektOffline-ModusFAQ