# Changelog AI Home Staging

Alle releaste Versions-Bumps dieses Moduls. Format: [Keep a Changelog](https://keepachangelog.com/de/1.0.0/), [SemVer](https://semver.org/lang/de/).

## 1.5.0 (2026-08-05)

### Changed

- **Die Bilder entstehen jetzt standardmäßig weltweit.** Damit steht in jedem Arbeitsbereich die aktuelle Modell-Generation zur Verfügung, ohne dass vorher jemand etwas einstellen muss. Gespeichert wird unverändert in Frankfurt: Der Verarbeitungsort betrifft nur die Rechenleistung während der Erzeugung, nicht den Ort deiner Daten.
- **Aus der Zustimmung ist eine Beschränkung geworden.** Wer vertraglich an Europa gebunden ist, stellt unter Einstellungen "nur in der EU" ein und nimmt dabei ausdrücklich schwächere Ergebnisse in Kauf. Für alle anderen entfällt der Zwischenschritt.
- **Text bleibt in Europa.** Die Umstellung gilt nur für Bild und Video.

### Added

- **Der Bild-Import kann deutlich mehr.** Fotos lassen sich jetzt auf die ganze Fläche ziehen, mit Strg+V aus der Zwischenablage einfügen, auf dem Telefon direkt mit der Kamera aufnehmen oder aus dem Dateispeicher und aus deinen Objektfotos wählen. Vorher ging nur der Datei-Dialog.
- **Das Tool sagt dir vor der Generierung, wenn ein Foto zu dunkel, flau oder unscharf ist.** Der Hinweis erscheint direkt an der Vorschau, und zwar bei jeder Quelle.
- **Ein Foto aus dem Dateispeicher wird direkt übernommen.** Bisher wurde es heruntergeladen und sofort wieder hochgeladen, was Zeit und Speicherplatz gekostet hat.

## 1.4.1 (2026-08-05)

### Changed

- Die Einstellungen sehen jetzt aus wie überall sonst in der Plattform und
  werden auch so gespeichert. Statt eines Speichern-Knopfs, der je nach
  Bereich woanders stand, erscheint unten eine Leiste, sobald du etwas
  geändert hast. Dort steht immer, ob noch etwas offen ist. Auf dem Handy
  schwebt sie über der unteren Leiste, verdeckt also nichts.
- Wechselst du den Bereich, während noch etwas ungespeichert ist, wirst du
  gefragt, statt die Eingabe stillschweigend zu verlieren.
- Was du in einer Liste tust, gilt sofort: eine Voreinstellung löschen, einen
  Teilen-Link widerrufen. Darauf wartet kein Speichern-Knopf mehr, und ein
  widerrufener Link ist auch wirklich sofort tot.

### Fixed

- Im Bereich Modelle liess sich der Standard-Modus zwar umstellen, aber nicht
  speichern: Es gab dort keinen Speichern-Knopf, und die Auswahl war beim
  nächsten Wechsel wieder weg. Sie wird jetzt gespeichert.

## 1.4.0 (2026-07-28)

### Added

- **Du entscheidest jetzt, wo die Bilder erzeugt werden.** Unter Einstellungen gibt es den neuen Bereich "Verarbeitungsort". Zur Wahl stehen: nur in der EU, weltweit, oder bei jeder Generierung fragen. Die Einstellung nimmt nur die Inhaberin oder der Inhaber des Arbeitsbereichs vor.
- **Warum das eine Rolle spielt:** die aktuelle Modell-Generation ist derzeit nur außerhalb der EU verfügbar. Wer in Europa bleiben will, arbeitet mit einer älteren Generation und bekommt sichtbar schwächere Ergebnisse. Wer die besseren Bilder will, stimmt der Verarbeitung außerhalb der EU einmal ausdrücklich zu.
- **Bei "fragen" steht die Wahl direkt im Ablauf.** Im Schritt "Qualität wählen & generieren" gibt es dann einen Umschalter zwischen EU und weltweit, und die getroffene Wahl steht in der Zusammenfassung neben Stil und Varianten.

### Changed

- **Ohne eigene Entscheidung wird in Europa gerechnet.** Das ist die neue Vorgabe. Bestehende Arbeitsbereiche wechseln damit auf die ältere Modell-Generation, bis die Inhaberin oder der Inhaber etwas anderes einstellt.
- **Die Speicherung ändert sich nicht.** Alle Ergebnisse liegen unverändert in Frankfurt. Der Verarbeitungsort betrifft nur die Rechenleistung während der Erzeugung.

## 1.3.0 (2026-07-27)

### Added

- **Dein Fortschritt geht beim Neuladen nicht mehr verloren.** Bisher warf ein versehentliches Neuladen der Seite alles weg, inklusive des bereits hochgeladenen Fotos. Jetzt landest du wieder genau in dem Schritt, in dem du warst, mit demselben Bild, demselben zugeordneten Objekt und denselben Einstellungen. Auch das gerade betrachtete Ergebnis bleibt gewählt.
- **Zwischenstände lassen sich verlinken.** Weil der Schritt und das Bild in der Adresszeile stehen, kannst du einen Stand als Lesezeichen speichern oder den Link an eine Kollegin schicken, die Zugriff auf denselben Workspace hat.
- **Die Objekt-Auswahl lässt sich mit der Tastatur bedienen.** Tippen, mit den Pfeiltasten durch die Vorschläge gehen, mit Enter übernehmen. Escape leert das Suchfeld.

### Changed

- **Objekte werden jetzt überall über ihre Adresse geführt, nicht über den Objekt-Titel.** Der Titel ist ein freies Textfeld und ändert sich ständig ("TOP-Objekt", "... reserviert"), die Adresse bleibt. In der Auswahl, in der Schritt-Leiste und in der Zusammenfassung steht deshalb "Musterstr. 32" statt des Titels. Darunter erscheint der Ort. Trägt der Titel zusätzliche Information (etwa "Wohnung 3. OG links" bei zwei Einheiten im selben Haus), wird er weiterhin angezeigt.
- **Die Vorschlagsliste ist sortiert und gruppiert: aktiv vermarktete Objekte stehen oben.** Darunter folgen die in Vorbereitung, ganz unten die abgeschlossenen. Bisher war die Liste allein nach dem letzten Bearbeitungsdatum sortiert, sodass ein längst verkauftes Objekt über dem stehen konnte, an dem du gerade arbeitest.
- **Die Suche findet Objekte jetzt auch mit Hausnummer.** Die Eingabe "Musterstr. 32" lieferte bisher keinen Treffer, weil Straße und Hausnummer getrennt gespeichert sind.
- Die Auswahl zeigt mehr Vorschläge auf einmal und ist in sich scrollbar, statt die Seite zu verlängern.

## 1.2.2 (2026-07-17)

### Fixed

- **Der Foto-Upload funktioniert jetzt auch am Computer zuverlässig.** Große Fotos (etwa aus der Kamera oder vom Explorer) wurden bisher stumm abgewiesen. Sie werden jetzt vor dem Hochladen im Browser automatisch auf eine für Exposé und KI reichlich hohe Auflösung verkleinert, sodass sie sicher durchkommen. Die Bildqualität für die Gestaltung bleibt dabei erhalten.
- **Verständlichere Meldung, wenn ein Upload doch scheitert.** Statt eines irreführenden Hinweises auf die Internetverbindung steht jetzt konkret da, was zu tun ist (Bild neu als JPG speichern und erneut versuchen). Nicht lesbare Bilddateien werden gesondert erklärt.

### Changed

- **Nach dem Hochladen springt das Tool nicht mehr sofort weiter.** Du bleibst zunächst im Upload-Schritt und siehst, dass das Bild bereit ist. Ordnest du danach ein Objekt zu, geht es automatisch zum nächsten Schritt. Ohne Objekt kommst du mit "Weiter" weiter. Ein Objekt, das du schon vor dem Hochladen gewählt hast, führt wie bisher direkt weiter.
- Wird ein Objekt erst nach dem Hochladen zugeordnet, erscheint das Ergebnis trotzdem korrekt unter "Erstellte Inhalte" des Objekts.

## 1.2.1 (2026-07-17)

### Fixed

- **Der Foto-Upload bleibt nicht mehr ewig auf "Wird hochgeladen" hängen.** Fotos über etwa 1 MB (also praktisch jedes echte Raumfoto) wurden vom Server abgelehnt, ohne dass eine Meldung erschien. Jetzt werden Bilder bis 10 MB zuverlässig angenommen. Schlägt ein Upload trotzdem fehl (etwa bei Verbindungsabbruch), erscheint sofort eine verständliche Meldung und du kannst es direkt erneut versuchen.
- Dateien, die nur in der Cloud liegen (zum Beispiel Dropbox oder OneDrive mit "Dateien bei Bedarf") und noch nicht vollständig heruntergeladen sind, werden sofort mit einem klaren Hinweis abgefangen.
- Auch bei einer unterbrochenen Generierung bleibt der Bildschirm nicht mehr stumm stehen: es erscheint eine Meldung mit dem Hinweis, dass reservierte Credits bei technischen Fehlern automatisch erstattet werden.

## 1.2.0 (2026-07-17)

### Fixed

- **Die Seite bleibt auf dem Handy stabil in der Bildschirmbreite.** Kurz nach dem Öffnen sprang das Layout bisher in die Breite, sobald die Objekt-Vorschläge geladen waren: Inhalte ragten rechts aus dem Bildschirm und die Seite ließ sich seitlich verschieben. Lange Objekt-Titel werden jetzt sauber gekürzt und das Layout hält immer die Bildschirmbreite.

### Added

- **Jeder Einrichtungsstil zeigt jetzt eine kleine Vorschau-Szene.** Statt 16 reiner Text-Knöpfe siehst du bei der Stil-Wahl pro Stil einen Miniatur-Raum mit typischen Farben und Materialien plus einer kurzen Beschreibung. So ist sofort klar, was zum Beispiel Japandi oder Art déco bedeutet.
- Auch der zweite Stil (Akzent) zeigt pro Option eine kleine Farbprobe.

### Changed

- **Flüssigere Übergänge im Assistenten.** Die mobile Fortschrittsleiste füllt sich jetzt gleitend statt in harten Sprüngen, Titel und Schrittnummer wechseln weich, die Inhalte jedes Schritts gleiten sanft nacheinander ins Bild und der Upload-Bereich atmet dezent.

## 1.1.0 (2026-07-17)

### Added

- **Homestaging direkt im Assistenten-Chat.** Du kannst dem Assistenten jetzt ein Raum-Foto anhängen und ihn bitten, es zu homestagen. Er erkennt den Raum selbst, klärt offene Punkte (etwa die Art des Homestagings oder die Stil-Richtung) über kurze Auswahl-Fragen mit vorbereiteten Antworten und erstellt das Bild anschließend automatisch mit passenden Einstellungen.
- **Live-Vorschau im Chat.** Während die KI arbeitet, zeigt der Chat eine Generierungs-Karte mit Fortschritts-Animation. Das fertige Bild erscheint direkt in der Unterhaltung als Vorher-Nachher-Vergleich, mit Download und Absprung ins Tool.
- **Ergebnisse landen in der Galerie.** Im Chat erstellte Bilder erscheinen zusätzlich ganz normal in der Galerie des Homestaging-Tools (bei erkanntem Objekt zugeordnet, sonst unter "Nicht zugeordnet").

Die Kosten pro Bild sind dabei exakt gleich wie bei einer Generierung im Tool selbst.

## 1.0.3 (2026-07-16)

### Fixed

- **Auf dem Handy erscheint jetzt die echte Mobil-Ansicht.** Vorher zeigten Smartphones eine herausgezoomte Desktop-Darstellung der ganzen Plattform. Jetzt greifen die mobilen Layouts überall: gestapelte Schritte, kompakte Fortschrittsleiste, feste Weiter/Zurück-Leiste.
- Beim Tippen in ein Eingabefeld zoomt das iPhone nicht mehr automatisch in die Seite hinein.

### Changed

- **Bedienelemente sind auf dem Handy größer.** Auswahl-Pillen, Optionsgruppen, Daumen-Bewertung, Varianten-Vorschauen und die Aktions-Knöpfe im Ergebnis haben jetzt volle Fingergröße; der Herunterladen-Knopf nutzt auf Mobile die ganze Breite.
- Der Foto-Upload-Bereich ist auf dem Handy kompakter, sodass die Objekt-Zuordnung ohne Scrollen sichtbar ist.
- Sehr breite Optionsgruppen scrollen auf schmalen Bildschirmen seitlich, statt das Layout zu sprengen.

## 1.0.2 (2026-07-16)

### Changed

- **Alle Auswahl-Elemente sind jetzt vollständig per Tastatur bedienbar.** Die Optionsgruppen (zum Beispiel Stil-Intensität, Tageszeit, Wetter, Anzahl Varianten) verhalten sich wie echte Auswahlfelder: Pfeiltasten wechseln die Option, der Fokus ist klar sichtbar. Screenreader lesen Fortschrittsbalken und Regler korrekt vor.
- Geteilte Seiten werden von Suchmaschinen nicht mehr erfasst. Ein Teilen-Link bleibt damit wirklich privat zwischen dir und den Personen, die ihn erhalten.

## 1.0.1 (2026-07-16)

### Fixed

- **Der Vorher-Nachher-Regler funktioniert wieder richtig.** Beim Ziehen wurde das Original-Bild gestaucht statt aufgedeckt. Jetzt liegen beide Bilder exakt deckungsgleich übereinander und der Regler blendet das Original mit einem sauberen Wisch-Effekt ein. Der Regler lässt sich zusätzlich per Tastatur bedienen (Pfeiltasten, Pos1 und Ende).
- Ungeeignete Dateien werden beim Hochladen sofort abgefangen: falsches Format oder mehr als 10 MB zeigen direkt eine verständliche Meldung, auch beim Hineinziehen und beim Einfügen mit Strg+V.

### Changed

- **Das Ergebnis wird zuerst vollständig angezeigt.** Der Vergleichs-Regler startet jetzt ganz links. Du siehst sofort das komplette generierte Bild und ziehst den Regler nach rechts, um das Original einzublenden.
- Die Aufbewahrung räumt jetzt auch hochgeladene Fotos ohne zugehörige Ergebnisse mit ab, damit sie keinen Speicherplatz mehr belegen.

## 1.0.0 (2026-07-16)

Die erste stabile Version. AI-Homestaging ist damit vollständig für den Alltag gehärtet: flexiblere Feinabstimmung, sichere Teilen-Links und ein rundum verlässlicheres Verhalten.

### Added

- **Teilen-Links mit Passwortschutz.** Beim Teilen eines Ergebnisses öffnet sich jetzt ein kleiner Dialog: Gültigkeit wählen, optional ein Passwort vergeben, Link kopieren. Empfänger ohne Passwort sehen nur eine Passwort-Abfrage, nie das Bild. Das Passwort wird niemals im Klartext gespeichert.
- **Aufruf-Zähler für Teilen-Links.** In den Einstellungen unter Freigabe siehst du pro Link, wie oft er geöffnet wurde und wann zuletzt. Passwortgeschützte Links sind dort markiert.
- **Bild aus der Zwischenablage einfügen.** Im Upload-Schritt kannst du ein kopiertes Foto oder einen Screenshot direkt mit Strg+V einfügen, ohne Datei-Dialog.

### Changed

- **Kreativitätsgrad als Regler mit fünf Stufen.** Statt drei Auswahlknöpfen gibt es jetzt einen Schieberegler von Minimal (nur dezente Auffrischung) über Sicher, Moderat und Kreativ bis Visionär (maximale gestalterische Freiheit). Bestehende Voreinstellungen funktionieren unverändert weiter.
- **Freigabe-Schalter wirkt sofort.** Wird das Teilen in den Einstellungen ausgeschaltet, sind auch bereits erstellte Links sofort nicht mehr abrufbar.
- **Aufbewahrung greift jetzt wirklich.** Die eingestellte Aufbewahrungsdauer für generierte Bilder wird automatisch durchgesetzt: ältere Ergebnisse werden entfernt und der belegte Speicherplatz wird wieder frei.
- **Heruntergeladene Bilder haben sprechende Namen.** Der Dateiname enthält jetzt Stil, Raum und Datum statt einer technischen Kennung.
- **Gelöschte Ergebnisse geben ihren Speicherplatz frei.** Beim Löschen einer Generierung wird auch das gespeicherte Bild entfernt und zählt nicht mehr gegen dein Speicher-Kontingent.

### Fixed

- Sehr viele Generierungen oder Uploads in kurzer Zeit werden jetzt sanft gebremst, mit klarer Meldung und Wartezeit. Das schützt dein Guthaben vor versehentlichen Schleifen.
- Die Objekt-Suche behandelt Sonderzeichen im Suchbegriff jetzt wortwörtlich statt als Platzhalter.

## 0.5.2 (2026-07-14)

### Changed

- Generierte Bilder behalten jetzt zuverlässig das Seitenverhältnis des hochgeladenen Fotos. Vorher konnte das Ergebnis in ein anderes Format kippen, zum Beispiel von Querformat zu Quadrat.
- Kurzzeitige Störungen beim KI-Anbieter werden automatisch abgefangen: die Generierung versucht es selbstständig erneut, statt sofort mit einer Fehlermeldung abzubrechen.

### Fixed

- Die Bildgenerierung brach in manchen Fällen mit einer Fehlermeldung ab, obwohl die KI das Bild bereits erstellt hatte. Ursache war ein Übertragungsproblem bei bestimmten Bildformaten auf Anbieterseite. Die Plattform holt generierte Bilder jetzt über einen stabileren Weg ab. Alle Bildformate kommen zuverlässig an, bereits reservierte Credits wurden bei betroffenen Läufen wie immer automatisch erstattet.

## 0.5.1 (2026-07-14)

### Fixed

- **Auf dem Handy: Die obere Leiste bleibt beim Scrollen sauber.** Beim Herunterscrollen in einem Schritt schob sich der Inhalt vorher über die obere Leiste mit Name und Profil. Jetzt liegt die obere Leiste immer im Vordergrund.
- **Auf dem Handy: Die Zurück/Weiter-Leiste sitzt bündig.** Die Leiste mit „Zurück" und „Weiter" schließt jetzt ohne Lücke direkt an die untere Navigationsleiste an.

## 0.5.0 (2026-07-12)

### Changed

- **UI-Erneuerung im Aurora-Stil.** Die Oberfläche unter `/tools/homestaging` übernimmt durchgehend den ruhigen, hochwertigen Aurora-Look vom Dashboard. Weg mit Regenbogen-Gradienten und lautem Chrome, hin zu einer einfarbigen Tool-Identität, Hairline-Rändern und dezenten Rundungen.
  - **Aurora-Wash statt Kopfzeile.** Oben ein full-bleed, langsam driftender Aurora-Wash (`<AuroraWash />`), der sanft nach unten ausläuft. Kein Titeltext, kein Icon, kein Rahmen. Die Einstellungen bleiben als dezenter Zahnrad-Button erreichbar.
  - **Schritt-Rail neu (Desktop).** Durchgehende Verbindungslinie mit mitwachsender Aurora-Füllung, drei klar unterscheidbare Kreis-Zustände (erledigt = gefüllt mit Haken, aktiv = Rand + Glow, offen = grau).
  - **Kompakte Stepper-Leiste (Mobile).** Nummern-Badge, aktueller Titel + Hinweis, „N / 5" und segmentierter Fortschrittsbalken. Der Modus wird automatisch nach Bildschirmbreite gewählt.
  - **Ruhiger Foto-Upload.** Großzügige Dropzone mit dünnem Upload-Symbol in weichem Kreis; beim Drüberziehen klarer Aktiv-Zustand (Aurora-Glow, „Jetzt loslassen"). Nach dem Upload saubere Vorschau mit „Bereit"-Markierung.
  - **Objekt-Zuordnung mit Querformat-Cover.** Die Trefferliste zeigt das echte Titelbild des Objekts im Landscape-Format; der ausgewählte Zustand ein größeres 16:9-Cover mit Objektdaten und Status.
  - **Zweiter Stil als Chips** statt Dropdown; Parameter (Kreativität, Tageszeit, Wetter, Intensität, Varianten) als volle-Breite-Segmented-Controls.
  - **Generieren-Schritt aufgeräumt.** Qualitätsstufen als klare Auswahl-Liste mit „Empfohlen"-Markierung und Radio-Häkchen, dezente Zusammenfassung, selbstbewusster „Jetzt generieren"-Button. **Kosten/Credits bewusst leise:** nur eine kleine Zeile unter dem Button, kein Kosten-Block.
  - **Atmender Generierungs-Zustand** ohne Rahmen-Titel (voller Fokus); Ergebnis-Ansicht mit Vorher-Nachher-Regler, Daumen-Feedback, Varianten und Aktionen.
- **Tenant-Farben statt hartkodiertem Violett.** Neuer plattformweiter Token `--grad-tool` (plus `--grad-tool-shadow`) in `globals.css`, aus der Tenant-Primärfarbe (`--aurora-blue`) abgeleitet. Die Tool-Identität ist ein einfarbiger Verlauf in der Farbe des jeweiligen Tenants, nie ein Regenbogen und nie eine hartkodierte Marke. Alle bisherigen `--grad-ai`-Regenbogen-Flächen im Tool (Rail, Stepper, Chips, Buttons, Objekt-Fallback, Settings-Modellwahl) nutzen jetzt `--grad-tool`.
- **Primäraktion flairt die Aurora.** „Jetzt generieren" ruft `flare()` (Aurora-Motion-System §2) auf: der Wash leuchtet kurz auf.

### Note

- Reine UI-/Interaktions-Erneuerung. Bild-Upload, API-Aufrufe, Generierung, Speichern, Objekt-Zuordnung und Credit-Abrechnung bleiben unverändert; keine Backend- oder Schema-Änderung.

## 0.4.0 (2026-07-11)

### Changed

- **„Projekte" durch „Objekte" (properties) ersetzt.** Statt einer tool-eigenen Projekt-Verwaltung wählt man beim Upload optional das Objekt, für das ein Bild erstellt wird. Die eigene Projekt-Tabelle (`hs_projects`) entfällt; `hs_originals`, `hs_generations` und `hs_shares` verweisen jetzt über `property_id` auf die geteilte `properties`-Tabelle (nullbar, `ON DELETE SET NULL`; Shares `ON DELETE CASCADE`). Migration `0065_hs_property_link`, idempotent.
- **Ergebnisse erscheinen unter dem Objekt.** Ist ein Objekt gewählt, taucht die Generierung zusätzlich unter `/properties/[id]` „Erstellte Inhalte" auf (eigene Bild-Galerie neben den Tool-Runs). Der Ergebnis-Schritt verlinkt direkt „Im Objekt ansehen".
- **Schlanker Kopf.** Der platzraubende Hero (REOS AI · Visualisierung / Studio-Titel / Ansichts-Umschalter) ist einem kompakten Kopf gewichen (Titel links, Einstellungen als Icon rechts). Die getrennte „Projekte"-Ansicht entfällt; das Studio ist die einzige Ansicht.
- **Mobile Navigation immer sichtbar.** Die Wizard-Navigation (Zurück/Weiter) ist auf Mobile fest über der Tenant-Bottombar verankert, statt sticky im Scroll-Fluss. Kein Runterscrollen mehr, um die Buttons zu finden.

### Added

- **Objekt-Auswahl mit Sofortsuche (`PropertyPicker`).** Search-as-you-type über Adresse und Name, jede Trefferzeile mit Titelbild und Status des Objekts. Ohne Suchbegriff werden aktive Objekte gezeigt; verkaufte und archivierte erscheinen nur, wenn explizit danach gesucht wird. Die Zuordnung bleibt optional.
- Neue Repository-Funktionen `searchProperties`, `getProperty`, `listGenerationsForProperty`, `listRecentGenerations` und der Server-Loader `loadHomestagingForProperty` für die Objekt-Seite.

### Removed

- Projekt-Actions (`createProjectAction`, `renameProjectAction`, `archiveProjectAction`, `deleteProjectAction`), die `Projekte`-Kachel-Ansicht und die Einstellung „Projekte automatisch benennen".

## 0.3.0 (2026-07-11)

### Changed

- **Komplett neu als mehrschrittiger Wizard** statt einer langen Scroll-Seite. Fünf geführte Schritte (Bild, Raum & Art, Stil, Feinabstimmung, Generieren) mit vertikaler Schritt-Leiste (Desktop) bzw. Fortschritts-Punkten (Mobile), breitem Inhalt der die Fläche nutzt und einer sticky Footer-Navigation (Zurück/Weiter) — Endlos-Scrollen entfällt. Jeder Schritt passt in den Viewport; abgeschlossene Schritte sind anklickbar.
- **Eigene „Projekte"-Ansicht** als Kachel-Grid (Cover, Name, Anzahl, Datum) mit Umbenennen/Archivieren/Löschen, getrennt vom Studio-Wizard und über den Kopf-Umschalter erreichbar.
- **Ergebnis-Schritt** mit großem Vorher-Nachher-Vergleich, Varianten-Galerie, Bewertung, Download, Teilen und „Neue Variante" / „Neues Bild".

### Added

- **Bildgenerierung läuft jetzt über den globalen `reos.ai.generate`-Handler**: der Modus (lite/standard/premium) ist der reos.ai-Tier, der ausführliche System-Prompt und der strukturierte User-Prompt fließen mit, das Originalbild als `inputImage`, das Bild-Modell als `override`. reos.ai (SDK) wurde dafür additiv um Bild-Output erweitert (`ReosAiGenerateInput.inputImage`/`imageOutput`, `ReosAiGenerateResult.image`, `OpenAiCompatibleProvider.generateImage`) — der Text-Pfad bleibt unverändert.
- **Extrem ausgebaute System-Prompts**: professionelles Immobilien-Virtual-Staging mit harten Leitplanken (Kamera/Perspektive/Architektur erhalten, Fotorealismus, korrektes Licht/Schatten/Reflexionen, maßstabsgetreue Möbel, keine Artefakte/Texte/Personen), pro Modus getunt (Lite schnell, Standard listing-grade, Premium editorial). Der User-Prompt ist klar strukturiert (TASK/ROOM/STYLE/CREATIVITY/PRESERVE/LIGHTING/SPECIAL REQUESTS).

## 0.2.0 (2026-07-11)

### Added

- **Drei KI-Modi (wie beim Assistenten): Lite, Standard, Premium.** Lite läuft auf `gemini-3.1-flash-lite-image` (günstigster Tarif), Standard und Premium auf `gemini-3.1-flash-image` (Pro-Level-Bildintelligenz bei Flash-Tempo). Der rohe Modellname bleibt verborgen; angezeigt wird „REOS AI · Lite/Standard/Premium“ mit vividem AI-Gradient bei Auswahl.
- **Nutzungsbasierte Credit-Abrechnung, exakt wie der Assistent.** Pro Bild wird ein Worst-Case-Cap reserviert (`CreditsEngine.reserve`), nach dem Lauf werden die echten Credits aus den Provider-Token gebucht (`commit(actualCredits)`) und der Rest atomar freigegeben. Formel wie beim Agent: `credits = costEur × Markup / 0,02 €` (Markup Lite/Standard 1,5×, Premium 2×). Vorab-Guthaben-Check verhindert Start ohne Deckung; bei Fehler wird `refund` ausgelöst (keine Belastung). Neue Spalte `hs_generations.credits_used` als `numeric(10,1)` (Migration `0064_hs_decimal_credits`).
- **Echte Bildgenerierung standardmäßig aktiv**, sobald ein Provider-Key konfiguriert ist (Kill-Switch `REOS_AI_IMAGE_DISABLED=true`). Ohne Key greift weiterhin die deterministische Vorschau.
- **Enterprise-Feinschliff der Generierungs-Ansicht:** Aurora-Shimmer-Text (`aurora-text-shimmer`) über zyklische Stufen-Labels („Bild wird analysiert“ … „Letzter Feinschliff“), atmender Orb, gestufter Fortschritt und das Original als weicher Hintergrund.
- **AI-Gradient-Toggle** im Design-System (`@reosa/ui` `Switch tone="ai"` + `--grad-ai`) für KI-native Schalter, genutzt in den Homestaging-Einstellungen.

### Changed

- Generierung läuft nicht mehr über den Fix-Kosten-Run-Harness, sondern über die modul-eigene Server-Action `generateAction` (`loadCompute: null`), damit die Abrechnung nutzungsbasiert ist.
- „Modell-Vergleich“ erzeugt jetzt alle drei Modi (Lite, Standard, Premium) statt Schnell/Pro. Der Credit-Schätzer auf dem Button ist modusabhängig.

### Fixed

- **Deployment-Build repariert:** synchrone Mapper-Funktionen aus der `"use server"`-Datei `api/reads.ts` in `api/mappers.ts` ausgelagert (Next erlaubt in `"use server"`-Modulen nur async Exporte). Zusätzlich `lib/pricing.ts` client-safe gemacht (kein `@reosa/sdk`-Import im Client-Pfad).

## 0.1.0 (2026-07-11)

### Added

- **Geführter Generierungs-Ablauf** in fünf Schritten (Referenz-Feature-Set): Bild hochladen (JPG, PNG, WEBP bis 10 MB), Bearbeitungsart (Neu dekorieren, Einrichten, Bearbeiten, Raum leeren), Raumtyp (14 Vorgaben plus eigener Raumtyp), Einrichtungsstil (16 Stile) und erweiterte Parameter.
- **Erweiterte Parameter:** Kreativitätsgrad (Sicher, Moderat, Kreativ), zu erhaltende Elemente als Mehrfachauswahl (Boden, Wände, Decke, Fenster, Kamin, Türen, Treppe, Außenansicht), Sonderwünsche als Freitext mit Prompt-Bibliothek, zweiter Stil als Akzent samt Intensität, Modellwahl (Schnell, Pro) sowie Tageszeit und Wetter.
- **Enterprise-Oberfläche** im Aurora-Design: edge-to-edge Layout mit Projekt-Rail (ab `xl`), großem Ergebnis-Canvas und Parameter-Inspector, voll responsive (Desktop-Breite genutzt, Mobile gestapelt mit sticky Generieren-Leiste).
- **Interaktiver Vorher-Nachher-Vergleich** per Schieberegler, Galerie-Streifen aller Varianten, Varianten-Generierung (bis zu vier) und Modell-Vergleich (Schnell und Pro parallel).
- **Projektmanagement:** benannte Projekte mit Cover, Original- und Varianten-Verwaltung, Umbenennen, Archivieren, Löschen. Optional automatische Projektbenennung.
- **Voreinstellungen:** Parameter-Sets speichern und per Klick anwenden. Zwei Beispiel-Presets werden beim Installieren angelegt.
- **Feedback** (Daumen hoch/runter) und **Download** je Ergebnis.
- **Teilen** per Link mit optionalem Ablauf; öffentlicher, login-freier Viewer unter `/share/<token>` (service_role-Auflösung, nur Ergebnis-Bilder, KI-Kennzeichnung).
- **KI-Bildschicht:** Generierung über `reos.ai` (Gemini-Default, Model-Name-Hiding) mit deterministischem Mock-Provider als Fallback (`REOS_AI_IMAGE_ENABLED`), damit das Tool ohne Provider-Key funktioniert.
- **Abrechnung** über den Run-Harness: ein Lauf = ein Bild = `creditsPerUse` Credits, automatische Erstattung bei Fehlern.
- **Settings-Panel** mit fünf deep-linkbaren Tabs (Allgemein, Generierung, Modell & Abrechnung, Voreinstellungen, Freigabe).
- **Agent-Surfaces** (lesend): `homestaging.projects` und `homestaging.recent`.
- **Datenmodell:** tenant-isolierte Tabellen `hs_projects`, `hs_originals`, `hs_generations`, `hs_presets`, `hs_shares`, `hs_settings` mit RLS (Migration `0063_homestaging`).
- **Tenant-User-Guides** (DE/EN): Überblick, Erste Schritte, Parameter, Einstellungen, Fehlerbehebung.
- **Tests:** Manifest-Konformität, Prompt-Bau, Credit-Schätzung, Mock-Provider-Determinismus.

### Notes

- Pro-Modell kostet in v0.1.0 denselben Credit-Betrag wie das Schnell-Modell (fixe Harness-Reservierung pro Lauf); modellabhängige Staffelung folgt mit dynamischer `platform.credits`-Reservierung.
- Passwortgeschützte Teilen-Links sind vorbereitet (Datenmodell), im Viewer aber noch nicht aktiv; v0.1.0 nutzt Ablauf plus Widerruf.
- Der rohe Modellname bleibt gemäß REOS-AI-Konvention verborgen; die Referenz-Bezeichnungen (Nano Banana) werden als „REOS AI · Schnell/Pro“ dargestellt.