Buch V — Architektur

Wer dieses Buch liest: Sie wollen die Architektur der Officina-del-Caffè-Appliance verstehen.

Quellen-Pflicht

Diese Doku-Instanz wird aus der SSOT unter source-of-truth/ gerendert (Doc-Renderer-Pipeline). Hand-Edits unter docs/ sind verboten (siehe Charta).

arc42-Mapping

arc42-Kapitel	Quelle in SSOT
1. Einführung & Ziele	MISSION.md + source-of-truth/prds/PRD-001/
2. Randbedingungen	PRD-001 §2
3. Kontextabgrenzung	source-of-truth/diagrams/context-c4.dsl (geplant)
4. Lösungsstrategie	PRD-001 §4 (Bausteine B-1..B-12)
5. Bausteinsicht	source-of-truth/diagrams/components-c4.dsl (geplant)
6. Laufzeitsicht	source-of-truth/diagrams/sequence-*.puml (geplant)
7. Verteilungssicht	deploy/ + ADR-011 ServiceManifest
8. Querschnittliche Konzepte	ADRs
9. Architekturentscheidungen	source-of-truth/specs/**/ADR-*.md

Wichtige ADRs

• ADR-011 — officina/v1 ServiceManifest als Single Source of Truth pro Service.
• ADR-020/-021 — Nummerierung verschoben (siehe SPEC-009).

Datenmodell (Kurz)

• Auction 1—n Listing 1—n Bid
• Listing 1—1 Record (Akte, 8-Phasen-Lifecycle)
• Bid.customerId → customer.id (Shopware-Core)

Laufzeitdiagramm Award zu ERP

sequenceDiagram
    participant Admin as Backoffice
    participant Shopware
    participant Integration as ERP-Integration
    participant Emulator as ERP-Emulator
    Admin->>Shopware: Award Listing
    Shopware->>Shopware: Order + Delivery + State erzeugen
    Shopware->>Integration: order.created / delivery.created / state.changed
    Integration->>Emulator: normalisierte Lifecycle-Events
    Emulator-->>Admin: Inbox- und Order-Beleg

Event-Bus

• BidPlacedEvent → SSE-Push (K-04), Audit-Log.
• BidOutbidEvent → Flow Builder (Mail).
• BidAwardedEvent → LoserNotificationSubscriber → BidFinalLoserEvent → Loser-Mails + Award-Mail.

Verwandte Spezifikationen

• SPEC-005 — Datenmodell.
• SPEC-020 — SSE.
• ADR-011 — ServiceManifest.

Stand: Skelett 2026-05-29.